Esta documentación esta orientada a la Nueva API Factura y Administración de Nubox, donde se explicará el uso de endpoints, autenticación, parámetros, ejemplos de uso, códigos de error comunes y definiciones de términos relevantes.
En cuanto a la documentación de antigua API de Factura Electrónica puedes encontrarla en el Menú Lateral Factura Electrónica
La solución de emisión de documentos tributarios electrónicos ha sido diseñada desde su origen con una arquitectura asíncrona, resiliente y completamente observable.
Este enfoque no solo busca maximizar la confiabilidad del proceso de emisión, sino también asegurar su continuidad incluso ante condiciones externas adversas, como caídas temporales del Servicio de Impuestos Internos (SII) u otros servicios de integración críticos. La arquitectura implementada permite que la plataforma funcione de manera robusta y sin interrupciones en entornos de alta demanda o situaciones de contingencia.
Cada etapa del proceso de emisión —incluyendo la creación del documento, su validación, el posteo al SII, la emisión formal y la posterior consulta de estado— opera de forma desacoplada mediante eventos distribuidos. Este diseño de flujo asíncrono permite una orquestación eficiente, en la que los componentes no dependen entre sí para seguir avanzando, lo que habilita una escalabilidad horizontal natural y evita cuellos de botella ante errores puntuales o latencias en servicios externos.
Adicionalmente, el sistema incorpora mecanismos de resiliencia mediante reintentos inteligentes, lo que significa que ante errores de red, caídas de servicios o rechazos temporales del SII, se aplican políticas automáticas de reintento controlado.
Estas políticas son configurables y están diseñadas para garantizar que ningún documento se pierda. Gracias a ello, los procesos de emisión pueden completarse exitosamente en etapas posteriores, sin requerir la intervención manual del usuario o del equipo técnico, mejorando así la eficiencia operativa y la experiencia del cliente.
Otro de los pilares fundamentales de esta arquitectura es la observabilidad integral.
Cada Documento Tributario Electrónico (DTE) emitido puede ser monitoreado en todas sus fases, desde el momento de su creación hasta la obtención del estado final (aceptado, rechazado o en espera).
La API permite realizar la emisión electrónica de los siguientes tipos de documentos tributarios:
En cuanto a la consulta y recuperación de documentos, la API permitirá obtener el PDF firmado con código PDF417, el XML correspondiente a cada DTE, y consultar el estado de los documentos emitidos.
El proceso de emisión gestionará automáticamente la asignación de folios, permitiendo enviar hasta 50 documentos por llamada al endpoint de emisión que pertenezcan a una compañía.
Además, nuestra API facilitará el envío de los XMLs generados directamente al cliente de la empresa emisora vía email, permitiendo una distribución automática de los documentos tributarios.
Nuestra API implementa un modelo de autenticación dual basado en cabeceras HTTP (headers) para asegurar el acceso controlado por parte de los partners integradores y su uso en representación de empresas específicas.
Este modelo permite mantener una separación lógica y segura entre la identidad del partner y los permisos otorgados por cada empresa cliente.
Authorization: Bearer <partner_token>
Ejemplo: Authorization: Bearer NP_SECRET_UAT_GfMTkOLEVq...
Importante: Cada partner debe custodiar su token con medidas de seguridad adecuadas. El uso indebido puede resultar en la revocación del acceso.
X-Api-Key: <company_api_key>
Esta clave identifica y autoriza a una empresa específica dentro del ecosistema de clientes de Nubox.
Ejemplo: X-Api-Key: NP_KEY_UAT_86d01536.044-5...
Este enfoque permite que un solo partner utilice su token para gestionar múltiples empresas sin exponer las credenciales entre sí.
|
Header utilizado |
Propósito |
|
Authorization |
Autenticación del integrador como entidad segura |
|
X-Api-Key |
Autorización para operar en nombre de la empresa |
Para el desarrollo y la implementación de tu integración, dispondrás de dos ambientes principales, cada uno con una URL base (baseUrl) específica.
La baseUrl que utilices dependerá de si estás en la fase de pruebas o si ya estás operando con transacciones reales.
Los ambientes disponibles son:
Ambiente de Certificación (Pruebas/UAT): Este es el entorno destinado a las pruebas y validaciones durante la etapa de desarrollo. Aquí podrás realizar todas las pruebas necesarias sin afectar datos reales.
URL: Entregada al momento de solicitar las credenciales de prueba
Ambiente Productivo: Este es el entorno para operar con transacciones reales y clientes finales. Solo debes utilizar esta URL cuando tu integración haya sido completamente probada y certificada en el ambiente de pruebas.
URL: Entregada al momento de solicitar las credenciales de prueba
Nuestro ambiente de certificación está disponible lunes a viernes (desde las 11:00 AM GMT a las 00:00 AM GMT). Fuera de este horario la API puede responder que no esta disponible.
Para comenzar a interactuar y realizar pruebas con la API de Integraciones, necesitarás un juego de credenciales único para el ambiente de UAT (User Acceptance Testing). Estas claves te permitirán autenticarse de forma segura.
Para iniciar el proceso, envía un correo electrónico a nuestro equipo de soporte a la siguiente dirección: soporte@nubox.com
En el correo, por favor, indica claramente que necesitas las credenciales de la API de Integraciones para el ambiente de pruebas (UAT), junto con el nombre de tu empresa y un contacto principal.
Nuestro equipo de soporte procesará tu solicitud y te enviará dos claves esenciales:
Token del Partner (Authorization): Este es tu token secreto y exclusivo como integrador. Te identifica y valida que la solicitud proviene de un partner autorizado en nuestra plataforma.
API Key de la Empresa Cliente (X-Api-Key): Esta clave identifica a la empresa específica de pruebas sobre la cual actuarás. Te autoriza a operar en nombre de esa compañía en el ambiente de pruebas UAT.
Host para ambiente (BaseUrl): Esta será usada para configurar el ambiente en el cual estaremos trabajando en nuestro postman
Una vez que tengas estas dos credenciales, ya estás listo para configurar tu entorno.
Hemos creado la siguiente colección de Postman, y comenzar a realizar tus primeras llamadas a la API en el ambiente de pruebas.
Esta colección incluye todos los endpoints con ejemplos pre-configurados para que solo tengas que preocuparte de probar la integración.
Para importar la colección sigue los siguientes pasos:
Opción A:
Opción B:
Paso 1: Copia el siguiente Link: https://api.postman.com/collections/42436964-d9694f99-f6d3-4eff-ab9e-7807565e2c5b?access_key=PMAT-01K8BZ0T4ADB9RXV527RPTTX18
2. Accede a Postman y presiona el Botón Import
Paso 3: Pega en la sección indicada el texto copiado en el primer paso:
Paso 4: La importación arrojará un mensaje de que ha sida agregada correctamente.
Para que las llamadas funcionen, sólo necesitas configurar tus credenciales una vez. La colección se encargará de incluirlas automáticamente en cada solicitud.
En la colección se debe cambiar el valor de la variable de host por la de la url según corresponda a UAT.
Dentro de Postman, haz clic en el nombre de la colección. Ve a la pestaña "Variables" y modifica el valor de la variable por la enviada por el equipo de soporte por ambiente.
Posteriormente, haz clic en el nombre de la colección. Ve a la pestaña "Scripts" y selecciona "Pre-request Script"
Reemplaza los valores "Bearer xxx" y "xxx" con tu token de Authorization y tu X-Api-Key respectivamente.
Modifica en la pestaña "Variables" y en value agrega la url del ambiente enviado en las credenciales:
Por último, guarda los cambios realizados.
El proceso de obtención de credenciales productivas posee una gestión administrativa relacionada a la habilitación de la cuenta y el acceso a la plataforma de Factura y Administración.
Una vez la misma estas actividades han sido realizadas por nuestros equipos de soporte, podras seguir los siguientes pasos para obtener tus credenciales productivas:
Paso 1:
Paso 2
Dar clic al botón "Iniciar" de la sección de API
-Nov-03-2025-05-41-11-1346-PM.png?width=824&height=410&name=image%20(1)-Nov-03-2025-05-41-11-1346-PM.png)
Paso 3
Una vez realizado este paso podrás ver en la pantalla las credenciales a utilizar.
Nuestra API te ofrece un conjunto de herramientas para gestionar de forma integral el ciclo de vida de tus documentos tributarios electrónicos.
A continuación, encontrarás un resumen de los principales endpoints que hemos diseñado para facilitar tu integración con Nubox:
|
Objetivo Principal |
Endpoint |
Descripción Breve |
|
Emitir Documentos de Venta |
POST /v1/sales/issuance |
El endpoint principal para crear y enviar facturas, boletas y notas de crédito/débito de forma asíncrona. |
|
Obtener una o varias Ventas |
GET /v1/sales |
Devuelve una lista de documentos de venta emitidos, con potentes filtros por período, folio o tipo. |
|
Obtener una Venta Específica |
GET /v1/sales/{documentId} |
Entrega toda la información detallada de un único documento de venta. |
|
Obtener Detalle de Productos |
GET /v1/sales/{documentId}/details |
Muestra los productos o servicios específicos (líneas de detalle) que se incluyeron en un documento. |
|
Obtener Documentos de Referencia |
GET /v1/sales/{documentId}/references |
Lista los documentos que un DTE referencia, útil para ver qué factura anula una nota de crédito. |
|
Descargar PDF |
GET /v1/sales/{documentId}/pdf |
Permite descargar la representación gráfica (PDF) de un documento en formato A4 o ticket. |
|
Descargar XML |
GET /v1/sales/{documentId}/xml |
Permite descargar el archivo XML con validez tributaria ante el SII. |
A continuación se explican los pasos generales para usar distintos endpoints de la API y que son esenciales para el proceso completo de emisión
Este endpoint es el punto de partida para la creación de todos tus documentos tributarios electrónicos en Nubox. Su función es recibir toda la información de tus ventas para que nuestro sistema inicie el proceso completo de emisión y validación oficial.
El diseño de este endpoint permite enviar la información de hasta 50 documentos distintos en una sola llamada.
Al recibir tu solicitud, la API la ingresa inmediatamente a una cola de procesamiento y te devuelve una respuesta al instante. Esta respuesta es una confirmación de recepción que incluye un identificador único para cada documento que enviaste, el cual te va a permitir realizar el seguimiento del proceso de emisión del mismo. No consideres esta respuesta como una respuesta de emisión del documento.
Aquí es donde entra en juego su funcionamiento asíncrono. Una vez que tienes los identificadores de tus documentos enviados a emitir, tu sistema queda libre para continuar con otras tareas. Mientras tanto, los sistemas de Nubox trabajan en segundo plano procesando los documentos de la cola. Este proceso incluye la creación y validación previa de los datos, la comunicación con el Servicio de Impuestos Internos (SII) para obtener el timbraje y folio, y la gestión inteligente de reintentos en caso de que el SII no esté disponible. Una vez que Nubox finaliza el proceso interno de validación y emisión, el documento contará con su estado de emisión y folio (si aplica).
Para verificar el estado de emisión final con el que queda el documento puedes usar el endpoint de consulta GET /v1/sales/{documentId}, indicando el identificador único recibido como respuesta en el endpoint de emisión. Dada la naturaleza asíncrona de la creación y validación previa del documento a emitir, considera en la lógica de tu proceso un leve delay entre que invocas el endpoint de emisión y consultas el estado del documento.
El endpoint de emisión de documentos de venta requiere también recibir como cabecera un identificador único y aleatorio del tipo UUID (x-idempotence-id). Esta cabecera permite identificar unívocamente cada solicitud de emisión, con el fin de evitar emisiones duplicadas de documentos.
Es decir, ante un nuevo intento de emisión cuyo x-idempotence-id recibido ya se encuentre registrado en nuestro sistema, el API se limitará a retornar la misma respuesta de emisión correspondiente a la invocación realizada con tal x-idempotence-id la primera vez, independiente de los datos ingresado en el cuerpo de la solicitud (no se realizará un nueva emisión contra el SII).
Nubox mantiene un historial de solicitudes de emisión por máximo 30 días, por lo cual, si se reintenta una emisión con un x-idempotence-id registrado hace más de 30 días, el sistema lo tomará como una solicitud de emisión nueva.
POST baseUrl/v1/sales/issuance
|
Nombre |
Tipo de dato |
Obligatorio |
Descripción |
|---|---|---|---|
|
Authorization |
string |
Sí |
Secret Key única asociada al partner |
|
X-Api-Key |
string |
Sí |
Api Key única asociada a una compañía autorizada para el partner |
|
x-idempotence-id |
string (UUID) |
Sí |
Identificador único de la solicitud, usado para evitar duplicados en escenarios de error. Debe enviarse un valor único y distinto cada vez que se realice una solicitud de emisión. Se requerirá este identificador en caso de querer realizar seguimiento o revisión de errores, por lo cual se recomienda registrar o respaldar este identificador para futuras referencias. |
|
Content-Type |
string |
Sí |
Tipo de contenido a enviar (application/json) |
No es necesario enviar ningún parámetro.
El cuerpo de la solicitud para la emisión de documentos está diseñado como un arreglo de objetos que puede contener un máximo de 50 documentos por solicitud. Cada objeto dentro del arreglo está definido de acuerdo al siguiente detalle:
|
Atributo |
Tipo de Dato |
Obligatorio |
Descripción |
|
sequence |
integer |
Sí |
Número secuencial del documento dentro del lote de emisión. Útil para identificar unívocamente cada uno de los documentos enviados dentro del arreglo.
Cada documento debe contener un sequence distinto a cada uno de los otros documentos incluidos dentro del cuerpo de solicitud. |
|
type.legalCode |
string |
Sí |
Código del tipo de documento (e.g., 39 = Boleta Afecta, 33 = Factura). |
|
client.tradeName |
string |
Sí |
Nombre de fantasía o razón social del cliente. |
|
client.identification.type |
integer |
Sí |
Enviar valor por defecto: 1, el cual identifica que es un RUT |
|
client.identification.value |
string |
Sí |
Número de identificación (por ejemplo, "12345678-9"). |
|
client.mainActivity |
string |
Sí |
Actividad económica principal del cliente. Largo máximo 40. |
|
client.email |
string |
No |
Correo electrónico del cliente. |
|
client.contactName |
string |
Nombre de la persona de contacto. Largo máximo 100. |
|
|
client.phone |
string |
No |
Teléfono de contacto. Largo máximo 30. |
|
client.address |
string |
No |
Dirección del cliente. Largo máximo 200. |
|
client.city |
string |
No |
Ciudad del cliente. Largo máximo 50. |
|
client.territorialDivisionLegalCode |
string |
Sí |
Código legal de la región (e.g., 13 = Región Metropolitana). |
|
client.territorialDivisionL2LegalCode |
string |
Sí |
Código legal de la comuna (e.g., 13101 = Santiago). |
|
dueDate |
string (YYYY-MM-DD) |
No |
Fecha de vencimiento del documento. Es la fecha límite de pago. |
|
saleType.id |
integer |
Sí |
Identificador del tipo de venta (por ejemplo, contado, crédito, etc.). Tipo de venta (1 = Venta normal). |
|
paymentForm.id |
integer |
Sí |
Forma de pago (1 = Contado). |
|
paymentDate |
string (YYYY-MM-DD) |
No |
Fecha en que se realizó el pago. |
|
totalNetAmount |
decimal |
No |
Monto neto total de la venta (sin impuestos). |
|
totalExemptAmount |
decimal |
No |
Monto total exento de impuestos (si aplica). |
|
totalTaxVatAmount |
decimal |
No |
Monto total de IVA (Impuesto al Valor Agregado). |
|
totalOtherTaxesAmount |
decimal |
No |
Monto total de otros impuestos (distintos al IVA). |
|
totalWithholdingAmount |
decimal |
No |
Monto total de retenciones aplicadas. |
|
totalAmount |
decimal |
No |
Monto total del documento (neto + impuestos - descuentos + recargos). |
|
comment |
string |
No |
Comentario adicional sobre la venta (opcional). Largo máximo 500. |
|
dispatchGuideDetail |
object |
No |
Obligatorio sólo cuando se trate de emitir una Guía de Despacho (type.legalCode: “52”) |
|
dispatchGuideDetail.driver |
object |
No |
Representa el modelo de datos del conductor. |
|
dispatchGuideDetail.driver.name |
string |
No |
Nombre completo del conductor. Largo máximo 30. |
|
dispatchGuideDetail.driver.identification |
object |
No |
Representa el modelo de identificación del conductor. |
|
dispatchGuideDetail.driver.identification.type |
integer |
Sí |
Enviar valor por defecto: 1, el cual identifica que es un RUT |
|
dispatchGuideDetail.driver.identification.value |
string |
Sí |
Número de identificación (por ejemplo, "12345678-9"). |
|
dispatchGuideDetail.conveyor |
object |
No |
Representa el modelo de datos de la empresa transportista. |
|
dispatchGuideDetail.conveyor.identification |
object |
No |
Representa el modelo de identificación de la empresa transportista. |
|
dispatchGuideDetail.conveyor.identification.type |
integer |
Sí |
Enviar valor por defecto: 1, el cual identifica que es un RUT |
|
dispatchGuideDetail.conveyor.identification.value |
string |
Sí |
Número de identificación (por ejemplo, "12345678-9"). |
|
dispatchGuideDetail.licensePlate |
string |
No |
Patente del vehículo. |
|
dispatchGuideDetail.destination |
object |
Sí |
Representa el modelo del destino del transporte. |
|
dispatchGuideDetail.destination.address |
string |
No |
Dirección de destino. Largo máximo 70. |
|
dispatchGuideDetail.destination.city |
string |
No |
Ciudad de destino. Largo máximo 20. |
|
dispatchGuideDetail.destination.territorialDivisionL2LegalCode |
string |
Sí |
Código legal de la comuna (e.g., “13101” = Santiago). |
|
dispatchGuideDetail.transferType |
object |
Sí |
Representa el modelo del tipo de traslado. |
|
dispatchGuideDetail.transferType.id |
integer |
Sí |
Código de tipo de traslado. Ver en la sección de Datos usados por la API las opciones disponibles de Tipos de Traslado. |
|
dispatchGuideDetail.dipatchType |
object |
No |
Representa el modelo del tipo de despacho. |
|
dispatchGuideDetail.dipatchType.id |
integer |
Sí |
Código de tipo de despacho. Ver en la sección de Datos usados por la API las opciones disponibles de Tipos de Despacho. |
|
globalTaxes[] |
array |
No |
Arreglo de impuestos globales, no aplica para dtes exentos |
|
globalTaxes[].taxId |
integer |
Solo si el array padre no es vacío |
Identificador del impuesto. |
|
globalTaxes[].amount |
decimal |
Solo, si el array padre no es vacío |
Monto del impuesto. |
|
details[].order |
integer |
Sí |
Número de orden del ítem. |
|
details[].productCode |
string |
No |
Código del producto. Largo máximo 35. Sólo acepta caracteres A-Z, a-z, 0-9 y -, _, ., #, @, [, ], (, ), {, } |
|
details[].quantity |
decimal |
Sí |
Cantidad vendida. |
|
details[].productDescription |
string |
Sí |
Descripción corta del producto. Largo máximo 80. |
|
details[].productDescriptionExtended |
string |
No |
Descripción extendida del producto. Largo máximo 1000. |
|
details[].subjectToTax |
boolean |
No |
Indica si el ítem está afecto a impuestos. Por defecto en false si no es recibido. |
|
details[].uom.id |
integer |
No |
identificador de la unidad de medida |
|
details[].uom.code |
string |
Si |
Código de la unidad (por ejemplo, "NIU" para unidad). Largo máximo 4. |
|
details[].price |
decimal |
Si |
Precio unitario del producto. |
|
details[].totalTaxAmount |
decimal |
No |
Monto total de impuestos para este ítem. |
|
details[].totalDiscountSurchargeAmount |
decimal |
No |
Monto total de descuentos o recargos para este ítem. |
|
details[].totalAmount |
decimal |
No |
Monto total del ítem (precio * cantidad + impuestos - descuentos). |
|
details[].taxes |
array |
No |
Lista de impuestos aplicados a este ítem. |
|
details[].taxes[].legalCode |
String |
Sí |
Código legal del impuesto (e.g., "14" = IVA). |
|
details[].taxes[].amount |
Number |
Sí |
Monto del impuesto aplicado al ítem. |
|
details[].discountsAndSurcharges |
array |
No |
Lista de descuentos o recargos aplicados a este ítem. |
|
details[].discountsAndSurcharges.amount |
decimal |
Sí |
Monto del descuentos o recargos aplicados a este ítem. |
|
references[] |
array de objetos |
No |
Referencias asociadas al documento a emitir |
|
references[].legalCode |
string |
Si |
Código legal del documento referenciado. Ver en la sección de Datos usados por la API las opciones disponibles en Tipos de Documentos a Referenciar (Document Types) |
|
references[].documentNumber |
string |
Si |
Número del documento referenciado. |
|
references[].documentEmissionDate |
string (ISO 8601) |
Si |
Fecha de emisión del documento referenciado. El formato a usar debe ser ISO.DATE_TIME |
|
references[].documentTotalAmount |
decimal |
Si |
Monto total del documento referenciado. |
|
references[].motiveTypeId |
integer |
Si |
Identificador del motivo de la referencia. |
|
references[].motiveDescription |
string |
No |
Descripción del motivo de la referencia. |
Ejemplo de json en el body con un solo documento enviado
[
{
"sequence": 1,
"type": {
"legalCode": "33"
},
"client": {
"tradeName": "Empresa de pruebas",
"identification": {
"type": 1,
"value": "11111111-1"
},
"email": "asdf@asdf.com",
"contactName": "Nombre de contacto",
"phone": "+56999999999",
"mainActivity": "Actividad 1",
"address": "Av. Siempre Viva 123",
"city": "Santiago",
"territorialDivisionLegalCode": "13",
"territorialDivisionL2LegalCode": "13101"
},
"dueDate": "2025-12-31",
"saleType": {
"id": 1
},
"paymentForm": {
"id": 2
},
"totalNetAmount": 105042,
"totalExemptAmount": 0,
"totalTaxVatAmount": 19958,
"totalAmount": 125000,
"comment": "Comentarios varios",
"globalTaxes": [],
"details": [
{
"order": 1,
"quantity": 1,
"productDescription": "Producto Uno",
"productDescriptionExtended": "Descripción muy descriptiva",
"productCode": "01",
"subjectToTax": true,
"price": 105042,
"totalTaxAmount": 19958,
"totalDiscountSurchargeAmount": 0,
"totalAmount": 125000,
"uom": {
"code": "UNID"
},
"taxes": [
{
"legalCode": "14",
"amount": 19958
}
],
"discountsAndSurcharges": []
}
],
"references": [
{
"legalCode": "SEN",
"documentNumber": "1234",
"documentEmissionDate": "2025-05-23T00:00:00.000-04:00",
"motiveDescription": "SEN_1234"
}
]
}
]
[
{
"sequence": 1,
"type": {
"legalCode": "33"
},
"client": {
"tradeName": "Empresa de pruebas",
"identification": {
"type": 1,
"value": "11111111-1"
},
"email": "asdf@asdf.com",
"contactName": "Nombre de contacto",
"phone": "+56999999999",
"mainActivity": "Actividad 1",
"address": "Av. Siempre Viva 123",
"city": "Santiago",
"territorialDivisionLegalCode": "13",
"territorialDivisionL2LegalCode": "13101"
},
"dueDate": "2025-12-31",
"saleType": {
"id": 1
},
"paymentForm": {
"id": 2
},
"totalNetAmount": 105042,
"totalExemptAmount": 0,
"totalTaxVatAmount": 19958,
"totalAmount": 125000,
"comment": "Transferencias Económicas",
"globalTaxes": [],
"details": [
{
"order": 1,
"quantity": 1,
"productDescription": "SEN_1234",
"productDescriptionExtended": "Transferencias Económicas",
"subjectToTax": true,
"price": 105042,
"totalTaxAmount": 19958,
"totalDiscountSurchargeAmount": 0,
"totalAmount": 125000,
"taxes": [
{
"legalCode": "14",
"amount": 19958
}
]
}
],
"references": [
{
"legalCode": "SEN",
"documentNumber": "1234",
"documentEmissionDate": "2025-05-23T00:00:00.000-04:00",
"motiveDescription": "SEN_1234"
}
]
},
{
"sequence": 2,
"type": {
"legalCode": "34"
},
"client": {
"tradeName": "Empresa de pruebas",
"identification": {
"type": 1,
"value": "11111111-1"
},
"email": "asdf@asdf.com",
"contactName": "Nombre de contacto",
"phone": "+56999999999",
"mainActivity": "Actividad 1",
"address": "Av. Siempre Viva 123",
"city": "Santiago",
"territorialDivisionLegalCode": "13",
"territorialDivisionL2LegalCode": "13101"
},
"dueDate": "2025-12-31",
"saleType": {
"id": 1
},
"paymentForm": {
"id": 2
},
"paymentDate": "2025-06-11",
"totalNetAmount": 0,
"totalExemptAmount": 5000,
"totalTaxVatAmount": 0,
"totalOtherTaxesAmount": 0,
"totalWithholdingAmount": 0,
"totalAmount": 5000,
"comment": "Venta de productos varios",
"globalTaxes": [],
"details": [
{
"order": 1,
"productCode": "PROD-1029",
"quantity": 1,
"productDescription": "Producto de prueba",
"productDescriptionExtended": "Descripción extendida del producto",
"subjectToTax": false,
"uom": {
"code": "UNID"
},
"price": 5000,
"totalTaxAmount": 0,
"totalDiscountSurchargeAmount": 0,
"totalAmount": 5000,
"taxes": [],
"discountsAndSurcharges": []
}
],
"references": [
{
"legalCode": "34",
"documentNumber": "259",
"documentEmissionDate": "2025-06-06T10:24:14.000Z",
"documentTotalAmount": 5000,
"motiveTypeId": 1,
"motiveDescription": "Referencia de prueba"
}
]
}
]
Response body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
id |
Integer |
Identificador interno del sistema, el cual representa unívocamente a cada documento enviado a emitir. |
|
sequence |
Integer |
Identifica el número secuencial del documento dentro del lote de emisión. |
|
type.legalCode |
string |
Código del SII del tipo de documento (por ejemplo, 39 = Boleta Afecta, 33 = Factura). |
|
errors |
Array |
Arreglo que contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error.
Si envías varios documentos en el array, recibirás un objeto por cada uno, con su secuencia correspondiente.
|
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 207
[
{
"id": 1039365
"sequence": 1,
"type": {
}
"errors":
[
{
"object": "SaleDocumentRequest",
"field": "client.email",
"rejectedValue": "correo_invalido",
"message": "El correo no es válido"
}
]
},{
"id": 1039366
"sequence": 1,
"errors": null
},
]
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 400
[
{
"id": 1039365
"sequence": 1,
"errors":
[
{
"object": "SaleDocumentRequest",
"field": "client.email",
"rejectedValue": "correo_invalido",
"message": "El correo no es válido"
}
]
},
{
"id": 1039366
"sequence": 2,
"errors": null,
"type": {
"legalCode": "41",
"name": "Boleta exenta electrónica"
}
}
]
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Si envías varios documentos en el array, recibirás un objeto por cada uno, con su secuencia correspondiente. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 500
{
"status": 500,
"code": "Code Description",
"timestamp": "2025-05-13T17:56:34.573Z",
"message": "string",
"type": "Message Description",
"errors": [
{}
]
}
Permite obtener el XML de un documento
GET baseUrl/v1/sales/{documentId}/xml
|
Nombre |
Tipo de dato |
Obligatorio |
Descripción |
|
Authorization |
string |
Sí |
Secret Key única asociada al partner |
|
X-Api-Key |
string |
Sí |
Api Key única asociada a una compañía autorizada para el partner |
|
Content-Type |
string |
Si |
Tipo de contenido a enviar (application/json) |
|
Accept |
string |
No |
Devuelve el formato del XML dependiendo del Accept recibido. Por defecto toma el valor application/json en caso de no reicibirse definido. |
|
Nombre |
Tipo de dato |
Obligatorio |
Descripción |
|
documentId |
string |
Si, tipo path |
Id correlativo a transacción de Nubox |
Response Body
Devuelve el XML solicitado
Ejemplo de 200: OK
<EnvioDTE xmlns="http://www.sii.cl/SiiDte" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.0" xsi:schemaLocation="http://www.sii.cl/SiiDte EnvioDTE_v10.xsd">
<SetDTE ID="SetDoc">
<Caratula version="1.0">
<RutEmisor>76684278-K</RutEmisor>
<RutEnvia>13215993-9</RutEnvia>
<RutReceptor>60803000-K</RutReceptor>
<FchResol>2017-11-13</FchResol>
<NroResol>0</NroResol>
<TmstFirmaEnv>2023-12-11T13:31:36</TmstFirmaEnv>
<SubTotDTE>
<TpoDTE>34</TpoDTE>
<NroDTE>1</NroDTE>...
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 400
{
"status": 400,
"timestamp": "2025-05-13T18:37:29.880750543",
"message": "Error de validaciones",
"type": "BUSINESS",
"errors": [
{
"field": "field.name",
"rejectedValue": "valor rechazado",
"message": "No es un valor válido"
}
]
}
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 500
{
"status": 500,
"code": "string",
"timestamp": "2025-04-16T18:25:17.619575415",
"message": "Message Description ",
"type": "TECHNICAL",
"errors": []
}
Response Body
Solo responde el verbo status, sin response body.
Permite obtener el XML de un documento
GET baseUrl/v1/sales/{documentId}/pdf?template={templateId}
|
Nombre |
Tipo de dato |
Obligatorio |
Descripción |
|
Authorization |
string |
Sí |
Secret Key única asociada al partner |
|
X-Api-Key |
string |
Sí |
Api Key única asociada a una compañía autorizada para el partner |
|
Content-Type |
string |
Si |
Tipo de contenido a enviar (application/pdf) |
|
Nombre |
Tipo de dato |
Tipo |
Descripción |
|
documentId |
string |
path (obligatorio) |
Identificador interno del sistema, el cual representa unívocamente a cada documento enviado a emitir. |
|
templateId |
string |
Query (obligatorio) |
Usado para generar formato en A4 o 80MM, donde:
“TEMPLATE_A4”representa el formato A4 estándar usado para documentos normales.
“TEMPLATE_80MM” representa el formato de 80 mm usado para documentos tipo voucher/boleta. |
Response Body
Devuelve el PDF solicitado
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 400
{
"status": 400,
"timestamp": "2025-05-13T18:37:29.880750543",
"message": "Error de validaciones",
"type": "BUSINESS",
"errors": [
{
"field": "getPdf.template",
"rejectedValue": "1",
"message": "No es un valor de enumeración válido"
}
]
}
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 500
{
"status": 500,
"code": "string",
"timestamp": "2025-04-16T18:25:17.619575415",
"message": "Message Description ",
"type": "TECHNICAL",
"errors": []
}
Response Body
Solo responde el verbo status, sin response body.
Permite obtener un listado de documentos de venta que han sido emitidos desde la Api de Integraciones.
GET baseUrl/v1/sales
|
Nombre |
Tipo de dato |
Obligatorio |
Descripción |
|
Authorization |
string |
Sí |
Secret Key única asociada al partner |
|
X-Api-Key |
string |
Sí |
Api Key única asociada a una compañía autorizada para el partner |
|
Content-Type |
string |
Si |
Tipo de contenido a enviar (application/json) |
|
Nombre del Parámetro |
Ubicación |
Tipo de Dato |
Obligatorio |
Descripción |
|
period |
query |
string |
Sí |
Periodo a consultar en formato YYYY-MM (ejemplo: 2025-04). |
|
emissionStatusId |
query |
integer |
No |
Filtro por estado de emisión del documento. |
|
documentStatusId |
query |
integer |
No |
Filtro por estado del documento. |
|
documentNumber |
query |
integer |
No |
Filtro por folio de documento, debe combinarse para su funcionamiento correcto con la query type. |
|
type |
query |
array |
No |
Lista de tipos de documentos a filtrar (por ejemplo: [33, 39]). |
|
page |
query |
integer |
No |
Número de página para paginación de resultados. |
|
size |
query |
integer |
No |
Cantidad de resultados por página. |
|
sort |
query |
array |
No |
Criterios de ordenamiento, por ejemplo: ["emissionDate,desc"]. |
Response Headers
|
Campo |
Tipo de Dato |
Descripción |
|
x-total-count |
Number |
Total de registros disponibles para paginar |
Response Body
|
Campo |
Tipo de Dato |
Descripción |
|
id |
Integer |
Identificador único del documento. |
|
number |
String |
Número de folio del documento. |
|
type |
Objeto |
Contiene datos sobre el tipo de documento. |
|
type.id |
Integer |
ID del tipo de documento. |
|
type.legalCode |
String |
Código legal del documento (ej. "33" = Factura Electrónica). |
|
type.abbreviation |
String |
Abreviatura del tipo de documento (ej. "FAC-EL"). |
|
type.name |
String |
Nombre completo del tipo de documento. |
|
totalNetAmount |
Number |
Monto neto (sin impuestos). |
|
totalExemptAmount |
Number |
Monto exento de impuestos. |
|
totalTaxVatAmount |
Number |
Total de IVA aplicado. |
|
totalOtherTaxesAmount |
Number |
Monto correspondiente a otros impuestos. |
|
totalWithholdingAmount |
Number |
Monto retenido (si aplica). |
|
totalAmount |
Number |
Monto total del documento (neto + impuestos). |
|
balance |
Number |
Saldo pendiente por pagar. (Para uso interno de Nubox). |
|
emissionDate |
String (ISO 8601) |
Fecha de emisión del documento. |
|
periodMonth |
Integer |
Mes del período contable asociado. |
|
periodYear |
Integer |
Año del período contable asociado. |
|
dueDate |
String (YYYY-MM-DD) |
Fecha de vencimiento del documento. |
|
origin |
Objeto |
Dato interno de donde se origina el documento. |
|
origin.id |
Integer |
ID del origen del documento. |
|
origin.name |
String |
Descripción del origen (ej. "Integración SII", "Sistema"). |
|
client |
Objeto |
Contiene datos del cliente. |
|
client.identification |
Objeto |
Contiene datos de la identificación del cliente. |
|
client.identification.value |
String |
RUT del cliente. |
|
client.tradeName |
String |
Nombre comercial del cliente. |
|
client.mainActivity |
String |
Actividad económica principal del cliente. |
|
emissionStatus |
Objeto |
Contiene datos sobre el estado de la emisión. |
|
emissionStatus.id |
Integer |
ID del estado de emisión del documento. |
|
emissionStatus.name |
String |
Nombre del estado (ej. "Emitido"). |
|
saleType |
Objeto |
Contiene datos legales del tipo de venta. |
|
saleType.legalCode |
String |
Código legal del tipo de venta. |
|
saleType.name |
String |
Nombre del tipo de venta (ej. "Ventas del Giro"). |
|
paymentForm |
Objeto |
Contiene datos de la forma de pago. |
|
data[].paymentForm.legalCode |
String (opcional) |
Código legal de la forma de pago. |
|
data[].paymentForm.name |
String (opcional) |
Descripción de la forma de pago (ej. "Contado"). |
|
data[].links |
Array de Objetos |
Contiene información de las referencias relacionadas. |
|
data[].links[].rel |
String |
Tipo de relación del enlace (ej. "self", "details", etc.). |
|
data[].links[].href |
String (URL) |
URL del recurso relacionado. |
|
dataCl |
Objeto |
Contiene datos relacionados al documento del numero de envio y si ha sido anulado |
|
dataCl.trackId |
number |
Número de envío |
|
dataCl.annulled |
Boolean |
Indica si está anulado el documento |
Ejemplo de Respuesta 200:
[
{
"id": 1282876,
"number": "51",
"type": {
"id": 3,
"legalCode": "33",
"abbreviation": "FAC-EL",
"name": "Factura electrónica"
},
"totalNetAmount": 1000,
"totalExemptAmount": 0,
"totalTaxVatAmount": 190,
"totalAmount": 1190,
"totalOtherTaxesAmount": 0,
"totalWithholdingAmount": 0,
"balance": 1190,
"emissionDate": "2025-05-20T20:09:24Z",
"periodMonth": 5,
"periodYear": 2025,
"dueDate": "2025-05-20",
"origin": {
"id": 4,
"name": "Manual Emision"
},
"paymentForm": {
"id": 1,
"legalCode": "1",
"name": "Contado"
},
"dataCl": {
"trackId": 239856938,
"annulled": false
},
"client": {
"tradeName": "Cliente genérico",
"identification": {
"value": "66666666-6"
},
"mainActivity": "Sin giro"
},
"emissionStatus": {
"id": 1,
"name": "Emitido",
"description": "El comprobante se encuentra emitido.",
"comments": "Error interno: No se pudo generar el documento."
},
"saleType": {
"id": 1,
"legalCode": "1",
"name": "Ventas del Giro"
},
"links": [
{
"rel": "collection",
"href": "https://api.test-nubox.com/nbxpymapi-uat/v1/sales/"
},
{
"rel": "self",
"href": "https://api.test-nubox.com/nbxpymapi-uat/v1/sales/1282876"
},
{
"rel": "details",
"href": "https://api.test-nubox.com/nbxpymapi-uat/v1/sales/1282876/details"
},
{
"rel": "references",
"href": "https://api.test-nubox.com/nbxpymapi-uat/v1/sales/1282876/references"
},
{
"rel": "incomes",
"href": "https://api.test-nubox.com/nbxpymapi-uat/v1/incomes/"
}
]
},
{
"id": 1282914,
"number": "51",
"type": {
"id": 4,
"legalCode": "34",
"abbreviation": "FAC-EE",
"name": "Factura no afecta o exenta electrónica"
},
"totalNetAmount": 0,
"totalExemptAmount": 1000,
"totalTaxVatAmount": 0,
"totalAmount": 1000,
"totalOtherTaxesAmount": 0,
"totalWithholdingAmount": 0,
"balance": 1000,
"emissionDate": "2025-05-20T21:04:34Z",
"periodMonth": 5,
"periodYear": 2025,
"dueDate": "2025-05-20",
"origin": {
"id": 4,
"name": "Manual Emision"
},
"paymentForm": {
"id": 1,
"legalCode": "1",
"name": "Contado"
},
"dataCl": {
"trackId": 239857380,
"annulled": false
},
"client": {
"tradeName": "Cliente genérico",
"identification": {
"value": "66666666-6"
},
"mainActivity": "Sin giro"
},
"emissionStatus": {
"id": 1,
"name": "Emitido",
"description": "El comprobante se encuentra emitido."
},
"saleType": {
"id": 1,
"legalCode": "1",
"name": "Ventas del Giro"
},
"links": [
{
"rel": "collection",
"href": "https://api.test-nubox.com/nbxpymapi-uat/v1/sales/"
},
{
"rel": "self",
"href": "https://api.test-nubox.com/nbxpymapi-uat/v1/sales/1282914"
},
{
"rel": "details",
"href": "https://api.test-nubox.com/nbxpymapi-uat/v1/sales/1282914/details"
},
{
"rel": "references",
"href": "https://api.test-nubox.com/nbxpymapi-uat/v1/sales/1282914/references"
},
{
"rel": "incomes",
"href": "https://api.test-nubox.com/nbxpymapi-uat/v1/incomes/"
}
]
}
]
Solo responde el verbo status, sin response body.
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 400
{
"status": 400,
"timestamp": "2025-05-13T18:37:29.880750543",
"message": "Error de validaciones",
"type": "BUSINESS",
"errors": [
{
"field": "field.name",
"rejectedValue": "valor rechazado",
"message": "No es un valor válido"
}
]
}
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 500
{
"status": 500,
"code": "string",
"timestamp": "2025-04-16T18:25:17.619575415",
"message": "Message Description ",
"type": "TECHNICAL",
"errors": []
}
Response Body
Solo responde el verbo status, sin response body.
Permite obtener un documento de venta
baseUrl/v1/sales/{documentId}
|
Nombre |
Tipo de dato |
Obligatorio |
Descripción |
|
Authorization |
string |
Sí |
Secret Key única asociada al partner |
|
X-Api-Key |
string |
Sí |
Api Key única asociada a una compañía autorizada para el partner |
|
Content-Type |
string |
si |
Tipo de contenido a enviar (application/json) |
|
Nombre |
Tipo de dato |
Tipo |
Descripción |
|
documentId |
string |
path (obligatorio) |
Id interno en Nubox del documento de venta |
Response Body
|
Campo |
Tipo de Dato |
Descripción |
|
id |
Integer |
Identificador único del documento. |
|
number |
String |
Número de folio del documento. |
|
client |
Objeto |
Contiene la información del cliente. |
|
client.identification.value |
String |
RUT del cliente con nomenclatura ddddddddd-d |
|
client.tradeName |
String |
Nombre comercial del cliente. |
|
client.mainActivity |
String |
Actividad económica principal del cliente. |
|
type |
Objeto |
Información del tipo de documento. |
|
type.id |
Integer |
Identificador del tipo de documento. |
|
type.legalCode |
String |
Código legal del documento (e.g., "33" = Factura Electrónica). |
|
type.abbreviation |
String |
Abreviatura del tipo de documento. |
|
type.name |
String |
Nombre completo del tipo de documento. |
|
totalNetAmount |
Number |
Monto neto del documento (sin impuestos). |
|
totalExemptAmount |
Number |
Monto exento de impuestos. |
|
totalTaxVatAmount |
Number |
Total de IVA aplicado. |
|
totalAmount |
Number |
Monto total del documento (neto + impuestos). |
|
totalOtherTaxesAmount |
Number |
Total de otros impuestos. |
|
totalWithholdingAmount |
Number |
Total de retenciones. |
|
balance |
Number |
Saldo pendiente de pago. |
|
emissionDate |
String (ISO 8601) |
Fecha y hora de emisión del documento. |
|
periodMonth |
Integer |
Mes del período contable. |
|
periodYear |
Integer |
Año del período contable. |
|
dueDate |
String (YYYY-MM-DD) |
Fecha de vencimiento del documento. |
|
emissionStatus |
Objeto |
Estado de emisión del documento. |
|
emissionStatus.id |
Integer |
Identificador del estado de emisión. |
|
emissionStatus.name |
String |
Nombre del estado de emisión (e.g., "Emitido"). |
|
emissionStatus.description |
string |
Descripción del estado de emisión |
|
origin |
Objeto |
Origen del documento. |
|
origin.id |
Integer |
Identificador del origen (dato interno) |
|
origin.name |
String |
Nombre del origen (e.g., "Integración SII"). (dato interno) |
|
paymentForm |
Objeto |
Forma de pago del documento. |
|
paymentForm.id |
number |
id de la forma de pago interno |
|
paymentForm.legalCode |
String |
Código legal de la forma de pago. |
|
paymentForm.name |
String |
Descripción de la forma de pago (e.g., "Contado"). |
|
saleType |
Objeto |
Tipo de venta asociada al documento. |
|
saleType.id |
number |
id interno del tipo de venta |
|
saleType.legalCode |
String |
Código legal del tipo de venta. |
|
saleType.name |
String |
Descripción del tipo de venta (e.g., "Ventas del Giro"). |
|
dataCl |
Objeto |
Contiene datos relacionados al documento del numero de envio y si ha sido anulado |
|
dataCl.trackId |
number |
Número de envío |
|
dataCl.annulled |
Boolean |
Indica si está anulado el documento |
Ejemplo de Respuesta OK
{
"id": 1282876,
"number": "51",
"type": {
"id": 3,
"legalCode": "33",
"abbreviation": "FAC-EL",
"name": "Factura electrónica"
},
"totalNetAmount": 1000,
"totalExemptAmount": 0,
"totalTaxVatAmount": 190,
"totalAmount": 1190,
"totalOtherTaxesAmount": 0,
"totalWithholdingAmount": 0,
"balance": 1190,
"emissionDate": "2025-05-20T20:09:24Z",
"periodMonth": 5,
"periodYear": 2025,
"dueDate": "2025-05-20",
"origin": {
"id": 4,
"name": "Manual Emision"
},
"paymentForm": {
"id": 1,
"legalCode": "1",
"name": "Contado"
},
"dataCl": {
"trackId": 239856938,
"annulled": false
},
"globalTaxes": [],
"client": {
"tradeName": "Cliente genérico",
"identification": {
"value": "66666666-6"
},
"mainActivity": "Sin giro"
},
"emissionStatus": {
"id": 1,
"name": "Emitido",
"description": "El comprobante se encuentra emitido."
},
"saleType": {
"id": 1,
"legalCode": "1",
"name": "Ventas del Giro"
}
}
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 400
{
"status": 400,
"timestamp": "2025-05-13T18:37:29.880750543",
"message": "Error de validaciones",
"type": "BUSINESS",
"errors": [
{
"field": "field.name",
"rejectedValue": "valor rechazado",
"message": "No es un valor válido"
}
]
}
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 500
{
"status": 500,
"code": "string",
"timestamp": "2025-04-16T18:25:17.619575415",
"message": "Message Description ",
"type": "TECHNICAL",
"errors": []
}
Response Body
Solo responde el verbo status, sin response body.
Obtiene un documento de ventas único
GET /v1/sales/{documentId}/details
|
Nombre |
Tipo de dato |
Obligatorio |
Descripción |
|
Authorization |
string |
Sí |
Secret Key única asociada al partner |
|
X-Api-Key |
string |
Sí |
Api Key única asociada a una compañía autorizada para el partner |
|
Content-Type |
string |
si |
Tipo de contenido a enviar (application/json) |
|
Nombre |
Tipo de dato |
Obligatorio |
Descripción |
|
documentId |
string |
path (obligatorio) |
Id interno en Nubox del documento de venta |
Response Body
|
Campo |
Tipo de Dato |
Descripción |
|
id |
Integer |
Identificador único del detalle de venta. |
|
product |
Objeto |
Datos del producto asociado al detalle. |
|
product.code |
String |
Código del producto. |
|
product.description |
String |
Descripción del producto. |
|
product.uom |
String |
Unidad de medida del producto (por ejemplo, "UNID" = Unidad). |
|
quantity |
Integer/Decimal |
Cantidad de unidades del producto vendidas. |
|
price |
Integer/Decimal |
Precio unitario del producto. |
|
subjectToTax |
Boolean |
Indica si el producto está afecto a impuestos (true/false). |
|
order |
Integer |
Orden del detalle dentro del documento de venta. |
|
totalAmount |
Integer/Decimal |
Monto total del detalle (quantity * price). |
|
totalTaxAmount |
Integer/Decimal |
Monto total de impuestos aplicados a este detalle. |
|
taxes |
Array de Objetos |
Lista de impuestos aplicados al detalle. |
|
taxes[].taxId |
Integer |
Identificador del impuesto aplicado. |
|
taxes[].legalCode |
String |
Código legal del impuesto (por ejemplo, "14" para IVA). |
|
taxes[].name |
String |
Nombre del impuesto. |
|
taxes[].amount |
Decimal |
Monto del impuesto. |
|
taxes[].withholding |
Boolean |
Indica si el impuesto corresponde a una retención (true/false). |
|
totalDiscountSurchargeAmount |
Integer/Decimal |
Monto total de descuentos o recargos aplicados. |
|
discountsAndSurcharges |
Array de Objetos |
Lista de descuentos o recargos aplicados (vacío si no existen). |
|
discountsAndSurcharges.id |
Integer |
Identificador interno del descuento/recargo. |
|
discountsAndSurcharges.amount |
Decimal |
Monto del descuento (si es negativo) o recargo (si es positivo). |
|
discountsAndSurcharges.discount |
Boolean |
Indica si es un descuento (true) o un recargo (false). |
|
links |
Array de Objetos |
Lista de enlaces relacionados al detalle de venta. |
|
links[].rel |
String |
Tipo de relación del enlace ("self", "document", etc.). |
|
links[].href |
String (URL) |
URL del recurso relacionado. |
Ejemplo de Respuesta OK
[
{
"id": 1037019,
"product": {
"code": "1022",
"description": "Producto con descripción adicional ",
"uom": "UNID"
},
"quantity": 1,
"price": 20000,
"subjectToTax": true,
"order": 1,
"totalAmount": 20000,
"totalTaxAmount": 3800,
"taxes": [
{
"taxId": 1,
"legalCode": "14",
"name": "IVA de Margen de Comercialización",
"amount": 3800.00,
"withholding": false
}
],
"totalDiscountSurchargeAmount": 0,
"discountsAndSurcharges": [
{
"id": 1,
"amount": -100,
"discount": true
},
{
"id": 2,
"amount": 50,
"discount": false
}
],
"links": [
{
"rel": "self",
"href": "baseUrl/v1/sales/1037019/details"
},
{
"rel": "document",
"href": "baseUrl/v1/sales/1037019"
}
]
}
]
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 400
{
"status": 400,
"timestamp": "2025-05-13T18:37:29.880750543",
"message": "Error de validaciones",
"type": "BUSINESS",
"errors": [
{
"field": "field.name",
"rejectedValue": "valor rechazado",
"message": "No es un valor válido"
}
]
}
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 500
{
"status": 500,
"code": "string",
"timestamp": "2025-04-16T18:25:17.619575415",
"message": "Message Description ",
"type": "TECHNICAL",
"errors": []
}
Response Body
Solo responde el verbo status, sin response body.
Permite obtener documentos referenciados de un documento de Venta
baseUrl/v1/sales/{documentId/references
|
Nombre |
Tipo de dato |
Obligatorio |
Descripción |
|
Authorization |
string |
Sí |
Secret Key única asociada al partner |
|
X-Api-Key |
string |
Sí |
Api Key única asociada a una compañía autorizada para el partner |
|
Content-Type |
string |
si |
Tipo de contenido a enviar (application/json) |
|
Nombre |
Tipo de dato |
Tipo |
Descripción |
|
documentId |
string |
path (obligatorio) |
Id interno en Nubox del documento de venta |
|
includeUnaccountable |
Boolean |
query(Opcional) |
Parámetro para obtener en la respuesta tanto las referencias contables respaldadas por documentos del dominio, como también aquellas declaradas como documentos no contables. Cuando sea true devuelve ambos tipos de referencias. |
Response Body
|
Campo |
Tipo de Dato |
Descripción |
|
id |
Integer |
Identificador único de la referencia. |
|
documentReferenceId |
Integer |
Identificador del documento de referencia asociado. |
|
documentTypeLegalCode |
String |
Código legal del tipo de documento de referencia (e.g., "39" = Boleta Electrónica). Ver en Datos usados por la Api Tipos de Documentos (DocumentTypes) |
|
documentNumber |
String |
Número de folio del documento de referencia. |
|
documentEmissionDate |
String (ISO 8601) |
Fecha de emisión del documento de referencia. |
|
documentTotalAmount |
Number |
Monto total del documento de referencia. |
|
motiveTypeId |
Integer |
Identificador del tipo de motivo de referencia. |
|
motiveDescription |
String |
Descripción del motivo de la referencia (e.g., "Anulación"). |
|
links |
Array de Objetos |
Lista de enlaces relacionados a la referencia. |
|
links[].rel |
String |
Tipo de relación del enlace ("self", "document", etc.). |
|
links[].href |
String (URL) |
URL del recurso relacionado. |
Ejemplo de Respuesta OK
[
{
"id": 1,
"documentReferenceId": 559465,
"documentTypeLegalCode": "39",
"documentNumber": "22",
"documentEmissionDate": "2025-01-07T03:00:00Z",
"documentTotalAmount": 34510,
"motiveTypeId": 3,
"motiveDescription": "Anulación",
"links": [
{
"rel": "self",
"href": "baseUrl/v1/sales/1037019/references"
},
{
"rel": "document",
"href": "baseUrl/v1/sales/1037019"
}
]
}
]
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 400
{
"status": 400,
"timestamp": "2025-05-13T18:37:29.880750543",
"message": "Error de validaciones",
"type": "BUSINESS",
"errors": [
{
"field": "field.name",
"rejectedValue": "valor rechazado",
"message": "No es un valor válido"
}
]
}
Response Body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
status |
Integer |
Código de estado HTTP. |
|
code |
String |
Descripción representativa del código HTTP devuelto. |
|
timestamp |
String (ISO 8601) |
Fecha y hora en que se generó la respuesta, en formato de timestamp ISO 8601 con nanosegundos. |
|
message |
String |
Mensaje descriptivo del error o situación ocurrida. |
|
type |
String |
Tipo de error. Puede representar categorías como BUSINESS, TECHNICAL, VALIDATION, etc. |
|
errors |
Array |
El campo error contiene objetos con información sobre el campo que falló, el valor rechazado y el mensaje de error. Cuando no hayan errores se devolverá un null, en caso un array con cada error encontrado. |
|
errors.object |
string |
Indica que el error ocurrió al validar el objeto de solicitud de documento de venta. |
|
errors.field |
string |
Es el nombre del campo específico dentro del objeto donde se detectó el error. |
|
errors.rejectedValue |
string |
Es el valor que fue enviado y que no pasó la validación. |
|
errors.message |
string |
Es el mensaje descriptivo del error, pensado para que el usuario o desarrollador entienda qué salió mal. |
Ejemplo de respuesta 500
{
"status": 500,
"code": "string",
"timestamp": "2025-04-16T18:25:17.619575415",
"message": "Message Description ",
"type": "TECHNICAL",
"errors": []
}
Response Body
Solo responde el verbo status, sin response body.
|
id |
Nombre |
|
1 |
Ventas del Giro |
|
2 |
Venta Activo Fijo |
|
3 |
Venta Bien Raíz |
|
id |
Nombre |
Descripción |
|
1 |
Emitido |
El comprobante se encuentra emitido. |
|
2 |
Borrador |
El comprobante se encuentra en borrador. |
|
3 |
Anulado |
El comprobante se anulado |
|
4 |
En espera de SII |
El comprobante se encuentra en espera de respuesta del SII |
|
5 |
Rechazado por SII |
El comprobante se encuentra rechazado por el SII |
|
6 |
En espera de reemisión |
El comprobante se encuentra en espera de reemisión |
|
7 |
Sin respuesta SII |
El comprobante se encuentra sin respuesta SII |
|
8 |
Reintentar emisión |
El documento está disponible para intentar emitirlo nuevamente |
|
id |
Nombre |
|
1 |
Contado |
|
2 |
Crédito |
|
id |
Nombre |
|
1 |
IVA |
|
2 |
Impuesto al consumo |
|
3 |
Retención al consumo |
|
4 |
Retención por honorarios |
|
5 |
IVA |
|
Nombre |
Código Legal |
|
IVA de Margen de Comercialización |
14 |
|
IVA Retenido Total |
15 |
|
IVA Anticipado Faenamiento Carne |
17 |
|
IVA Anticipado Harina |
19 |
|
IVA Retenido Legumbres |
30 |
|
IVA Retenido Silvestres |
31 |
|
IVA Retenido Ganado |
32 |
|
IVA Retenido Madera |
33 |
|
IVA Retenido Trigo |
34 |
|
IVA Retenido Arroz |
36 |
|
IVA Retenido Chatarra |
38 |
|
IVA Retenido PPA |
39 |
|
IVA Retenido Construcción |
41 |
|
Impuesto Adicional Art. 37 Letras a, b, c (artículos oro, platino, marfil, joyas, piedras preciosas y pieles finas) |
23 |
|
Impuesto Adicional Art. 37 Letras e, h, i, l (alfombras, tapices, casa rodantes, caviar, armas de aire o gas) |
44 |
|
Impuesto Adicional Art. 37 Letras j (primera venta de pirotecnia) |
45 |
|
Impuesto Art. 42, letra c (vinos) |
25 |
|
Impuesto Art. 42, letra c (cervezas y bebidas alcohólicas) |
26 |
|
Impuesto Art. 42, letra a (bebidas analcohólicas y minerales) |
27 |
|
Impuesto Art. 42, letra d y e (bebidas analcohólicas y minerales con elevado contenido de azúcares) |
271 |
|
Impuesto Específico Diesel |
28 |
|
Recuperación Impuesto Específico Diesel Transportistas (para transportistas de carga) |
29 |
|
Impuesto Específico Gasolina |
35 |
|
IVA Retenido Cartones |
47 |
|
IVA Retenido Frambuesas y Pasas |
48 |
|
Factura de Compra sin Retención (Sólo Bolsa de Productos de Chile) |
49 |
|
IVA de Margen de Comercialización de Instrumentos de Prepago |
50 |
|
Impuesto Gas Natural Comprimido; 1,93 UTM/KM3, Art. 1°, Ley N° 20.052, Se usa en Facturas que emite el vendedor, se registra en la IEV, no se registra separado en la IEC. |
51 |
|
Impuesto Retenido Suplementeros Art. 74 N°5 Ley de la Renta |
53 |
|
Impuesto Retenido Factura de Inicio |
60 |
|
IVA Retenido ORO |
46 |
|
Impuesto Art. 42, Ley 825/74 letra b (licores, piscos, whisky, aguardientes, vinos licorosos o aromatizados) |
24 |
|
IVA Retenido Hidrobiológicas |
37 |
|
Impuesto Gas Licuado de Petróleo; 1,40 UTM/M3, Art. 1°, Ley N° 20.052, Se usa en Facturas que emite el vendedor, se registra en la IEV, no se registra separado en la IEC. |
52 |
|
IVA Anticipado Carne |
18 |
|
id |
Código (code) |
Descripción |
|
1 |
BDJA |
Bandeja |
|
2 |
BIN |
BIN |
|
3 |
BTLL |
Botella |
|
45 |
QQM |
Quintales Métricos |
|
5 |
CAJA |
Caja |
|
6 |
CART |
Cartón |
|
8 |
CM |
Centímetros |
|
9 |
CM3 |
Centímetros Cúbicos |
|
10 |
DIA |
Día |
|
11 |
DISP |
Display |
|
12 |
DNA |
Docena |
|
13 |
EA |
Artículos Walmart |
|
14 |
G |
Gramos |
|
15 |
GLB |
Global |
|
16 |
HA |
Hectárea |
|
17 |
HORA |
Hora |
|
18 |
KG |
Kilogramo |
|
19 |
LT |
Litro |
|
20 |
M |
Metros |
|
21 |
M2 |
Metro cuadrado |
|
22 |
M3 |
Metro Cúbico |
|
23 |
MES |
Mes |
|
24 |
ML |
Metro Lineal |
|
25 |
MR |
Metro Ruma |
|
26 |
P2 |
Pies Cuadrado |
|
27 |
PAR |
PAR |
|
28 |
PIE |
Pie |
|
29 |
PLGO |
Pliego |
|
30 |
PM |
Pulgada Maderera |
|
31 |
PP |
Pulgada Pinera |
|
32 |
PQ |
Paquete |
|
33 |
PULG |
Pulgada |
|
34 |
QTAL |
Quintal(100 Kg.) |
|
35 |
RLLO |
Rollo |
|
36 |
SACO |
Saco |
|
37 |
TBDM |
Tonelada BDMT |
|
38 |
TBDU |
Tonelada BDU |
|
39 |
TIRA |
Tira |
|
40 |
TON |
Tonelada |
|
42 |
UNID |
Unidad |
|
44 |
VIAJ |
Viaje |
|
7 |
CJ |
Cajas Walmart |
|
43 |
USD |
Dolar |
|
4 |
CW |
Cajas Walmart |
|
41 |
UF |
U.F |
|
id |
nombre |
|
1 |
Anular documento |
|
2 |
Corregir texto |
|
3 |
Corregir monto |
|
ID |
Descripción |
|
30 |
Factura |
|
32 |
Factura no afecta o exenta |
|
33 |
Factura electrónica |
|
34 |
Factura no afecta o exenta electrónica |
|
35 |
Boleta de ventas y servicios |
|
38 |
Boleta no afecta o exenta |
|
39 |
Boleta electrónica |
|
40 |
Liquidación factura |
|
41 |
Boleta exenta electrónica |
|
43 |
Liquidación factura electrónica |
|
45 |
Factura de compra |
|
46 |
Factura de compra electrónica |
|
48 |
Boleta voucher o pago electrónico |
|
50 |
Guía de despacho |
|
52 |
Guía de despacho electrónica |
|
55 |
Nota de débito |
|
56 |
Nota de débito electrónica |
|
60 |
Nota de crédito |
|
61 |
Nota de crédito electrónica |
|
101 |
Factura de exportación |
|
103 |
Liquidación |
|
104 |
Nota de débito de exportación |
|
106 |
Nota de crédito de exportación |
|
110 |
Factura de exportación electrónica |
|
111 |
Nota de débito de exportación electrónica |
|
112 |
Nota de crédito de exportación electrónica |
|
801 |
Orden de compra |
|
802 |
Nota de pedido |
|
803 |
Contrato |
|
804 |
Resolución |
|
807 |
DUS |
|
809 |
AWB (Air Will Bill) |
|
810 |
MIC/DTA |
|
811 |
Carta de Porte |
|
813 |
Pasaporte |
|
CON |
Conformidad |
|
COT |
Cotización |
|
GSE |
Guía de Servicio por Evaluación Trabajo |
|
HE |
Hoja de Evaluación |
|
HEM |
Hoja de entrada de material |
|
HES |
Hoja de entrada de servicio |
|
NTV |
Nota de venta |
|
ORV |
Orden de venta |
|
PTO |
Presupuesto |
|
ROC |
Recepción de OC Trabajo Terminado |
|
SEN |
Sistema Eléctrico Nacional |
|
id |
Nombre |
Descripción |
legalCode |
|
1 |
I Tarapacá |
I Tarapacá |
01 |
|
2 |
II Antofagasta |
II Antofagasta |
02 |
|
3 |
III Atacama |
III Atacama |
03 |
|
4 |
IV Coquimbo |
IV Coquimbo |
04 |
|
5 |
V Valparaíso |
V Valparaíso |
05 |
|
6 |
VI Libertador General Bernardo O'Higgins |
VI Libertador General Bernardo O'Higgins |
06 |
|
7 |
VII Maule |
VII Maule |
07 |
|
8 |
VIII Biobío |
VIII Biobío |
08 |
|
9 |
IX La Araucanía |
IX La Araucanía |
09 |
|
10 |
X Los Lagos |
X Los Lagos |
10 |
|
11 |
XI Aysén del General Carlos Ibáñez del Campo |
XI Aysén del General Carlos Ibáñez del Campo |
11 |
|
12 |
XII Magallanes y de la Antártica Chilena |
XII Magallanes y de la Antártica Chilena |
12 |
|
13 |
XIII Metropolitana de Santiago |
XIII Metropolitana de Santiago |
13 |
|
14 |
XIV Los Ríos |
XIV Los Ríos |
14 |
|
15 |
XV Arica y Parinacota |
XV Arica y Parinacota |
15 |
|
16 |
XVI Ñuble |
XVI Ñuble |
16 |
|
17 |
Sin Información |
Sin Información |
NA |
|
id |
Nombre |
description |
legalCode |
| 1 | Iquique | Iquique | 01101 |
| 2 | Alto Hospicio | Alto Hospicio | 01107 |
| 3 | Pozo Almonte | Pozo Almonte | 01401 |
| 4 | Camiña | Camiña | 01402 |
| 5 | Colchane | Colchane | 01403 |
| 6 | Huara | Huara | 01404 |
| 7 | Pica | Pica | 01405 |
| 8 | Antofagasta | Antofagasta | 02101 |
| 9 | Mejillones | Mejillones | 02102 |
| 10 | Sierra Gorda | Sierra Gorda | 02103 |
| 11 | Taltal | Taltal | 02104 |
| 12 | Calama | Calama | 02201 |
| 13 | Ollagüe | Ollagüe | 02202 |
| 14 | San Pedro de Atacama | San Pedro de Atacama | 02203 |
| 15 | Tocopilla | Tocopilla | 02301 |
| 16 | María Elena | María Elena | 02302 |
| 17 | Copiapó | Copiapó | 03101 |
| 18 | Caldera | Caldera | 03102 |
| 19 | Tierra Amarilla | Tierra Amarilla | 03103 |
| 20 | Chañaral | Chañaral | 03201 |
| 21 | Diego de Almagro | Diego de Almagro | 03202 |
| 22 | Vallenar | Vallenar | 03301 |
| 23 | Alto del Carmen | Alto del Carmen | 03302 |
| 24 | Freirina | Freirina | 03303 |
| 25 | Huasco | Huasco | 03304 |
| 26 | La Serena | La Serena | 04101 |
| 27 | Coquimbo | Coquimbo | 04102 |
| 28 | Andacollo | Andacollo | 04103 |
| 29 | La Higuera | La Higuera | 04104 |
| 30 | Paiguano | Paiguano | 04105 |
| 31 | Vicuña | Vicuña | 04106 |
| 32 | Illapel | Illapel | 04201 |
| 33 | Canela | Canela | 04202 |
| 34 | Los Vilos | Los Vilos | 04203 |
| 35 | Salamanca | Salamanca | 04204 |
| 36 | Ovalle | Ovalle | 04301 |
| 37 | Combarbalá | Combarbalá | 04302 |
| 38 | Monte Patria | Monte Patria | 04303 |
| 39 | Punitaqui | Punitaqui | 04304 |
| 40 | Río Hurtado | Río Hurtado | 04305 |
| 41 | Valparaíso | Valparaíso | 05101 |
| 42 | Casablanca | Casablanca | 05102 |
| 43 | Concón | Concón | 05103 |
| 44 | Juan Fernández | Juan Fernández | 05104 |
| 45 | Puchuncaví | Puchuncaví | 05105 |
| 46 | Quintero | Quintero | 05107 |
| 47 | Viña del Mar | Viña del Mar | 05109 |
| 48 | Isla de Pascua | Isla de Pascua | 05201 |
| 49 | Los Andes | Los Andes | 05301 |
| 50 | Calle Larga | Calle Larga | 05302 |
| 51 | Rinconada | Rinconada | 05303 |
| 52 | San Esteban | San Esteban | 05304 |
| 53 | La Ligua | La Ligua | 05401 |
| 54 | Cabildo | Cabildo | 05402 |
| 55 | Papudo | Papudo | 05403 |
| 56 | Petorca | Petorca | 05404 |
| 57 | Zapallar | Zapallar | 05405 |
| 58 | Quillota | Quillota | 05501 |
| 59 | Calera | Calera | 05502 |
| 60 | Hijuelas | Hijuelas | 05503 |
| 61 | La Cruz | La Cruz | 05504 |
| 62 | Nogales | Nogales | 05506 |
| 63 | San Antonio | San Antonio | 05601 |
| 64 | Algarrobo | Algarrobo | 05602 |
| 65 | Cartagena | Cartagena | 05603 |
| 66 | El Quisco | El Quisco | 05604 |
| 67 | El Tabo | El Tabo | 05605 |
| 68 | Santo Domingo | Santo Domingo | 05606 |
| 69 | San Felipe | San Felipe | 05701 |
| 70 | Catemu | Catemu | 05702 |
| 71 | Llaillay | Llaillay | 05703 |
| 72 | Panquehue | Panquehue | 05704 |
| 73 | Putaendo | Putaendo | 05705 |
| 74 | Santa María | Santa María | 05706 |
| 75 | Quilpué | Quilpué | 05801 |
| 76 | Limache | Limache | 05802 |
| 77 | Olmué | Olmué | 05803 |
| 78 | Villa Alemana | Villa Alemana | 05804 |
| 79 | Rancagua | Rancagua | 06101 |
| 80 | Codegua | Codegua | 06102 |
| 81 | Coinco | Coinco | 06103 |
| 82 | Coltauco | Coltauco | 06104 |
| 83 | Doñihue | Doñihue | 06105 |
| 84 | Graneros | Graneros | 06106 |
| 85 | Las Cabras | Las Cabras | 06107 |
| 86 | Machalí | Machalí | 06108 |
| 87 | Malloa | Malloa | 06109 |
| 88 | Mostazal | Mostazal | 06110 |
| 89 | Olivar | Olivar | 06111 |
| 90 | Peumo | Peumo | 06112 |
| 91 | Pichidegua | Pichidegua | 06113 |
| 92 | Quinta de Tilcoco | Quinta de Tilcoco | 06114 |
| 93 | Rengo | Rengo | 06115 |
| 94 | Requínoa | Requínoa | 06116 |
| 95 | San Vicente | San Vicente | 06117 |
| 96 | Pichilemu | Pichilemu | 06201 |
| 97 | La Estrella | La Estrella | 06202 |
| 98 | Litueche | Litueche | 06203 |
| 99 | Marchihue | Marchihue | 06204 |
| 100 | Navidad | Navidad | 06205 |
| 101 | Paredones | Paredones | 06206 |
| 102 | San Fernando | San Fernando | 06301 |
| 103 | Chépica | Chépica | 06302 |
| 104 | Chimbarongo | Chimbarongo | 06303 |
| 105 | Lolol | Lolol | 06304 |
| 106 | Nancagua | Nancagua | 06305 |
| 107 | Palmilla | Palmilla | 06306 |
| 108 | Peralillo | Peralillo | 06307 |
| 109 | Placilla | Placilla | 06308 |
| 110 | Pumanque | Pumanque | 06309 |
| 111 | Santa Cruz | Santa Cruz | 06310 |
| 112 | Talca | Talca | 07101 |
| 113 | Constitución | Constitución | 07102 |
| 114 | Curepto | Curepto | 07103 |
| 115 | Empedrado | Empedrado | 07104 |
| 116 | Maule | Maule | 07105 |
| 117 | Pelarco | Pelarco | 07106 |
| 118 | Pencahue | Pencahue | 07107 |
| 119 | Río Claro | Río Claro | 07108 |
| 120 | San Clemente | San Clemente | 07109 |
| 121 | San Rafael | San Rafael | 07110 |
| 122 | Cauquenes | Cauquenes | 07201 |
| 123 | Chanco | Chanco | 07202 |
| 124 | Pelluhue | Pelluhue | 07203 |
| 125 | Curicó | Curicó | 07301 |
| 126 | Hualañé | Hualañé | 07302 |
| 127 | Licantén | Licantén | 07303 |
| 128 | Molina | Molina | 07304 |
| 129 | Rauco | Rauco | 07305 |
| 130 | Romeral | Romeral | 07306 |
| 131 | Sagrada Familia | Sagrada Familia | 07307 |
| 132 | Teno | Teno | 07308 |
| 133 | Vichuquén | Vichuquén | 07309 |
| 134 | Linares | Linares | 07401 |
| 135 | Colbún | Colbún | 07402 |
| 136 | Longaví | Longaví | 07403 |
| 137 | Parral | Parral | 07404 |
| 138 | Retiro | Retiro | 07405 |
| 139 | San Javier | San Javier | 07406 |
| 140 | Villa Alegre | Villa Alegre | 07407 |
| 141 | Yerbas Buenas | Yerbas Buenas | 07408 |
| 142 | Concepción | Concepción | 08101 |
| 143 | Coronel | Coronel | 08102 |
| 144 | Chiguayante | Chiguayante | 08103 |
| 145 | Florida | Florida | 08104 |
| 146 | Hualqui | Hualqui | 08105 |
| 147 | Lota | Lota | 08106 |
| 148 | Penco | Penco | 08107 |
| 149 | San Pedro de la Paz | San Pedro de la Paz | 08108 |
| 150 | Santa Juana | Santa Juana | 08109 |
| 151 | Talcahuano | Talcahuano | 08110 |
| 152 | Tomé | Tomé | 08111 |
| 153 | Hualpén | Hualpén | 08112 |
| 154 | Lebu | Lebu | 08201 |
| 155 | Arauco | Arauco | 08202 |
| 156 | Cañete | Cañete | 08203 |
| 157 | Contulmo | Contulmo | 08204 |
| 158 | Curanilahue | Curanilahue | 08205 |
| 159 | Los Alamos | Los Alamos | 08206 |
| 160 | Tirúa | Tirúa | 08207 |
| 161 | Los Angeles | Los Angeles | 08301 |
| 162 | Antuco | Antuco | 08302 |
| 163 | Cabrero | Cabrero | 08303 |
| 164 | Laja | Laja | 08304 |
| 165 | Mulchén | Mulchén | 08305 |
| 166 | Nacimiento | Nacimiento | 08306 |
| 167 | Negrete | Negrete | 08307 |
| 168 | Quilaco | Quilaco | 08308 |
| 169 | Quilleco | Quilleco | 08309 |
| 170 | San Rosendo | San Rosendo | 08310 |
| 171 | Santa Bárbara | Santa Bárbara | 08311 |
| 172 | Tucapel | Tucapel | 08312 |
| 173 | Yumbel | Yumbel | 08313 |
| 174 | Alto Biobío | Alto Biobío | 08314 |
| 175 | Temuco | Temuco | 09101 |
| 176 | Carahue | Carahue | 09102 |
| 177 | Cunco | Cunco | 09103 |
| 178 | Curarrehue | Curarrehue | 09104 |
| 179 | Freire | Freire | 09105 |
| 180 | Galvarino | Galvarino | 09106 |
| 181 | Gorbea | Gorbea | 09107 |
| 182 | Lautaro | Lautaro | 09108 |
| 183 | Loncoche | Loncoche | 09109 |
| 184 | Melipeuco | Melipeuco | 09110 |
| 185 | Nueva Imperial | Nueva Imperial | 09111 |
| 186 | Padre Las Casas | Padre Las Casas | 09112 |
| 187 | Perquenco | Perquenco | 09113 |
| 188 | Pitrufquén | Pitrufquén | 09114 |
| 189 | Pucón | Pucón | 09115 |
| 190 | Saavedra | Saavedra | 09116 |
| 191 | Teodoro Schmidt | Teodoro Schmidt | 09117 |
| 192 | Toltén | Toltén | 09118 |
| 193 | Vilcún | Vilcún | 09119 |
| 194 | Villarrica | Villarrica | 09120 |
| 195 | Cholchol | Cholchol | 09121 |
| 196 | Angol | Angol | 09201 |
| 197 | Collipulli | Collipulli | 09202 |
| 198 | Curacautín | Curacautín | 09203 |
| 199 | Ercilla | Ercilla | 09204 |
| 200 | Lonquimay | Lonquimay | 09205 |
| 201 | Los Sauces | Los Sauces | 09206 |
| 202 | Lumaco | Lumaco | 09207 |
| 203 | Purén | Purén | 09208 |
| 204 | Renaico | Renaico | 09209 |
| 205 | Traiguén | Traiguén | 09210 |
| 206 | Victoria | Victoria | 09211 |
| 207 | Puerto Montt | Puerto Montt | 10101 |
| 208 | Calbuco | Calbuco | 10102 |
| 209 | Cochamó | Cochamó | 10103 |
| 210 | Fresia | Fresia | 10104 |
| 211 | Frutillar | Frutillar | 10105 |
| 212 | Los Muermos | Los Muermos | 10106 |
| 213 | Llanquihue | Llanquihue | 10107 |
| 214 | Maullín | Maullín | 10108 |
| 215 | Puerto Varas | Puerto Varas | 10109 |
| 216 | Castro | Castro | 10201 |
| 217 | Ancud | Ancud | 10202 |
| 218 | Chonchi | Chonchi | 10203 |
| 219 | Curaco de Vélez | Curaco de Vélez | 10204 |
| 220 | Dalcahue | Dalcahue | 10205 |
| 221 | Puqueldón | Puqueldón | 10206 |
| 222 | Queilén | Queilén | 10207 |
| 223 | Quellón | Quellón | 10208 |
| 224 | Quemchi | Quemchi | 10209 |
| 225 | Quinchao | Quinchao | 10210 |
| 226 | Osorno | Osorno | 10301 |
| 227 | Puerto Octay | Puerto Octay | 10302 |
| 228 | Purranque | Purranque | 10303 |
| 229 | Puyehue | Puyehue | 10304 |
| 230 | Río Negro | Río Negro | 10305 |
| 231 | San Juan de la Costa | San Juan de la Costa | 10306 |
| 232 | San Pablo | San Pablo | 10307 |
| 233 | Chaitén | Chaitén | 10401 |
| 234 | Futaleufú | Futaleufú | 10402 |
| 235 | Hualaihué | Hualaihué | 10403 |
| 236 | Palena | Palena | 10404 |
| 238 | Lago Verde | Lago Verde | 11102 |
| 239 | Aisén | Aisén | 11201 |
| 240 | Cisnes | Cisnes | 11202 |
| 241 | Guaitecas | Guaitecas | 11203 |
| 242 | Cochrane | Cochrane | 11301 |
| 243 | O'Higgins | O'Higgins | 11302 |
| 244 | Tortel | Tortel | 11303 |
| 245 | Chile Chico | Chile Chico | 11401 |
| 246 | Río Ibáñez | Río Ibáñez | 11402 |
| 247 | Punta Arenas | Punta Arenas | 12101 |
| 248 | Laguna Blanca | Laguna Blanca | 12102 |
| 249 | Río Verde | Río Verde | 12103 |
| 250 | San Gregorio | San Gregorio | 12104 |
| 251 | Cabo de Hornos | Cabo de Hornos | 12201 |
| 252 | Antártica | Antártica | 12202 |
| 253 | Porvenir | Porvenir | 12301 |
| 254 | Primavera | Primavera | 12302 |
| 255 | Timaukel | Timaukel | 12303 |
| 256 | Natales | Natales | 12401 |
| 257 | Torres del Paine | Torres del Paine | 12402 |
| 258 | Santiago | Santiago | 13101 |
| 259 | Cerrillos | Cerrillos | 13102 |
| 260 | Cerro Navia | Cerro Navia | 13103 |
| 261 | Conchalí | Conchalí | 13104 |
| 262 | El Bosque | El Bosque | 13105 |
| 263 | Estación Central | Estación Central | 13106 |
| 264 | Huechuraba | Huechuraba | 13107 |
| 265 | Independencia | Independencia | 13108 |
| 266 | La Cisterna | La Cisterna | 13109 |
| 267 | La Florida | La Florida | 13110 |
| 268 | La Granja | La Granja | 13111 |
| 269 | La Pintana | La Pintana | 13112 |
| 270 | La Reina | La Reina | 13113 |
| 271 | Las Condes | Las Condes | 13114 |
| 272 | Lo Barnechea | Lo Barnechea | 13115 |
| 273 | Lo Espejo | Lo Espejo | 13116 |
| 274 | Lo Prado | Lo Prado | 13117 |
| 275 | Macul | Macul | 13118 |
| 276 | Maipú | Maipú | 13119 |
| 277 | Ñuñoa | Ñuñoa | 13120 |
| 278 | Pedro Aguirre Cerda | Pedro Aguirre Cerda | 13121 |
| 279 | Peñalolén | Peñalolén | 13122 |
| 280 | Providencia | Providencia | 13123 |
| 281 | Pudahuel | Pudahuel | 13124 |
| 282 | Quilicura | Quilicura | 13125 |
| 283 | Quinta Normal | Quinta Normal | 13126 |
| 284 | Recoleta | Recoleta | 13127 |
| 285 | Renca | Renca | 13128 |
| 286 | San Joaquín | San Joaquín | 13129 |
| 287 | San Miguel | San Miguel | 13130 |
| 288 | San Ramón | San Ramón | 13131 |
| 289 | Vitacura | Vitacura | 13132 |
| 290 | Puente Alto | Puente Alto | 13201 |
| 291 | Pirque | Pirque | 13202 |
| 292 | San José de Maipo | San José de Maipo | 13203 |
| 293 | Colina | Colina | 13301 |
| 294 | Lampa | Lampa | 13302 |
| 295 | Tiltil | Tiltil | 13303 |
| 296 | San Bernardo | San Bernardo | 13401 |
| 297 | Buin | Buin | 13402 |
| 298 | Calera de Tango | Calera de Tango | 13403 |
| 299 | Paine | Paine | 13404 |
| 300 | Melipilla | Melipilla | 13501 |
| 301 | Alhué | Alhué | 13502 |
| 302 | Curacaví | Curacaví | 13503 |
| 303 | María Pinto | María Pinto | 13504 |
| 304 | San Pedro | San Pedro | 13505 |
| 305 | Talagante | Talagante | 13601 |
| 306 | El Monte | El Monte | 13602 |
| 307 | Isla de Maipo | Isla de Maipo | 13603 |
| 308 | Padre Hurtado | Padre Hurtado | 13604 |
| 309 | Peñaflor | Peñaflor | 13605 |
| 310 | Valdivia | Valdivia | 14101 |
| 311 | Corral | Corral | 14102 |
| 312 | Lanco | Lanco | 14103 |
| 313 | Los Lagos | Los Lagos | 14104 |
| 314 | Máfil | Máfil | 14105 |
| 315 | Mariquina | Mariquina | 14106 |
| 316 | Paillaco | Paillaco | 14107 |
| 317 | Panguipulli | Panguipulli | 14108 |
| 318 | La Unión | La Unión | 14201 |
| 319 | Futrono | Futrono | 14202 |
| 320 | Lago Ranco | Lago Ranco | 14203 |
| 321 | Río Bueno | Río Bueno | 14204 |
| 322 | Arica | Arica | 15101 |
| 323 | Camarones | Camarones | 15102 |
| 324 | Putre | Putre | 15201 |
| 325 | General Lagos | General Lagos | 15202 |
| 326 | Chillán | Chillán | 16101 |
| 327 | Bulnes | Bulnes | 16102 |
| 328 | Chillán Viejo | Chillán Viejo | 16103 |
| 329 | El Carmen | El Carmen | 16104 |
| 330 | Pemuco | Pemuco | 16105 |
| 331 | Pinto | Pinto | 16106 |
| 332 | Quillón | Quillón | 16107 |
| 333 | San Ignacio | San Ignacio | 16108 |
| 334 | Yungay | Yungay | 16109 |
| 335 | Quirihue | Quirihue | 16201 |
| 336 | Cobquecura | Cobquecura | 16202 |
| 337 | Coelemu | Coelemu | 16203 |
| 338 | Ninhue | Ninhue | 16204 |
| 339 | Portezuelo | Portezuelo | 16205 |
| 340 | Ranquil | Ranquil | 16206 |
| 341 | Treguaco | Treguaco | 16207 |
| 342 | San Carlos | San Carlos | 16301 |
| 343 | Coihueco | Coihueco | 16302 |
| 344 | Ñiquén | Ñiquén | 16303 |
| 345 | San Fabián | San Fabián | 16304 |
| 346 | San Nicolás | San Nicolás | 16305 |
| 347 | Sin información | Sin información | NA |
| 237 | Coyhaique | Coyhaique | 11101 |
