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

curl --location --request POST 'https://api.nubox.com/Nubox.API/factura/documento/15478788-7/1/rutFuncionario/1/emitir/ventaExtendido?rutFuncionario=13954729-2&emitir=true' \
--header 'token: f49ddf96-fdb5-4394-8cbd-0b6229dde981' \
--header 'Content-Type: application/json' \
--header 'Cookie: .Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da' \
--data-raw '{
 "productos": [
 {
 "rutContraparte": "11111111-1",
 "razonSocialContraparte": "venta23",
 "giroContraparte": "venta23",
 "tipo": 33,
 "folio": 1600,
 "secuencia": 1,
 "fecha": "2020-06-22T00:00:00.8751996-04:00",
 "afecto": "SI",
 "producto": "producto de ejemplo",
 "descripcion": null,
 "cantidad": 1,
 "comunaContraparte": "Las Condes",
 "direccionContraparte": "Av Vitacura 3110",
 "precio": 70000,
 "valor": 70000,
 "ponderacionDescuento": 0,
 "emailContraparte": "mail@ejemplo.com",
 "tipoDeServicio": "",
 "fechaPeriodoDesde": "",
 "fechaPeriodoHasta": "",
 "fechaVencimiento": "",
 "codigoSucursal": "Cod 0001",
 "vendedor": "Pedro Sanchez",
 "codigoItem": "01",
 "unidadMedida": "UNID",
 "codigoIMP": "",
 "montoIMP": 0,
 "indicadorDeTraslado": "1",
 "formaDePago": "1",
 "medioDePago": "EF",
 "terminosDePagoDias": "",
 "terminosDePagoCodigo": "",
 "comunaDestino": "Santiago",
 "rutSolicitanteFactura": "9663691-1",
 "productoCambioSujeto": "",
 "cantidadMontoCambioSujeto": 0,
 "tipoGlobalAfecto": "",
 "valorGlobalAfecto": 0,
 "tipoGlobalExento": "",
 "valorGlobalExento": 0,
 "precioCambioSujeto": 0,
 "descuentoMonto": 0,
 "rutTransportista": "14183701-k",
 "rutChofer": "14183701-k",
 "patente": "SVFV02",
 "nombreChofer": "Juan Pereira",
 "direccionDestino": "Santa Rosa 215",
 "ciudadDestino": "Santiago",
 "tipoDeDespacho": "",
 "nombreDeContacto": "Lorena Álvarez",
 "observacion": "Observación."
 }
 ],
 "documentoReferenciado": {
 "tipo": 0,
 "folio": 2343,
 "secuencia": 0,
 "tipoDocumentoReferenciado": 0,
 "folioDocumentoReferenciado": 34,
 "fechaDocumentoReferenciado": "2020-06-22T15:31:10.8751996-04:00",
 "motivoReferencia": 0,
 "glosa": "Glosa"
 }
 }'

Ejemplo Response

Response Body

{
 "Respuesta":{
 "Version":{
 "Major":1,
 "Minor":1,
 "Build":-1,
 "Revision":-1,
 "MajorRevision":-1,
 "MinorRevision":-1
 },
 "Content":{
 "Headers":[
 {
 "Key":"Content-Type",
 "Value":[
 "image/png"
 ]
 },
 {
 "Key":"Content-Disposition",
 "Value":[
 "attachment; filename=DTE_FOLIO_9.png"
 ]
 }
 ]
 },
 "StatusCode":200,
 "ReasonPhrase":"OK",
 "Headers":[
],
 "RequestMessage":null,
 "IsSuccessStatusCode":true
 },
 "MontoTotal":83300,
 "Folio":9,
 "UrlBoleta":"error al obtener la url",
 "TED":"<TED version=\"1.0\"><DD><RE>15478788-7</RE><TD>33</TD><F>9</F><FE>2020-06-22</FE><RR>11111111-1</RR><RSR>venta23</RSR><MNT>83300</MNT><IT1>producto de ejemplo</IT1><CAF version=\"1.0\"><DA><RE>15478788-7</RE><RS>PruebaQA PR</RS><TD>33</TD><RNG><D>1</D><H>200</H></RNG><FA>2019-11-29</FA><RSAPK><M>sX0nvDd4SUWiFLU2mjVl9/UWfybVjUz2qsxIZV752vwx3RmeCIWGRzSgTbyQCkYjoTHlc1XZA1N7MzOCEWR17w==</M><E>Aw==</E></RSAPK><IDK>100</IDK></DA><FRMA algoritmo=\"SHA1withRSA\">ivgTWDkuxqnI85Pc4N6kSoKJCX7k0knBBgy2e+SCZPW1Fcuzveh3A25Npsmj7poCQN/g0TTLT8TOU8AFlWs+9g==</FRMA></CAF><TSTED>2020-06-22T16:30:20</TSTED></DD><FRMT algoritmo=\"SHA1withRSA\">\r\nMmXWdBTQeaJlIM/XSvDPgfRc5vj2DvHlthdxS0Ztmntps28fdzHg5/0H8DaQCm4wAC5gX8enbMsQxzDASATa8A==\r\n</FRMT></TED>"
}

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

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