Esta documentación detalla los endpoints a crear en la API de Integraciones de Nubox, incluyendo autenticación, parámetros, ejemplos de uso, códigos de error comunes y definiciones de términos relevantes.
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 gestionados a través de Apache Kafka. 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 de Integraciones habilitará 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, soportando una capacidad de procesamiento de hasta 8.000 documentos al mes por empresa.
Para optimizar el flujo, los documentos se podrán 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, 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>
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 |
La siguiente colección tiene el objetivo de facilitar las pruebas con la API de Integraciones Nubox.
Configuraciones de la Colección
Para configurar las credenciales authorization y x-api-key dentro de la colección, en los Scripts -> Pre-request y presionar Save
Permite realizar la emisión de uno o más Documentos Tributarios Electrónicos (DTE) en una sola operación, con un límite de 50.
A través de esta interfaz, los partners pueden enviar lotes de documentos de distintos tipos para que sean validados, procesados y registrados dentro del sistema de Nubox de una empresa.
La emisión se gestiona de forma asincrónica, permitiendo una alta capacidad de procesamiento y garantizando la trazabilidad de cada documento emitido.
Esta operación da inicio al flujo completo de asignación de folios, validación interna, y preparación para posteo al SII, siendo el punto de entrada principal para la integración de sistemas externos con la lógica tributaria de Nubox.
Nota:
La baseUrl, que se muestra en cada endpoint será compartida en una próxima versión posterior de esta misma documentación.
POST baseUrl/v1/sales/issuance
BaseURL
Ambiente Certificación:
https://api.test-nubox.com/nbxpymapi-uat/v1
Ambiente Productivo:
https://api.pyme.nubox.com/nbxpymapi-environment-pyme/v1
authorization
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.
|
Nombre |
Tipo de dato |
Obligatorio |
Descripción |
|---|---|---|---|
|
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í |
|
|
Content-Type |
string |
Sí |
Tipo de contenido a enviar (application/json) |
No es necesario enviar ningún parámetro.
|
Atributo |
Tipo de Dato |
Obligatorio |
Descripción |
|
sequence |
integer |
No |
Número secuencial del documento dentro del lote de emisión. Útil para identificar unívocamente de los documentos enviados. |
|
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. |
|
client.email |
string |
No |
Correo electrónico del cliente. |
|
client.contactName |
string |
Nombre de la persona de contacto. |
|
|
client.phone |
string |
No |
Teléfono de contacto. |
|
client.address |
string |
No |
Dirección del cliente. |
|
client.city |
string |
No |
Ciudad del cliente. |
|
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). |
|
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[].productId |
integer |
No |
Identificador del producto. |
|
details[].productCode |
string |
No |
Código del producto. |
|
details[].quantity |
decimal |
Sí |
Cantidad vendida. |
|
details[].productDescription |
string |
Sí |
Descripción corta del producto. |
|
details[].productDescriptionExtended |
string |
No |
Descripción extendida del producto (opcional). |
|
details[].subjectToTax |
boolean |
No |
Indica si el ítem está afecto a impuestos (true o false). |
|
details[].uom.id |
integer |
No |
identificador de la unidad de medida |
|
details[].uom.code |
string |
No |
Código de la unidad (por ejemplo, "NIU" para unidad). |
|
details[].uom.description |
string |
No |
Descripción de la unidad. |
|
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í, si el array padre no es vacío |
Código legal del impuesto (e.g., "14" = IVA). |
|
details[].taxes[].amount |
Number |
Sí, si el array padre no es vacío |
Monto del impuesto aplicado al ítem. |
|
details[].discountsAndSurcharges |
array |
No |
Lista de descuentos o recargos aplicados a este ítem. |
|
details[].discountsAndSurcharges.amount |
decimal |
Sí, si el array padre no es vacío |
Monto del descuentos o recargos aplicados a este ítem. |
|
references[] |
array de objetos |
Solo si el array padre no es vacío |
Referencias asociadas al documento a emitir |
|
references[].legalCode |
string |
Solo si el array padre no es vacío |
Código legal del documento referenciado. |
|
references[].documentNumber |
string |
Solo si el array padre no es vacío |
Número del documento referenciado. |
|
references[].documentEmissionDate |
string (ISO 8601) |
Solo si el array padre no es vacío |
Fecha de emisión del documento referenciado. El formato a usar debe ser ISO.DATE_TIME |
|
references[].documentTotalAmount |
decimal |
Solo si el array padre no es vacío |
Monto total del documento referenciado. |
|
references[].motiveTypeId |
integer |
Solo si el array padre no es vacío |
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": "Cliente Ejemplo S.A.",
"identification": {
"type": 1,
"number": "12345678-9"
},
"mainActivity": "Comercio",
"email": "cliente@ejemplo.com",
"contactName": "Juan Pérez",
"phone": "+56912345678",
"address": "Av. Siempre Viva 123",
"city": "Santiago",
"territorialDivisionLegalCode": "13",
"territorialDivisionL2LegalCode": "13101"
},
"dueDate": "2024-06-30",
"saleType": {
"id": 1
},
"paymentForm": {
"id": 2
},
"paymentDate": "2024-05-12",
"totalNetAmount": 1000.0,
"totalExemptAmount": 0.0,
"totalTaxVatAmount": 190.0,
"totalOtherTaxesAmount": 0.0,
"totalWithholdingAmount": 0.0,
"totalAmount": 1190.0,
"comment": "Venta de productos varios",
"globalTaxes": [
{
"taxId": 1,
"amount": 190.0
}
],
"details": [
{
"order": 1,
"productId": 1001,
"productCode": "PROD-001",
"quantity": 2,
"productDescription": "Producto de prueba",
"productDescriptionExtended": "Descripción extendida del producto",
"subjectToTax": true,
"uom": {
"id": 1,
"code": "NIU",
"description": "Unidad"
},
"price": 500.0,
"totalTaxAmount": 190.0,
"totalDiscountSurchargeAmount": 0.0,
"totalAmount": 1190.0,
"taxes": [],
"discountsAndSurcharges": []
}
],
"references": [
{
"legalCode": "33",
"documentNumber": "1234",
"documentEmissionDate": "2024-05-01T00:00:00Z",
"documentTotalAmount": 1190.0,
"motiveTypeId": 1,
"motiveDescription": "Referencia a documento anterior"
}
]
}
]
[
{
"sequence": 2,
"type": {
"legalCode": "33"
},
"client": {
"tradeName": "Cliente Ejemplo S.A.",
"identification": {
"type": 1,
"number": "12345678-9"
},
"mainActivity": "Comercio",
"email": "cliente@ejemplo.com",
"contactName": "Juan Pérez",
"phone": "+56912345678",
"address": "Av. Siempre Viva 123",
"city": "Santiago",
"territorialDivisionLegalCode": "13",
"territorialDivisionL2LegalCode": "13101"
},
"dueDate": "2024-06-30",
"saleType": {
"id": 1
},
"paymentForm": {
"id": 2
},
"paymentDate": "2024-05-12",
"totalNetAmount": 1000.0,
"totalExemptAmount": 0.0,
"totalTaxVatAmount": 190.0,
"totalOtherTaxesAmount": 0.0,
"totalWithholdingAmount": 0.0,
"totalAmount": 1190.0,
"comment": "Venta de productos varios",
"globalTaxes": [
{
"taxId": 1,
"amount": 190.0
}
],
"details": [
{
"order": 1,
"productId": 1001,
"productCode": "PROD-001",
"quantity": 2,
"productDescription": "Producto de prueba",
"productDescriptionExtended": "Descripción extendida del producto",
"subjectToTax": true,
"uom": {
"id": 1,
"code": "NIU",
"description": "Unidad"
},
"price": 500.0,
"totalTaxAmount": 190.0,
"totalDiscountSurchargeAmount": 0.0,
"totalAmount": 1190.0,
"taxes": [],
"discountsAndSurcharges": []
}
],
"references": [
{
"legalCode": "33",
"documentNumber": "1234",
"documentEmissionDate": "2024-05-01T00:00:00Z",
"documentTotalAmount": 1190.0,
"motiveTypeId": 1,
"motiveDescription": "Referencia a documento anterior"
}
]
}
]
Response body
|
Nombre del Campo |
Tipo de Dato |
Descripción |
|
id |
Integer |
ID interno del sistema que representa la emisión del documento. Es único por cada emisión. |
|
sequence |
Integer |
Identifica el número secuencial del documento dentro del lote de emisión |
|
errors |
Array |
El campo errors 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 devolvera 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 207
[
{
"id": 1039365
"sequence": 1,
"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
{
"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. 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 colocado: |
|
Nombre |
Tipo de dato |
Tipo |
Descripción |
|
documentId |
string |
path (obligatorio) |
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
El id o identificador enviado no corresponde a ningún registro en la base de datos.
Permite obtener el XML de un documento
GET baseUrl/v1/sales/{documentId}/pdf
|
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) |
Id correlativo a transacción de Nubox |
|
template |
string |
path (obligatorio) |
Usado para generar formato en A4 o 80MM Valor = TEMPLATE_A4 Usado para documentos normales Valor = TEMPLATE_80MM Formato de 80mm Usado para documentos tipo ticket/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 |
|
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 |
