Nubox es un software contable para pymes y contadores enfocado en facturación electrónica, gestión contable y remuneraciones. Sus productos están diseñados para simplificar y automatizar procesos administrativos y financieros, facilitando el cumplimiento de obligaciones tributarias y mejorando la eficiencia operativa.

¿Para qué sirve Nubox?

Nubox ofrece herramientas diseñadas para facilitar la gestión administrativa y financiera de las empresas. Con su plataforma, es posible emitir facturas electrónicas, lo que permite generar y enviar Documentos Tributarios Electrónicos (DTE) cumpliendo con la normativa vigente. Además, Nubox ayuda a llevar la contabilidad al registrar y organizar movimientos financieros, generar balances y estados de resultados, y preparar declaraciones juradas. Por último, también permite gestionar remuneraciones, ofreciendo funcionalidades para calcular y procesar liquidaciones de sueldo, administrar cotizaciones previsionales y generar informes relacionados con el pago de empleados.

api docs

Información sobre Nueva API Factura y Administración de Nubox

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.

Información sobre Antigua API Factura Electrónica

En cuanto a la documentación de antigua API de Factura Electrónica puedes encontrarla en el Menú Lateral Factura Electrónica

Resumen técnico

Sobre la API

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).

Tipos de Documentos soportados

La API permite realizar la emisión electrónica de los siguientes tipos de documentos tributarios:

33: Factura Electrónica
34: Factura No Afecta o Exenta Electrónica

56: Nota de Débito Electrónica

61: Nota de Crédito Electrónica
38: Boleta Exenta Electrónica
41: Boleta Electrónica
52: Guia de Despacho
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

Sobre la Obtención de Documentos

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.

Sobre el Proceso de Emisión y Gestión

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.

Modelo de Autenticación

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 – Token del Partner

Authorization: Bearer <partner_token>

Este token es exclusivo para el partner integrador.
Permite autenticar y validar que la solicitud proviene de un partner registrado y autorizado en nuestra plataforma.
Debe ser enviado en cada request a través del header Authorization usando el esquema Bearer.

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 - Key de la Empresa Cliente

X-Api-Key: <company_api_key>

Esta clave identifica y autoriza a una empresa específica dentro del ecosistema de clientes de Nubox.
Permite que un partner actúe en nombre de una empresa a la que le presta servicios.

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

URLs de Ambientes: Certificación y Productivo

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

Disponibilidad de Ambiente de Certificación

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.

Obtención de Credenciales para Pruebas (UAT)

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.

Paso 1: Solicita tus Credenciales

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.

Paso 2: Recibe tus Claves de Acceso

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

Paso 3: Utiliza nuestra colección de 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.

¿Cómo configurar la colección?

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.

Obtención de Credenciales Productivas

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:

Ingresa a la cuenta del producto de Factura y Administración, dar clic en el engranaje e ingresar al módulo de integraciones & API

Paso 2

Dar clic al botón "Iniciar" de la sección de API

Paso 3

Para este paso se mostrará una ventana donde debes seleccionar entre dos opciones:

Integración a a través de partners

Para aquellos casos donde tu proceso de integración es realizado por un partner de la compañia, selecciona la primera opción "A través de una empresa asociada a Nubox". Luego selecciona la empresa partner que aparezca en el listado y presiona el botón Generar Credenciales.

Una vez culminado el proceso veras el siguiente mensaje, como consecuencia tu partner podrá visualizar tu credencial:

Integración independiente

Para los casos donde las credenciales serán usadas directamente por tu empresa, selecciona la segunda opción "Directamente con Nubox (por mi cuenta, sin empresa asociada)" y presiona el botón Generar Credenciales

Cuando el proceso haya sido exitoso podras ver el siguiente mensaje:

Una vez realizado este paso podrás ver en la pantalla las credenciales a utilizar.

Endpoints disponibles en la API

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.

Ejemplo de uso de endpoints

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

Emisión de Documentos

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.

Endpoint

POST baseUrl/v1/sales/issuance

Headers a enviar:

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)

Parámetros requeridos:

No es necesario enviar ningún parámetro.

Request Body

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. Largo máximo 100.
client.identification.type	integer	Sí	1, para RUT chileno; 2, para identificador extranjero.
client.identification.value	string	Sí	Número de identificación. Este es validado dependiendo del type indicado.
client.mainActivity	string	Sí	Actividad económica principal del cliente. Largo máximo 40.
client.email	string	No	Correo electrónico del cliente. Largo máximo 100. Si bien no es obligatorio se recomienda enviarlo siempre para garantizar el envío al cliente receptor.
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). Ver en la sección de Datos usados por la API las opciones disponibles de Regiones
client.territorialDivisionL2LegalCode	string	Sí	Código legal de la comuna (e.g., 13101 = Santiago). Ver en la sección de Datos usados por la API las opciones disponibles de Comunas
client.countryLegalCode	string	Cond.	Código de país del cliente. Requerido sólo para documentos de exportación (type.legalCode igual a “110”, “111” y “112”). Ver en la sección de Datos usados por la API las opciones disponibles de Países.
dueDate	string (YYYY-MM-DD)	No	Fecha de vencimiento del documento, corresponde a la fecha límite de pago. Debe ser siempre mayor o igual a la fecha actual. En caso no ser recibida, se asigna la fecha actual más 30 días sólo si paymentForm.id es igual a 2 (pago al crédito); en caso de que paymentForm.id sea igual a 1 (pago al contado), se asigna la fecha actual.
saleType.id	integer	Sí	Identificador del tipo de venta (por ejemplo, contado, crédito, etc.). Tipo de venta (1 = Venta normal). Ver en la sección de Datos usados por la API las opciones disponibles de Tipos de Venta (saleTypes)
paymentForm.id	integer	Sí	Forma de pago (1 = Contado). Ver en la sección de Datos usados por la API las opciones disponibles de Formas de Pago (PaymentForms)
paymentDate	string (YYYY-MM-DD)	No	Fecha en que se realizó el pago.
currencyConversionRate	decimal	Cond.	Factor de conversión al tipo de cambio de la fecha de emisión del documento. Requerido sólo para documentos de exportación (type.legalCode igual a “110”, “111” y “112”).
totalTaxVatAmount	decimal	No	Monto total de IVA (Impuesto al Valor Agregado).
commenttotalAmount	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í	1, para RUT chileno; 2, para identificador extranjero.
dispatchGuideDetail.driver.identification.value	string	Sí	Número de identificación. Este es validado dependiendo del type indicado.
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í	1, para RUT chileno; 2, para identificador extranjero.
dispatchGuideDetail.conveyor.identification.value	string	Sí	Número de identificación. Este es validado dependiendo del type indicado.
dispatchGuideDetail.licensePlate	string	No	Patente del vehículo. Largo máximo 8.
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). Ver en la sección de Datos usados por la API las opciones disponibles de Comunas.
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.
exportationDetail	object	Cond.	Representa el modelo de datos asociado a los documentos de exportación. Requerido sólo para documentos de exportación (type.legalCode igual a “110”, “111” y “112”).
exportationDetail.serviceIndicator	object	No	Representa el modelo del indicador de servicio.
exportationDetail.serviceIndicator.id	integer	Sí	Código de indicador de servicio. Ver en la sección de Datos usados por la API las opciones disponibles de Indicadores de Servicio.
exportationDetail.saleMode	object	No	Representa el modelo de modalidad de venta.
exportationDetail.saleMode.id	integer	Sí	Código de modalidad de venta. Ver en la sección de Datos usados por la API las opciones disponibles de Modalidades de Venta.
exportationDetail.incoterm	object	No	Representa el modelo del cláusulas de venta.
exportationDetail.incoterm.id	integer	Sí	Código de cláusula de venta. Ver en la sección de Datos usados por la API las opciones disponibles de Cláusulas de Venta.
exportationDetail.transportMode	object	No	Representa el modelo del vía de transporte.
exportationDetail.transportMode.id	integer	Sí	Código de vía de transporte. Ver en la sección de Datos usados por la API las opciones disponibles de Vías de Transporte.
exportationDetail.departurePort	object	No	Representa el modelo del puerto de embarque.
exportationDetail.departurePort.legalCode	string	Sí	Código de puerto de embarque. Ver en la sección de Datos usados por la API las opciones disponibles de Puertos.
exportationDetail.arrivalPort	object	No	Representa el modelo del puerto de desembarque.
exportationDetail.arrivalPort.legalCode	string	Sí	Código de puerto de desembarque. Ver en la sección de Datos usados por la API las opciones disponibles de Puertos.
exportationDetail.arrivalPort.description	string	No	Descripción adicional del puerto de desembarque. Largo máximo 100.
exportationDetail.originCity	string	Sí	Ciudad de origen del emisor. Largo máximo 20.
exportationDetail.destinationCity	string	Sí	Ciudad de destino del receptor. Largo máximo 20.
exportationDetail.destinationAddress	string	Sí	Dirección de destino del receptor. Largo máximo 200.
exportationDetail.destinationCountryLegalCode	string	Sí	Código de país del receptor. Ver en la sección de Datos usados por la API las opciones disponibles de Países.
exportationDetail.packagesQuantity	integer	No	Cantidad de bultos.
exportationDetail.totalIncoterm	decimal	No	Monto total de la exportación a pagar por el importador según la cláusula de venta (exportationDetail.incoterm.id) acordada entre las partes.
details[]	array	Sí	Arreglo de detalles de productos.
details[].order	integer	Sí	Número de orden del ítem. Todos los valores de este atributo deben ser únicos entre cada elemento de details[]
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 Ver en la sección de Datos usados por la API las opciones disponibles de Unidades de medida (UOMs Code)
details[].uom.code	string	Si	Código de la unidad (por ejemplo, "NIU" para unidad). Largo máximo 4. Ver en la sección de Datos usados por la API las opciones disponibles de Unidades de medida (UOMs Code)
details[].price	decimal	Si	Precio unitario del producto.
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). Ver en la sección de Datos usados por la API las opciones disponibles de Impuestos (Taxes)
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 (yyyy-MM-dd'T'HH:mm:ss.SSSXXX)
references[].documentTotalAmount	decimal	Si	Monto total del documento referenciado.
references[].motiveTypeId	integer	Si	Identificador del motivo de la referencia. Ver en la sección de Datos usados por la API las opciones disponibles de Tipos de Motivos de Referencias (MotiveType)
references[].motiveDescription	string	No	Descripción del motivo de la referencia. Largo máximo 90.

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

"comment": "Comentarios varios",

"details": [

{

"order": 1,

"quantity": 1,

"productDescription": "Producto Uno",

"productDescriptionExtended": "Descripción muy descriptiva",

"productCode": "01",

"subjectToTax": true,

"price": 105042,

"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"

}

]

}

]

Ejemplo de json en el body con 2 documentos

[

{

"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

"comment": "Transferencias Económicas",

"details": [

{

"order": 1,

"quantity": 1,

"productDescription": "SEN_1234",

"productDescriptionExtended": "Transferencias Económicas",

"subjectToTax": true,

"price": 105042,

"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",

"comment": "Venta de productos varios",

"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,

"taxes": [],

"discountsAndSurcharges": []

}

"references": [

{

"legalCode": "34",

"documentNumber": "259",

"documentEmissionDate": "2025-06-06T10:24:14.000Z",

"documentTotalAmount": 5000,

"motiveTypeId": 1,

"motiveDescription": "Referencia de prueba"

}

]

}

]

Posibles respuestas a la solicitud (application/json):

207: Multi-Status

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

]

400 Bad Request:

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"

}

]

500: Internal Server Error:

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": [

{}

]

}

Obtener XML de un Documento

Permite obtener el XML de un documento

Endpoint

GET baseUrl/v1/sales/{documentId}/xml

Headers a enviar:

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. Accept: application/json retorna un JSON con una representación en formato Base64 del XML. Accept: application/xml retorna un XML.

Parámetros requeridos:

Nombre	Tipo de dato	Obligatorio	Descripción
documentId	string	Si, tipo path	Id correlativo a transacción de Nubox

Posibles respuestas a la solicitud (application/xml ó application/json ):

200 OK:

Response Body

Devuelve el XML solicitado

Ejemplo de 200: OK

<NroDTE>1</NroDTE>...

400 Bad Request:

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"

}

]

}

500: Internal Server Error

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": []

}

404: Not Found

Response Body

Solo responde el verbo status, sin response body.

Obtener PDF de un Documento

Permite obtener el XML de un documento

Endpoint

GET baseUrl/v1/sales/{documentId}/pdf?template={templateId}

Headers a enviar:

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)

Parámetros requeridos:

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.

Posibles respuestas a la solicitud (application/pdf):

200 OK:

Response Body

Devuelve el PDF solicitado

400 Bad Request:

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"

}

]

}

500: Internal Server Error

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": []

}

404:Not Found

Response Body

Solo responde el verbo status, sin response body.

Obtener Ventas

Permite obtener un listado de documentos de venta que han sido emitidos desde la Api de Integraciones.

Endpoint

GET baseUrl/v1/sales

Headers a enviar:

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)

Parámetros a enviar:

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"].

Posibles respuestas a la solicitud (application/json):

200 OK:

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/"

}

]

}

]

204 No Content:

Solo responde el verbo status, sin response body.

400 Bad Request:

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"

}

]

}

500: Internal Server Error

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": []

}

404 Not Found

Response Body

Solo responde el verbo status, sin response body.

Obtener venta

Permite obtener un documento de venta

Endpoint

baseUrl/v1/sales/{documentId}

Headers a enviar:

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)

Parámetros a enviar:

Nombre	Tipo de dato	Tipo	Descripción
documentId	string	path (obligatorio)	Id interno en Nubox del documento de venta

Posibles respuestas a la solicitud (application/json):

200 OK:

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.
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

"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"

}

400 Bad Request:

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"

}

]

}

500 Internal Server Error

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": []

}

404: Not Found

Response Body

Solo responde el verbo status, sin response body.

Obtener Detalle de Productos de Venta

Obtiene un documento de ventas único

Endpoint

GET /v1/sales/{documentId}/details

Headers a enviar:

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)

Parámetros a enviar:

Nombre	Tipo de dato	Obligatorio	Descripción
documentId	string	path (obligatorio)	Id interno en Nubox del documento de venta

Posibles respuestas a la solicitud (application/json):

200 OK:

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"

}

]

}

]

400 Bad Request:

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"

}

]

}

500 Internal Server Error

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": []

}

404 Not Found

Response Body

Solo responde el verbo status, sin response body.

Obtener documentos referenciados

Permite obtener documentos referenciados de un documento de Venta

Endpoint

baseUrl/v1/sales/{documentId/references

Headers a enviar:

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)

Parámetros a enviar:

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.

Posibles respuestas a la solicitud (application/json):

200 OK:

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"

}

]

}

]

400 Bad Request:

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"

}

]

}

500 Internal Server Error

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": []

}

404 Not Found

Response Body

Solo responde el verbo status, sin response body.

Datos usados por la API

Tipos de Venta (Sales Types)

id	Nombre
1	Ventas del Giro
2	Venta Activo Fijo
3	Venta Bien Raíz

Estados de Emisión (EmissionStatus)

id	Nombre	Descripción
1	Emitido	El comprobante se encuentra emitido.
2	Borrador	El comprobante se encuentra en borrador. Este es un estado interno de Nubox no utilizable por el cliente
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

Formas de Pago (Payment Form)

id	Nombre
1	Contado
2	Crédito

Tipos de Impuestos (TaxTypes)

id	Nombre
1	IVA
2	Impuesto al consumo
3	Retención al consumo
4	Retención por honorarios
5	IVA

Impuestos (Taxes)

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

Unidades de Medida (UOMs codes)

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

Modalidades de venta

id	Nombre	Descripción
1	FIRME	A firme
2	BAJO COND.	Bajo condición
3	CONS-LIBRE	En consignación libre
4	COND-M.F.	En consignación con un mínimo a firme
9	SIN PAGO	Sin pago

Tipos de Despacho

id	Nombre	Descripción
1	A instalaciones del cliente por cuenta del receptor	A instalaciones del cliente por cuenta del receptor
2	A instalaciones del cliente por cuenta del emisor	Este es el caso más común, en el cual un determinado comercio realiza el despacho desde sus almacenes o bodegas
3	A otras instalaciones por cuenta del emisor	Ejemplo: entrega en Obra

Cláusulas de venta

id	Nombre	Descripción
1	CIF	Costos, seguro y flete
2	CFR	Costos y flete
3	EXW	En fábrica
4	FAS	Franco al costado del buque
5	FOB	Franco a bordo
6	S/CL	Sin cláusula de compraventa
7	FCA	Franco transportista

Vías de Transporte

ID	Nombre
1	Marítima, fluvial y lacustre
4	Aéreo
5	Postal
6	Ferroviario
7	Carretero/terrestre
8	Oleoductos/gasoductos
9	Tendido eléctrico (aéreo/subterráneo)
10	Otra
11	Courier/aéreo

Indicadores de Servicio

id	Nombre
3	Servicios calificados como tal por Aduanas
4	Servicios de hotelería

Tipos de Motivos de Referencias (MotiveTypes)

ID	Nombre
1	Anular documento
2	Corregir texto
3	Corregir monto

Tipos de Documentos a Referenciar (Document Types)

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

Regiones

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

Comunas

id	description
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

Regiones

id	legalCode	name	description
1	1	I Tarapacá	I Tarapacá
2	2	II Antofagasta	II Antofagasta
3	3	III Atacama	III Atacama
4	4	IV Coquimbo	IV Coquimbo
5	5	V Valparaíso	V Valparaíso
6	6	VI Libertador General Bernardo O'Higgins	VI Libertador General Bernardo O'Higgins
7	7	VII Maule	VII Maule
8	8	VIII Biobío	VIII Biobío
9	9	IX La Araucanía	IX La Araucanía
10	10	X Los Lagos	X Los Lagos
11	11	XI Aysén del General Carlos Ibáñez del Campo	XI Aysén del General Carlos Ibáñez del Campo
12	12	XII Magallanes y de la Antártica Chilena	XII Magallanes y de la Antártica Chilena
13	13	XIII Metropolitana de Santiago	XIII Metropolitana de Santiago
14	14	XIV Los Ríos	XIV Los Ríos
15	15	XV Arica y Parinacota	XV Arica y Parinacota
16	16	XVI Ñuble	XVI Ñuble
17	NA	Sin Información	Sin Información

Comunas

id	legalCode	nombre	Descripcioón	territorialDivisionId
1	1101	Iquique	Iquique	1
2	1107	Alto Hospicio	Alto Hospicio	1
3	1401	Pozo Almonte	Pozo Almonte	1
4	1402	Camiña	Camiña	1
5	1403	Colchane	Colchane	1
6	1404	Huara	Huara	1
7	1405	Pica	Pica	1
8	2101	Antofagasta	Antofagasta	2
9	2102	Mejillones	Mejillones	2
10	2103	Sierra Gorda	Sierra Gorda	2
11	2104	Taltal	Taltal	2
12	2201	Calama	Calama	2
13	2202	Ollagüe	Ollagüe	2
14	2203	San Pedro de Atacama	San Pedro de Atacama	2
15	2301	Tocopilla	Tocopilla	2
16	2302	María Elena	María Elena	2
17	3101	Copiapó	Copiapó	3
18	3102	Caldera	Caldera	3
19	3103	Tierra Amarilla	Tierra Amarilla	3
20	3201	Chañaral	Chañaral	3
21	3202	Diego de Almagro	Diego de Almagro	3
22	3301	Vallenar	Vallenar	3
23	3302	Alto del Carmen	Alto del Carmen	3
24	3303	Freirina	Freirina	3
25	3304	Huasco	Huasco	3
26	4101	La Serena	La Serena	4
27	4102	Coquimbo	Coquimbo	4
28	4103	Andacollo	Andacollo	4
29	4104	La Higuera	La Higuera	4
30	4105	Paiguano	Paiguano	4
31	4106	Vicuña	Vicuña	4
32	4201	Illapel	Illapel	4
33	4202	Canela	Canela	4
34	4203	Los Vilos	Los Vilos	4
35	4204	Salamanca	Salamanca	4
36	4301	Ovalle	Ovalle	4
37	4302	Combarbalá	Combarbalá	4
38	4303	Monte Patria	Monte Patria	4
39	4304	Punitaqui	Punitaqui	4
40	4305	Río Hurtado	Río Hurtado	4
41	5101	Valparaíso	Valparaíso	5
42	5102	Casablanca	Casablanca	5
43	5103	Concón	Concón	5
44	5104	Juan Fernández	Juan Fernández	5
45	5105	Puchuncaví	Puchuncaví	5
46	5107	Quintero	Quintero	5
47	5109	Viña del Mar	Viña del Mar	5
48	5201	Isla de Pascua	Isla de Pascua	5
49	5301	Los Andes	Los Andes	5
50	5302	Calle Larga	Calle Larga	5
51	5303	Rinconada	Rinconada	5
52	5304	San Esteban	San Esteban	5
53	5401	La Ligua	La Ligua	5
54	5402	Cabildo	Cabildo	5
55	5403	Papudo	Papudo	5
56	5404	Petorca	Petorca	5
57	5405	Zapallar	Zapallar	5
58	5501	Quillota	Quillota	5
59	5502	Calera	Calera	5
60	5503	Hijuelas	Hijuelas	5
61	5504	La Cruz	La Cruz	5
62	5506	Nogales	Nogales	5
63	5601	San Antonio	San Antonio	5
64	5602	Algarrobo	Algarrobo	5
65	5603	Cartagena	Cartagena	5
66	5604	El Quisco	El Quisco	5
67	5605	El Tabo	El Tabo	5
68	5606	Santo Domingo	Santo Domingo	5
69	5701	San Felipe	San Felipe	5
70	5702	Catemu	Catemu	5
71	5703	Llaillay	Llaillay	5
72	5704	Panquehue	Panquehue	5
73	5705	Putaendo	Putaendo	5
74	5706	Santa María	Santa María	5
75	5801	Quilpué	Quilpué	5
76	5802	Limache	Limache	5
77	5803	Olmué	Olmué	5
78	5804	Villa Alemana	Villa Alemana	5
79	6101	Rancagua	Rancagua	6
80	6102	Codegua	Codegua	6
81	6103	Coinco	Coinco	6
82	6104	Coltauco	Coltauco	6
83	6105	Doñihue	Doñihue	6
84	6106	Graneros	Graneros	6
85	6107	Las Cabras	Las Cabras	6
86	6108	Machalí	Machalí	6
87	6109	Malloa	Malloa	6
88	6110	Mostazal	Mostazal	6
89	6111	Olivar	Olivar	6
90	6112	Peumo	Peumo	6
91	6113	Pichidegua	Pichidegua	6
92	6114	Quinta de Tilcoco	Quinta de Tilcoco	6
93	6115	Rengo	Rengo	6
94	6116	Requínoa	Requínoa	6
95	6117	San Vicente	San Vicente	6
96	6201	Pichilemu	Pichilemu	6
97	6202	La Estrella	La Estrella	6
98	6203	Litueche	Litueche	6
99	6204	Marchihue	Marchihue	6
100	6205	Navidad	Navidad	6
101	6206	Paredones	Paredones	6
102	6301	San Fernando	San Fernando	6
103	6302	Chépica	Chépica	6
104	6303	Chimbarongo	Chimbarongo	6
105	6304	Lolol	Lolol	6
106	6305	Nancagua	Nancagua	6
107	6306	Palmilla	Palmilla	6
108	6307	Peralillo	Peralillo	6
109	6308	Placilla	Placilla	6
110	6309	Pumanque	Pumanque	6
111	6310	Santa Cruz	Santa Cruz	6
112	7101	Talca	Talca	7
113	7102	Constitución	Constitución	7
114	7103	Curepto	Curepto	7
115	7104	Empedrado	Empedrado	7
116	7105	Maule	Maule	7
117	7106	Pelarco	Pelarco	7
118	7107	Pencahue	Pencahue	7
119	7108	Río Claro	Río Claro	7
120	7109	San Clemente	San Clemente	7
121	7110	San Rafael	San Rafael	7
122	7201	Cauquenes	Cauquenes	7
123	7202	Chanco	Chanco	7
124	7203	Pelluhue	Pelluhue	7
125	7301	Curicó	Curicó	7
126	7302	Hualañé	Hualañé	7
127	7303	Licantén	Licantén	7
128	7304	Molina	Molina	7
129	7305	Rauco	Rauco	7
130	7306	Romeral	Romeral	7
131	7307	Sagrada Familia	Sagrada Familia	7
132	7308	Teno	Teno	7
133	7309	Vichuquén	Vichuquén	7
134	7401	Linares	Linares	7
135	7402	Colbún	Colbún	7
136	7403	Longaví	Longaví	7
137	7404	Parral	Parral	7
138	7405	Retiro	Retiro	7
139	7406	San Javier	San Javier	7
140	7407	Villa Alegre	Villa Alegre	7
141	7408	Yerbas Buenas	Yerbas Buenas	7
142	8101	Concepción	Concepción	8
143	8102	Coronel	Coronel	8
144	8103	Chiguayante	Chiguayante	8
145	8104	Florida	Florida	8
146	8105	Hualqui	Hualqui	8
147	8106	Lota	Lota	8
148	8107	Penco	Penco	8
149	8108	San Pedro de la Paz	San Pedro de la Paz	8
150	8109	Santa Juana	Santa Juana	8
151	8110	Talcahuano	Talcahuano	8
152	8111	Tomé	Tomé	8
153	8112	Hualpén	Hualpén	8
154	8201	Lebu	Lebu	8
155	8202	Arauco	Arauco	8
156	8203	Cañete	Cañete	8
157	8204	Contulmo	Contulmo	8
158	8205	Curanilahue	Curanilahue	8
159	8206	Los Alamos	Los Alamos	8
160	8207	Tirúa	Tirúa	8
161	8301	Los Angeles	Los Angeles	8
162	8302	Antuco	Antuco	8
163	8303	Cabrero	Cabrero	8
164	8304	Laja	Laja	8
165	8305	Mulchén	Mulchén	8
166	8306	Nacimiento	Nacimiento	8
167	8307	Negrete	Negrete	8
168	8308	Quilaco	Quilaco	8
169	8309	Quilleco	Quilleco	8
170	8310	San Rosendo	San Rosendo	8
171	8311	Santa Bárbara	Santa Bárbara	8
172	8312	Tucapel	Tucapel	8
173	8313	Yumbel	Yumbel	8
174	8314	Alto Biobío	Alto Biobío	8
175	9101	Temuco	Temuco	9
176	9102	Carahue	Carahue	9
177	9103	Cunco	Cunco	9
178	9104	Curarrehue	Curarrehue	9
179	9105	Freire	Freire	9
180	9106	Galvarino	Galvarino	9
181	9107	Gorbea	Gorbea	9
182	9108	Lautaro	Lautaro	9
183	9109	Loncoche	Loncoche	9
184	9110	Melipeuco	Melipeuco	9
185	9111	Nueva Imperial	Nueva Imperial	9
186	9112	Padre Las Casas	Padre Las Casas	9
187	9113	Perquenco	Perquenco	9
188	9114	Pitrufquén	Pitrufquén	9
189	9115	Pucón	Pucón	9
190	9116	Saavedra	Saavedra	9
191	9117	Teodoro Schmidt	Teodoro Schmidt	9
192	9118	Toltén	Toltén	9
193	9119	Vilcún	Vilcún	9
194	9120	Villarrica	Villarrica	9
195	9121	Cholchol	Cholchol	9
196	9201	Angol	Angol	9
197	9202	Collipulli	Collipulli	9
198	9203	Curacautín	Curacautín	9
199	9204	Ercilla	Ercilla	9
200	9205	Lonquimay	Lonquimay	9
201	9206	Los Sauces	Los Sauces	9
202	9207	Lumaco	Lumaco	9
203	9208	Purén	Purén	9
204	9209	Renaico	Renaico	9
205	9210	Traiguén	Traiguén	9
206	9211	Victoria	Victoria	9
207	10101	Puerto Montt	Puerto Montt	10
208	10102	Calbuco	Calbuco	10
209	10103	Cochamó	Cochamó	10
210	10104	Fresia	Fresia	10
211	10105	Frutillar	Frutillar	10
212	10106	Los Muermos	Los Muermos	10
213	10107	Llanquihue	Llanquihue	10
214	10108	Maullín	Maullín	10
215	10109	Puerto Varas	Puerto Varas	10
216	10201	Castro	Castro	10
217	10202	Ancud	Ancud	10
218	10203	Chonchi	Chonchi	10
219	10204	Curaco de Vélez	Curaco de Vélez	10
220	10205	Dalcahue	Dalcahue	10
221	10206	Puqueldón	Puqueldón	10
222	10207	Queilén	Queilén	10
223	10208	Quellón	Quellón	10
224	10209	Quemchi	Quemchi	10
225	10210	Quinchao	Quinchao	10
226	10301	Osorno	Osorno	10
227	10302	Puerto Octay	Puerto Octay	10
228	10303	Purranque	Purranque	10
229	10304	Puyehue	Puyehue	10
230	10305	Río Negro	Río Negro	10
231	10306	San Juan de la Costa	San Juan de la Costa	10
232	10307	San Pablo	San Pablo	10
233	10401	Chaitén	Chaitén	10
234	10402	Futaleufú	Futaleufú	10
235	10403	Hualaihué	Hualaihué	10
236	10404	Palena	Palena	10
238	11102	Lago Verde	Lago Verde	11
239	11201	Aisén	Aisén	11
240	11202	Cisnes	Cisnes	11
241	11203	Guaitecas	Guaitecas	11
242	11301	Cochrane	Cochrane	11
243	11302	O'Higgins	O'Higgins	11
244	11303	Tortel	Tortel	11
245	11401	Chile Chico	Chile Chico	11
246	11402	Río Ibáñez	Río Ibáñez	11
247	12101	Punta Arenas	Punta Arenas	12
248	12102	Laguna Blanca	Laguna Blanca	12
249	12103	Río Verde	Río Verde	12
250	12104	San Gregorio	San Gregorio	12
251	12201	Cabo de Hornos	Cabo de Hornos	12
252	12202	Antártica	Antártica	12
253	12301	Porvenir	Porvenir	12
254	12302	Primavera	Primavera	12
255	12303	Timaukel	Timaukel	12
256	12401	Natales	Natales	12
257	12402	Torres del Paine	Torres del Paine	12
258	13101	Santiago	Santiago	13
259	13102	Cerrillos	Cerrillos	13
260	13103	Cerro Navia	Cerro Navia	13
261	13104	Conchalí	Conchalí	13
262	13105	El Bosque	El Bosque	13
263	13106	Estación Central	Estación Central	13
264	13107	Huechuraba	Huechuraba	13
265	13108	Independencia	Independencia	13
266	13109	La Cisterna	La Cisterna	13
267	13110	La Florida	La Florida	13
268	13111	La Granja	La Granja	13
269	13112	La Pintana	La Pintana	13
270	13113	La Reina	La Reina	13
271	13114	Las Condes	Las Condes	13
272	13115	Lo Barnechea	Lo Barnechea	13
273	13116	Lo Espejo	Lo Espejo	13
274	13117	Lo Prado	Lo Prado	13
275	13118	Macul	Macul	13
276	13119	Maipú	Maipú	13
277	13120	Ñuñoa	Ñuñoa	13
278	13121	Pedro Aguirre Cerda	Pedro Aguirre Cerda	13
279	13122	Peñalolén	Peñalolén	13
280	13123	Providencia	Providencia	13
281	13124	Pudahuel	Pudahuel	13
282	13125	Quilicura	Quilicura	13
283	13126	Quinta Normal	Quinta Normal	13
284	13127	Recoleta	Recoleta	13
285	13128	Renca	Renca	13
286	13129	San Joaquín	San Joaquín	13
287	13130	San Miguel	San Miguel	13
288	13131	San Ramón	San Ramón	13
289	13132	Vitacura	Vitacura	13
290	13201	Puente Alto	Puente Alto	13
291	13202	Pirque	Pirque	13
292	13203	San José de Maipo	San José de Maipo	13
293	13301	Colina	Colina	13
294	13302	Lampa	Lampa	13
295	13303	Tiltil	Tiltil	13
296	13401	San Bernardo	San Bernardo	13
297	13402	Buin	Buin	13
298	13403	Calera de Tango	Calera de Tango	13
299	13404	Paine	Paine	13
300	13501	Melipilla	Melipilla	13
301	13502	Alhué	Alhué	13
302	13503	Curacaví	Curacaví	13
303	13504	María Pinto	María Pinto	13
304	13505	San Pedro	San Pedro	13
305	13601	Talagante	Talagante	13
306	13602	El Monte	El Monte	13
307	13603	Isla de Maipo	Isla de Maipo	13
308	13604	Padre Hurtado	Padre Hurtado	13
309	13605	Peñaflor	Peñaflor	13
310	14101	Valdivia	Valdivia	14
311	14102	Corral	Corral	14
312	14103	Lanco	Lanco	14
313	14104	Los Lagos	Los Lagos	14
314	14105	Máfil	Máfil	14
315	14106	Mariquina	Mariquina	14
316	14107	Paillaco	Paillaco	14
317	14108	Panguipulli	Panguipulli	14
318	14201	La Unión	La Unión	14
319	14202	Futrono	Futrono	14
320	14203	Lago Ranco	Lago Ranco	14
321	14204	Río Bueno	Río Bueno	14
322	15101	Arica	Arica	15
323	15102	Camarones	Camarones	15
324	15201	Putre	Putre	15
325	15202	General Lagos	General Lagos	15
326	16101	Chillán	Chillán	16
327	16102	Bulnes	Bulnes	16
328	16103	Chillán Viejo	Chillán Viejo	16
329	16104	El Carmen	El Carmen	16
330	16105	Pemuco	Pemuco	16
331	16106	Pinto	Pinto	16
332	16107	Quillón	Quillón	16
333	16108	San Ignacio	San Ignacio	16
334	16109	Yungay	Yungay	16
335	16201	Quirihue	Quirihue	16
336	16202	Cobquecura	Cobquecura	16
337	16203	Coelemu	Coelemu	16
338	16204	Ninhue	Ninhue	16
339	16205	Portezuelo	Portezuelo	16
340	16206	Ranquil	Ranquil	16
341	16207	Treguaco	Treguaco	16
342	16301	San Carlos	San Carlos	16
343	16302	Coihueco	Coihueco	16
344	16303	Ñiquén	Ñiquén	16
345	16304	San Fabián	San Fabián	16
346	16305	San Nicolás	San Nicolás	16
347	NA	Sin información	Sin información	17
237	11101	Coyhaique	Coyhaique	11

Países

id	legalCode	name
1	308	Afghanistan
2	518	Albania
3	563	Alemania
4	525	Andorra
5	140	Angola
6	242	Anguila
7	240	Antigua Y Barbuda
8	247	Antillas Neerlandesas
9	302	Arabia Saudita
10	127	Argelia
11	224	Argentina
12	540	Armenia
13	243	Aruba
14	406	Australia
15	509	Austria
16	541	Azerbaijan
17	207	Bahamas
18	313	Bahrein
19	321	Bangladesh
20	204	Barbados
21	542	Belarus
22	420	Belau
23	514	Belgica
24	236	Belice
25	150	Benin
26	244	Bermudas
27	221	Bolivia
28	543	Bosnia Y Herzegovina
29	113	Botswana
30	220	Brasil
31	344	Brunei
32	527	Bulgaria
33	161	Burkina Faso
34	141	Burundi
35	318	Butan
36	129	Cabo Verde
37	315	Cambodia
38	149	Camerun
39	226	Canada
40	130	Chad
41	997	Chile
42	336	China
43	305	Chipre
44	202	Colombia
45	118	Comoras
46	144	Congo
47	334	Corea Del Norte
48	333	Corea Del Sur
49	107	Costa De Marfil
50	211	Costa Rica
51	547	Croacia
52	209	Cuba
53	507	Dinamarca
54	155	Djibouti
55	231	Dominica
56	218	Ecuador
57	124	Egipto
58	213	El Salvador
59	341	Emiratos Arabes Unidos
60	163	Eritrea
61	548	Eslovenia
62	517	España
63	225	Estados Unidos De América
64	549	Estonia
65	139	Etiopia
66	401	Fiji
67	335	Filipinas
68	512	Finlandia
69	505	Francia
70	145	Gabon
71	102	Gambia
72	550	Georgia
73	108	Ghana
74	565	Gibraltar
75	232	Granada
76	520	Grecia
77	253	Groenlandia
78	425	Guam
79	215	Guatemala
80	566	Guernsey
81	104	Guinea
82	103	Guinea - Bissau
83	147	Guinea Ecuatorial
84	217	Guyana
85	208	Haiti
86	515	Países Bajos
87	214	Honduras
88	342	Hong Kong - Región Administrativa Especial De China
89	530	Hungria
90	317	India
91	328	Indonesia
92	307	Irak
93	309	Iran
94	506	Irlanda
95	516	Islandia
96	246	Islas Cayman
97	427	Islas Cook
98	567	Islas De Man
99	327	Islas Maldivas
100	424	Islas Marianas Del Norte
101	164	Islas Marshall
102	418	Islas Salomon
103	403	Islas Tonga
104	249	Islas Virgenes (Estados Unidos De America)
105	245	Islas Virgenes Britanicas
106	306	Israel
107	504	Italia
108	205	Jamaica
109	331	Japon
110	568	Jersey
111	301	Jordania
112	551	Kasajstan
113	137	Kenia
114	552	Kirgistan
115	416	Kiribati
116	303	Kuwait
117	316	Laos
118	114	Lesotho
119	553	Letonia
120	311	Libano
121	106	Liberia
122	125	Libia
123	534	Liechtenstein
124	554	Lituania
125	532	Luxemburgo
126	345	Macao
127	555	Macedonia
128	120	Madagascar
129	329	Malasia
130	115	Malawi
131	133	Mali
132	523	Malta
133	128	Marruecos
134	250	Martinica
135	119	Mauricio
136	134	Mauritania
137	216	Mexico
138	417	Micronesia
139	556	Moldova
140	535	Monaco
141	337	Mongolia
142	252	Monserrat
143	561	Montenegro
144	121	Mozambique
145	326	Myanmar (Ex Birmania)
146	159	Namibia
147	402	Nauru
148	320	Nepal
149	212	Nicaragua
150	131	Niger
151	111	Nigeria
152	421	Niue
153	513	Noruega
154	423	Nueva Caledonia
155	405	Nueva Zelandia
156	304	Oman
157	324	Pakistan
158	322	Palestina
159	210	Panama
160	412	Papua, Nueva Guinea
161	222	Paraguay
162	219	Peru
163	422	Polinesia Francesa
164	528	Polonia
165	501	Portugal
166	251	Puerto Rico
167	312	Qatar
168	510	Reino Unido
169	148	Republica Centro Africana
170	544	Republica Checa
171	546	Republica De Serbia
172	346	Republica De Yemen
173	143	Republica Democratica Del Congo
174	206	Republica Dominicana
175	545	Republica Eslovaca
176	519	Rumania
177	562	Rusia
178	142	Rwanda
179	165	Sahara Occidental
180	241	Saint Kitts & Nevis
181	404	Samoa Occidental
182	536	San Marino
183	234	San Vicente Y Las Granadinas
184	233	Santa Lucia (Islas Occidentales)
185	524	Santa Sede
186	146	Sao Tome Y Principe
187	101	Senegal
188	156	Seychelles
189	105	Sierra Leona
190	332	Singapur
191	310	Siria
192	138	Somalia
193	314	Sri Lanka
194	112	Sudafrica
195	123	Sudan
196	160	Sudan Del Sur
197	511	Suecia
198	508	Suiza
199	235	Surinam
200	122	Swazilandia
201	557	Tadjikistan
202	330	Taiwan
203	135	Tanzania
204	151	Territorio Británico En Africa
205	227	Territorio Británico En America
206	407	Territorio Británico En Oceania Y El Pacifico
207	230	Territorio De Dinamarca
208	152	Territorio Español En Africa
209	153	Territorio Frances En Africa
210	228	Territorio Frances En America
211	408	Territorio Frances En Oceania Y El Pacifico
212	229	Territorio Holandes En America
213	409	Territorio Norteamericano En Oceania Y El Pacifico
214	343	Territorio Portugues En Asia
215	319	Thailandia
216	426	Timor Oriental
217	109	Togo
218	203	Trinidad Y Tobago
219	126	Tunez
220	248	Turcas Y Caicos
221	558	Turkmenistan
222	522	Turquia
223	419	Tuvalu
224	559	Ucrania
225	136	Uganda
226	223	Uruguay
227	560	Uzbekistan
228	415	Vanuatu
229	201	Venezuela
230	325	Vietnam
231	117	Zambia
232	116	Zimbabwe
233	902	Aprovisionamiento De Naves Y Aeronaves Extranjeras Y De Maderas Para Estibar Mercancías Cargadas En Puertos Chilenos
234	901	Combustibles Y Lubricantes Destinados Al Consumo De Naves Y Aeronaves Extranjeras Y De Revistas Con El Mismo Objeto
235	906	Depósito Franco
236	998	Nacional Reputada
237	904	Orígenes O Destinaciones No Precisadas Por Razones Comerciales O Militares
238	999	Otros (País Desconocido)
239	903	Pesca Extraterritorial
241	910	Zona Franca Arica, Zona Industrial
242	905	Zona Franca Iquique
243	907	Zona Franca Punta Arenas

Factura y Administración API de Integraciones (Nueva API)

Información sobre Nueva API Factura y Administración de Nubox

Información sobre Antigua API Factura Electrónica

Resumen técnico

Sobre la API

Tipos de Documentos soportados

Sobre la Obtención de Documentos

Sobre el Proceso de Emisión y Gestión

Modelo de Autenticación

Authorization – Token del Partner

X-Api-Key - Key de la Empresa Cliente

URLs de Ambientes: Certificación y Productivo

Disponibilidad de Ambiente de Certificación

Obtención de Credenciales para Pruebas (UAT)

Paso 1: Solicita tus Credenciales

Paso 2: Recibe tus Claves de Acceso

Paso 3: Utiliza nuestra colección de Postman

¿Cómo configurar la colección?

Obtención de Credenciales Productivas

Endpoints disponibles en la API

Ejemplo de uso de endpoints

Emisión de Documentos

Endpoint

Headers a enviar:

Parámetros requeridos:

Request Body

Ejemplo de json en el body con 2 documentos

Posibles respuestas a la solicitud (application/json):

207: Multi-Status

400 Bad Request:

500: Internal Server Error:

Obtener XML de un Documento

Endpoint

Headers a enviar:

Parámetros requeridos:

Posibles respuestas a la solicitud (application/xml ó application/json ):

200 OK:

400 Bad Request:

500: Internal Server Error

404: Not Found

Obtener PDF de un Documento

Endpoint

Headers a enviar:

Parámetros requeridos:

Posibles respuestas a la solicitud (application/pdf):

200 OK:

400 Bad Request:

500: Internal Server Error

404:Not Found

Obtener Ventas

Endpoint

Headers a enviar:

Parámetros a enviar:

Posibles respuestas a la solicitud (application/json):

200 OK:

204 No Content:

400 Bad Request:

500: Internal Server Error

404 Not Found

Obtener venta

Endpoint

Headers a enviar:

Parámetros a enviar:

Posibles respuestas a la solicitud (application/json):

200 OK:

400 Bad Request:

500 Internal Server Error

404: Not Found

Obtener Detalle de Productos de Venta

Endpoint

Headers a enviar:

Parámetros a enviar:

Posibles respuestas a la solicitud (application/json):

200 OK:

400 Bad Request:

500 Internal Server Error

404 Not Found

Obtener documentos referenciados

Endpoint

Headers a enviar: