Guardado y Emisión de Documentos

    Emitir un documento significa que enviaremos el archivo al SII para que sea revisado, firmado y aceptado.

    En esta sección aprenderás cómo utilizar la API para insertar documentos y emitirlos.

    Flujo de emisión de ventas

    Hubspot - nubox (34)

    Insertando y emitiendo una venta

    Para insertar una venta utilizaremos el verbo http POST, puedes insertar y emitir documentos de ventas como facturas, facturas electrónicas, etc.

    exclamacion

    API endpoint exclusivo para partners que trabajen con factura electronica.

    URL del recurso

    https://api.nubox.com/Nubox.API.cert/factura/documento/{rut}/{numeroSerie}/rutFuncionario/{opcionFoliosAutomaticos}/emitir/ventaExtendido?rutFuncionario={rutFuncionario}&emitir={emitir}

     

     

    Información del recurso

    Formato de respuesta JSON
    ¿Requiere autenticación? SI
    ¿Requiere token? SI
    ¿Requiere Partner key? NO

    Parámetros

    Nombre Descripción Tipo del parámetro Tipo del dato
    rut Rut de la empresa Path String
    numeroSerie Número de serie del sistema, este valor se obtiene desde el resultado de la autenticación API Path Integer
    rutFuncionario
    		 rut del funcionario Path String
    opcionFoliosAutomaticos
    		 0: folios informados
    1: genera folios automáticos    		 Path Integer
    emitir

    true : emite los documentos

    false : documentos con estado borrador

    		 Path Boolean
    documento Detalle de la venta Body Json

    JSON de Documento

    En el parámetro documento debes incluir un JSON con la siguiente estructura.

    Nombre Tipo Obligatorio Descripción
    productos Array SI Array de Json de los productos incluidos en la venta
    documentoReferenciado Json SI Referencia de la venta, debe ser declarado aunque este vacío

    JSON de Productos

    En el parámetro producto debes incluir un JSON con la siguiente estructura

    Nombre Tipo Obligatorio Descripción
    rutContraparte string SI Rut de la contraparte
    razonSocialContraparte string SI Nombre de la contraparte
    giroContraparte string SI Giro de la contraparte
    comunaContraparte string SI

    Comuna de la contraparte
    direccionContraparte string NO

    Dirección de la contraparte
    emailContraparte string NO Email Contraparte
    tipo integer SI

    Código SII del tipo de documento. Valores posibles:

    • 33: Factura electrónica.
    • 34: Factura exenta electrónica.
    • 56: Nota débito electrónica.
    • 61: Nota de crédito electrónica.
    • 39: Boleta electrónica.
    • 41: Boleta exenta electrónica.
    folio integer SI Número de Folio del documento
    secuencia integer SI Es el número de la secuencia de los productos
    fecha string SI

    Fecha de emisión de la boleta en formato yyyy-mm-dd
    afecto string NO

     Indicador para marcar si el producto es afecto. Valores posibles:

    • SI.
    • NO.
    producto string NO

    Nombre del producto
    descripcion string NO

    Descripción corta del producto
    cantidad number NO Cantidad del producto
    precio integer NO deprecado
    valor number NO

    Valor del producto o precio del producto, el total lo calcula la API
    tipoDeServicio string NO

    Código SII del Servicio de la Boleta (solo necesario para Boletas Electrónicas y Boletas Electrónicas Exentas, de no serlo puede quedar vacío) Valores Posibles:

    • 1 : Boleta de servicios periódicos domiciliarios.
    • 2 : Boleta de otros servicios periódicos
    • 3 : Boleta de servicios
    fechaPeriodoDesde string SI Fecha periodo desde
    fechaPeriodoHasta string SI Fecha periodo hasta
    fechaVencimiento string NO Fecha de vencimiento
    codigoSucursal string SI Código de la sucursal ingresada en el sistema, si no hay sucursales ingresadas ingresa un 1
    vendedor string NO Nombre del vendedor
    codigoItem string NO Código del producto (valor con el que se registró en el sistema)
    unidadMedida string NO

    Unidad de Medida. Valores posibles:

    • BDJA : Bandeja.
    • BIN : BIN.
    • BTLL : Botella.
    • CA : Cajas Walmart
    • CAJA : Caja.
    • CART : Cartón.
    • CJ : Cajas Walmart.
    • CM : Centímetros.
    • CM3 : Centímetros Cúbicos.
    • DIA : Día.
    • DISP : Display.
    • DNA : Docena.
    • EA : Artículos Walmart.
    • G : Gramos.
    • GLB : Global.
    • HA : Hectárea.
    • Hora : Hora.
    • KG : Kilogramo.
    • LT : Litro.
    • M : Metros.
    • M2 : Metro cuadrado.
    • M3 : Metro Cúbico.
    • MES : Mes.
    • ML : Metro Lineal.
    • MR : Metro Ruma.
    • P2 : Pies Cuadrado.
    • PAR : PAR.
    • PIE : Pie.
    • PLGO : Pliego.
    • PM : Pulgada Maderera.
    • PP : Pulgada Pinera.
    • PQ : Paquete.
    • PULG : Pulgada.
    • QTAL : Quintal(100 Kg.).
    • RLLO : Rollo, SACO : Saco.
    • TBDM : Tonelada BDMT.
    • TBDU : Tonelada BDU.
    • TIRA : Tira.
    • TON : Tonelada.
    • UF : U.F.
    • UNID : Unidad.
    • USD : Dolar.
    • VIAJ : Viaje
    codigoIMP string NO Código de impuesto o retención adicional declarados por el SII, puedes revisar la lista de impuestos aquí 
    montoIMP integer NO Monto de impuesto o retención adicional
    indicadorDeTraslado string NO

    Indicador De Traslado. Valores posibles:

    • 1:Operación constituye venta.
    • 2:Ventas por efectuar.
    • 3:Consignaciones.
    • 4:Entrega gratuita.
    • 5:Traslados internos.
    • 6:Otros traslados no venta.
    • 7:Guia de devolución.
    formaDePago string NO

    Forma De Pago. Valores posibles:

    • 1: Contado.
    • 2: Crédito.
    • 3: Sin costo
    medioDePago string NO

    Medio De Pago. Valores posibles:

    • CH:Cheque.
    • CF:Cheque a fecha.
    • LT:letra.
    • EF:Efectivo.
    • PE:Pago a cta.cte, TC:Tarjeta Credito,OT:Otro
    terminosDePagoDias string NO Términos De Pago Dias
    terminosDePagoCodigo string NO Términos De Pago Código
    comunaDestino string NO Comuna Destino
    rutSolicitanteFactura string NO RUT del cliente que solicita la factura
    productoCambioSujeto string NO Producto Cambio Sujeto
    cantidadMontoCambioSujeto integer NO Cantidad Monto Cambio Sujeto
    tipoGlobalAfecto string NO Tipo Global Afecto. se puede incluir si el producto es declarado como afecto.

    Valores posibles: 1:DSCTO%, 2:DSCTO$, 3:RCGO%, 4:RCGO$
    valorGlobalAfecto string NO Valor Global Afecto, se debe incluir si se declara el campo "tipoGlobalAfecto"
    tipoGlobalExento string NO Tipo Global Exento. se puede incluir si el producto es declarado como exento.

    Valores posibles: 1:DSCTO%, 2:DSCTO$, 3:RCGO%, 4:RCGO$
    valorGlobalExento string NO Valor Global Exento, se debe incluir si se declara el campo "tipoGlobalExento"
    precioCambioSujeto string NO Precio Cambio Sujeto
    ponderacionDescuento integer NO Si deseas realizar un descuento por porcentaje ocupa este campo dejando el campo descuentoMonto en 0
    descuentoMonto string NO Si deseas realizar un descuento por monto ocupa este campo dejando el campo ponderacionDescuento en 0
    rutTransportista string NO Rut del transportista
    rutChofer string NO Rut del chofer
    patente string NO patente
    nombreChofer string NO Nombre Chofer
    direccionDestino string NO Dirección Destino
    ciudadDestino string NO Ciudad Destino
    tipoDeDespacho string NO

    Tipo De Despacho. Valores posibles:

    1:A instalaciones del cliente por cuenta del receptor.

    2:A instalaciones del cliente por cuenta del emisor.

    3:A otras instalaciones por cuenta del emisor

    nombreDeContacto string NO Nombre De Contacto
    observacion string NO Parámetro opcional

    JSON de documento referenciado

    En el parámetro documento referenciado debes incluir un JSON con la siguiente estructura

    Nombre Tipo Obligatorio Descripción
    tipo integer NO

    Es el mismo tipo del documento ya declarado en el nodo de producto

    Código SII del tipo de documento. Valores posibles:

    • 33: Factura electrónica.
    • 34: Factura exenta electrónica.
    • 56: Nota débito electrónica.
    • 61: Nota de crédito electrónica.
    • 39: Boleta electrónica.
    • 41: Boleta exenta electrónica.
    folio  integer NO

    Es el mismo folio del documento ya declarado en el nodo de producto

    Número de folio del documento
    secuencia
    		 integer NO

    Número de secuencia (cambiará según la cantidad de productos que se ingresen)
    tipoDocumentoReferenciado integer NO

    Código SII del tipo de documento. Valores posibles:

    • 30: Factura.
    • 33: Factura electrónica.
    • 34:Factura electrónica exenta.
    • 39: Boleta Electrónica.
    • 41: Boleta Electrónica Exent.
    • 45: Factura de Compra.
    • 46: Factura de Compra Electrónica.
    • 50: Guía de Despacho.
    • 52: Guía de despacho electrónica.
    • 56: Nota débito electrónica.
    • 61:Nota de crédito electrónica.
    • 103:Liquidación.
    • 801: Orden de Compra.
    • 802: Nota de Pedido.
    folioDocumentoReferenciado integer NO

    Número de Folio del documento referenciado
    fechaDocumentoReferenciado
    		 integer NO

    Fecha de emisión del documento referenciado
    motivoReferencia integer NO

    Valores posibles:
    1: Anula documento.
    2: Corrige texto.
    3: Corrige monto
    glosa string NO

    Glosa libre del porque estas cambiando un documento

    Consideraciones

    exclamacion
    • El IVA es calculado automáticamente solo debes setear el campo afecto en SI.
    • Cuando emites un documento de manera correcta, queda en una cola a la espera de ser emitido por el SII, en este caso el estado del documento es borrador te recomendamos utilizar el recurso de consulta de estado para saber en que estado esta el documento.

    Ejemplos de Request

    Ejemplo Response

    Response Body

    Response Header

    Nombre Valor
    date Mon, 22 Jun 2020 20:30:21 GMT
    cache-control no-cache
    content-length 1174
    content-type text/plain; charset=utf-8

    Pruebas

    Probar en Swagger
     
    nubox.com.co | nubox.com
    Orinoco 90, piso 9 - Las Condes, Santiago de Chile | Teléfono (56 2) 2478 5000
    © Nubox 2020