# Introducción
Esta es la documentación oficial de nuestra API Facturación Electrónica
## API Legacy Facturación Electrónica
Con la **API de Facturación Electrónica de Aliaddo** dispondrás de las funcionalidades de nuestra aplicación para integrarlas a tu software. Nuestra API está basada en **REST**, por lo que los datos serán codificados siempre como tipo `JSON`.
Nuestra API puede ser usada de tres formas, en **modo habilitación, modo pruebas** y en **modo producción**, dependiendo del endpoint que uses.
### **Modo Habilitación**
El **modo habilitación** se usa para pruebas y para que la DIAN te habilite como facturador electrónico.
{% hint style="info" %}
Es importante contar con el `testSetId` que te proporcionará la DIAN para hacer tus pruebas, en el ejemplo se encuentra al final de la ruta.
{% endhint %}
**Ejemplo:**
`https://isv.aliaddo.net/api/v1/public/documents/invoice/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca`
### Modo Pruebas
El **modo pruebas** se usa para emitir facturas ficticias a la API con el fin de corroborar el funcionamiento de esta y también para verificar que la estructura y los datos de tus objetos se encuentren correctamente construidos.
**Ejemplo:**
`https://isv.aliaddo.net/api/v1/public/documents/invoice/test`
### Modo Producción
El **modo producción** se usa para enviar documentos oficialmente a la DIAN después de haber sido habilitado como facturador electrónico.
**Ejemplo:**
`https://isv.aliaddo.net/api/v1/public/documents/invoice`
### Métodos HTTP
Estos son los métodos que se usan en nuestra API.
| Método | Función |
| ------ | -------------------- |
| GET | Trae uno más objetos |
| POST | Crea un objeto |
| PUT | Modifica un objeto |
{% hint style="warning" %}
Por favor revise la siguiente sección: [***Consideraciones Importantes***](/primeros-pasos/consideraciones)
{% endhint %}
## Archivo Plano
Al final de esta documentación encontrarás como importar documentos por medio de archivo plano delimitado por punto y coma.
{% content-ref url="/pages/-M04TPz-Lj20QYo2ZXAc" %}
[Archivo Plano (.CSV)](/archivo-plano-.csv/consideraciones-sobre-el-archivo-plano)
{% endcontent-ref %}
> Made with 🧡
# Cuotas y límites
Las siguientes operaciones tienen limitaciones en cuanto a la frecuencia con que puedes realizarlas.
| Modalidad | Límite |
| ------------- | -------------------------------------------------------------- |
| API Rest | 2.500 Llamadas (requests)/día y 100 Llamadas (requests)/minuto |
| Archivo plano | 1.000 facturas/archivo y 5.000 facturas/día |
{% hint style="info" %}
Si requieres infraestructura con más capacidad de procesamiento solicita una cotización ajustada a tus necesidades puntuales.
{% endhint %}
# Consideraciones Importantes
Algunas cosas que debes tener en cuenta para usar nuestra API
### **Para que el uso de nuestra API sea óptimo debes tener en cuenta lo siguiente:**
* El **tamaño máximo del archivo XML** resultante debe ser menor a **500KB.** Si tu archivo supera este tamaño **deberás dividir el mismo en varias facturas**.
* El endpoint para todos los métodos es `https://isv.aliaddo.net/api/v1/public/documents`
* Deberás generar una **API KEY de autenticación** en nuestro [***Portal ISV***](https://isv.nubixar.com/login) y reemplazarlo en el código de ejemplo donde se encuentra `{{x-api-key}}`
* Las consultas `GET` son independientes del modo en que estés usando la API **(Habilitación, pruebas o producción)**.
* Los documentos no pueden tener una fecha anterior al día en el que son emitidos, en caso de ser así, serán rechazados.
* Ten en cuenta que los archivos PDF y XML generados en nuestra plataforma son de carácter temporal y se realiza eliminación de los mismos periódicamente.
* El consecutivo debe encontrarse dentro del rango de la resolución.
* Los campos que tienen un valor vacío `""` o el valor cero `0` son campos con valores opcionales.
* Los campos con valores numéricos obligatorios y opcionales deben cómo mínimo tener un cero `0` ya que estos campos no pueden estar vacíos.
* Verifica tener las librerías o dependencias adecuadas.
* Las fechas tienen el formato **`AAAA-MM-DD`**
* Las fechas también pueden contener horas con el formato **`AAAA-MM-DDTHH:MM:SS±hhmm`**
* Tenga en cuenta que si va a realizar descuentos o cargos sobre la **factura en general** no se pueden realizar sobre el **detalle o sobre cada producto o servicio facturado**.
* Los campos que requieren de un código pueden ser consultados [***aquí***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos).
* Si encuentras inconsistencias en esta documentación o códigos de error desconocidos por favor infórmanos [***aquí***](https://aliaddo.freshdesk.com).
* Es posible que al enviar una factura sea devuelto un error *500* con el mensaje `Service Unavaliable` en el atributo `dianStateReason` y el código `error` en el atributo `dianDeliveryStatus`, esto indica que el servicio de la DIAN está temporalmente no disponible, deberás re intentar el envío de la factura con el método que usaste primeramente en intervalos de 20 segundos. \
Se mostrará de esta manera: \
`"dianStateReason": ["One or more errors ocurred. Service Unavaliable"]` \
`"dianDeliveryStatus": "error"`\
O puede que se muestre así\
`"dianStateReason": ["One or more errors ocurred. Internal Server Error"]`\
`"dianDeliveryStatus": "error"`
* Sólo en caso de que `"dianDeliveryStatus": "new"` ó `"dianDeliveryStatus": "error"` se podrá volver a enviar el documento con el método `POST` para crear.
* Nuestro software realiza una serie de validaciones previas al procesamiento que realiza la DIAN, si una de estas validaciones es alcanzada se devolverá un error *500* con un cuerpo donde se explican los errores para que se hagan las respectivas correcciones.
# Manual Operativo de la Plataforma
## Ingreso a la plataforma
Para ingresar a la plataforma debes utilizar tu correo o nombre de usuario y tu contraseña asignada, es recomendable que en el primer ingreso cambies la contraseña.
Luego deberás seleccionar tu empresa:
A continuación encontrarás una página cómo la siguiente:
## Interacción con la plataforma
Ahora veremos las funcionalidades de la plataforma en dos partes, la parte superior (Encabezado) y la parte inferior (Menú y contenido)
### Encabezado
El encabezado se divide en las siguientes opciones:
1. **Selector de empresa:** Buscador que te permite seleccionar la empresa con la que vas a interactuar, es importante seleccionar una empresa antes de realizar cualquier operación o consulta en la plataforma.
2. **Botón de api key:** Permite consultar el **x-api-key** asociado a tu empresa:
3\. **Botón de crear empresa:** Te permite crear una nueva empresa, te redireccionará a este formulario en el que deberás ingresar los datos de la nueva empresa:
4\. **Menú de usuario:** Permite interactuar con las opciones de tu usuario personal:\
a. **Empresas:** Consultar las empresas vinculadas a tu usuario.\
b. **Plan y Facturación:** Consulta el pan que tienes adquirido actualmente y el historial de comprobantes de pago.\
c. **Cambiar contraseña:** Permite cambiar tu contraseña.\
d. **Documentación Swagger:** Redirige a la documentación de swagger.\
e. **Documentación API:** Redirige a la documentación de la API.\
f. **Cerrar sesión:** Finalizar la sesión actual, redirige al inicio de sesión.
### **Menú y contenido**
El menú cuenta con las siguientes opciones:
1. **Dashboard:** Permite ver el flujo de documentos de la plataforma por medio de gráficos:
2\. **Log documentos:** Historial de documentos procesados por la api, cuenta con los registros de todos los documentos: Facturas, Notas crédito, Notas débito, Nómina, Notas de reemplazo de nómina y Notas de eliminación de nómina.
### Facturas, notas crédito y débito
Cada uno de estos documentos puede ser consultado por uno de estos tres criterios de búsqueda: **Por fecha, Por consecutivo o por Estado**
Los documentos cuentan con las siguientes acciones de interacción:
**Botón de acciones:** Permite visualizar y/o descargar el documento en los formatos listados
**ID:** Copia el ID del documento al portapapeles
**Cufe:** Copia el cufe al portapapeles
**JSON:** Muestra el documento en formato JSON
**Avión de papel:** Muestra el historial de acciones del envío del documento
**DIAN:** Muestra detalladamente el mensaje de respuesta de la DIAN
### Comprobantes de nómina
Estos documentos pueden ser filtrados en dos categorías, por el período o por un empleado específico:
Los documentos de nómina cuentan con las siguientes acciones de interacción:
**Botón de acciones:** Permite visualizar y/o descargar el documento en los formatos listados
**ID:** Copia el ID del documento al portapapeles
**Cufe:** Copia el cufe al portapapeles
**Número:** Muestra el número del documento
**Ambiente:** Indica el ambiente al que fue enviado el documento, puede ser: Pruebas, Habilitación o Producción
**DIAN:** Muestra detalladamente el mensaje de respuesta de la DIAN
3\. **Logo:** Permite subir el logo de la empresa y eliminarlo
4\. **Resoluciones:** Consultar las resoluciones agregadas en el portal de la DIAN para facturar, el botón **JSON** muestra la resolución en formato JSON.
5\. **Empresa:** Permite visualizar los datos de la empresa, editarlos y copiar o generar la api key.
6\. **Firma:** Permite subir el archivo de la firma electrónica que debe ir con la contraseña asignada
7\. **Importar Facturas:** Permite importar y ver el historial de facturas
La **modalidad** indica para qué ambiente serán enviadas las facturas: Producción, habilitación, pruebas. Adicionalmente indica qué se hará con ellas en las opciones de **Acción**: Crear o actualizar los documentos.
El **log de archivos importados** indica el registro de las facturas filtrado con las opciones en la parte superior, funciona cómo el log de documentos mencionado más arriba.
8\. **Importar Notas Débito:** Permite importar notas débito, funciona igual que **Importar Facturas.**
9\. **Importar Notas Crédito**: Permite importar notas crédito, funciona igual que **Importar Facturas.**
10\. **Usuarios:** Listado de usuarios que tienen acceso a la plataforma. Permite agregar o editar a los usuarios.
# Generar X-API-KEY
Esta sección te explica como generar la x-api-key o token de autenticación.
### Autenticación
Para generar el token de autenticación o x-api-key sigue estos pasos:
1.Ingresa a **Aliaddo ISV** y selecciona tu empresa.
2\. Accede a la sección ***Empresa*** desde el menú de la parte izquierda*.*
3\. Genera el token en el botón ***GENERAR API KEY*** de la parte inferior según el servicio que requieras, Facturación electrónica o nómina electrónica.
4\. ¡Listo! Tu token ya ha sido generado, lo puedes copiar con el botón ***COPIAR LLAVE API*** en la parte izquierda*.*
# Librerías
Estas son las librerías que deberás agregar a tu proyecto.
{% hint style="info" %}
Selecciona el lenguaje de tu preferencia y da clic en el nombre de la librería para acceder a su página oficial.
{% endhint %}
{% tabs %}
{% tab title="C#" %}
1. [*RestSharp*](http://restsharp.org/)
2. [*JSON*](https://www.newtonsoft.com/json)
{% endtab %}
{% tab title="Javascript" %}
1. Fetch (Nativa)
{% endtab %}
{% tab title="Java" %}
1. [*Unirest*](http://kong.github.io/unirest-java/)
2. [*GSON*](https://github.com/google/gson)
{% endtab %}
{% tab title="PHP" %}
1. [*CURL*](https://www.php.net/manual/es/curl.installation.php)
{% endtab %}
{% tab title="Python" %}
1. [*Requests*](https://requests.kennethreitz.org/en/master/)
{% endtab %}
{% tab title="Ruby" %}
1. [*Rest-client*](https://github.com/rest-client/rest-client)
{% endtab %}
{% endtabs %}
# Estructura de los datos
En este apartado podrás ver la estructura de los campos que componen los objetos que van a ser enviados. Por favor ten en cuenta las siguientes consideraciones:
{% hint style="info" %}
Los campos están en el mismo orden en el que se deben enviar. Mira los [***códigos de ejemplo***](/habilitacion/facturas/enviar-una-factura-para-set-de-pruebas).
{% endhint %}
{% hint style="info" %}
Los campos con el tipo **Array** son, por lo general, arreglos de objetos.
{% endhint %}
{% hint style="info" %}
Los campos con la **longitud** vacía no tienen un límite de esta.
{% endhint %}
{% hint style="warning" %}
**IMPORTANTE,** en caso de que la empresa integradora sea persona natural:
* El campo `companyName` debe contener el nombre de la persona natural. (En caso de que la empresa sea persona jurídica, los campos`firstName` y`lastName`no son requeridos)
* El campo`digitCheck`(Dígito de verificación) no es requerido debido a que la empresa no es persona jurídica.
* El campo `merchantRegistration` no es requerido.
{% endhint %}
{% content-ref url="/pages/-Lzc6mfUdp8RL\_\_J10IZ" %}
[Listas de códigos](/primeros-pasos/estructura-de-los-datos/listas-de-codigos)
{% endcontent-ref %}
{% content-ref url="/pages/-LrtDqdtfOpFlzs68t8e" %}
[Factura](/primeros-pasos/estructura-de-los-datos/factura)
{% endcontent-ref %}
{% content-ref url="/pages/-LrtDqE8uR72ID59rijw" %}
[Nota débito](/primeros-pasos/estructura-de-los-datos/nota-debito)
{% endcontent-ref %}
{% content-ref url="/pages/-LrtDpdPh1jG\_KFbpx31" %}
[Nota crédito](/primeros-pasos/estructura-de-los-datos/nota-credito)
{% endcontent-ref %}
# Listas de códigos
## Códigos ¿Para qué?
Los códigos se utilizan para referenciar una propiedad o valor de una forma más concreta y simplificada.
En esta sección podrás encontrar las **listas de códigos y opciones** de cada una de las propiedades de los objetos que requieren un código o valor específico para indicar una opción. \
\
**Por ejemplo:**
La propiedad `concept` de el objeto `isvInvoiceNoteDb`(Nota débito) requiere indicar el tipo de concepto por el cuál se hace la nota débito, estos tipos, debido a su naturaleza predeterminada han sido "simplificados" en la siguiente serie de códigos:
> 1: Intereses
>
> 2: Gastos por cobrar
>
> 3: Cambio del valor
>
> 4: Otro
Esto resulta más cómodo al establecer los valores del objeto. Por lo tanto, la propiedad `concept` debe tener cómo valor uno de los ítems mencionados anteriormente, así que si el concepto de la nota débito es **Gastos por cobrar** se indicaría de la siguiente manera:
```javascript
{
"format": "Estandar",
"emailSender": "",
"concept": "2", // Nótese el código para indicar que el concepto es "Gastos por cobrar"
"consecutive": 990000012,
// ...
```
# Responsable de
| Código | Significado |
| ------ | ----------- |
| 01 | IVA |
| 04 | INC |
| ZA | IVA e INC |
| ZZ | No aplica\* |
{% hint style="info" %}
\*Se utiliza en los casos donde el Emisor/Adquiriente no cuente con los detalles tributarios informados en los primeros tres códigos, aplica para personas jurídicas, naturales y consumidor final
{% endhint %}
# Campos generales (Facturas, notas)
A continuación están listados los códigos y opciones que se presentan en los objetos de factura, notas crédito y notas débito.
{% tabs %}
{% tab title="Factura" %}
| Propiedad | Códigos / Opciones | Descripción |
| :-------------------------------------------------------------------------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| code | 01: Factura de venta nacional
02: Factura de exportación
03: Factura por contigencia facturador
04: Factura por contigencia DIAN
| Tipo de documento factura DIAN |
| format | Estandar
Azul
Continental
Indigo
FacturaExportacion
MediaCarta
| Formato PDF |
| currencyCode | [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-moneda) | Códigos de moneda |
| typeOfOperation | 09: AIU
10: Estándar
11: Mandatos
| Tipo de operación |
| dueDiligence | 01: Debida diligencia del cliente – DDC general
| Debida Diligencia |
| incoterms
(Requerido al exportar)
| CFR: Costo y flete
CIF: Costo, flete y seguro
CIP: Transporte y Seguro Pagados hasta
CPT: Transporte Pagado Hasta
DAP: Entregado en un Lugar
DAT: Entregado en Terminal
DDP: Entregado con Pago de Derechos
EXW: En Fábrica
FAS: Franco al costado del buque
FCA: Franco transportista
FOB: Franco a bordo
| Código de condición de entrega |
| paymentMeanCode | [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-forma-de-pago) | Medio de pago |
| personType | 1: Para personas jurídicas
2: Para personas naturales
| Tipo de persona |
| regimeType | 48: Responsable del impueto sobre las ventas IVA
49: No responsable de IVA
| Tipo de régimen |
| identificationTypeCode
(customer, mandante)
| 11: Registro civil
12: Tarjeta de identidad
13: Cédula de ciudadanía
21: Tarjeta de extranjería
22: Cédula de extranjería.
31: NIT
41: Pasaporte
42: Documento de identificación extranjero
47: Permiso especial de permanencia
48: Permiso protección temporal
50: NIT de otro país
91: NUIP
| Tipo de identificación |
| responsibilities | O-13: Gran contribuyente
O-15: Autorretenedor
O-23: Agente de retención IVA
O-47: Régimen simple de tributación
R-99-PN: No responsable
| Responsabilidad fiscal |
| economicActivities | [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-actividades-economicas) | Actividades económicas |
| countryName /
billingCountryName /
shippingCountryName
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-pais) | Nombre del país |
| countryCode /
billingCountryCode /
shippingCountryCode
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-pais) | Código del país |
| departamentName /
billingRegionName /
shippingRegionName
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-region) | Nombre de la región / departamento |
| departamentCode /
billingRegionCode /
shippingRegionCode
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-region) | Código de la región / departamento |
| cityName /
billingCityName /
shippingCityName
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-ciudad) | Nombre de la ciudad |
| cityCode /
billingCityCode /
shippingCityCode
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-ciudad) | Código de la ciudad |
| standardType | 001: UNSPSC
010: GTIN
020: Partida Arancelaria
999: Estándar de adopción del contribuyente
| Tipo estándar DIAN |
| standardCode | Código de acuerdo con el tipo estándar | Código del tipo estándar |
| unitMeasurementCode | [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-unidades-de-medida) | Código de unidades de medida |
| unitMeasurementName | [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-unidades-de-medida) | Nombre de unidades de medida |
| type
| P: Porcentaje
V: Valor fijo
Si es tipo “F” fijo, en tarifa y valor debe ir el mismo valor en “rate” y “amount” Ejemplo { "type": "V", Esto es por cada unidad "rate": 10, Debe ir lo mismo valor de amount "amount": 10 Debe ir el mismo valor de rate }
| Tipo de valor (Descuentos, cargos) |
| type
| F: Valor fijo
P: Porcentaje
M: Tarifa x 1000
| Tipo de valor
|
| code
| 01: IVA
02: IC
03: ICA
04: INC
05: ReteIVA
06: ReteRenta
07: ReteICA
08: ICPorcentual
20: FtoHorticultura
21: Timbre
22: Bolsas
23: INCarbono
24: INCombustibles
25: Sobretasa Combustibles
26: Sordicom
ZZ: Nombre de la figura tributaria
| Código de tipo de impuesto |
| remmitanceMeasurementUnit | KGM: Kilogramos
| Unidad de medida de la carga transportada, aplica únicamente si es un servicio de remesa (Sector de transporte) |
| {% endtab %} | | |
{% tab title="Nota débito" %}
| Propiedad | Códigos / Opciones | Descripción |
| :-------------------------------------------------------------------------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| format | Estandar
Azul
Continental
Indigo
FacturaExportacion
MediaCarta
| Formato del documento |
| concept | 1: Intereses
2: Gastos por cobrar
3: Cambio del valor
4: Otro
| Concepto de la nota |
| currencyCode | [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-moneda) | Código de moneda |
| typeOfOperation | 30: Nota Débito que referencia una factura.
32: Nota Débito sin referencia a facturas.
| Tipo de operación |
| personType | 1: Para personas jurídicas
2: Para personas naturales
| Tipo de persona |
| regimeType | 48: Responsable del impueto sobre las ventas IVA
49: No responsable de IVA
| Tipo de régimen |
| identificationTypeCode
(customer, mandante)
| 11: Registro civil
12: Tarjeta de identidad
13: Cédula de ciudadanía
21: Tarjeta de extranjería
22: Cédula de extranjería.
31: NIT
41: Pasaporte
42: Documento de identificación extranjero
50: NIT de otro país
91: NUIP
| Tipo de identificación |
| responsibilities | O-13: Gran contribuyente
O-15: Autorretenedor
O-23: Agente de retención IVA
O-47: Régimen simple de tributación
R-99-PN: No responsable
| Responsabilidad fiscal |
| economicActivities | [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-actividades-economicas) | Actividades económicas |
| countryName /
billingCountryName /
shippingCountryName
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-pais) | Nombre del país |
| countryCode /
billingCountryCode /
shippingCountryCode
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-pais) | Código del país |
| departamentName /
billingRegionName /
shippingRegionName
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-region) | Nombre de la región / departamento |
| departamentCode /
billingRegionCode /
shippingRegionCode
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-region) | Código de la región / departamento |
| cityName /
billingCityName /
shippingCityName
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-ciudad) | Nombre de la ciudad |
| cityCode /
billingCityCode /
shippingCityCode
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-ciudad) | Código de la ciudad |
| standardType | 001: UNSPSC
010: GTIN
020: Partida Arancelaria
999: Estándar de adopción del contribuyente
| Tipo estándar DIAN |
| standardCode | Código de acuerdo con el tipo estándar | Código del tipo estándar |
| unitMeasurementCode | [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-unidades-de-medida) | Código de unidades de medida |
| unitMeasurementName | [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-unidades-de-medida) | Nombre de unidades de medida |
| type
| P: Porcentaje
V: Valor fijo
Si es tipo “F” fijo, en tarifa y valor debe ir el mismo valor en “rate” y “amount” Ejemplo { "type": "V", Esto es por cada unidad "rate": 10, Debe ir lo mismo valor de amount "amount": 10 Debe ir el mismo valor de rate }
| Tipo de valor (Descuentos, cargos) |
| type
| F: Valor fijo
P: Porcentaje
M: Tarifa x 1000
| Tipo de valor
|
| code
| 01: IVA
02: IC
03: ICA
04: INC
05: ReteIVA
06: ReteRenta
07: ReteICA
08: ICPorcentual
20: FtoHorticultura
21: Timbre
22: Bolsas
23: INCarbono
24: INCombustibles
25: Sobretasa Combustibles
26: Sordicom
ZZ: Nombre de la figura tributaria
| Código de tipo de impuesto |
| {% endtab %} | | |
{% tab title="Nota crédito" %}
| Propiedad | Códigos / Opciones | Descripción |
| :-------------------------------------------------------------------------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| format | Estandar
Azul
Continental
Indigo
FacturaExportacion
MediaCarta
| Formato del documento |
| concept | 1: Devolución de parte de los bienes; no aceptación de partes del servicio
2: Anulación de factura electrónica
3: Rebaja total aplicada
4: Descuento total aplicado
5: Rescisión: nulidad por falta de requisitos
6: Otros
| Formato PDF |
| currencyCode | [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-moneda) | Códigos de moneda |
| typeOfOperation | 20: Nota Crédito que referencia una factura.
22: Nota Crédito sin referencia a facturas.
| Tipo de operación |
| personType | 1: Para personas jurídicas
2: Para personas naturales
| Tipo de persona |
| regimeType | 48: Responsable del impueto sobre las ventas IVA
49: No responsable de IVA
| Tipo de régimen |
| identificationTypeCode
(customer, mandante)
| 11: Registro civil
12: Tarjeta de identidad
13: Cédula de ciudadanía
21: Tarjeta de extranjería
22: Cédula de extranjería.
31: NIT
41: Pasaporte
42: Documento de identificación extranjero
50: NIT de otro país
91: NUIP
| Tipo de identificación |
| responsibilities | O-13: Gran contribuyente
O-15: Autorretenedor
O-23: Agente de retención IVA
O-47: Régimen simple de tributación
R-99-PN: No responsable
| Responsabilidad fiscal |
| economicActivities | [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-actividades-economicas) | Actividades económicas |
| countryName /
billingCountryName /
shippingCountryName
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-pais) | Nombre del país |
| countryCode /
billingCountryCode /
shippingCountryCode
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-pais) | Código del país |
| departamentName /
billingRegionName /
shippingRegionName
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-region) | Nombre de la región / departamento |
| departamentCode /
billingRegionCode /
shippingRegionCode
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-region) | Código de la región / departamento |
| cityName /
billingCityName /
shippingCityName
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-ciudad) | Nombre de la ciudad |
| cityCode /
billingCityCode /
shippingCityCode
| [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-ciudad) | Código de la ciudad |
| standardType | 001: UNSPSC
010: GTIN
020: Partida Arancelaria
999: Estándar de adopción del contribuyente
| Tipo estándar DIAN |
| standardCode | Código de acuerdo con el tipo estándar | Código del tipo estándar |
| unitMeasurementCode | [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-unidades-de-medida) | Código de unidades de medida |
| unitMeasurementName | [***Ver códigos***](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/codigos-de-unidades-de-medida) | Nombre de unidades de medida |
| type
| P: Porcentaje
V: Valor fijo
Si es tipo “F” fijo, en tarifa y valor debe ir el mismo valor en “rate” y “amount” Ejemplo { "type": "V", Esto es por cada unidad "rate": 10, Debe ir lo mismo valor de amount "amount": 10 Debe ir el mismo valor de rate }
| Tipo de valor (Descuentos, cargos) |
| type
| F: Valor fijo
P: Porcentaje
M: Tarifa x 1000
| Tipo de valor
|
| code
| 01: IVA
02: IC
03: ICA
04: INC
05: ReteIVA
06: ReteRenta
07: ReteICA
08: ICPorcentual
20: FtoHorticultura
21: Timbre
22: Bolsas
23: INCarbono
24: INCombustibles
25: Sobretasa Combustibles
26: Sordicom
ZZ: Nombre de la figura tributaria
| Código de tipo de impuesto |
| {% endtab %} | | |
| {% endtabs %} | | |
# Códigos de moneda
### Listas de códigos de moneda:
| Código | Valor |
| :----: | --------------------------------------------------------------------- |
| AED | Dírham de los Emiratos Árabes Unidos |
| AFN | Afgani |
| ALL | Lek |
| AMD | Dram armenio |
| ANG | Florín antillano neerlandés |
| AOA | Kwanza |
| ARS | Peso argentino |
| AUD | Dólar australiano |
| AWG | Florín arubeño |
| AZN | Manat azerbaiyano |
| BAM | Marco convertible |
| BBD | Dólar de Barbados |
| BDT | Taka |
| BGN | Lev búlgaro |
| BHD | Dinar bareiní |
| BIF | Franco de Burundi |
| BMD | Dólar bermudeño |
| BND | Dólar de Brunéi |
| BOB | Boliviano |
| BOV | MVDOL |
| BRL | Real brasileño |
| BSD | Dólar bahameño |
| BTN | Ngultrum |
| BWP | Pula |
| BYR | Rublo bielorruso |
| BZD | Dólar beliceño |
| CAD | Dólar canadiense |
| CDF | Franco congoleño |
| CHE | Euro WIR |
| CHF | Franco suizo |
| CHW | Franco WIR |
| CLF | Unidad de fomento |
| CLP | Peso chileno |
| CNY | Yuan chino |
| COP | Peso colombiano |
| COU | Unidad de valor real |
| CRC | Colón costarricense |
| CUC | Peso convertible |
| CUP | Peso cubano |
| CVE | Escudo caboverdiano |
| CZK | Corona checa |
| DJF | Franco yibutiano |
| DKK | Corona danesa |
| DOP | Peso dominicano |
| DZD | Dinar argelino |
| EGP | Libra egipcia |
| ERN | Nakfa |
| ETB | Birr etíope |
| EUR | Euro |
| FJD | Dólar fiyiano |
| FKP | Libra malvinense |
| GBP | Libra esterlina |
| GEL | Lari |
| GHS | Cedi ghanés |
| GIP | Libra de Gibraltar |
| GMD | Dalasi |
| GNF | Franco guineano |
| GTQ | Quetzal |
| GYD | Dólar guyanés |
| HKD | Dólar de Hong Kong |
| HNL | Lempira |
| HRK | Kuna |
| HTG | Gourde |
| HUF | Forinto |
| IDR | Rupia indonesia |
| ILS | Nuevo shéquel israelí |
| INR | Rupia india |
| IQD | Dinar iraquí |
| IRR | Rial iraní |
| ISK | Corona islandesa |
| JMD | Dólar jamaiquino |
| JOD | Dinar jordano |
| JPY | Yen |
| KES | Chelín keniano |
| KGS | Som |
| KHR | Riel |
| KMF | Franco comorense |
| KPW | Won norcoreano |
| KRW | Won |
| KWD | Dinar kuwaití |
| KYD | Dólar de las Islas Caimán |
| KZT | Tenge |
| LAK | Kip |
| LBP | Libra libanesa |
| LKR | Rupia de Sri Lanka |
| LRD | Dólar liberiano |
| LSL | Loti |
| LYD | Dinar libio |
| MAD | Dírham marroquí |
| MDL | Leu moldavo |
| MGA | Ariary malgache |
| MKD | Denar |
| MMK | Kyat |
| MNT | Tugrik |
| MOP | Pataca |
| MRO | Uguiya |
| MUR | Rupia de Mauricio |
| MVR | Rufiyaa |
| MWK | Kwacha |
| MXN | Peso mexicano |
| MXV | Unidad de Inversión (UDI) mexicana |
| MYR | Ringgit malayo |
| MZN | Metical mozambiqueño |
| NAD | Dólar namibio |
| NGN | Naira |
| NIO | Córdoba |
| NOK | Corona noruega |
| NPR | Rupia nepalí |
| NZD | Dólar neozelandés |
| OMR | Rial omaní |
| PAB | Balboa |
| PEN | Sol |
| PGK | Kina |
| PHP | Peso filipino |
| PKR | Rupia pakistaní |
| PLN | Złoty |
| PYG | Guaraní |
| QAR | Riyal qatarí |
| RON | Leu rumano |
| RSD | Dinar serbio |
| RUB | Rublo ruso |
| RWF | Franco ruandés |
| SAR | Riyal saudí |
| SBD | Dólar de las Islas Salomón |
| SCR | Rupia seychelense |
| SDG | Dinar sudanés |
| SEK | Corona sueca |
| SGD | Dólar de Singapur |
| SHP | Libra de Santa Elena |
| SLL | Leone |
| SOS | Chelín somalí |
| SRD | Dólar surinamés |
| SSP | Libra sursudanesa |
| STD | Dobra |
| SVC | Colon Salvadoreño |
| SYP | Libra siria |
| SZL | Lilangeni |
| THB | Baht |
| TJS | Somoni tayiko |
| TMT | Manat turcomano |
| TND | Dinar tunecino |
| TOP | Paʻanga |
| TRY | Lira turca |
| TTD | Dólar de Trinidad y Tobago |
| TWD | Nuevo dólar taiwanés |
| TZS | Chelín tanzano |
| UAH | Grivna |
| UGX | Chelín ugandés |
| USD | Dólar estadounidense |
| USN | Dólar estadounidense (Siguiente día) |
| UYI | Peso en Unidades Indexadas (Uruguay) |
| UYU | Peso uruguayo |
| UZS | Som uzbeko |
| VEF | Bolívar |
| VES7 | Bolívar soberano |
| VND | Dong vietnamita |
| VUV | Vatu |
| WST | Tala |
| XAF | Franco CFA de África Central |
| XAG | Plata (una onza troy) |
| XAU | Oro (una onza troy) |
| XBA | Unidad compuesta europea (EURCO) (Unidad del mercado de bonos) |
| XBB | Unidad Monetaria europea (E.M.U.-6) (Unidad del mercado de bonos) |
| XBC | Unidad europea de cuenta 9 (E.U.A.-9) (Unidad del mercado de bonos) |
| XBD | Unidad europea de cuenta 17 (E.U.A.-17) (Unidad del mercado de bonos) |
| XCD | Dólar del Caribe Oriental |
| XDR | Derechos especiales de giro |
| XOF | Franco CFA de África Occidental |
| XPD | Paladio (una onza troy) |
| XPF | Franco CFP |
| XPT | Platino (una onza troy) |
| XSU | SUCRE |
| XTS | Reservado para pruebas |
| XUA | Unidad de cuenta BAD |
| XXX | Sin divisa |
| YER | Rial yemení |
| ZAR | Rand |
| ZMW | Kwacha zambiano |
| ZWL | Dólar zimbabuense |
# Códigos de forma de pago
Lista de códigos para formas de pago.
| Código | Valor |
| :----: | ------------------------------------------------------------------------ |
| 1 | Instrumento no definido |
| 2 | Crédito ACH |
| 3 | Débito ACH |
| 4 | Reversión débito de demanda ACH |
| 5 | Reversión crédito de demanda ACH |
| 6 | Crédito de demanda ACH |
| 7 | Débito de demanda ACH |
| 8 | Mantener |
| 9 | Clearing Nacional o Regional |
| 10 | Efectivo |
| 11 | Reversión Crédito Ahorro |
| 12 | Reversión Débito Ahorro |
| 13 | Crédito Ahorro |
| 14 | Débito Ahorro |
| 15 | Bookentry Crédito |
| 16 | Bookentry Débito |
| 17 | Concentración de la demanda en efectivo /Desembolso Crédito (CCD) |
| 18 | Concentración de la demanda en efectivo / Desembolso (CCD) débito |
| 19 | Crédito Pago negocio corporativo (CTP) |
| 20 | Cheque |
| 21 | Poyecto bancario |
| 22 | Proyecto bancario certificado |
| 23 | Cheque bancario |
| 24 | Nota cambiaria esperando aceptación |
| 25 | Cheque certificado |
| 26 | Cheque Local |
| 27 | Débito Pago Neogcio Corporativo (CTP) |
| 28 | Crédito Negocio Intercambio Corporativo (CTX) |
| 29 | Débito Negocio Intercambio Corporativo (CTX) |
| 30 | Transferecia Crédito |
| 31 | Transferencia Débito |
| 32 | Concentración Efectivo / Desembolso Crédito plus (CCD+) |
| 33 | Concentración Efectivo / Desembolso Débito plus (CCD+) |
| 34 | Pago y depósito pre acordado (PPD) |
| 35 | Concentración efectivo ahorros / Desembolso Crédito (CCD) |
| 36 | Concentración efectivo ahorros / Desembolso Drédito (CCD) |
| 37 | Pago Negocio Corporativo Ahorros Crédito (CTP) |
| 38 | Pago Neogcio Corporativo Ahorros Débito (CTP) |
| 39 | Crédito Negocio Intercambio Corporativo (CTX) |
| 40 | Débito Negocio Intercambio Corporativo (CTX) |
| 41 | Concentración efectivo/Desembolso Crédito plus (CCD+) |
| 42 | Consiganción bancaria |
| 43 | Concentración efectivo / Desembolso Débito plus (CCD+) |
| 44 | Nota cambiaria |
| 45 | Transferencia Crédito Bancario |
| 46 | Transferencia Débito Interbancario |
| 47 | Transferencia Débito Bancaria |
| 48 | Tarjeta Crédito |
| 49 | Tarjeta Débito |
| 50 | Postgiro |
| 51 | Telex estándar bancario francés |
| 52 | Pago comercial urgente |
| 53 | Pago Tesorería Urgente |
| 60 | Nota promisoria |
| 61 | Nota promisoria firmada por el acreedor |
| 62 | Nota promisoria firmada por el acreedor: avalada por el banco |
| 63 | Nota promisoria firmada por el acreedor: avalada por un tercero |
| 64 | Nota promisoria firmada pro el banco |
| 65 | Nota promisoria firmada por un banco avalada por otro banco |
| 66 | Nota promisoria firmada |
| 67 | Nota promisoria firmada por un tercero avalada por un banco |
| 70 | Retiro de nota por el por el acreedor |
| 74 | Retiro de nota por el por el acreedor sobre un banco |
| 75 | Retiro de nota por el acreedor: avalada por otro banco |
| 76 | Retiro de nota por el acreedor: sobre un banco avalada por un tercero |
| 77 | Retiro de una nota por el acreedor sobre un tercero |
| 78 | Retiro de una nota por el acreedor sobre un tercero avalada por un banco |
| 91 | Nota bancaria tranferible |
| 92 | Cheque local traferible |
| 93 | Giro referenciado |
| 94 | Giro urgente |
| 95 | Giro formato abierto |
| 96 | Método de pago solicitado no usuado |
| 97 | Clearing entre partners |
| ZZZ | Acuerdo mutuo |
# Códigos de actividades económicas
### Clasificación de las actividades económicas
| Código | Actividad |
| :----: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 0111 | Cultivo de cereales (excepto arroz), legumbres y semillas oleaginosas |
| 0112 | Cultivo de arroz |
| 0113 | Cultivo de hortalizas, raíces y tubérculos |
| 0114 | Cultivo de tabaco |
| 0115 | Cultivo de plantas textiles |
| 0119 | Otros cultivos transitorios n.c.p. |
| 0121 | Cultivo de frutas tropicales y subtropicales |
| 0122 | Cultivo de plátano y banano |
| 0123 | Cultivo de café |
| 0124 | Cultivo de caña de azúcar |
| 0125 | Cultivo de flor de corte |
| 0126 | Cultivo de palma para aceite (palma africana) y otros frutos oleaginosos |
| 0127 | Cultivo de plantas con las que se preparan bebidas |
| 0128 | Cultivo de especias y de plantas aromáticas y medicinales |
| 0129 | Otros cultivos permanentes n.c.p. |
| 0130 | Propagación de plantas (actividades de los viveros, excepto viveros forestales) |
| 0141 | Cría de ganado bovino y bufalino |
| 0142 | Cría de caballos y otros equinos |
| 0143 | Cría de ovejas y cabras |
| 0144 | Cría de ganado porcino |
| 0145 | Cría de aves de corral |
| 0149 | Cría de otros animales n.c.p. |
| 0150 | Explotación mixta (agrícola y pecuaria) |
| 0161 | Actividades de apoyo a la agricultura |
| 0162 | Actividades de apoyo a la ganadería |
| 0163 | Actividades posteriores a la cosecha |
| 0164 | Tratamiento de semillas para propagación |
| 0170 | Caza ordinaria y mediante trampas y actividades de servicios conexas |
| 0210 | Silvicultura y otras actividades forestales |
| 0220 | Extracción de madera |
| 0230 | Recolección de productos forestales diferentes a la madera |
| 0240 | Servicios de apoyo a la silvicultura |
| 0311 | Pesca marítima |
| 0312 | Pesca de agua dulce |
| 0321 | Acuicultura marítima |
| 0322 | Acuicultura de agua dulce |
| 0510 | Extracción de hulla (carbón de piedra) |
| 0520 | Extracción de carbón lignito |
| 0610 | Extracción de petróleo crudo |
| 0620 | Extracción de gas natural |
| 0710 | Extracción de minerales de hierro |
| 0721 | Extracción de minerales de uranio y de torio |
| 0722 | Extracción de oro y otros metales preciosos |
| 0723 | Extracción de minerales de níquel |
| 0729 | Extracción de otros minerales metalíferos no ferrosos n.c.p. |
| 0811 | Extracción de piedra, arena, arcillas comunes, yeso y anhidrita |
| 0812 | Extracción de arcillas de uso industrial, caliza, caolín y bentonitas |
| 0820 | Extracción de esmeraldas, piedras preciosas y semipreciosas |
| 0891 | Extracción de minerales para la fabricación de abonos y productos químicos |
| 0892 | Extracción de halita (sal) |
| 0899 | Extracción de otros minerales no metálicos n.c.p. |
| 0910 | Actividades de apoyo para la extracción de petróleo y de gas natural |
| 0990 | Actividades de apoyo para otras actividades de explotación de minas y canteras |
| 1011 | Procesamiento y conservación de carne y productos cárnicos |
| 1012 | Procesamiento y conservación de pescados, crustáceos y moluscos |
| 1020 | Procesamiento y conservación de frutas, legumbres, hortalizas y tubérculos |
| 1030 | Elaboración de aceites y grasas de origen vegetal y animal |
| 1040 | Elaboración de productos lácteos |
| 1051 | Elaboración de productos de molinería |
| 1052 | Elaboración de almidones y productos derivados del almidón |
| 1061 | Trilla de café |
| 1062 | Descafeinado, tostión y molienda del café |
| 1063 | Otros derivados del café |
| 1071 | Elaboración y refinación de azúcar |
| 1072 | Elaboración de panela |
| 1081 | Elaboración de productos de panadería |
| 1082 | Elaboración de cacao, chocolate y productos de confitería |
| 1083 | Elaboración de macarrones, fideos, alcuzcuz y productos farináceos similares |
| 1084 | Elaboración de comidas y platos preparados |
| 1089 | Elaboración de otros productos alimenticios n.c.p. |
| 1090 | Elaboración de alimentos preparados para animales |
| 1101 | Destilación, rectificación y mezcla de bebidas alcohólicas |
| 1102 | Elaboración de bebidas fermentadas no destiladas |
| 1103 | Producción de malta, elaboración de cervezas y otras bebidas malteadas |
| 1104 | Elaboración de bebidas no alcohólicas, producción de aguas minerales y de otras aguas embotelladas |
| 1200 | Elaboración de productos de tabaco |
| 1311 | Preparación e hilatura de fibras textiles |
| 1312 | Tejeduría de productos textiles |
| 1313 | Acabado de productos textiles |
| 1391 | Fabricación de tejidos de punto y ganchillo |
| 1392 | Confección de artículos con materiales textiles, excepto prendas de vestir |
| 1393 | Fabricación de tapetes y alfombras para pisos |
| 1394 | Fabricación de cuerdas, cordeles, cables, bramantes y redes |
| 1399 | Fabricación de otros artículos textiles n.c.p. |
| 1410 | Confección de prendas de vestir, excepto prendas de piel |
| 1420 | Fabricación de artículos de piel |
| 1430 | Fabricación de artículos de punto y ganchillo |
| 1511 | Curtido y recurtido de cueros; recurtido y teñido de pieles |
| 1512 | Fabricación de artículos de viaje, bolsos de mano y artículos similares elaborados en cuero, y fabricación de artículos de talabartería y guarnicionería |
| 1513 | Fabricación de artículos de viaje, bolsos de mano y artículos similares; artículos de talabartería y guarnicionería elaborados en otros materiales |
| 1521 | Fabricación de calzado de cuero y piel, con cualquier tipo de suela |
| 1522 | Fabricación de otros tipos de calzado, excepto calzado de cuero y piel |
| 1523 | Fabricación de partes del calzado |
| 1610 | Aserrado, acepillado e impregnación de la madera |
| 1620 | Fabricación de hojas de madera para enchapado; fabricación de tableros contrachapados, tableros laminados, tableros de partículas y otros tableros y paneles |
| 1630 | Fabricación de partes y piezas de madera, de carpintería y ebanistería para la construcción |
| 1640 | Fabricación de recipientes de madera |
| 1690 | Fabricación de otros productos de madera; fabricación de artículos de corcho, cestería y espartería |
| 1701 | Fabricación de pulpas (pastas) celulósicas; papel y cartón |
| 1702 | Fabricación de papel y cartón ondulado (corrugado); fabricación de envases, empaques y de embalajes de papel y cartón. |
| 1709 | Fabricación de otros artículos de papel y cartón |
| 1811 | Actividades de impresión |
| 1812 | Actividades de servicios relacionados con la impresión |
| 1820 | Producción de copias a partir de grabaciones originales |
| 1910 | Fabricación de productos de hornos de coque |
| 1921 | Fabricación de productos de la refinación del petróleo |
| 1922 | Actividad de mezcla de combustibles |
| 2011 | Fabricación de sustancias y productos químicos básicos |
| 2012 | Fabricación de abonos y compuestos inorgánicos nitrogenados |
| 2013 | Fabricación de plásticos en formas primarias |
| 2014 | Fabricación de caucho sintético en formas primarias |
| 2021 | Fabricación de plaguicidas y otros productos químicos de uso agropecuario |
| 2022 | Fabricación de pinturas, barnices y revestimientos similares, tintas para impresión y masillas |
| 2023 | Fabricación de jabones y detergentes, preparados para limpiar y pulir; perfumes y preparados de tocador |
| 2029 | Fabricación de otros productos químicos n.c.p. |
| 2030 | Fabricación de fibras sintéticas y artificiales |
| 2100 | Fabricación de productos farmacéuticos, sustancias químicas medicinales y productos botánicos de uso farmacéutico |
| 2211 | Fabricación de llantas y neumáticos de caucho |
| 2212 | Reencauche de llantas usadas |
| 2219 | Fabricación de formas básicas de caucho y otros productos de caucho n.c.p. |
| 2221 | Fabricación de formas básicas de plástico |
| 2229 | Fabricación de artículos de plástico n.c.p. |
| 2310 | Fabricación de vidrio y productos de vidrio |
| 2391 | Fabricación de productos refractarios |
| 2392 | Fabricación de materiales de arcilla para la construcción |
| 2393 | Fabricación de otros productos de cerámica y porcelana |
| 2394 | Fabricación de cemento, cal y yeso |
| 2395 | Fabricación de artículos de hormigón, cemento y yeso |
| 2396 | Corte, tallado y acabado de la piedra |
| 2399 | Fabricación de otros productos minerales no metálicos n.c.p. |
| 2410 | Industrias básicas de hierro y de acero |
| 2421 | Industrias básicas de metales preciosos |
| 2429 | Industrias básicas de otros metales no ferrosos |
| 2431 | Fundición de hierro y de acero |
| 2432 | Fundición de metales no ferrosos |
| 2511 | Fabricación de productos metálicos para uso estructural |
| 2512 | Fabricación de tanques, depósitos y recipientes de metal, excepto los utilizados para el envase o transporte de mercancías |
| 2513 | Fabricación de generadores de vapor, excepto calderas de agua caliente para calefacción central |
| 2520 | Fabricación de armas y municiones |
| 2591 | Forja, prensado, estampado y laminado de metal; pulvimetalurgia |
| 2592 | Tratamiento y revestimiento de metales; mecanizado |
| 2593 | Fabricación de artículos de cuchillería, herramientas de mano y artículos de ferretería |
| 2599 | Fabricación de otros productos elaborados de metal n.c.p. |
| 2610 | Fabricación de componentes y tableros electrónicos |
| 2620 | Fabricación de computadoras y de equipo periférico |
| 2630 | Fabricación de equipos de comunicación |
| 2640 | Fabricación de aparatos electrónicos de consumo |
| 2651 | Fabricación de equipo de medición, prueba, navegación y control |
| 2652 | Fabricación de relojes |
| 2660 | Fabricación de equipo de irradiación y equipo electrónico de uso médico y terapéutico |
| 2670 | Fabricación de instrumentos ópticos y equipo fotográfico |
| 2680 | Fabricación de medios magnéticos y ópticos para almacenamiento de datos |
| 2711 | Fabricación de motores, generadores y transformadores eléctricos |
| 2712 | Fabricación de aparatos de distribución y control de la energía eléctrica |
| 2720 | Fabricación de pilas, baterías y acumuladores eléctricos |
| 2731 | Fabricación de hilos y cables eléctricos y de fibra óptica |
| 2732 | Fabricación de dispositivos de cableado |
| 2740 | Fabricación de equipos eléctricos de iluminación |
| 2750 | Fabricación de aparatos de uso doméstico |
| 2790 | Fabricación de otros tipos de equipo eléctrico n.c.p. |
| 2811 | Fabricación de motores, turbinas, y partes para motores de combustión interna |
| 2812 | Fabricación de equipos de potencia hidráulica y neumática |
| 2813 | Fabricación de otras bombas, compresores, grifos y válvulas |
| 2814 | Fabricación de cojinetes, engranajes, trenes de engranajes y piezas de transmisión |
| 2815 | Fabricación de hornos, hogares y quemadores industriales |
| 2816 | Fabricación de equipo de elevación y manipulación |
| 2817 | Fabricación de maquinaria y equipo de oficina (excepto computadoras y equipo periférico) |
| 2818 | Fabricación de herramientas manuales con motor |
| 2819 | Fabricación de otros tipos de maquinaria y equipo de uso general n.c.p. |
| 2821 | Fabricación de maquinaria agropecuaria y forestal |
| 2822 | Fabricación de máquinas formadoras de metal y de máquinas herramienta |
| 2823 | Fabricación de maquinaria para la metalurgia |
| 2824 | Fabricación de maquinaria para explotación de minas y canteras y para obras de construcción |
| 2825 | Fabricación de maquinaria para la elaboración de alimentos, bebidas y tabaco |
| 2826 | Fabricación de maquinaria para la elaboración de productos textiles, prendas de vestir y cueros |
| 2829 | Fabricación de otros tipos de maquinaria y equipo de uso especial n.c.p. |
| 2910 | Fabricación de vehículos automotores y sus motores |
| 2920 | Fabricación de carrocerías para vehículos automotores; fabricación de remolques y semirremolques |
| 2930 | Fabricación de partes, piezas (autopartes) y accesorios (lujos) para vehículos automotores |
| 3011 | Construcción de barcos y de estructuras flotantes |
| 3012 | Construcción de embarcaciones de recreo y deporte |
| 3020 | Fabricación de locomotoras y de material rodante para ferrocarriles |
| 3030 | Fabricación de aeronaves, naves espaciales y de maquinaria conexa |
| 3040 | Fabricación de vehículos militares de combate |
| 3091 | Fabricación de motocicletas |
| 3092 | Fabricación de bicicletas y de sillas de ruedas para personas con discapacidad |
| 3099 | Fabricación de otros tipos de equipo de transporte n.c.p. |
| 3110 | Fabricación de muebles |
| 3120 | Fabricación de colchones y somieres |
| 3210 | Fabricación de joyas, bisutería y artículos conexos |
| 3220 | Fabricación de instrumentos musicales |
| 3230 | Fabricación de artículos y equipo para la práctica del deporte |
| 3240 | Fabricación de juegos, juguetes y rompecabezas |
| 3250 | Fabricación de instrumentos, aparatos y materiales médicos y odontológicos (incluido mobiliario) |
| 3290 | Otras industrias manufactureras n.c.p. |
| 3311 | Mantenimiento y reparación especializado de productos elaborados en metal |
| 3312 | Mantenimiento y reparación especializado de maquinaria y equipo |
| 3313 | Mantenimiento y reparación especializado de equipo electrónico y óptico |
| 3314 | Mantenimiento y reparación especializado de equipo eléctrico |
| 3315 | Mantenimiento y reparación especializado de equipo de transporte, excepto los vehículos automotores, motocicletas y bicicletas |
| 3319 | Mantenimiento y reparación de otros tipos de equipos y sus componentes n.c.p. |
| 3320 | Instalación especializada de maquinaria y equipo industrial |
| 3511 | Generación de energía eléctrica |
| 3512 | Transmisión de energía eléctrica |
| 3513 | Distribución de energía eléctrica |
| 3514 | Comercialización de energía eléctrica |
| 3520 | Producción de gas; distribución de combustibles gaseosos por tuberías |
| 3530 | Suministro de vapor y aire acondicionado |
| 3600 | Captación, tratamiento y distribución de agua |
| 3700 | Evacuación y tratamiento de aguas residuales |
| 3811 | Recolección de desechos no peligrosos |
| 3812 | Recolección de desechos peligrosos |
| 3821 | Tratamiento y disposición de desechos no peligrosos |
| 3822 | Tratamiento y disposición de desechos peligrosos |
| 3830 | Recuperación de materiales |
| 3900 | Actividades de saneamiento ambiental y otros servicios de gestión de desechos |
| 4111 | Construcción de edificios residenciales |
| 4112 | Construcción de edificios no residenciales |
| 4210 | Construcción de carreteras y vías de ferrocarril |
| 4220 | Construcción de proyectos de servicio público |
| 4290 | Construcción de otras obras de ingeniería civil |
| 4311 | Demolición |
| 4312 | Preparación del terreno |
| 4321 | Instalaciones eléctricas |
| 4322 | Instalaciones de fontanería, calefacción y aire acondicionado |
| 4329 | Otras instalaciones especializadas |
| 4330 | Terminación y acabado de edificios y obras de ingeniería civil |
| 4390 | Otras actividades especializadas para la construcción de edificios y obras de ingeniería civil |
| 4511 | Comercio de vehículos automotores nuevos |
| 4512 | Comercio de vehículos automotores usados |
| 4520 | Mantenimiento y reparación de vehículos automotores |
| 4530 | Comercio de partes, piezas (autopartes) y accesorios (lujos) para vehículos automotores |
| 4541 | Comercio de motocicletas y de sus partes, piezas y accesorios |
| 4542 | Mantenimiento y reparación de motocicletas y de sus partes y piezas |
| 4610 | Comercio al por mayor a cambio de una retribución o por contrata |
| 4620 | Comercio al por mayor de materias primas agropecuarias; animales vivos |
| 4631 | Comercio al por mayor de productos alimenticios |
| 4632 | Comercio al por mayor de bebidas y tabaco |
| 4641 | Comercio al por mayor de productos textiles, productos confeccionados para uso doméstico |
| 4642 | Comercio al por mayor de prendas de vestir |
| 4643 | Comercio al por mayor de calzado |
| 4644 | Comercio al por mayor de aparatos y equipo de uso doméstico |
| 4645 | Comercio al por mayor de productos farmacéuticos, medicinales, cosméticos y de tocador |
| 4649 | Comercio al por mayor de otros utensilios domésticos n.c.p. |
| 4651 | Comercio al por mayor de computadores, equipo periférico y programas de informática |
| 4652 | Comercio al por mayor de equipo, partes y piezas electrónicos y de telecomunicaciones |
| 4653 | Comercio al por mayor de maquinaria y equipo agropecuarios |
| 4659 | Comercio al por mayor de otros tipos de maquinaria y equipo n.c.p. |
| 4661 | Comercio al por mayor de combustibles sólidos, líquidos, gaseosos y productos conexos |
| 4662 | Comercio al por mayor de metales y productos metalíferos |
| 4663 | Comercio al por mayor de materiales de construcción, artículos de ferretería, pinturas, productos de vidrio, equipo y materiales de fontanería y calefacción |
| 4664 | Comercio al por mayor de productos químicos básicos, cauchos y plásticos en formas primarias y productos químicos de uso agropecuario |
| 4665 | Comercio al por mayor de desperdicios, desechos y chatarra |
| 4669 | Comercio al por mayor de otros productos n.c.p. |
| 4690 | Comercio al por mayor no especializado |
| 4711 | Comercio al por menor en establecimientos no especializados con surtido compuesto principalmente por alimentos, bebidas o tabaco |
| 4719 | Comercio al por menor en establecimientos no especializados, con surtido compuesto principalmente por productos diferentes de alimentos (víveres en general), bebidas y tabaco |
| 4721 | Comercio al por menor de productos agrícolas para el consumo en establecimientos especializados |
| 4722 | Comercio al por menor de leche, productos lácteos y huevos, en establecimientos especializados |
| 4723 | Comercio al por menor de carnes (incluye aves de corral), productos cárnicos, pescados y productos de mar, en establecimientos especializados |
| 4724 | Comercio al por menor de bebidas y productos del tabaco, en establecimientos especializados |
| 4729 | Comercio al por menor de otros productos alimenticios n.c.p., en establecimientos especializados |
| 4731 | Comercio al por menor de combustible para automotores |
| 4732 | Comercio al por menor de lubricantes (aceites, grasas), aditivos y productos de limpieza para vehículos automotores |
| 4741 | Comercio al por menor de computadores, equipos periféricos, programas de informática y equipos de telecomunicaciones en establecimientos especializados |
| 4742 | Comercio al por menor de equipos y aparatos de sonido y de video, en establecimientos especializados |
| 4751 | Comercio al por menor de productos textiles en establecimientos especializados |
| 4752 | Comercio al por menor de artículos de ferretería, pinturas y productos de vidrio en establecimientos especializados |
| 4753 | Comercio al por menor de tapices, alfombras y cubrimientos para paredes y pisos en establecimientos especializados |
| 4754 | Comercio al por menor de electrodomésticos y gasodomésticos de uso doméstico, muebles y equipos de iluminación |
| 4755 | Comercio al por menor de artículos y utensilios de uso doméstico |
| 4759 | Comercio al por menor de otros artículos domésticos en establecimientos especializados |
| 4761 | Comercio al por menor de libros, periódicos, materiales y artículos de papelería y escritorio, en establecimientos especializados |
| 4762 | Comercio al por menor de artículos deportivos, en establecimientos especializados |
| 4769 | Comercio al por menor de otros artículos culturales y de entretenimiento n.c.p. en establecimientos especializados |
| 4771 | Comercio al por menor de prendas de vestir y sus accesorios (incluye artículos de piel) en establecimientos especializados |
| 4772 | Comercio al por menor de todo tipo de calzado y artículos de cuero y sucedáneos del cuero en establecimientos especializados. |
| 4773 | Comercio al por menor de productos farmacéuticos y medicinales, cosméticos y artículos de tocador en establecimientos especializados |
| 4774 | Comercio al por menor de otros productos nuevos en establecimientos especializados |
| 4775 | Comercio al por menor de artículos de segunda mano |
| 4781 | Comercio al por menor de alimentos, bebidas y tabaco, en puestos de venta móviles |
| 4782 | Comercio al por menor de productos textiles, prendas de vestir y calzado, en puestos de venta móviles |
| 4789 | Comercio al por menor de otros productos en puestos de venta móviles |
| 4791 | Comercio al por menor realizado a través de Internet |
| 4792 | Comercio al por menor realizado a través de casas de venta o por correo |
| 4799 | Otros tipos de comercio al por menor no realizado en establecimientos, puestos de venta o mercados. |
| 4911 | Transporte férreo de pasajeros |
| 4912 | Transporte férreo de carga |
| 4921 | Transporte de pasajeros |
| 4922 | Transporte mixto |
| 4923 | Transporte de carga por carretera |
| 4930 | Transporte por tuberías |
| 5011 | Transporte de pasajeros marítimo y de cabotaje |
| 5012 | Transporte de carga marítimo y de cabotaje |
| 5021 | Transporte fluvial de pasajeros |
| 5022 | Transporte fluvial de carga |
| 5111 | Transporte aéreo nacional de pasajeros |
| 5112 | Transporte aéreo internacional de pasajeros |
| 5121 | Transporte aéreo nacional de carga |
| 5122 | Transporte aéreo internacional de carga |
| 5210 | Almacenamiento y depósito |
| 5221 | Actividades de estaciones, vías y servicios complementarios para el transporte terrestre |
| 5222 | Actividades de puertos y servicios complementarios para el transporte acuático |
| 5223 | Actividades de aeropuertos, servicios de navegación aérea y demás actividades conexas al transporte aéreo |
| 5224 | Manipulación de carga |
| 5229 | Otras actividades complementarias al transporte |
| 5310 | Actividades postales nacionales |
| 5320 | Actividades de mensajería |
| 5511 | Alojamiento en hoteles |
| 5512 | Alojamiento en apartahoteles |
| 5513 | Alojamiento en centros vacacionales |
| 5514 | Alojamiento rural |
| 5519 | Otros tipos de alojamientos para visitantes |
| 5520 | Actividades de zonas de camping y parques para vehículos recreacionales |
| 5530 | Servicio por horas |
| 5590 | Otros tipos de alojamiento n.c.p. |
| 5611 | Expendio a la mesa de comidas preparadas |
| 5612 | Expendio por autoservicio de comidas preparadas |
| 5613 | Expendio de comidas preparadas en cafeterías |
| 5619 | Otros tipos de expendio de comidas preparadas n.c.p. |
| 5621 | Catering para eventos |
| 5629 | Actividades de otros servicios de comidas |
| 5630 | Expendio de bebidas alcohólicas para el consumo dentro del establecimiento |
| 5811 | Edición de libros |
| 5812 | Edición de directorios y listas de correo |
| 5813 | Edición de periódicos, revistas y otras publicaciones periódicas |
| 5819 | Otros trabajos de edición |
| 5820 | Edición de programas de informática (software) |
| 5911 | Actividades de producción de películas cinematográficas, videos, programas, anuncios y comerciales de televisión |
| 5912 | Actividades de posproducción de películas cinematográficas, videos, programas, anuncios y comerciales de televisión |
| 5913 | Actividades de distribución de películas cinematográficas, videos, programas, anuncios y comerciales de televisión |
| 5914 | Actividades de exhibición de películas cinematográficas y videos |
| 5920 | Actividades de grabación de sonido y edición de música |
| 6010 | Actividades de programación y transmisión en el servicio de radiodifusión sonora |
| 6020 | Actividades de programación y transmisión de televisión |
| 6110 | Actividades de telecomunicaciones alámbricas |
| 6120 | Actividades de telecomunicaciones inalámbricas |
| 6130 | Actividades de telecomunicación satelital |
| 6190 | Otras actividades de telecomunicaciones |
| 6201 | Actividades de desarrollo de sistemas informáticos (planificación, análisis, diseño, programación, pruebas) |
| 6202 | Actividades de consultoría informática y actividades de administración de instalaciones informáticas |
| 6209 | Otras actividades de tecnologías de información y actividades de servicios informáticos |
| 6311 | Procesamiento de datos, alojamiento (hosting) y actividades relacionadas |
| 6312 | Portales web |
| 6391 | Actividades de agencias de noticias |
| 6399 | Otras actividades de servicio de información n.c.p. |
| 6411 | Banco Central |
| 6412 | Bancos comerciales |
| 6421 | Actividades de las corporaciones financieras |
| 6422 | Actividades de las compañías de financiamiento |
| 6423 | Banca de segundo piso |
| 6424 | Actividades de las cooperativas financieras |
| 6431 | Fideicomisos, fondos y entidades financieras similares |
| 6432 | Fondos de cesantías |
| 6491 | Leasing financiero (arrendamiento financiero) |
| 6492 | Actividades financieras de fondos de empleados y otras formas asociativas del sector solidario |
| 6493 | Actividades de compra de cartera o factoring |
| 6494 | Otras actividades de distribución de fondos |
| 6495 | Instituciones especiales oficiales |
| 6499 | Otras actividades de servicio financiero, excepto las de seguros y pensiones n.c.p. |
| 6511 | Seguros generales |
| 6512 | Seguros de vida |
| 6513 | Reaseguros |
| 6514 | Capitalización |
| 6521 | Servicios de seguros sociales de salud |
| 6522 | Servicios de seguros sociales de riesgos profesionales |
| 6531 | Régimen de prima media con prestación definida (RPM) |
| 6532 | Régimen de ahorro individual (RAI) |
| 6611 | Administración de mercados financieros |
| 6612 | Corretaje de valores y de contratos de productos básicos |
| 6613 | Otras actividades relacionadas con el mercado de valores |
| 6614 | Actividades de las casas de cambio |
| 6615 | Actividades de los profesionales de compra y venta de divisas |
| 6619 | Otras actividades auxiliares de las actividades de servicios financieros n.c.p. |
| 6621 | Actividades de agentes y corredores de seguros |
| 6629 | Evaluación de riesgos y daños, y otras actividades de servicios auxiliares |
| 6630 | Actividades de administración de fondos |
| 6810 | Actividades inmobiliarias realizadas con bienes propios o arrendados |
| 6820 | Actividades inmobiliarias realizadas a cambio de una retribución o por contrata |
| 6910 | Actividades jurídicas |
| 6920 | Actividades de contabilidad, teneduría de libros, auditoría financiera y asesoría tributaria |
| 7010 | Actividades de administración empresarial |
| 7020 | Actividades de consultaría de gestión |
| 7110 | Actividades de arquitectura e ingeniería y otras actividades conexas de consultoría técnica |
| 7120 | Ensayos y análisis técnicos |
| 7210 | Investigaciones y desarrollo experimental en el campo de las ciencias naturales y la ingeniería |
| 7220 | Investigaciones y desarrollo experimental en el campo de las ciencias sociales y las humanidades |
| 7310 | Publicidad |
| 7320 | Estudios de mercado y realización de encuestas de opinión pública |
| 7410 | Actividades especializadas de diseño |
| 7420 | Actividades de fotografía |
| 7490 | Otras actividades profesionales, científicas y técnicas n.c.p. |
| 7500 | Actividades veterinarias |
| 7710 | Alquiler y arrendamiento de vehículos automotores |
| 7721 | Alquiler y arrendamiento de equipo recreativo y deportivo |
| 7722 | Alquiler de videos y discos |
| 7729 | Alquiler y arrendamiento de otros efectos personales y enseres domésticos n.c.p. |
| 7730 | Alquiler y arrendamiento de otros tipos de maquinaria, equipo y bienes tangibles n.c.p. |
| 7740 | Arrendamiento de propiedad intelectual y productos similares, excepto obras protegidas por derechos de autor |
| 7810 | Actividades de agencias de empleo |
| 7820 | Actividades de agencias de empleo temporal |
| 7830 | Otras actividades de suministro de recurso humano |
| 7911 | Actividades de las agencias de viaje |
| 7912 | Actividades de operadores turísticos |
| 7990 | Otros servicios de reserva y actividades relacionadas |
| 8010 | Actividades de seguridad privada |
| 8020 | Actividades de servicios de sistemas de seguridad |
| 8030 | Actividades de detectives e investigadores privados |
| 8110 | Actividades combinadas de apoyo a instalaciones |
| 8121 | Limpieza general interior de edificios |
| 8129 | Otras actividades de limpieza de edificios e instalaciones industriales |
| 8130 | Actividades de paisajismo y servicios de mantenimiento conexos |
| 8211 | Actividades combinadas de servicios administrativos de oficina |
| 8219 | Fotocopiado, preparación de documentos y otras actividades especializadas de apoyo a oficina |
| 8220 | Actividades de centros de llamadas (Call center) |
| 8230 | Organización de convenciones y eventos comerciales |
| 8291 | Actividades de agencias de cobranza y oficinas de calificación crediticia |
| 8292 | Actividades de envase y empaque |
| 8299 | Otras actividades de servicio de apoyo a las empresas n.c.p. |
| 8411 | Actividades legislativas de la administración pública |
| 8412 | Actividades ejecutivas de la administración pública |
| 8413 | Regulación de las actividades de organismos que prestan servicios de salud, educativos, culturales y otros servicios sociales, excepto servicios de seguridad social |
| 8414 | Actividades reguladoras y facilitadoras de la actividad económica |
| 8415 | Actividades de los otros órganos de control |
| 8421 | Relaciones exteriores |
| 8422 | Actividades de defensa |
| 8423 | Orden público y actividades de seguridad |
| 8424 | Administración de justicia |
| 8430 | Actividades de planes de seguridad social de afiliación obligatoria |
| 8511 | Educación de la primera infancia |
| 8512 | Educación preescolar |
| 8513 | Educación básica primaria |
| 8521 | Educación básica secundaria |
| 8522 | Educación media académica |
| 8523 | Educación media técnica y de formación laboral |
| 8530 | Establecimientos que combinan diferentes niveles de educación |
| 8541 | Educación técnica profesional |
| 8542 | Educación tecnológica |
| 8543 | Educación de instituciones universitarias o de escuelas tecnológicas |
| 8544 | Educación de universidades |
| 8551 | Formación académica no formal |
| 8552 | Enseñanza deportiva y recreativa |
| 8553 | Enseñanza cultural |
| 8559 | Otros tipos de educación n.c.p. |
| 8560 | Actividades de apoyo a la educación |
| 8610 | Actividades de hospitales y clínicas, con internación |
| 8621 | Actividades de la práctica médica, sin internación |
| 8622 | Actividades de la práctica odontológica |
| 8691 | Actividades de apoyo diagnóstico |
| 8692 | Actividades de apoyo terapéutico |
| 8699 | Otras actividades de atención de la salud humana |
| 8710 | Actividades de atención residencial medicalizada de tipo general |
| 8720 | Actividades de atención residencial, para el cuidado de pacientes con retardo mental, enfermedad mental y consumo de sustancias psicoactivas |
| 8730 | Actividades de atención en instituciones para el cuidado de personas mayores y/o discapacitadas |
| 8790 | Otras actividades de atención en instituciones con alojamiento |
| 8810 | Actividades de asistencia social sin alojamiento para personas mayores y discapacitadas |
| 8890 | Otras actividades de asistencia social sin alojamiento |
| 9001 | Creación literaria |
| 9002 | Creación musical |
| 9003 | Creación teatral |
| 9004 | Creación audiovisual |
| 9005 | Artes plásticas y visuales |
| 9006 | Actividades teatrales |
| 9007 | Actividades de espectáculos musicales en vivo |
| 9008 | Otras actividades de espectáculos en vivo |
| 9101 | Actividades de bibliotecas y archivos |
| 9102 | Actividades y funcionamiento de museos, conservación de edificios y sitios históricos |
| 9103 | Actividades de jardines botánicos, zoológicos y reservas naturales |
| 9200 | Actividades de juegos de azar y apuestas |
| 9311 | Gestión de instalaciones deportivas |
| 9312 | Actividades de clubes deportivos |
| 9319 | Otras actividades deportivas |
| 9321 | Actividades de parques de atracciones y parques temáticos |
| 9329 | Otras actividades recreativas y de esparcimiento n.c.p. |
| 9411 | Actividades de asociaciones empresariales y de empleadores |
| 9412 | Actividades de asociaciones profesionales |
| 9420 | Actividades de sindicatos de empleados |
| 9491 | Actividades de asociaciones religiosas |
| 9492 | Actividades de asociaciones políticas |
| 9499 | Actividades de otras asociaciones n.c.p. |
| 9511 | Mantenimiento y reparación de computadores y de equipo periférico |
| 9512 | Mantenimiento y reparación de equipos de comunicación |
| 9521 | Mantenimiento y reparación de aparatos electrónicos de consumo |
| 9522 | Mantenimiento y reparación de aparatos y equipos domésticos y de jardinería |
| 9523 | Reparación de calzado y artículos de cuero |
| 9524 | Reparación de muebles y accesorios para el hogar |
| 9529 | Mantenimiento y reparación de otros efectos personales y enseres domésticos |
| 9601 | Lavado y limpieza, incluso la limpieza en seco, de productos textiles y de piel |
| 9602 | Peluquería y otros tratamientos de belleza |
| 9603 | Pompas fúnebres y actividades relacionadas |
| 9609 | Otras actividades de servicios personales n.c.p. |
| 9700 | Actividades de los hogares individuales como empleadores de personal doméstico |
| 9810 | Actividades no diferenciadas de los hogares individuales como productores de bienes para uso propio |
| 9820 | Actividades no diferenciadas de los hogares individuales como productores de servicios para uso propio |
| 9900 | Actividades de organizaciones y entidades extraterritoriales |
### Otras clasificaciones
| 0010 | Asalariados |
| ---- | -------------------------------------------------- |
| 0081 | Personas Naturales sin Actividad Económica |
| 0082 | Personas Naturales Subsidiadas por Terceros |
| 0090 | Rentistas de Capital, solo para personas naturales |
# Códigos de país
### Lista de los códigos de país:
| **Código** | **Valor** |
| :--------: | ----------------------------------------- |
| AI | Anguila |
| AQ | Antártida |
| AG | Antigua y Barbuda |
| SA | Arabia Saudita |
| DZ | Argelia |
| AR | Argentina |
| AM | Armenia |
| AW | Aruba |
| AU | Australia |
| AT | Austria |
| AZ | Azerbaiyán |
| BS | Bahamas |
| BD | Bangladés |
| BB | Barbados |
| BH | Baréin |
| BE | Bélgica |
| BZ | Belice |
| BJ | Benín |
| BM | Bermudas |
| BY | Bielorrusia |
| BO | Bolivia |
| BQ | Bonaire, San Eustaquio y Saba |
| BA | Bosnia y Herzegovina |
| BW | Botsuana |
| BR | Brasil |
| BN | Brunéi |
| BG | Bulgaria |
| BF | Burkina Faso |
| BI | Burundi |
| BT | Bután |
| CV | Cabo Verde |
| KH | Camboya |
| CM | Camerún |
| CA | Canadá |
| QA | Catar |
| TD | Chad |
| CL | Chile |
| CN | China |
| CY | Chipre |
| CO | Colombia |
| KM | Comoras |
| KP | Corea del Norte |
| KR | Corea del Sur |
| CI | Costa de Marfil |
| CR | Costa Rica |
| HR | Croacia |
| CU | Cuba |
| CW | Curazao |
| DK | Dinamarca |
| DM | Dominica |
| EC | Ecuador |
| EG | Egipto |
| SV | El Salvador |
| AE | Emiratos Árabes Unidos |
| ER | Eritrea |
| SK | Eslovaquia |
| SI | Eslovenia |
| ES | España |
| US | Estados Unidos |
| EE | Estonia |
| ET | Etiopía |
| PH | Filipinas |
| FI | Finlandia |
| FJ | Fiyi |
| FR | Francia |
| GA | Gabón |
| GM | Gambia |
| GE | Georgia |
| GH | Ghana |
| GI | Gibraltar |
| GD | Granada |
| GR | Grecia |
| GL | Groenlandia |
| GP | Guadalupe |
| GU | Guam |
| GT | Guatemala |
| GF | Guayana Francesa |
| GG | Guernsey |
| GN | Guinea |
| GW | Guinea-Bisáu |
| GQ | Guinea Ecuatorial |
| GY | Guyana |
| HT | Haití |
| HN | Honduras |
| HK | Hong Kong |
| HU | Hungría |
| IN | India |
| ID | Indonesia |
| IQ | Irak |
| IR | Irán |
| IE | Irlanda |
| BV | Isla Bouvet |
| IM | Isla de Man |
| CX | Isla de Navidad |
| IS | Islandia |
| KY | Islas Caimán |
| CC | Islas Cocos |
| CK | Islas Cook |
| FO | Islas Feroe |
| GS | Islas Georgias del Sur y Sandwich del Sur |
| HM | Islas Heard y McDonald |
| FK | Islas Malvinas |
| MP | Islas Marianas del Norte |
| MH | Islas Marshall |
| PN | Islas Pitcairn |
| SB | Islas Salomón |
| TC | Islas Turcas y Caicos |
| UM | Islas ultramarinas de Estados Unidos |
| VG | Islas Vírgenes Británicas |
| VI | Islas Vírgenes de los Estados Unidos |
| IL | Israel |
| IT | Italia |
| JM | Jamaica |
| JP | Japón |
| JE | Jersey |
| JO | Jordania |
| KZ | Kazajistán |
| KE | Kenia |
| KG | Kirguistán |
| KI | Kiribati |
| KW | Kuwait |
| LA | Laos |
| LS | Lesoto |
| LV | Líbano |
| LB | Líbano |
| LR | Liberia |
| LY | Libia |
| LI | Liechtenstein |
| LT | Lituania |
| LU | Luxemburgo |
| MO | Macao |
| MK | Macedonia |
| MG | Madagascar |
| MY | Malasia |
| MW | Malaui |
| MV | Maldivas |
| ML | Malí |
| MT | Marruecos |
| MA | Marruecos |
| MQ | Martinica |
| MU | Mauricio |
| MR | Mauritania |
| YT | Mayotte |
| MX | México |
| FM | Micronesia |
| MD | Moldavia |
| MC | Mónaco |
| MN | Mongolia |
| ME | Montenegro |
| MS | Montserrat |
| MZ | Mozambique |
| MM | Myanmar |
| NA | Namibia |
| NR | Nauru |
| NP | Nepal |
| NI | Nicaragua |
| NE | Níger |
| NG | Nigeria |
| UN | Niue |
| NF | Norfolk |
| NO | Noruega |
| NC | Nueva Caledonia |
| NZ | Nueva Zelanda |
| OM | Omán |
| NL | Países Bajos |
| PK | Pakistán |
| PW | Palaos |
| PS | Palestina |
| PA | Panamá |
| PG | Papúa Nueva Guinea |
| PY | Paraguay |
| PE | Perú |
| PF | Polinesia Francesa |
| PL | Polonia |
| PT | Portugal |
| PR | Puerto Rico |
| GB | Reino Unido |
| EH | República Árabe Saharaui Democrática |
| CF | República Centroafricana |
| CZ | República Checa |
| CG | República del Congo |
| CD | República Democrática del Congo |
| DO | República Dominicana |
| RE | Reunión |
| RW | Ruanda |
| RO | Rumania |
| RU | Rusia |
| WS | Samoa |
| AS | Samoa Americana |
| BL | San Bartolomé |
| KN | San Cristóbal y Nieves |
| SM | San Marino |
| MF | San Martín |
| PM | San Pedro y Miquelón |
| VC | San Vicente y las Granadinas |
| SH | Santa Elena, Ascensión y Tristán de Acuña |
| LC | Santa Lucía |
| ST | Santo Tomé y Príncipe |
| SN | Senegal |
| RS | Serbia |
| SC | Seychelles |
| SL | Sierra Leona |
| SG | Singapur |
| SX | Sint Maarten |
| SY | Siria |
| SO | Somalia |
| LK | Sri Lanka |
| SZ | Suazilandia |
| ZA | Sudáfrica |
| SD | Sudán |
| SS | Sudán del Sur |
| SI | Suecia |
| CH | Suiza |
| SR | Surinam |
| SJ | Svalbard y Jan Mayen |
| TH | Tailandia |
| TW | Taiwán (República de China) |
| TZ | Tanzania |
| TJ | Tayikistán |
| IO | Territorio Británico del Océano Índico |
| TF | Tierras Australes y Antárticas Francesas |
| TL | Timor Oriental |
| TG | Togo |
| TK | Tokelau |
| TO | Tonga |
| TT | Trinidad y Tobago |
| TN | Túnez |
| TM | Turkmenistán |
| TR | Turquía |
| TV | Tuvalu |
| UA | Ucrania |
| UG | Uganda |
| UY | Uruguay |
| UZ | Uzbekistán |
| VU | Vanuatu |
| VA | Vaticano, Ciudad del |
| VE | Venezuela |
| VN | Vietnam |
| WF | Wallis y Futuna |
| YE | Yemen |
| DJ | Yibuti |
| ZM | Zambia |
| ZW | Zimbabue |
# Códigos de región
### Lista de códigos de regiones:
| Código | Valor |
| :----: | ------------------------ |
| 91 | Amazonas |
| 05 | Antioquia |
| 81 | Arauca |
| 08 | Atlántico |
| 11 | Bogotá |
| 13 | Bolívar |
| 15 | Boyacá |
| 17 | Caldas |
| 18 | Caquetá |
| 85 | Casanare |
| 19 | Cauca |
| 20 | Cesar |
| 27 | Chocó |
| 23 | Córdoba |
| 25 | Cundinamarca |
| 94 | Guainía |
| 95 | Guaviare |
| 41 | Huila |
| 44 | La Guajira |
| 47 | Magdalena |
| 50 | Meta |
| 52 | Nariño |
| 54 | Norte de Santander |
| 86 | Putumayo |
| 63 | Quindío |
| 66 | Risaralda |
| 88 | San Andrés y Providencia |
| 68 | Santander |
| 70 | Sucre |
| 73 | Tolima |
| 76 | Valle del Cauca |
| 97 | Vaupés |
| 99 | Vichada |
# Códigos de ciudad
### Lista de códigos de ciudades colombianas:
| Código | Valor |
| :----: | --------------------------- |
| 05001 | Medellín |
| 05002 | Abejorral |
| 05004 | Abriaquí |
| 05021 | Alejandría |
| 05030 | Amagá |
| 05031 | Amalfi |
| 05034 | Andes |
| 05036 | Angelópolis |
| 05038 | Angostura |
| 05040 | Anorí |
| 05042 | Santa Fé De Antioquia |
| 05044 | Anzá |
| 05045 | Apartadó |
| 05051 | Arboletes |
| 05055 | Argelia |
| 05059 | Armenia |
| 05079 | Barbosa |
| 05086 | Belmira |
| 05088 | Bello |
| 05091 | Betania |
| 05093 | Betulia |
| 05101 | Ciudad Bolívar |
| 05107 | Briceño |
| 05113 | Buriticá |
| 05120 | Cáceres |
| 05125 | Caicedo |
| 05129 | Caldas |
| 05134 | Campamento |
| 05138 | Cañasgordas |
| 05142 | Caracolí |
| 05145 | Caramanta |
| 05147 | Carepa |
| 05148 | El Carmen De Viboral |
| 05150 | Carolina |
| 05154 | Caucasia |
| 05172 | Chigorodó |
| 05190 | Cisneros |
| 05197 | Cocorná |
| 05206 | Concepción |
| 05209 | Concordia |
| 05212 | Copacabana |
| 05234 | Dabeiba |
| 05237 | Donmatías |
| 05240 | Ebéjico |
| 05250 | El Bagre |
| 05264 | Entrerríos |
| 05266 | Envigado |
| 05282 | Fredonia |
| 05284 | Frontino |
| 05306 | Giraldo |
| 05308 | Girardota |
| 05310 | Gómez Plata |
| 05313 | Granada |
| 05315 | Guadalupe |
| 05318 | Guarne |
| 05321 | Guatapé |
| 05347 | Heliconia |
| 05353 | Hispania |
| 05360 | Itagüí |
| 05361 | Ituango |
| 05364 | Jardín |
| 05368 | Jericó |
| 05376 | La Ceja |
| 05380 | La Estrella |
| 05390 | La Pintada |
| 05400 | La Unión |
| 05411 | Liborina |
| 05425 | Maceo |
| 05440 | Marinilla |
| 05467 | Montebello |
| 05475 | Murindó |
| 05480 | Mutatá |
| 05483 | Nariño |
| 05490 | Necoclí |
| 05495 | Nechí |
| 05501 | Olaya |
| 05541 | Peñol |
| 05543 | Peque |
| 05576 | Pueblorrico |
| 05579 | Puerto Berrío |
| 05585 | Puerto Nare |
| 05591 | Puerto Triunfo |
| 05604 | Remedios |
| 05607 | Retiro |
| 05615 | Rionegro |
| 05628 | Sabanalarga |
| 05631 | Sabaneta |
| 05642 | Salgar |
| 05647 | San Andrés De Cuerquía |
| 05649 | San Carlos |
| 05652 | San Francisco |
| 05656 | San Jerónimo |
| 05658 | San José De La Montaña |
| 05659 | San Juan De Urabá |
| 05660 | San Luis |
| 05664 | San Pedro De Los Milagros |
| 05665 | San Pedro De Urabá |
| 05667 | San Rafael |
| 05670 | San Roque |
| 05674 | San Vicente Ferrer |
| 05679 | Santa Bárbara |
| 05686 | Santa Rosa De Osos |
| 05690 | Santo Domingo |
| 05697 | El Santuario |
| 05736 | Segovia |
| 05756 | Sonsón |
| 05761 | Sopetrán |
| 05789 | Támesis |
| 05790 | Tarazá |
| 05792 | Tarso |
| 05809 | Titiribí |
| 05819 | Toledo |
| 05837 | Turbo |
| 05842 | Uramita |
| 05847 | Urrao |
| 05854 | Valdivia |
| 05856 | Valparaíso |
| 05858 | Vegachí |
| 05861 | Venecia |
| 05873 | Vigía Del Fuerte |
| 05885 | Yalí |
| 05887 | Yarumal |
| 05890 | Yolombó |
| 05893 | Yondó |
| 05895 | Zaragoza |
| 08001 | Barranquilla |
| 08078 | Baranoa |
| 08137 | Campo De La Cruz |
| 08141 | Candelaria |
| 08296 | Galapa |
| 08372 | Juan De Acosta |
| 08421 | Luruaco |
| 08433 | Malambo |
| 08436 | Manatí |
| 08520 | Palmar De Varela |
| 08549 | Piojó |
| 08558 | Polonuevo |
| 08560 | Ponedera |
| 08573 | Puerto Colombia |
| 08606 | Repelón |
| 08634 | Sabanagrande |
| 08638 | Sabanalarga |
| 08675 | Santa Lucía |
| 08685 | Santo Tomás |
| 08758 | Soledad |
| 08770 | Suan |
| 08832 | Tubará |
| 08849 | Usiacurí |
| 11001 | Bogotá, D.c. |
| 13001 | Cartagena De Indias |
| 13006 | Achí |
| 13030 | Altos Del Rosario |
| 13042 | Arenal |
| 13052 | Arjona |
| 13062 | Arroyohondo |
| 13074 | Barranco De Loba |
| 13140 | Calamar |
| 13160 | Cantagallo |
| 13188 | Cicuco |
| 13212 | Córdoba |
| 13222 | Clemencia |
| 13244 | El Carmen De Bolívar |
| 13248 | El Guamo |
| 13268 | El Peñón |
| 13300 | Hatillo De Loba |
| 13430 | Magangué |
| 13433 | Mahates |
| 13440 | Margarita |
| 13442 | María La Baja |
| 13458 | Montecristo |
| 13468 | Mompós |
| 13473 | Morales |
| 13490 | Norosí |
| 13549 | Pinillos |
| 13580 | Regidor |
| 13600 | Río Viejo |
| 13620 | San Cristóbal |
| 13647 | San Estanislao |
| 13650 | San Fernando |
| 13654 | San Jacinto |
| 13655 | San Jacinto Del Cauca |
| 13657 | San Juan Nepomuceno |
| 13667 | San Martín De Loba |
| 13670 | San Pablo |
| 13673 | Santa Catalina |
| 13683 | Santa Rosa |
| 13688 | Santa Rosa Del Sur |
| 13744 | Simití |
| 13760 | Soplaviento |
| 13780 | Talaigua Nuevo |
| 13810 | Tiquisio |
| 13836 | Turbaco |
| 13838 | Turbaná |
| 13873 | Villanueva |
| 13894 | Zambrano |
| 15001 | Tunja |
| 15022 | Almeida |
| 15047 | Aquitania |
| 15051 | Arcabuco |
| 15087 | Belén |
| 15090 | Berbeo |
| 15092 | Betéitiva |
| 15097 | Boavita |
| 15104 | Boyacá |
| 15106 | Briceño |
| 15109 | Buenavista |
| 15114 | Busbanzá |
| 15131 | Caldas |
| 15135 | Campohermoso |
| 15162 | Cerinza |
| 15172 | Chinavita |
| 15176 | Chiquinquirá |
| 15180 | Chiscas |
| 15183 | Chita |
| 15185 | Chitaraque |
| 15187 | Chivatá |
| 15189 | Ciénega |
| 15204 | Cómbita |
| 15212 | Coper |
| 15215 | Corrales |
| 15218 | Covarachía |
| 15223 | Cubará |
| 15224 | Cucaita |
| 15226 | Cuítiva |
| 15232 | Chíquiza |
| 15236 | Chivor |
| 15238 | Duitama |
| 15244 | El Cocuy |
| 15248 | El Espino |
| 15272 | Firavitoba |
| 15276 | Floresta |
| 15293 | Gachantivá |
| 15296 | Gámeza |
| 15299 | Garagoa |
| 15317 | Guacamayas |
| 15322 | Guateque |
| 15325 | Guayatá |
| 15332 | Güicán De La Sierra |
| 15362 | Iza |
| 15367 | Jenesano |
| 15368 | Jericó |
| 15377 | Labranzagrande |
| 15380 | La Capilla |
| 15401 | La Victoria |
| 15403 | La Uvita |
| 15407 | Villa De Leyva |
| 15425 | Macanal |
| 15442 | Maripí |
| 15455 | Miraflores |
| 15464 | Mongua |
| 15466 | Monguí |
| 15469 | Moniquirá |
| 15476 | Motavita |
| 15480 | Muzo |
| 15491 | Nobsa |
| 15494 | Nuevo Colón |
| 15500 | Oicatá |
| 15507 | Otanche |
| 15511 | Pachavita |
| 15514 | Páez |
| 15516 | Paipa |
| 15518 | Pajarito |
| 15522 | Panqueba |
| 15531 | Pauna |
| 15533 | Paya |
| 15537 | Paz De Río |
| 15542 | Pesca |
| 15550 | Pisba |
| 15572 | Puerto Boyacá |
| 15580 | Quípama |
| 15599 | Ramiriquí |
| 15600 | Ráquira |
| 15621 | Rondón |
| 15632 | Saboyá |
| 15638 | Sáchica |
| 15646 | Samacá |
| 15660 | San Eduardo |
| 15664 | San José De Pare |
| 15667 | San Luis De Gaceno |
| 15673 | San Mateo |
| 15676 | San Miguel De Sema |
| 15681 | San Pablo De Borbur |
| 15686 | Santana |
| 15690 | Santa María |
| 15693 | Santa Rosa De Viterbo |
| 15696 | Santa Sofía |
| 15720 | Sativanorte |
| 15723 | Sativasur |
| 15740 | Siachoque |
| 15753 | Soatá |
| 15755 | Socotá |
| 15757 | Socha |
| 15759 | Sogamoso |
| 15761 | Somondoco |
| 15762 | Sora |
| 15763 | Sotaquirá |
| 15764 | Soracá |
| 15774 | Susacón |
| 15776 | Sutamarchán |
| 15778 | Sutatenza |
| 15790 | Tasco |
| 15798 | Tenza |
| 15804 | Tibaná |
| 15806 | Tibasosa |
| 15808 | Tinjacá |
| 15810 | Tipacoque |
| 15814 | Toca |
| 15816 | Togüí |
| 15820 | Tópaga |
| 15822 | Tota |
| 15832 | Tununguá |
| 15835 | Turmequé |
| 15837 | Tuta |
| 15839 | Tutazá |
| 15842 | Úmbita |
| 15861 | Ventaquemada |
| 15879 | Viracachá |
| 15897 | Zetaquira |
| 17001 | Manizales |
| 17013 | Aguadas |
| 17042 | Anserma |
| 17050 | Aranzazu |
| 17088 | Belalcázar |
| 17174 | Chinchiná |
| 17272 | Filadelfia |
| 17380 | La Dorada |
| 17388 | La Merced |
| 17433 | Manzanares |
| 17442 | Marmato |
| 17444 | Marquetalia |
| 17446 | Marulanda |
| 17486 | Neira |
| 17495 | Norcasia |
| 17513 | Pácora |
| 17524 | Palestina |
| 17541 | Pensilvania |
| 17614 | Riosucio |
| 17616 | Risaralda |
| 17653 | Salamina |
| 17662 | Samaná |
| 17665 | San José |
| 17777 | Supía |
| 17867 | Victoria |
| 17873 | Villamaría |
| 17877 | Viterbo |
| 18001 | Florencia |
| 18029 | Albania |
| 18094 | Belén De Los Andaquíes |
| 18150 | Cartagena Del Chairá |
| 18205 | Curillo |
| 18247 | El Doncello |
| 18256 | El Paujíl |
| 18410 | La Montañita |
| 18460 | Milán |
| 18479 | Morelia |
| 18592 | Puerto Rico |
| 18610 | San José Del Fragua |
| 18753 | San Vicente Del Caguán |
| 18756 | Solano |
| 18785 | Solita |
| 18860 | Valparaíso |
| 19001 | Popayán |
| 19022 | Almaguer |
| 19050 | Argelia |
| 19075 | Balboa |
| 19100 | Bolívar |
| 19110 | Buenos Aires |
| 19130 | Cajibío |
| 19137 | Caldono |
| 19142 | Caloto |
| 19212 | Corinto |
| 19256 | El Tambo |
| 19290 | Florencia |
| 19300 | Guachené |
| 19318 | Guapí |
| 19355 | Inzá |
| 19364 | Jambaló |
| 19392 | La Sierra |
| 19397 | La Vega |
| 19418 | López De Micay |
| 19450 | Mercaderes |
| 19455 | Miranda |
| 19473 | Morales |
| 19513 | Padilla |
| 19517 | Páez |
| 19532 | Patía |
| 19533 | Piamonte |
| 19548 | Piendamó - Tunía |
| 19573 | Puerto Tejada |
| 19585 | Puracé |
| 19622 | Rosas |
| 19693 | San Sebastián |
| 19698 | Santander De Quilichao |
| 19701 | Santa Rosa |
| 19743 | Silvia |
| 19760 | Sotara |
| 19780 | Suárez |
| 19785 | Sucre |
| 19807 | Timbío |
| 19809 | Timbiquí |
| 19821 | Toribío |
| 19824 | Totoró |
| 19845 | Villa Rica |
| 20001 | Valledupar |
| 20011 | Aguachica |
| 20013 | Agustín Codazzi |
| 20032 | Astrea |
| 20045 | Becerril |
| 20060 | Bosconia |
| 20175 | Chimichagua |
| 20178 | Chiriguaná |
| 20228 | Curumaní |
| 20238 | El Copey |
| 20250 | El Paso |
| 20295 | Gamarra |
| 20310 | González |
| 20383 | La Gloria |
| 20400 | La Jagua De Ibirico |
| 20443 | Manaure Balcón Del Cesar |
| 20517 | Pailitas |
| 20550 | Pelaya |
| 20570 | Pueblo Bello |
| 20614 | Río De Oro |
| 20621 | La Paz |
| 20710 | San Alberto |
| 20750 | San Diego |
| 20770 | San Martín |
| 20787 | Tamalameque |
| 23001 | Montería |
| 23068 | Ayapel |
| 23079 | Buenavista |
| 23090 | Canalete |
| 23162 | Cereté |
| 23168 | Chimá |
| 23182 | Chinú |
| 23189 | Ciénaga De Oro |
| 23300 | Cotorra |
| 23350 | La Apartada |
| 23417 | Lorica |
| 23419 | Los Córdobas |
| 23464 | Momil |
| 23466 | Montelíbano |
| 23500 | Moñitos |
| 23555 | Planeta Rica |
| 23570 | Pueblo Nuevo |
| 23574 | Puerto Escondido |
| 23580 | Puerto Libertador |
| 23586 | Purísima De La Concepción |
| 23660 | Sahagún |
| 23670 | San Andrés De Sotavento |
| 23672 | San Antero |
| 23675 | San Bernardo Del Viento |
| 23678 | San Carlos |
| 23682 | San José De Uré |
| 23686 | San Pelayo |
| 23807 | Tierralta |
| 23815 | Tuchín |
| 23855 | Valencia |
| 25001 | Agua De Dios |
| 25019 | Albán |
| 25035 | Anapoima |
| 25040 | Anolaima |
| 25053 | Arbeláez |
| 25086 | Beltrán |
| 25095 | Bituima |
| 25099 | Bojacá |
| 25120 | Cabrera |
| 25123 | Cachipay |
| 25126 | Cajicá |
| 25148 | Caparrapí |
| 25151 | Cáqueza |
| 25154 | Carmen De Carupa |
| 25168 | Chaguaní |
| 25175 | Chía |
| 25178 | Chipaque |
| 25181 | Choachí |
| 25183 | Chocontá |
| 25200 | Cogua |
| 25214 | Cota |
| 25224 | Cucunubá |
| 25245 | El Colegio |
| 25258 | El Peñón |
| 25260 | El Rosal |
| 25269 | Facatativá |
| 25279 | Fómeque |
| 25281 | Fosca |
| 25286 | Funza |
| 25288 | Fúquene |
| 25290 | Fusagasugá |
| 25293 | Gachalá |
| 25295 | Gachancipá |
| 25297 | Gachetá |
| 25299 | Gama |
| 25307 | Girardot |
| 25312 | Granada |
| 25317 | Guachetá |
| 25320 | Guaduas |
| 25322 | Guasca |
| 25324 | Guataquí |
| 25326 | Guatavita |
| 25328 | Guayabal De Síquima |
| 25335 | Guayabetal |
| 25339 | Gutiérrez |
| 25368 | Jerusalén |
| 25372 | Junín |
| 25377 | La Calera |
| 25386 | La Mesa |
| 25394 | La Palma |
| 25398 | La Peña |
| 25402 | La Vega |
| 25407 | Lenguazaque |
| 25426 | Machetá |
| 25430 | Madrid |
| 25436 | Manta |
| 25438 | Medina |
| 25473 | Mosquera |
| 25483 | Nariño |
| 25486 | Nemocón |
| 25488 | Nilo |
| 25489 | Nimaima |
| 25491 | Nocaima |
| 25506 | Venecia |
| 25513 | Pacho |
| 25518 | Paime |
| 25524 | Pandi |
| 25530 | Paratebueno |
| 25535 | Pasca |
| 25572 | Puerto Salgar |
| 25580 | Pulí |
| 25592 | Quebradanegra |
| 25594 | Quetame |
| 25596 | Quipile |
| 25599 | Apulo |
| 25612 | Ricaurte |
| 25645 | San Antonio Del Tequendama |
| 25649 | San Bernardo |
| 25653 | San Cayetano |
| 25658 | San Francisco |
| 25662 | San Juan De Rioseco |
| 25718 | Sasaima |
| 25736 | Sesquilé |
| 25740 | Sibaté |
| 25743 | Silvania |
| 25745 | Simijaca |
| 25754 | Soacha |
| 25758 | Sopó |
| 25769 | Subachoque |
| 25772 | Suesca |
| 25777 | Supatá |
| 25779 | Susa |
| 25781 | Sutatausa |
| 25785 | Tabio |
| 25793 | Tausa |
| 25797 | Tena |
| 25799 | Tenjo |
| 25805 | Tibacuy |
| 25807 | Tibirita |
| 25815 | Tocaima |
| 25817 | Tocancipá |
| 25823 | Topaipí |
| 25839 | Ubalá |
| 25841 | Ubaque |
| 25843 | Villa De San Diego De Ubaté |
| 25845 | Une |
| 25851 | Útica |
| 25862 | Vergara |
| 25867 | Vianí |
| 25871 | Villagómez |
| 25873 | Villapinzón |
| 25875 | Villeta |
| 25878 | Viotá |
| 25885 | Yacopí |
| 25898 | Zipacón |
| 25899 | Zipaquirá |
| 27001 | Quibdó |
| 27006 | Acandí |
| 27025 | Alto Baudó |
| 27050 | Atrato |
| 27073 | Bagadó |
| 27075 | Bahía Solano |
| 27077 | Bajo Baudó |
| 27099 | Bojayá |
| 27135 | El Cantón Del San Pablo |
| 27150 | Carmen Del Darién |
| 27160 | Cértegui |
| 27205 | Condoto |
| 27245 | El Carmen De Atrato |
| 27250 | El Litoral Del San Juan |
| 27361 | Istmina |
| 27372 | Juradó |
| 27413 | Lloró |
| 27425 | Medio Atrato |
| 27430 | Medio Baudó |
| 27450 | Medio San Juan |
| 27491 | Nóvita |
| 27495 | Nuquí |
| 27580 | Río Iró |
| 27600 | Río Quito |
| 27615 | Riosucio |
| 27660 | San José Del Palmar |
| 27745 | Sipí |
| 27787 | Tadó |
| 27800 | Unguía |
| 27810 | Unión Panamericana |
| 41001 | Neiva |
| 41006 | Acevedo |
| 41013 | Agrado |
| 41016 | Aipe |
| 41020 | Algeciras |
| 41026 | Altamira |
| 41078 | Baraya |
| 41132 | Campoalegre |
| 41206 | Colombia |
| 41244 | Elías |
| 41298 | Garzón |
| 41306 | Gigante |
| 41319 | Guadalupe |
| 41349 | Hobo |
| 41357 | Íquira |
| 41359 | Isnos |
| 41378 | La Argentina |
| 41396 | La Plata |
| 41483 | Nátaga |
| 41503 | Oporapa |
| 41518 | Paicol |
| 41524 | Palermo |
| 41530 | Palestina |
| 41548 | Pital |
| 41551 | Pitalito |
| 41615 | Rivera |
| 41660 | Saladoblanco |
| 41668 | San Agustín |
| 41676 | Santa María |
| 41770 | Suaza |
| 41791 | Tarqui |
| 41797 | Tesalia |
| 41799 | Tello |
| 41801 | Teruel |
| 41807 | Timaná |
| 41872 | Villavieja |
| 41885 | Yaguará |
| 44001 | Riohacha |
| 44035 | Albania |
| 44078 | Barrancas |
| 44090 | Dibulla |
| 44098 | Distracción |
| 44110 | El Molino |
| 44279 | Fonseca |
| 44378 | Hatonuevo |
| 44420 | La Jagua Del Pilar |
| 44430 | Maicao |
| 44560 | Manaure |
| 44650 | San Juan Del Cesar |
| 44847 | Uribia |
| 44855 | Urumita |
| 44874 | Villanueva |
| 47001 | Santa Marta |
| 47030 | Algarrobo |
| 47053 | Aracataca |
| 47058 | Ariguaní |
| 47161 | Cerro De San Antonio |
| 47170 | Chivolo |
| 47189 | Ciénaga |
| 47205 | Concordia |
| 47245 | El Banco |
| 47258 | El Piñón |
| 47268 | El Retén |
| 47288 | Fundación |
| 47318 | Guamal |
| 47460 | Nueva Granada |
| 47541 | Pedraza |
| 47545 | Pijiño Del Carmen |
| 47551 | Pivijay |
| 47555 | Plato |
| 47570 | Puebloviejo |
| 47605 | Remolino |
| 47660 | Sabanas De San Ángel |
| 47675 | Salamina |
| 47692 | San Sebastián De Buenavista |
| 47703 | San Zenón |
| 47707 | Santa Ana |
| 47720 | Santa Bárbara De Pinto |
| 47745 | Sitionuevo |
| 47798 | Tenerife |
| 47960 | Zapayán |
| 47980 | Zona Bananera |
| 50001 | Villavicencio |
| 50006 | Acacías |
| 50110 | Barranca De Upía |
| 50124 | Cabuyaro |
| 50150 | Castilla La Nueva |
| 50223 | Cubarral |
| 50226 | Cumaral |
| 50245 | El Calvario |
| 50251 | El Castillo |
| 50270 | El Dorado |
| 50287 | Fuente De Oro |
| 50313 | Granada |
| 50318 | Guamal |
| 50325 | Mapiripán |
| 50330 | Mesetas |
| 50350 | La Macarena |
| 50370 | Uribe |
| 50400 | Lejanías |
| 50450 | Puerto Concordia |
| 50568 | Puerto Gaitán |
| 50573 | Puerto López |
| 50577 | Puerto Lleras |
| 50590 | Puerto Rico |
| 50606 | Restrepo |
| 50680 | San Carlos De Guaroa |
| 50683 | San Juan De Arama |
| 50686 | San Juanito |
| 50689 | San Martín |
| 50711 | Vistahermosa |
| 52001 | Pasto |
| 52019 | Albán |
| 52022 | Aldana |
| 52036 | Ancuyá |
| 52051 | Arboleda |
| 52079 | Barbacoas |
| 52083 | Belén |
| 52110 | Buesaco |
| 52203 | Colón |
| 52207 | Consacá |
| 52210 | Contadero |
| 52215 | Córdoba |
| 52224 | Cuaspúd |
| 52227 | Cumbal |
| 52233 | Cumbitara |
| 52240 | Chachagüí |
| 52250 | El Charco |
| 52254 | El Peñol |
| 52256 | El Rosario |
| 52258 | El Tablón De Gómez |
| 52260 | El Tambo |
| 52287 | Funes |
| 52317 | Guachucal |
| 52320 | Guaitarilla |
| 52323 | Gualmatán |
| 52352 | Iles |
| 52354 | Imués |
| 52356 | Ipiales |
| 52378 | La Cruz |
| 52381 | La Florida |
| 52385 | La Llanada |
| 52390 | La Tola |
| 52399 | La Unión |
| 52405 | Leiva |
| 52411 | Linares |
| 52418 | Los Andes |
| 52427 | Magüí |
| 52435 | Mallama |
| 52473 | Mosquera |
| 52480 | Nariño |
| 52490 | Olaya Herrera |
| 52506 | Ospina |
| 52520 | Francisco Pizarro |
| 52540 | Policarpa |
| 52560 | Potosí |
| 52565 | Providencia |
| 52573 | Puerres |
| 52585 | Pupiales |
| 52612 | Ricaurte |
| 52621 | Roberto Payán |
| 52678 | Samaniego |
| 52683 | Sandoná |
| 52685 | San Bernardo |
| 52687 | San Lorenzo |
| 52693 | San Pablo |
| 52694 | San Pedro De Cartago |
| 52696 | Santa Bárbara |
| 52699 | Santacruz |
| 52720 | Sapuyes |
| 52786 | Taminango |
| 52788 | Tangua |
| 52835 | San Andrés De Tumaco |
| 52838 | Túquerres |
| 52885 | Yacuanquer |
| 54001 | San José De Cúcuta |
| 54003 | Ábrego |
| 54051 | Arboledas |
| 54099 | Bochalema |
| 54109 | Bucarasica |
| 54125 | Cácota |
| 54128 | Cáchira |
| 54172 | Chinácota |
| 54174 | Chitagá |
| 54206 | Convención |
| 54223 | Cucutilla |
| 54239 | Durania |
| 54245 | El Carmen |
| 54250 | El Tarra |
| 54261 | El Zulia |
| 54313 | Gramalote |
| 54344 | Hacarí |
| 54347 | Herrán |
| 54377 | Labateca |
| 54385 | La Esperanza |
| 54398 | La Playa |
| 54405 | Los Patios |
| 54418 | Lourdes |
| 54480 | Mutiscua |
| 54498 | Ocaña |
| 54518 | Pamplona |
| 54520 | Pamplonita |
| 54553 | Puerto Santander |
| 54599 | Ragonvalia |
| 54660 | Salazar |
| 54670 | San Calixto |
| 54673 | San Cayetano |
| 54680 | Santiago |
| 54720 | Sardinata |
| 54743 | Silos |
| 54800 | Teorama |
| 54810 | Tibú |
| 54820 | Toledo |
| 54871 | Villa Caro |
| 54874 | Villa Del Rosario |
| 63001 | Armenia |
| 63111 | Buenavista |
| 63130 | Calarcá |
| 63190 | Circasia |
| 63212 | Córdoba |
| 63272 | Filandia |
| 63302 | Génova |
| 63401 | La Tebaida |
| 63470 | Montenegro |
| 63548 | Pijao |
| 63594 | Quimbaya |
| 63690 | Salento |
| 66001 | Pereira |
| 66045 | Apía |
| 66075 | Balboa |
| 66088 | Belén De Umbría |
| 66170 | Dosquebradas |
| 66318 | Guática |
| 66383 | La Celia |
| 66400 | La Virginia |
| 66440 | Marsella |
| 66456 | Mistrató |
| 66572 | Pueblo Rico |
| 66594 | Quinchía |
| 66682 | Santa Rosa De Cabal |
| 66687 | Santuario |
| 68001 | Bucaramanga |
| 68013 | Aguada |
| 68020 | Albania |
| 68051 | Aratoca |
| 68077 | Barbosa |
| 68079 | Barichara |
| 68081 | Barrancabermeja |
| 68092 | Betulia |
| 68101 | Bolívar |
| 68121 | Cabrera |
| 68132 | California |
| 68147 | Capitanejo |
| 68152 | Carcasí |
| 68160 | Cepitá |
| 68162 | Cerrito |
| 68167 | Charalá |
| 68169 | Charta |
| 68176 | Chima |
| 68179 | Chipatá |
| 68190 | Cimitarra |
| 68207 | Concepción |
| 68209 | Confines |
| 68211 | Contratación |
| 68217 | Coromoro |
| 68229 | Curití |
| 68235 | El Carmen De Chucurí |
| 68245 | El Guacamayo |
| 68250 | El Peñón |
| 68255 | El Playón |
| 68264 | Encino |
| 68266 | Enciso |
| 68271 | Florián |
| 68276 | Floridablanca |
| 68296 | Galán |
| 68298 | Gámbita |
| 68307 | Girón |
| 68318 | Guaca |
| 68320 | Guadalupe |
| 68322 | Guapotá |
| 68324 | Guavatá |
| 68327 | Güepsa |
| 68344 | Hato |
| 68368 | Jesús María |
| 68370 | Jordán |
| 68377 | La Belleza |
| 68385 | Landázuri |
| 68397 | La Paz |
| 68406 | Lebrija |
| 68418 | Los Santos |
| 68425 | Macaravita |
| 68432 | Málaga |
| 68444 | Matanza |
| 68464 | Mogotes |
| 68468 | Molagavita |
| 68498 | Ocamonte |
| 68500 | Oiba |
| 68502 | Onzaga |
| 68522 | Palmar |
| 68524 | Palmas Del Socorro |
| 68533 | Páramo |
| 68547 | Piedecuesta |
| 68549 | Pinchote |
| 68572 | Puente Nacional |
| 68573 | Puerto Parra |
| 68575 | Puerto Wilches |
| 68615 | Rionegro |
| 68655 | Sabana De Torres |
| 68669 | San Andrés |
| 68673 | San Benito |
| 68679 | San Gil |
| 68682 | San Joaquín |
| 68684 | San José De Miranda |
| 68686 | San Miguel |
| 68689 | San Vicente De Chucurí |
| 68705 | Santa Bárbara |
| 68720 | Santa Helena Del Opón |
| 68745 | Simacota |
| 68755 | Socorro |
| 68770 | Suaita |
| 68773 | Sucre |
| 68780 | Suratá |
| 68820 | Tona |
| 68855 | Valle De San José |
| 68861 | Vélez |
| 68867 | Vetas |
| 68872 | Villanueva |
| 68895 | Zapatoca |
| 70001 | Sincelejo |
| 70110 | Buenavista |
| 70124 | Caimito |
| 70204 | Colosó |
| 70215 | Corozal |
| 70221 | Coveñas |
| 70230 | Chalán |
| 70233 | El Roble |
| 70235 | Galeras |
| 70265 | Guaranda |
| 70400 | La Unión |
| 70418 | Los Palmitos |
| 70429 | Majagual |
| 70473 | Morroa |
| 70508 | Ovejas |
| 70523 | Palmito |
| 70670 | Sampués |
| 70678 | San Benito Abad |
| 70702 | San Juan De Betulia |
| 70708 | San Marcos |
| 70713 | San Onofre |
| 70717 | San Pedro |
| 70742 | San Luis De Sincé |
| 70771 | Sucre |
| 70820 | Santiago De Tolú |
| 70823 | Tolú Viejo |
| 73001 | Ibagué |
| 73024 | Alpujarra |
| 73026 | Alvarado |
| 73030 | Ambalema |
| 73043 | Anzoátegui |
| 73055 | Armero |
| 73067 | Ataco |
| 73124 | Cajamarca |
| 73148 | Carmen De Apicalá |
| 73152 | Casabianca |
| 73168 | Chaparral |
| 73200 | Coello |
| 73217 | Coyaima |
| 73226 | Cunday |
| 73236 | Dolores |
| 73268 | Espinal |
| 73270 | Falan |
| 73275 | Flandes |
| 73283 | Fresno |
| 73319 | Guamo |
| 73347 | Herveo |
| 73349 | Honda |
| 73352 | Icononzo |
| 73408 | Lérida |
| 73411 | Líbano |
| 73443 | San Sebastián De Mariquita |
| 73449 | Melgar |
| 73461 | Murillo |
| 73483 | Natagaima |
| 73504 | Ortega |
| 73520 | Palocabildo |
| 73547 | Piedras |
| 73555 | Planadas |
| 73563 | Prado |
| 73585 | Purificación |
| 73616 | Rioblanco |
| 73622 | Roncesvalles |
| 73624 | Rovira |
| 73671 | Saldaña |
| 73675 | San Antonio |
| 73678 | San Luis |
| 73686 | Santa Isabel |
| 73770 | Suárez |
| 73854 | Valle De San Juan |
| 73861 | Venadillo |
| 73870 | Villahermosa |
| 73873 | Villarrica |
| 76001 | Cali |
| 76020 | Alcalá |
| 76036 | Andalucía |
| 76041 | Ansermanuevo |
| 76054 | Argelia |
| 76100 | Bolívar |
| 76109 | Buenaventura |
| 76111 | Guadalajara De Buga |
| 76113 | Bugalagrande |
| 76122 | Caicedonia |
| 76126 | Calima |
| 76130 | Candelaria |
| 76147 | Cartago |
| 76233 | Dagua |
| 76243 | El Águila |
| 76246 | El Cairo |
| 76248 | El Cerrito |
| 76250 | El Dovio |
| 76275 | Florida |
| 76306 | Ginebra |
| 76318 | Guacarí |
| 76364 | Jamundí |
| 76377 | La Cumbre |
| 76400 | La Unión |
| 76403 | La Victoria |
| 76497 | Obando |
| 76520 | Palmira |
| 76563 | Pradera |
| 76606 | Restrepo |
| 76616 | Riofrío |
| 76622 | Roldanillo |
| 76670 | San Pedro |
| 76736 | Sevilla |
| 76823 | Toro |
| 76828 | Trujillo |
| 76834 | Tuluá |
| 76845 | Ulloa |
| 76863 | Versalles |
| 76869 | Vijes |
| 76890 | Yotoco |
| 76892 | Yumbo |
| 76895 | Zarzal |
| 81001 | Arauca |
| 81065 | Arauquita |
| 81220 | Cravo Norte |
| 81300 | Fortul |
| 81591 | Puerto Rondón |
| 81736 | Saravena |
| 81794 | Tame |
| 85001 | Yopal |
| 85010 | Aguazul |
| 85015 | Chámeza |
| 85125 | Hato Corozal |
| 85136 | La Salina |
| 85139 | Maní |
| 85162 | Monterrey |
| 85225 | Nunchía |
| 85230 | Orocué |
| 85250 | Paz De Ariporo |
| 85263 | Pore |
| 85279 | Recetor |
| 85300 | Sabanalarga |
| 85315 | Sácama |
| 85325 | San Luis De Palenque |
| 85400 | Támara |
| 85410 | Tauramena |
| 85430 | Trinidad |
| 85440 | Villanueva |
| 86001 | Mocoa |
| 86219 | Colón |
| 86320 | Orito |
| 86568 | Puerto Asís |
| 86569 | Puerto Caicedo |
| 86571 | Puerto Guzmán |
| 86573 | Puerto Leguízamo |
| 86749 | Sibundoy |
| 86755 | San Francisco |
| 86757 | San Miguel |
| 86760 | Santiago |
| 86865 | Valle Del Guamuez |
| 86885 | Villagarzón |
| 88001 | San Andrés |
| 88564 | Providencia |
| 91001 | Leticia |
| 91263 | El Encanto |
| 91405 | La Chorrera |
| 91407 | La Pedrera |
| 91430 | La Victoria |
| 91460 | Mirití - Paraná |
| 91530 | Puerto Alegría |
| 91536 | Puerto Arica |
| 91540 | Puerto Nariño |
| 91669 | Puerto Santander |
| 91798 | Tarapacá |
| 94001 | Inírida |
| 94343 | Barranco Minas |
| 94663 | Mapiripana |
| 94883 | San Felipe |
| 94884 | Puerto Colombia |
| 94885 | La Guadalupe |
| 94886 | Cacahual |
| 94887 | Pana Pana |
| 94888 | Morichal |
| 95001 | San José Del Guaviare |
| 95015 | Calamar |
| 95025 | El Retorno |
| 95200 | Miraflores |
| 97001 | Mitú |
| 97161 | Carurú |
| 97511 | Pacoa |
| 97666 | Taraira |
| 97777 | Papunahua |
| 97889 | Yavaraté |
| 99001 | Puerto Carreño |
| 99524 | La Primavera |
| 99624 | Santa Rosalía |
| 99773 | Cumaribo |
# Códigos de unidades de medida
Lista de códigos de unidades de medida
| Código | Valor |
| :----: | ------------------------------------------------------------------------ |
| 04 | spray pequeño |
| 05 | levantar |
| 08 | Lote calor |
| 10 | grupo |
| 11 | equipar |
| 13 | ración |
| 14 | Disparo |
| 15 | palo |
| 16 | tambor de ciento quince kg |
| 17 | tambor de cien libras |
| 18 | tambor de cincuenta y cinco galones (US) |
| 19 | camión cisterna |
| 20 | contenedor de veinte pies |
| 21 | contenedor de cuarenta pies |
| 22 | decilitro por gramo |
| 23 | gramo por centímetro cúbico |
| 24 | libra teórica |
| 25 | gramo por centímetro cuadrado |
| 26 | tonelada real |
| 27 | tonelada teórica |
| 28 | kilogramo por metro cuadrado |
| 29 | libra por mil pies cuadrados |
| 30 | Día de potencia del caballo por tonelada métrica seca al aire. |
| 31 | coger peso |
| 32 | kilogramo por aire seco tonelada métrica |
| 33 | kilopascales metros cuadrados por gramo |
| 34 | kilopascales por milímetro |
| 35 | mililitros por centímetro cuadrado segundo |
| 36 | pies cúbicos por minuto por pie cuadrado |
| 37 | onza por pie cuadrado |
| 38 | onzas por pie cuadrado por 0:01 pulgadas |
| 40 | mililitro por segundo |
| 41 | mililitro por minuto |
| 43 | bolsa súper a granel |
| 44 | bolsa a granel de quinientos kg |
| 45 | bolsa a granel de trescientos kg |
| 46 | bolsa a granel de cincuenta libras |
| 47 | bolsa de cincuenta libras |
| 48 | carga de automóviles a granel |
| 53 | kilogramos teóricos |
| 54 | tonelada teórica |
| 56 | sitas |
| 57 | malla |
| 58 | kilogramo neto |
| 59 | parte por millón |
| 60 | porcentaje de peso |
| 61 | parte por billón (US) |
| 62 | porcentaje por 1000 horas |
| 63 | tasa de fracaso en el tiempo |
| 64 | libra por pulgada cuadrada: calibre |
| 66 | Oersted |
| 69 | prueba de escala específica |
| 71 | voltio amperio por libra |
| 72 | vatio por libra |
| 73 | amperio tum por centímetro |
| 74 | milipascal |
| 76 | gauss |
| 77 | mili pulgadas |
| 78 | kilogauss |
| 80 | libras por pulgada cuadrada absoluta |
| 81 | Enrique |
| 84 | kilopound por pulgada cuadrada |
| 85 | fuerza libra pie |
| 87 | libra por pie cúbico |
| 89 | equilibrio |
| 90 | Saybold segundo universal |
| 91 | alimenta |
| 92 | calorías por centímetro cúbico |
| 93 | calorías por gramo |
| 94 | unidad |
| 95 | veinte mil galones (US) de carros |
| 96 | diez mil galones (US) de carros |
| 97 | tambor de diez kg |
| 98 | tambor de quince kg |
| 1ª | milla de coche |
| 1B | recuento de coches |
| 1C | recuento de locomotoras |
| 1D | recuento de cabos |
| 1E | carro vacio |
| 1F | millas de tren |
| 1G | uso de combustible galón (US) |
| 1H | milla del caboose |
| 1I | tipo de interés fijo |
| 1J | tonelada milla |
| 1K | milla locomotora |
| 1L | recuento total de coches |
| 1M | milla de coche total |
| 1X | cuarto de milla |
| 2A | radianes por segundo |
| 2B | radianes por segundo al cuadrado |
| 2C | Röntgen |
| 2I | Unidad térmica británica por hora. |
| 2J | centímetro cúbico por segundo |
| 2K | pie cúbico por hora |
| 2L | pie cúbico por minuto |
| 2M | centímetro por segundo |
| 2N | decibel |
| 2P | kilobyte |
| 2Q | kilobecquerel |
| 2R | kilocurie |
| 2U | megagramo |
| 2V | megagramo por hora |
| 2W | compartimiento |
| 2X | metro por minuto |
| 2Y | milliröntgen |
| 2Z | milivoltios |
| 3B | megajulio |
| 3C | manmonth |
| 3E | libra por libra de producto |
| 3G | libra por pieza de producto |
| 3H | kilogramo por kilogramo de producto |
| 3I | kilogramo por pieza de producto |
| 4ª | bobina |
| 4B | gorra |
| 4C | centistokes |
| 4E | paquete de veinte |
| 4G | microlitro |
| 4H | micrometro |
| 4K | miliamperio |
| 4L | megabyte |
| 4M | miligramo por hora |
| 4N | megabecquerel |
| 4º | microfarad |
| 4P | newton por metro |
| 4Q | onza pulgada |
| 4R | pie onza |
| 4T | picofarad |
| 4U | libra por hora |
| 4W | tonelada (US) por hora |
| 4X | kilolitro por hora |
| 5ª | barril por minuto |
| 5B | lote |
| 5C | galón (US) por mil |
| 5E | MMSCF / día |
| 5F | libras por mil |
| 5G | bomba |
| 5H | escenario |
| 5I | pie cúbico estándar |
| 5J | potencia hidráulica de caballos |
| 5K | contar por minuto |
| 5P | nivel sismico |
| 5Q | nfor sismica |
| A1 | 15 calorías C |
| A10 | amperio metro cuadrado por joule segundo |
| A11 | Ã ¥ ngström |
| A12 | unidad astronómica |
| A13 | attojoule |
| A14 | granero |
| A15 | granero por electrón voltio |
| A16 | granero por voltio de electrones esteradiano: |
| A17 | granero por sterdian |
| A18 | becquerel por kilogramo |
| A19 | becquerel por metro cúbico |
| A2 | amperio por centímetro |
| A20 | Unidad térmica británica por segundo pie cuadrado grado Rankin |
| A21 | Unidad térmica británica por libra grado Rankin |
| A22 | Unidad térmica británica por segundo pie grado Rankin |
| A23 | Unidad térmica británica por hora pie cuadrado grado Rankin |
| A24 | candela por metro cuadrado |
| A25 | cheval vapeur |
| A26 | medidor de culombio |
| A27 | medidor de culombio al cuadrado por voltio |
| A28 | Coulomb por centímetro cúbico |
| A29 | Coulomb por metro cúbico |
| A3 | amperio por milímetro |
| A30 | Coulomb por milímetro cúbico |
| A31 | Coulomb por kilogramo segundo |
| A32 | Coulomb por mol |
| A33 | Coulomb por centímetro cuadrado |
| A34 | Coulomb por metro cuadrado |
| A35 | Coulomb por milímetro cuadrado |
| A36 | centímetro cúbico por mol |
| A37 | nformaci cúbico por mol |
| A38 | metro cúbico por coulomb |
| A39 | metro cúbico por kilogramo |
| A4 | amperio por centímetro cuadrado |
| A40 | metro cúbico por mol |
| A41 | amperio por metro cuadrado |
| A42 | curie por kilogramo |
| A43 | tonelaje de peso muerto |
| A44 | decalitro |
| A45 | decámetro |
| A47 | decitex |
| A48 | grado Rankin |
| A49 | negador |
| A5 | amperio metro cuadrado |
| A50 | dyn segundo por centímetro cúbico |
| A51 | dina segundo por centímetro |
| A52 | dina segundo por centímetro al quinto |
| A53 | electronvolt |
| A54 | electronvoltio por metro |
| A55 | metro electronvolt cuadrado |
| A56 | electronvoltio de metro cuadrado por kilogramo |
| A57 | ergio |
| A58 | erg por centímetro |
| A6 | amperio por metro cuadrado kelvin al cuadrado |
| A60 | erg por centímetro cúbico |
| A61 | erg por gramo |
| A62 | erg por gramo de segundo |
| A63 | erg por segundo |
| A64 | erg por segundo centímetro cuadrado |
| A65 | erg por centímetro cuadrado segundo |
| A66 | erg centímetro cuadrado |
| A67 | ergímetro cuadrado por gramo |
| A68 | exajulio |
| A69 | faradio por metro |
| A7 | amperio por milímetro cuadrado |
| A70 | femtojoule |
| A71 | femtometro |
| A73 | pie por segundo al cuadrado |
| A74 | pie-fuerza de la libra por segundo |
| A75 | tonelada de carga |
| A76 | galón |
| A77 | Unidad de desplazamiento CGS gaussiana |
| A78 | Unidad gaussiana CGS de corriente eléctrica. |
| A79 | Unidad Gaussian CGS de carga eléctrica. |
| A8 | amperio segundo |
| A80 | Unidad Gaussian CGS de intensidad de campo eléctrico. |
| A81 | Unidad Gaussian CGS de polarización eléctrica. |
| A82 | Unidad Gaussian CGS de potencial eléctrico. |
| A83 | Unidad Gaussiana CGS de magnetización. |
| A84 | gigacoulomb por metro cúbico |
| A85 | Gigaelectronvolt |
| A86 | gigahercios |
| A87 | gigaohm |
| A88 | medidor de gigaohm |
| A89 | gigapascal |
| A9 | tarifa |
| A90 | gigavatios |
| A91 | gon |
| A93 | gramo por metro cúbico |
| A94 | gramo por mol |
| A95 | gris |
| A96 | gris por segundo |
| A97 | hectopascal |
| A98 | Henry por metro |
| AA | bola |
| AB | paquete a granel |
| ACR | acre |
| AD | byte |
| AE | amperio por metro |
| AH | minuto adicional |
| AI | minuto promedio por llamada |
| AJ | policía |
| AK | braza |
| AL | nfor de acceso |
| AM | ampolla |
| AMH | hora amperio |
| AMP | amperio |
| ANA | año |
| AP | solo libra de aluminio |
| APZ | onza troy o onza de boticarios |
| AQ | Unidad de factor antihemofílico (AHF) |
| AR | supositorio |
| SON | son |
| COMO | surtido |
| ASM | fuerza alcohólica en masa |
| ASU | fuerza alcohólica por volumen |
| ATM | ambiente estándar |
| ATT | ambiente técnico |
| AV | cápsula |
| AW | vial lleno de polvo |
| SÍ | montaje |
| AZ | Unidad térmica británica por libra |
| B0 | Btu por pie cúbico |
| B1 | barril (US) por día |
| B11 | julios por kilogramo kelvin |
| B12 | julios por metro |
| B13 | julios por metro cuadrado |
| B14 | julios por metro a la cuarta potencia |
| B15 | julios por mol |
| B16 | julios por mol kelvin |
| B18 | joule segundo |
| B2 | litera |
| B20 | joule metro cuadrado por kilogramo |
| B21 | kelvin por vatio |
| B22 | Kiloampere |
| B23 | kiloampere por metro cuadrado |
| B24 | kiloampere por metro |
| B25 | kilobecquerel por kilogramo |
| B26 | kilocoulomb |
| B27 | kilocoulomb por metro cúbico |
| B28 | kilocoulomb por metro cuadrado |
| B29 | kiloelectronvolt |
| B3 | libra de bateo |
| B31 | kilogramo metro por segundo |
| B32 | kilogramo metro cuadrado |
| B33 | kilogramo metro cuadrado por segundo |
| B34 | kilogramo por decímetro cúbico |
| B35 | kilogramo por litro |
| B36 | caloría termoquímica por gramo |
| B37 | kilogramo de fuerza |
| B38 | metro de fuerza de kilogramo |
| B39 | metro de fuerza de kilogramo por segundo |
| B4 | barril: imperial |
| B40 | kilogramo de fuerza por metro cuadrado |
| B41 | kilojoule per kelvin |
| B42 | kilojoule por kilogramo |
| B43 | kilojoule por kilogramo kelvin |
| B44 | kilojoule por mol |
| B45 | kilomol |
| B46 | kilomol por metro cúbico |
| B47 | Kilonewton |
| B48 | medidor de kilonewton |
| B49 | kiloohm |
| B5 | palanquilla |
| B50 | medidor de kiloohm |
| B51 | kilopond |
| B52 | kilosegundo |
| B53 | kilosiemens |
| B54 | kilosiemens por metro |
| B55 | kilovoltios por metro |
| B56 | kiloveber por metro |
| B57 | año luz |
| B58 | litro por mol |
| B59 | hora lumen |
| B6 | bollo |
| B60 | lumen por metro cuadrado |
| B61 | lumen por vatio |
| B62 | lumen segundo |
| B63 | hora de lux |
| B64 | lux segundo |
| B65 | Maxwell |
| B66 | megaamperios por metro cuadrado |
| B67 | megabecquerel por kilogramo |
| B69 | megacoulomb por metro cúbico |
| B7 | ciclo |
| B70 | megacoulomb por metro cuadrado |
| B71 | megaelectronvolt |
| B72 | megagramo por metro cúbico |
| B73 | meganewton |
| B74 | medidor de meganewton |
| B75 | megaohm |
| B76 | metro megaohm |
| B77 | megasiemens por metro |
| B78 | megavoltio |
| B79 | megavolt por metro |
| B8 | julios por metro cúbico |
| B81 | metro recíproco cuadrado recíproco segundo |
| B83 | metro a la cuarta potencia |
| B84 | microamperios |
| B85 | microbar |
| B86 | microcoulomb |
| B87 | microcoulomb por metro cúbico |
| B88 | microcoulomb por metro cuadrado |
| B89 | microfarada por metro |
| B9 | batt |
| B90 | microhenry |
| B91 | microhenry por metro |
| B92 | micronewton |
| B93 | medidor de micronewton |
| B94 | microohm |
| B95 | medidor de microohmios |
| B96 | micropascal |
| B97 | microradiano |
| B98 | microsegundo |
| B99 | microsiemens |
| BAR | bar |
| BB | caja base |
| BD | tablero |
| SER | haz |
| BFT | pie de tabla |
| BG | bolso |
| BH | cepillo |
| BHP | potencia al freno |
| BIL | trillón de dólares |
| BJ | cangilón |
| BK | cesta |
| BL | bala |
| BLD | barril seco |
| BLL | barril (EE. UU.) (petróleo: etc.) |
| BO | botella |
| BP | cien pies de tabla |
| BQL | becquerel |
| BR | bar |
| BT | tornillo |
| BTU | Unidad Térmica Británica |
| BUA | bushel (EE. UU.) |
| BUI | bushel (Reino Unido) |
| BW | peso base |
| BX | caja |
| BZ | millones de BTUs |
| C0 | llamada |
| C1 | producto compuesto libra (peso total) |
| C10 | millifarad |
| C11 | miligal |
| C12 | miligramo por metro |
| C13 | miligray |
| C14 | milihenry |
| C15 | milijoule |
| C16 | milímetro por segundo |
| C17 | milímetro cuadrado por segundo |
| C18 | milimol |
| C19 | mol por kilogramo |
| C2 | carset |
| C20 | millinewton |
| C22 | millinewton por metro |
| C23 | medidor de miliohm |
| C24 | segundo milipascal |
| C25 | miliradian |
| C26 | milisegundo |
| C27 | milisiemens |
| C28 | milisievert |
| C29 | millitesla |
| C3 | microvoltios por metro |
| C30 | milivoltios por metro |
| C31 | milivatios |
| C32 | milivatios por metro cuadrado |
| C33 | milliweber |
| C34 | Topo |
| C35 | mol por decímetro cúbico |
| C36 | mol por metro cúbico |
| C38 | mol por litro |
| C39 | Nanoampere |
| C4 | partido de carga |
| C40 | nanocoulomb |
| C41 | nanofarad |
| C42 | nanofarad por metro |
| C43 | nanohenry |
| C44 | nanohenry por metro |
| C45 | nanometro |
| C46 | medidor de nanoohm |
| C47 | nanosegundo |
| C48 | nanotesla |
| C49 | nanovatio |
| C5 | costo |
| C50 | neper |
| C51 | neper por segundo |
| C52 | picometro |
| C53 | metro de newton segundo |
| C54 | newton metro cuadrado kilogramo cuadrado |
| C55 | newton por metro cuadrado |
| C56 | newton por milímetro cuadrado |
| C57 | newton segundo |
| C58 | newton segundo por metro |
| C59 | octava |
| C6 | célula |
| C60 | ohm centímetro |
| C61 | ohm metro |
| C62 | uno |
| C63 | parsec |
| C64 | pascal por kelvin |
| C65 | segundo pascal |
| C66 | segundo pascal por metro cúbico |
| C67 | segundo pascal por metro |
| C68 | petajoule |
| C69 | telefono |
| C7 | centipoise |
| C70 | picoampere |
| C71 | picocoulomb |
| C72 | picofarad por metro |
| C73 | picohenry |
| C75 | picowatt |
| C76 | picowatt por metro cuadrado |
| C77 | medidor de libras |
| C78 | fuerza de libra |
| C8 | Millicoulomb por kilogramo |
| C80 | rad |
| C81 | radián |
| C82 | medidor de radianes al cuadrado por mol |
| C83 | medidor de radianes al cuadrado por kilogramo |
| C84 | radian por metro |
| C85 | â € ngstr recíproco m |
| C86 | metro cúbico recíproco |
| C87 | metro cúbico recíproco por segundo |
| C88 | voltios de electrones recíprocos por metro cúbico |
| C89 | Henry Recíproco |
| C9 | grupo de bobina |
| C90 | Joule recíproco por metro cúbico |
| C91 | kelvin recíproco o kelvin al poder menos uno |
| C92 | medidor recíproco |
| C93 | metro cuadrado recíproco |
| C94 | minuto recíproco |
| C95 | mole recíproco |
| C96 | Pascal recíproco o pascal a la potencia menos uno. |
| C97 | segundo recíproco |
| C98 | segundo recíproco por metro cúbico |
| C99 | segundo recíproco por metro cuadrado |
| CA | Caja |
| CCT | Capacidad de carga en toneladas métricas. |
| CDL | candela |
| CEL | grado Celsius |
| CEN | cien |
| CG | tarjeta |
| CGM | centigramo |
| CH | envase |
| CJ | cono |
| CK | conector |
| CKG | Coulomb por kilogramo |
| CL | bobina |
| CLF | cientos de licencia |
| CLT | centilitro |
| CMK | centímetro cuadrado |
| CMQ | centímetro cúbico |
| CMT | centímetro |
| CNP | paquete de cien |
| CNT | Cental (Reino Unido) |
| CO | garrafón |
| COU | culombio |
| CQ | cartucho |
| CR | caja |
| CS | caso |
| CT | caja de cartón |
| CTM | quilate métrico |
| CU | vaso |
| CUR | curie |
| CV | cubrir |
| CWA | cien libras (quintales) / cien pesos (US) |
| CWI | cien pesos (Reino Unido) |
| CY | cilindro |
| CZ | combo |
| D1 | segundo recíproco por esteradiano |
| D10 | siemens por metro |
| D12 | siemens metro cuadrado por mol |
| D13 | sievert |
| D14 | mil yardas lineales |
| D15 | sone |
| D16 | centímetro cuadrado por ergio |
| D17 | centímetro cuadrado por erg esterlina |
| D18 | metro kelvin |
| D19 | kelvin metro cuadrado por vatio |
| D2 | segundo recíproco por metros cuadrados esteradianos |
| D20 | metro cuadrado por julio |
| D21 | metro cuadrado por kilogramo |
| D22 | metro cuadrado por mol |
| D23 | pluma gramo (proteína) |
| D24 | metro cuadrado por esterilizador |
| D25 | metro cuadrado por julios esteradianos |
| D26 | metro cuadrado por voltio segundo |
| D27 | esteradiano |
| D28 | sifón |
| D29 | terahercios |
| D30 | terajulio |
| D31 | teravatio |
| D32 | hora de teravatio |
| D33 | tesla |
| D34 | Texas |
| D35 | caloría termoquímica |
| D37 | caloría termoquímica por gramo kelvin |
| D38 | calorías termoquímicas por segundo centímetro kelvin |
| D39 | calorías termoquímicas por segundo centímetro cuadrado kelvin |
| D40 | mil litros |
| D41 | tonelada por metro cúbico |
| D42 | año tropical |
| D43 | unidad de masa atómica unificada |
| D44 | var |
| D45 | voltios al cuadrado por kelvin al cuadrado |
| D46 | voltio – amperio |
| D47 | voltio por centímetro |
| D48 | voltio por kelvin |
| D49 | milivoltios por kelvin |
| D5 | kilogramo por centímetro cuadrado |
| D50 | voltios por metro |
| D51 | voltios por milímetro |
| D52 | vatios por kelvin |
| D53 | vatios por metro kelvin |
| D54 | vatios por metro cuadrado |
| D55 | vatios por metro cuadrado kelvin |
| D56 | vatios por metro cuadrado de kelvin a la cuarta potencia |
| D57 | vatios por steradian |
| D58 | vatios por metro cuadrado esterlino |
| D59 | weber por metro |
| D6 | röntgen por segundo |
| D60 | weber por milímetro |
| D61 | minuto |
| D62 | segundo |
| D63 | libro |
| D64 | bloquear |
| D65 | redondo |
| D66 | casete |
| D67 | dólar por hora |
| D69 | pulgada a la cuarta potencia |
| D7 | Sandwich |
| D70 | Tabla Internacional (IT) caloría |
| D71 | Tabla Internacional (IT) calorías por segundo centímetro kelvin |
| D72 | Tabla Internacional (IT) calorías por segundo centímetro cuadrado kelvin |
| D73 | joule metro cuadrado |
| D74 | kilogramo por mol |
| D75 | Tabla Internacional (IT) calorías por gramo |
| D76 | Tabla Internacional (IT) calorías por gramo kelvin |
| D77 | megacoulomb |
| D79 | haz |
| D8 | puntaje de drenaje |
| D80 | microwatt |
| D81 | microtesla |
| D82 | microvoltio |
| D83 | medidor de millinewton |
| D85 | microwatt por metro cuadrado |
| D86 | Millicoulomb |
| D87 | milimol por kilogramo |
| D88 | millicoulomb por metro cúbico |
| D89 | millicoulomb por metro cuadrado |
| D9 | dina por centímetro cuadrado |
| D90 | metro cúbico (neto) |
| D91 | movimiento rápido del ojo |
| D92 | banda |
| D93 | segundo por metro cúbico |
| D94 | segundo por metro cúbico radianes |
| D95 | julios por gramo |
| D96 | libra bruta |
| D97 | carga de palet / unidad |
| D98 | libra de masa |
| D99 | manga |
| DAA | despreciar |
| DAD | diez dias |
| DAY | día |
| DB | libra seca |
| DC | disco |
| DD | la licenciatura |
| DE | acuerdo |
| DEC | década |
| DG | decigramo |
| DI | dispensador |
| DJ | decagramo |
| DLT | decilitro |
| DMK | nformaci cuadrado |
| DMQ | decímetro cúbico |
| DMT | decímetro |
| DN | medidor de decinewton |
| DPC | docena pieza |
| DPR | docena par |
| DPT | tonelaje de desplazamiento |
| DQ | registro de datos |
| DR | tambor |
| DRA | dram (US) |
| DRI | dram (Reino Unido) |
| DRL | docena rollo |
| DRM | dracma (Reino Unido) |
| DS | monitor |
| DT | tonelada seca |
| DTN | Decitonne |
| DU | dina |
| DWT | pennyweight |
| DX | dina por centímetro |
| DY | libro de directorio |
| DZN | docena |
| DZP | paquete de doce |
| E2 | cinturón |
| E3 | remolque |
| E4 | kilogramo bruto |
| E5 | tonelada métrica larga |
| EA | cada |
| EB | casilla de correo electrónico |
| CE | cada uno por mes |
| EP | paquete de once |
| EQ | galón equivalente |
| EV | sobre |
| F1 | mil pies cúbicos por día |
| F9 | Fibra por centímetro cúbico de aire |
| FAH | grado Fahrenheit |
| FAR | faradio |
| FB | campo |
| FC | mil pies cúbicos |
| FD | millón de partículas por pie cúbico |
| FE | pie de pista |
| FF | cien metros cúbicos |
| FG | parche transdérmico |
| FH | micromol |
| FL | tonelada en escamas |
| FM | millones de pies cúbicos |
| FOT | pie |
| FP | libra por pie cuadrado |
| FR | pie por minuto |
| FS | pie por segundo |
| FTK | pie cuadrado |
| FTQ | pie cubico |
| G2 | US galones por minuto |
| G3 | Galon imperial por minuto |
| G7 | hoja de microficha |
| GB | galón (US) por día |
| GBQ | gigabecquerel |
| GC | gramo por 100 gramo |
| GD | barril bruto |
| GE | libra por galón (US) |
| GF | gramo por metro (gramo por 100 centímetros) |
| GFI | gramo de isótopo fisionable |
| GGR | gramo |
| GH | medio galón (EE. UU.) |
| GIA | branquias |
| GII | Gill (Reino Unido) |
| GJ | gramo por mililitro |
| G | : gramo por kilogramo |
| GL | gramo por litro |
| GLD | galón seco (EE. UU.) |
| GLI | galón (Reino Unido) |
| GLL | galón |
| GM | gramo por metro cuadrado |
| GN | galón bruto |
| GO | miligramos por metro cuadrado |
| GP | miligramo por metro cúbico |
| GQ | microgramos por metro cúbico |
| GRM | gramo |
| GRN | grano |
| GRO | bruto |
| GRT | tonelada de registro bruto |
| GT | tonelada bruta |
| GV | gigajoule |
| GW | galón por mil pies cúbicos |
| GWH | hora de gigavatios |
| GY | patio bruto |
| GZ | sistema de medición |
| H1 | media página – electrónica |
| H2 | medio litro |
| HA | madeja |
| HAR | hectárea |
| HBA | hectobar |
| HBX | cien cajas |
| HC | cien cuentas |
| HD | media docena |
| ÉL | centésima de quilate |
| HF | cien pies |
| HGM | hectogramo |
| HH | cien pies cúbicos |
| HI | cien hojas |
| HIU | cien unidades internacionales |
| HJ | caballo métrico |
| HK | cien kilogramos |
| HL | cien pies (lineales) |
| HLT | hectolitro |
| HM | milla por hora |
| HMQ | millones de metros cúbicos |
| HMT | hectómetro |
| HN | milímetro convencional de mercurio |
| HO | cien onzas troy |
| HP | milímetro convencional de agua |
| HPA | hectolitro de alcohol puro |
| HS | cien pies cuadrados |
| HT | media hora |
| HTZ | hertz |
| HUR | hora |
| HY | cien yardas |
| IA | pulgada libra |
| IC | contar por pulgada |
| IE | persona |
| IF | pulgadas de agua |
| II | columna pulgada |
| IL | pulgada por minuto |
| IM | impresión |
| INH | pulgada |
| INK | pulgada cuadrada |
| INQ | pulgada en cubos |
| IP | póliza de seguros |
| IT | conteo por centímetro |
| IU | pulgada por segundo (velocidad lineal) |
| IV | pulgada por segundo al cuadrado (aceleración) |
| J2 | julios por kilogramo |
| JB | jumbo |
| JE | joule por kelvin |
| JG | jarra |
| JK | megajulio por kilogramo |
| JM | megajulio por metro cúbico |
| JO | articulación |
| JOU | joule |
| JR | tarro |
| K1 | demanda de kilovatios |
| K2 | kilovoltios amperios reactivos de demanda |
| K3 | kilovoltio amperio hora reactiva |
| K5 | amperios kilovoltios (reactivos) |
| K6 | kilolitro |
| KA | pastel |
| KB | kilocharacter |
| KBA | kilobar |
| KD | kilogramo decimal |
| KEL | kelvin |
| KF | kilopacket |
| KG | barrilete |
| KGM | kilogramo |
| KGS | kilogramo por segundo |
| KHZ | kilohercio |
| KI | Kilogramo por milímetro de ancho |
| KJ | kilosegmento |
| KJO | kilojoule |
| KL | kilogramo por metro |
| KMH | kilómetro por hora |
| KMK | kilometro cuadrado |
| KMQ | kilogramo por metro cúbico |
| KNI | kilogramo de nitrógeno |
| KNS | kilogramo de sustancia nombrada |
| KNT | nudo |
| KO | Milliequivalencia de potasa cáustica por gramo de producto. |
| KPA | kilopascal |
| KPH | kilogramo de hidróxido de potasio (potasa cáustica) |
| KPO | kilogramo de óxido de potasio |
| KPP | kilogramo de pentóxido de fósforo (anhídrido fosfórico) |
| KR | Kiloröntgen |
| KS | mil libras por pulgada cuadrada |
| KSD | kilogramo de sustancia 90% seca |
| KSH | kilogramo de hidróxido de sodio (soda cáustica) |
| KT | equipo |
| KTM | kilómetro |
| KTN | kilotonne |
| KUR | kilogramo de uranio |
| KVA | kilovoltio – ampere |
| KVR | kilovar |
| KVT | kilovoltio |
| KW | kilogramos por milímetro |
| KWH | kilovatios hora |
| KWT | kilovatio |
| KX | mililitro por kilogramo |
| L2 | litro por minuto |
| LA | libra por pulgada cúbica |
| LBR | libra |
| LBT | libra troy |
| LC | centímetro lineal |
| LD | litro por día |
| LE | lite |
| LEF | hoja |
| LF | pie lineal |
| LH | hora de trabajo |
| LI | pulgada lineal |
| LJ | spray grande |
| LK | enlazar |
| LM | metro lineal |
| LN | longitud |
| LO | mucho |
| LP | libra liquida |
| LPA | litro de alcohol puro |
| LR | capa |
| LS | Suma global |
| LTN | ton (Reino Unido) o longton (EE. UU.) |
| LTR | litro |
| LUM | lumen |
| LUX | lux |
| LX | yarda lineal por libra |
| LY | yarda lineal |
| M0 | cinta magnética |
| M1 | miligramos por litro |
| M4 | valor monetario |
| M5 | microcurie |
| M7 | micropulgada |
| M9 | millones de Btu por 1000 pies cúbicos |
| MA | máquina por unidad |
| MAL | mega litro |
| MAM | megametro |
| MAW | megavatio |
| MBE | mil equivalentes de ladrillo estándar |
| MBF | mil pies de tabla |
| MBR | milibar |
| MC | microgramo |
| MCU | milicurie |
| MD | aire seco tonelada métrica |
| MF | miligramo por pie cuadrado por lado |
| MGM | miligramo |
| MGM | megahercio |
| MIK | milla cuadrada |
| MIL | mil |
| MIN | minuto |
| MIO | millón |
| MIU | millones de unidades internacionales |
| MK | miligramo por pulgada cuadrada |
| MLD | mil millones |
| MLT | mililitro |
| MMK | milímetro cuadrado |
| MMQ | milímetro cúbico |
| MMT | milímetro |
| LUN | mes |
| MPA | megapascal |
| MQ | mil metros |
| MQH | metro cúbico por hora |
| MQS | metro cúbico por segundo |
| MSK | metro por segundo al cuadrado |
| MT | estera |
| MTK | metro cuadrado |
| MTQ | Metro cúbico |
| MTR | metro |
| MTS | metro por segundo |
| MV | numero de mults |
| MVA | megavolt – ampere |
| MWH | megavatios hora (1000 kW\.h) |
| N1 | calorías de la pluma |
| N2 | número de líneas |
| N3 | punto de impresión |
| NA | miligramo por kilogramo |
| NAR | número de artículos |
| NB | barcaza |
| NBB | número de bobinas |
| NC | coche |
| NCL | número de celdas |
| ND | barril neto |
| NE | litro neto |
| NEW | newton |
| NF | mensaje |
| NG | galón neto (nosotros) |
| NH | hora del mensaje |
| NI | galón imperial neto |
| NIU | número de unidades internacionales |
| NJ | número de pantallas |
| NL | carga |
| MNI | milla nautica |
| NMP | número de paquetes |
| NN | entrenar |
| NPL | número de parcelas |
| NPR | numero de pares |
| TNP | numero de partes |
| NQ | mho |
| NR | micromho |
| NRL | número de rollos |
| NT | tonelada neta |
| NTT | registro neto de toneladas |
| NU | medidor de newton |
| NV | vehículo |
| NX | parte por mil |
| NY | libra por aire seco tonelada métrica |
| OA | panel |
| OHM | ohm |
| EN | onza por yarda cuadrada |
| ONZ | onza |
| OP | Dos paquetes |
| OT | hora extra |
| ONZ | onza av |
| OZA | onza líquida (US) |
| OZI | onza líquida (Reino Unido) |
| P0 | pagina – electronica |
| P1 | por ciento |
| P2 | libra por pie |
| P3 | paquete de tres |
| P4 | paquete de cuatro |
| P5 | paquete de cinco |
| P6 | paquete de seis |
| P7 | paquete de siete |
| P8 | paquete de ocho |
| P9 | paquete de nueve |
| PA | paquete |
| PAL | pascal |
| PB | par de pulgadas |
| PD | almohadilla |
| PE | equivalente en libras |
| PF | palet (ascensor) |
| PG | plato |
| PGL | galón de prueba |
| Pi | tono |
| PK | paquete |
| PL | cubo |
| PM | porcentaje de libra |
| PN | libra neta |
| PO | libra por pulgada de longitud |
| PQ | página por pulgada |
| PR | par |
| PD | fuerza de libra por pulgada cuadrada |
| PT | pinta |
| PTD | pinta seca |
| PTI | pinta (Reino Unido) |
| PTL | pinta liquida (US) |
| PU | bandeja / paquete de bandeja |
| PV | media pinta (US) |
| PW | libra por pulgada de ancho |
| PY | Peck Dry (US) |
| PZ | Peck Dry (Reino Unido) |
| Q3 | comida |
| QA | página – facsímil |
| QAN | cuarto (de un año) |
| QB | página – copia impresa |
| QD | cuarto de docena |
| QH | un cuarto de hora |
| QK | cuarto de kilogramo |
| QR | mano de papel |
| QT | cuarto de galón (US) |
| QTD | cuarto seco (EE. UU.) |
| QTI | cuarto de galón (Reino Unido) |
| QTL | cuarto líquido (US) |
| QTR | cuarto (UK) |
| R1 | pica |
| R4 | caloría |
| R9 | mil metros cúbicos |
| RA | estante |
| RD | barra |
| RG | anillo |
| RH | hora de funcionamiento o de funcionamiento |
| RK | medida métrica rollo |
| RL | carrete |
| RM | resma |
| RN | medida métrica de resma |
| RO | rodar |
| RP | libra por resma |
| RPM | revoluciones por minuto |
| RPS | revoluciones por segundo |
| RS | Reiniciar |
| RT | ingreso tonelada milla |
| RU | correr |
| S3 | pie cuadrado por segundo |
| S4 | metro cuadrado por segundo |
| S5 | sesenta cuartos de pulgada |
| S6 | sesión |
| S7 | unidad de almacenamiento |
| S8 | unidad de publicidad estándar |
| SA | saco |
| SAN | medio año (6 meses) |
| OCS | Puntuación |
| SCR | escrúpulo |
| SD | libra solida |
| SE | sección |
| SEC | segundo |
| SET | conjunto |
| SG | segmento |
| SHT | tonelada de envío |
| SIE | siemens |
| SK | camión cisterna dividido |
| SL | hoja de deslizamiento |
| SMI | milla (milla estatutaria) |
| SN | varilla cuadrada |
| SO | carrete |
| SP | paquete de estante |
| SQ | cuadrado |
| SR | tira |
| SS | hoja métrica medida |
| SST | corto estándar (7200 partidos) |
| ST | hoja |
| ITS | piedra (Reino Unido) |
| STN | tonelada (US) o tonelada corta (UK / US) |
| SV | patinar |
| SO | madeja |
| SX | envío |
| T0 | Línea de telecomunicaciones en servicio. |
| T1 | mil libras brutas |
| T3 | mil piezas |
| T4 | bolsa de mil |
| T5 | caja de mil |
| T6 | mil galones (US) |
| T7 | mil impresiones |
| T8 | mil pulgadas lineales |
| TA | décimo pie cúbico |
| TAH | Kiloampere hora (mil amperios hora) |
| TC | camion |
| TD | termia |
| TE | totalizador |
| TF | diez metros cuadrados |
| TI | mil pulgadas cuadradas |
| TJ | mil centímetros cuadrados |
| TK | tanque: rectangular |
| TL | mil pies (lineales) |
| TN | estaño |
| TNE | tonelada (tonelada métrica) |
| TP | paquete de diez |
| TPR | diez pares |
| TQ | mil pies |
| TQD | mil metros cúbicos por día |
| TR | diez pies cuadrados |
| TRL | trillón (EUR) |
| TS | mil pies cuadrados |
| TSD | tonelada de sustancia 90% seca |
| TSH | tonelada de vapor por hora |
| TT | mil metros lineales |
| TU | tubo |
| TV | mil kilogramos |
| TW | mil hojas |
| TY | tanque: cilíndrico |
| U1 | tratamiento |
| U2 | tableta |
| UA | torr |
| UB | Línea de telecomunicaciones en servicio promedio. |
| UC | puerto de telecomunicaciones |
| UD | décimo minuto |
| UE | décima hora |
| UF | uso por línea de telecomunicación promedio |
| UH | diez mil yardas |
| UM | millones de unidades |
| VA | voltio amperio por kilogramo |
| VI | frasco |
| VLT | voltio |
| VQ | abultar |
| VS | visitar |
| W2 | kilo mojado |
| W4 | dos semanas |
| WA | vatio por kilogramo |
| WB | libra mojada |
| WCD | cable |
| WE | tonelada mojada |
| WEB | weber |
| WEE | semana |
| WG | galon de vino |
| WH | rueda |
| WHR | vatios hora |
| WI | peso por pulgada cuadrada |
| WM | mes de trabajo |
| WR | envolver |
| WSD | estándar |
| WTT | vatio |
| WW | mililitro de agua |
| X1 | cadena |
| YDK | yarda cuadrada |
| YDQ | Yarda cúbica |
| YL | cien yardas lineales |
| YRD | yarda |
| YT | diez yardas |
| Z1 | van de elevación |
| Z2 | pecho |
| Z3 | barril |
| Z4 | pipa |
| Z5 | arrastrar |
| Z6 | punto de conferencia |
| Z8 | línea de noticias de ágata |
| ZP | página |
| ZZ | mutuamente definido |
# Factura
Estructura del objeto de una factura.
## Ejemplo
```javascript
{
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": "990004322",
"externalNumber": "",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-23",
"dateDue": "2020-1-29",
"dateStart": "2020-1-23",
"dateEnd": "2020-1-29",
"typeOfOperation": "10",
"dueDiligence": "",
"incoterms": "",
"deliveryTerms": "",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departamentCode": "",
"departamentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETT",
"resolutionNumber": "18760000001",
"resolutionRangeInitial": "990000000",
"resolutionRangeFinal": "995000000",
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "email@email.com",
"phone": "",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2824;2920",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContactName": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false
}],
"charges": [{
"name": "Servicio",
"type": "P",
"rate": 10,
"amount": 1000
}],
"tip": {
"base": 10000,
"rate": 10,
"amount": 1000
}
}
```
## Estructura
### invoice
Tipo: Objeto
Objeto de una factura.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción code (Ver códigos) string 2 No Tipo de factura DIAN format (Ver opciones) string (Enum) 32 Sí Formato PDF documento emailSender string 128 Sí Remitente email consecutive int No Consecutivo de la factura externalNumber string 42 Sí Número externo de la factura (Orden de compra) currencyCode string 3 No Tipo de moneda currencyRate (Obligatorio si hay un tipo de moneda extranjera) number 18,6 No Tasa de cambio date date No Fecha de expedición de la factura dateDue date Sí Fecha de vencimiento de la factura dateStart date Sí Fecha inicial del periodo de facturación dateEnd date Sí Fecha final del periodo de facturación typeOfOperation (Ver códigos) string 2 No Tipo de operación dueDiligence (Ver códigos) string 2 Sí (No es nulable si se indica el tipo de operación 15 o 16) Debida dilengencia para contol cambiario incoterms (Requerido cuando es exportación) string 3 Sí Código de condición de entrega deliveryTerms string 800 Sí Términos de entrega terms string 800 Sí Términos y condiciones remark string 800 Sí Pie de pagina observation string 800 Sí Nota / Observación termDay int Sí Días del termino de pago (Si es pago a contado debe ser 0, si es crédito debe indicar el número de días) paymentMeanCode (Ver códigos) string 8 Sí Código de medio de pago branch ( branch ) object Sí Objeto de la sucursal resolution ( resolution ) object No Objeto de la resolución customer ( customer ) object No Objeto del cliente invoiceDetails ( invoiceDetail ) array No Arreglo de objetos del detalle de la factura totals ( total ) object No Objeto de los totales de la factura discounts ( discount ) array Sí Arreglo de objetos de los descuentos charges ( charge ) array Sí Arreglo de objetos de los cargos tip ( tip ) object Sí Objeto de la propina (ChargeIndicator=true, AllowanceChargeReasonCode=03) currencyExchange (Ver currencyExchange ) object Sí (Obligatorio si typeOfOperation es 15 o 16 — declaración cambiaria DIAN Res. 000210/2025) Objeto de declaración de operación de cambio (compra/venta de divisas) customFields (customFields array Sí Arreglo de objetos de los campos personalizados
### branch
Tipo: Objeto
Sucursales de facturación, para colocar estos datos a cambio de los de la empresa configurados en el portal ISV.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 128 Sí Nombre de la sucursal address string 64 Sí Dirección de la sucursal phone string 32 Sí Teléfono de la sucursal countryCode string 8 Sí Código del país countryName string 48 Sí Nombre del país departamentCode string 8 Sí Código del departamento departamentName string 48 Sí Nombre del departamento cityCode string 8 Sí Código de la ciudad cityName string 48 Sí Nombre de la ciudad
### resolution
Tipo: Objeto
Datos de la resolución de facturación electrónica expedida por la DIAN, para generar la resolución por favor ver vídeo: .
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción resolutionKey string 256 No Clave técnica de resolución de numeración de la DIAN resolutionPrefix string 8 No Prefijo del de numeración autorizado por la DIAN resolutionNumber int No No. de la resolución resolutionRangeInitial int No Rango inicial de facturación resolutionRangeFinal int No Rango final de facturación resolutionValidFrom date No Fecha inicial de validación de facturación resolutionValidUntil date No Fecha final de validación de facturación
### customer
Tipo: Objeto
Detalles del cliente.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción companyName string 128 No Razón social o nombre completo personType (Ver códigos) string 2 No Tipo de persona regimeType (Ver códigos) string 2 No Tipo de régimen firstName string 80 No Nombres lastName string 80 No Apellidos identification string 24 No Numero de identificación digitCheck string 1 No Dígito de verificación identificationTypeCode string 4 No Tipo de identificación email string 160 Sí Email phone string 24 Sí Teléfono merchantRegistration string 16 Sí Registro mercantil responsibilities string 500 No Responsabilidades fiscales responsibleFor string 12 Sí Responsable de... Ver códigos economicActivities string 500 Sí Actividades económicas (Separadas por punto y coma) e.g: "2920;2825;2817" billingAddress string 128 Sí DATO DE FACTURACIÓN - Dirección billingCountryName string 48 Sí DATO DE FACTURACIÓN - Nombre del país billingCountryCode string 8 No DATO DE FACTURACIÓN - Código del país billingRegionName string 48 Sí DATO DE FACTURACIÓN - Nombre de la región billingRegionCode string 8 No DATO DE FACTURACIÓN -Código de la región billingCityName string 48 Sí DATO DE FACTURACIÓN - Nombre de la ciudad billingCityCode string 8 Sí DATO DE FACTURACIÓN - Código de la ciudad billingPostalCode string 16 Sí DATO DE FACTURACIÓN - Código postal billingNeighborhood string 40 Sí DATO DE FACTURACIÓN - Barrio billingPhone string 24 Sí DATO DE FACTURACIÓN - Teléfono billingContactName string 160 Sí DATO DE FACTURACIÓN - Nombre contacto shippingAddress string 128 Sí DATO DE ENTREGA - Dirección shippingCountryName string 48 Sí DATO DE ENTREGA - Nombre del país shippingCountryCode string 8 Sí DATO DE ENTREGA - Código del país shippingRegionName string 48 Sí DATO DE ENTREGA - Nombre de la región shippingRegionCode string 8 Sí DATO DE ENTREGA - Código de la región shippingCityName string 48 Sí DATO DE ENTREGA - Nombre de la ciudad shippingCityCode string 8 Sí DATO DE ENTREGA - Código de la ciudad shippingPostalCode string 16 Sí DATO DE ENTREGA - Código postal shippingNeighborhood string 40 Sí DATO DE ENTREGA - Barrio shippingPhone string 24 Sí DATO DE ENTREGA - Teléfono shippingContactName string 160 Sí DATO DE ENTREGA - Nombre contacto
### invoiceDetail
Tipo: Objeto
Detalle de la factura.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción standardType (Ver códigos) string 3 Sí Tipo de código estándar DIAN standardCode string 64 Sí Código estándar DIAN itemCode string 32 No Código del producto o servicio itemName string 200 No Nombre del producto o servicio itemModel string 32 Sí Modelo del producto o servicio description string 1024 No Descripción de la venta brandName string 64 Sí Marca del producto o servicio itemCodeSupplier string 32 Sí Código del producto colocado por el proveedor isPresent boolean 1 No Indica si el producto es un obsequio y por tanto el precio es cero isRemmitance boolean 1 Sí Indica si el producto o servicio es una remesa (Sólo para sector de transportes) remmitanceNumber string 32 Sí Número de Radicación de la Remesa entregado por el RNDC (Obligatorio para sector transportes) remmitanceConsecutive string 23 Sí Nro. del consecutivo de la Remesa según codificación interna de cada empresa (Obligatorio para sector transportes) RemmitanceValue int Sí Valor del flete a cobrar por el servicio de transporte de la remesa. (Obligatorio para sector transportes) remmitanceQuantityValue int Sí Valor de cantidad de la carga transportada, debe ser un entero (sin decimales). remmitanceMeasurementUnit (Ver códigos) string 3 Sí Unidad de medida de la carga transportada unitMeasurementCode string 4 No Código de unidad de medida del producto o servicio (NIU por defecto) unitMeasurementName string 64 Sí Nombre de unidad de medida del producto o servicio price number 18,6 No Precio unitario del producto o servicio quantity number 18,6 No Cantidad del producto o servicio discounts ( discount ) array Sí Descuentos sobre los items (Productos o servicios) charges ( charge ) array Sí Cargos adicionales sobre los items (Productos o servicios) taxes ( tax ) array Sí Impuestos sobre los items (Productos o servicios) withholdings ( tax ) array Sí Retenciones sobre los items (Productos o servicios) isvMandante ( mandante ) object Sí Mandante
{% hint style="warning" %}
Los **descuentos y cargos** pueden ser sobre los items o sobre la factura **pero no sobre ambos**.
Si agregas los descuentos y cargos en el detalle serán calculados **sobre los items de la factura**, de lo contrario (si son agregados directamente en el objeto de la factura), serán calculados **sobre la factura en general**.
{% endhint %}
### discount
Tipo: Arreglo de objetos
Descuentos **sobre la factura**, tenga en cuenta que **si va a realizar descuentos sobre la factura no se pueden realizar sobre el detalle** o sobre cada producto o servicio facturado.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 40 Sí Nombre del descuento type string 1 No Tipo de valor (V: Valor Fijo, P: Porcentaje) rate number 18,2 No Tarifa del descuento (porcentaje o valor) amount number 18,2 No Valor del descuento
### charge
Tipo: Arreglo de objetos
Cargos **sobre la factura**, tenga en cuenta que **si va a realizar cargos sobre la factura no se pueden realizar sobre el detalle** o sobre cada producto o servicio facturado.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 40 Sí Nombre del cargo type string 1 No Tipo de valor (V: Valor Fijo, P: Porcentaje) rate number 18,6 No Tarifa del cargo (porcentaje o valor) amount number 18,6 No Valor del cargo
### tip
Tipo: Objeto
Propina de la factura. Se envía como cargo DIAN con `ChargeIndicator=true`, `AllowanceChargeReasonCode=03` y `AllowanceChargeReason="Propina"`. La tarifa máxima permitida es 10%.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción base number 18,6 No Monto base sobre el cual se calcula la propina rate number 18,6 No Tarifa de la propina, en porcentaje (máximo 10) amount number 18,6 No Monto total de la propina, calculado según la tarifa
### tax
Tipo: Arreglo de objetos
Impuestos sobre el item, producto o servicio facturado estos impuestos tenga en cuenta que **son por unidad facturada, no lo calcule por la cantidad**.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 64 No Nombre del impuesto code string 8 No Código del impuesto type string 1 No Tipo del impuesto (V: Valor Fijo, P: Porcentaje, M: Tarifa x 1000) rate number 18,6 No Tarifa o Porcentaje amount number 18,6 No Valor con cada cantidad
### mandante
Tipo: Objeto
Datos del mandante.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 128 No Razón social o nombre identification string 24 No Número de identificación digitCheck string 1 No Dígito de verificación identificationTypeCode string 4 No Tipo de identificación
### total
Tipo: Objeto
Totales de la factura.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción amount number 18,6 No Total de la factura sin impuestos ni retenciones prepaymentAmount number 18,6 No Valor anticipado aplicado a la factura
### customFields
Tipo: Arreglo de objetos
Valores personalizados, puedes enviar por ejemplo la key interna de tu factura, "Estos campos no son enviados a la DIAN son de utilidad únicamente para el integrador".
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción key string 64 Sí Llave del campo value string 64 Sí Valor del campo
### currencyExchange
Tipo: Objeto
Declaración de operación de cambio (compra/venta de divisas), exigida por la Resolución DIAN 000210/2025 para operadores de casas de cambio. Se envía únicamente cuando `typeOfOperation` es `15` (compra) o `16` (venta); si no se envía en ese caso, la extensión UBL de cambio no se adjunta a la factura.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción beneficiaryParty (Ver exchangeParty ) object No Persona que origina la compra/venta de divisas (Formulario 18 "Identificación del beneficiario") declarantParty (Ver exchangeParty ) object No Persona que firma la declaración; igual a beneficiaryParty si el beneficiario declara directamente declarationData (Ver declarationData ) object No Datos de la operación de cambio exchangeProfessionalParty (Ver exchangeProfessionalParty ) object No Datos de la casa de cambio que realiza la operación customerDueDiligence (Ver customerDueDiligence ) object No Debida diligencia del cliente, exigida por el Art. 18 de la Res. DIAN 000210/2025
### exchangeParty
Tipo: Objeto
Reutilizado para `beneficiaryParty` y `declarantParty`.
**Resolución de dirección:** se usa `address` si se envía; si no, se arma con los campos planos (`addressLine`, `cityName`, `cityCode`/`municipalityCode`, `department`, `departmentCode`, `countryCode`, `countryName`). Si `beneficiaryParty` o `declarantParty` no traen ninguna dirección (ni `address` ni campos planos con código DANE), se usa automáticamente la dirección de `customerDueDiligence.customer` como *fallback*. Este fallback no aplica a `exchangeProfessionalParty`.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción additionalAccountID string - No Tipo de persona (Tabla 5): 1 jurídica, 2 natural documentType string - No Tipo de documento: 11 Registro civil, 12 T.I., 13 Cédula, 21 T.E., 22 C.E., 31 NIT, 41 Pasaporte, 42 Doc. extranjero, 47 PEP, 48 PPT, 50 NIT otro país, 91 NUIP documentNumber string - No Número de documento (solo dígitos) schemeId string - Sí (requerido si documentType = 31 ) Esquema de identificación; valor 1 = NIT con dígito de verificación name string - No Nombre completo o razón social addressLine string - Sí Dirección en texto libre; usado solo si address no se envía cityName string - Sí Ciudad; usado solo si address no se envía cityCode string 5 Sí Código DANE de municipio; usado solo si address no se envía. Alias: municipalityCode municipalityCode string 5 Sí Código DANE de municipio; alias de cityCode. Usado solo si address no se envía department string - Sí Nombre del departamento; usado solo si address no se envía departmentCode string 2 Sí Código DANE de departamento; usado solo si address no se envía countryCode string - Sí Código ISO 3166-1 alpha-2; usado solo si address no se envía countryName string - Sí Nombre del país; usado solo si address no se envía birthDate string (fecha) - Sí (solo persona natural, additionalAccountID=2 ) Fecha de nacimiento, formato yyyy-MM-dd birthPlace string - Sí (solo persona natural, additionalAccountID=2 ) Lugar de nacimiento economicActivityName string - Sí Descripción CIIU de la actividad económica economicActivityId string - Sí (requerido para persona jurídica ) Código CIIU Rev. 4, ej. 3415, 6492, 6619 telephone string - Sí Teléfono email string - Sí Correo electrónico address (Ver exchangeAddress ) object Sí Dirección estructurada; tiene prioridad sobre addressLine/cityName si se envía shareholders (Ver shareholder ) array Sí (requerido si additionalAccountID=1 , persona jurídica; omitir o vacío para persona natural) Arreglo de socios/accionistas
### shareholder
Tipo: Arreglo de objetos
Socios o accionistas de una persona jurídica. Solo se reportan socios con participación igual o superior al 25%.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string - No Nombre completo del socio documentType string - No Tipo de documento: 11 Registro civil, 12 T.I., 13 Cédula, 21 T.E., 22 C.E., 31 NIT, 41 Pasaporte, 42 Doc. extranjero, 47 PEP, 48 PPT, 50 NIT otro país, 91 NUIP documentNumber string - No Número de documento sharePercentage number - No Porcentaje de participación accionaria (solo se reportan socios ≥25%)
### exchangeAddress
Tipo: Objeto
Dirección estructurada, reutilizada en `beneficiaryParty`, `declarantParty`, `exchangeProfessionalParty` y `customer` (dentro de `customerDueDiligence`).
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción municipalityCode string 5 Sí Código DANE de municipio, ej. 11001 Bogotá, 05001 Medellín, 76001 Cali cityName string - Sí Nombre de ciudad según catálogo DANE department string - Sí Nombre del departamento, ej. Bogotá D.C., Antioquia departmentCode string 2 Sí Código DANE de departamento, ej. 11 Bogotá, 05 Antioquia, 76 Valle del Cauca addressLine string - Sí Dirección en texto libre countryCode string - Sí Código ISO 3166-1 alpha-2; si se omite, se aplica por defecto CO countryName string - Sí Nombre del país; si se omite, se aplica por defecto Colombia
### exchangeProfessionalParty
Tipo: Objeto
Datos de la casa de cambio (siempre persona jurídica).
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción additionalAccountID string - No Siempre 1 (persona jurídica) documentType string - No Siempre 31 (NIT) documentNumber string - No NIT sin dígito de verificación schemeId string - No Siempre 1 name string - No Razón social de la casa de cambio telephone string - Sí Teléfono(s); puede contener varios números en texto libre chamberOfCommerceCity string - Sí Ciudad de la cámara de comercio, ej. Bogotá, Medellín, Cali chamberOfCommerceCode string - Sí Código de cámara de comercio: 04 Bogotá, 06 Medellín, 09 Cali, 08 Barranquilla, 13 Bucaramanga, 15 Cartagena, 17 Cúcuta, 23 Pereira, 24 Manizales commercialRegistration string - Sí Matrícula mercantil addressLine string - Sí Dirección en texto libre de la oficina o sucursal; usado solo si address no se envía cityName string - Sí Ciudad; usado solo si address no se envía cityCode string 5 Sí Código DANE de municipio; alias: municipalityCode. Usado solo si address no se envía municipalityCode string 5 Sí Código DANE de municipio; alias de cityCode. Usado solo si address no se envía department string - Sí Nombre del departamento; usado solo si address no se envía departmentCode string 2 Sí Código DANE de departamento; usado solo si address no se envía countryCode string - Sí Código ISO 3166-1 alpha-2; usado solo si address no se envía countryName string - Sí Nombre del país; usado solo si address no se envía address (Ver exchangeAddress ) object Sí Dirección de la oficina o sucursal; tiene prioridad sobre los campos planos si se envía
### declarationData
Tipo: Objeto
Descripción completa de la operación de cambio.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción id string - No Consecutivo de la declaración, ej. C6VE102253 concept string - No Declaración de origen de fondos en texto libre (Formulario 18, literales 1-3) conceptLocale string - Sí Idioma/locale del concepto; se recomienda ES_CO salePointId string - Sí Identificador del punto de venta / ventanilla salePointType string - Sí Tipo de punto de venta o terminal, ej. DISPENSER, VENTANILLA, CAJERO. Requerido para identificar operaciones en dispensers o cajeros automáticos employeeNumber string - Sí Documento o código del cajero cardNumber string - Sí (solo si el pago fue con tarjeta ) Número de tarjeta usada en el pago cm string - Sí Código de movimiento interno (opcional) operationType string - No purchase (typeOfOperation 15) o sale (typeOfOperation 16)exchangedQuantityCurrency string 3 No Código ISO 4217 de la moneda entregada por el cliente, ej. USD, EUR, GBP, COP, BRL, ARS, MXN exchangedQuantity number 18,2 No Cantidad entregada por el cliente exchangeRate number 18,2 No Tasa de cambio (TRM o pactada) exchangeRateCurrency string 3 No Moneda de referencia de la tasa, ej. COP exchangedTotalCurrency string 3 No Código ISO 4217 del monto recibido (contravalor) exchangedTotal number 18,2 No Contravalor bruto antes de comisión commission number 18,2 Sí Comisión cobrada; 0 si no aplica. Solo se incluye en el XML si es mayor a 0 commissionCurrency string 3 Sí Moneda de la comisión, ej. COP amountToReceive number 18,2 Sí Monto neto tras comisión; 0 si no aplica. Solo se incluye en el XML si es mayor a 0 paymentMeansCode string - No Tabla 13 del Anexo Técnico DIAN (97 códigos); ejemplos: 10 Efectivo, 20 Cheque, 42 Consignación bancaria, 45 Transferencia crédito, 47 Transferencia débito, 48 Tarjeta crédito, 49 Tarjeta débito, ZZZ Otro. Ver tabla completa en el Anexo Técnico DIAN paymentMeansId string - Sí Identificador secuencial, usualmente 1 exchangeControlNumber string - No Numeral cambiario según Anexo 1 DCIP-83 del Banco de la República: 1601 Ingresos de divisas (compra), 2904 Egresos de divisas (venta). Ver tabla completa en banrep.gov.co exchangeControlDescription string - Sí Descripción del numeral cambiario, ej. "Otros conceptos" exchangeControlOperation string - No purchase o sale
### customerDueDiligence
Tipo: Objeto
Debida diligencia del cliente, exigida por el Art. 18 de la Res. DIAN 000210/2025.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción diligenceTypeCode string - No Ver catálogo del Anexo Técnico DIAN, ej. 01 = DDC General diligenceTypeId string - Sí Usualmente igual a diligenceTypeCode diligenceTypeName string - Sí Ej. "Debida Diligencia del Cliente - DDC General", "...Intensificada", "...Reforzada" customer (Ver dueDiligenceCustomer ) object No Datos del cliente para debida diligencia intensifiedDueDiligence string - Sí Se activa por encima de umbrales de la Superfinanciera; nulo si no aplica strengthenedDueDiligence string - Sí Para clientes de alto riesgo o PEP; nulo si no aplica
### dueDiligenceCustomer
Tipo: Objeto
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción additionalAccountID string - No 1 jurídica / 2 naturaldocumentType string - No Tipo de documento: 11 Registro civil, 12 T.I., 13 Cédula, 21 T.E., 22 C.E., 31 NIT, 41 Pasaporte, 42 Doc. extranjero, 47 PEP, 48 PPT, 50 NIT otro país, 91 NUIP documentNumber string - No Número de documento name string - No Nombre completo o razón social birthDate string (fecha) - Sí (solo persona natural, additionalAccountID=2 ) Fecha de nacimiento, formato yyyy-MM-dd birthPlace string - Sí (solo persona natural, additionalAccountID=2 ) Lugar de nacimiento telephone string - Sí Teléfono email string - Sí Correo electrónico fundsSourceId string - Sí Ver catálogo del Anexo Técnico DIAN, ej. CP = Capital Propio fundsSourceName string - Sí Ej. Capital Propio, Salario, Venta de inmueble fundsDestinationId string - Sí Ver catálogo del Anexo Técnico DIAN fundsDestinationName string - Sí Ej. Turismo, Pago proveedores, Estudios fundsPurposeId string - Sí Ver catálogo del Anexo Técnico DIAN, ej. 2904 = Otros conceptos fundsPurposeName string - Sí Ej. Otros conceptos, Importaciones de bienes economicActivityId string - Sí Código CIIU, ej. 3415, 6492 economicActivityName string - Sí Descripción de la actividad económica addressLine string - Sí Dirección en texto libre; usado solo si address no se envía cityName string - Sí Ciudad; usado solo si address no se envía cityCode string 5 Sí Código DANE de municipio; alias: municipalityCode. Usado solo si address no se envía municipalityCode string 5 Sí Código DANE de municipio; alias de cityCode. Usado solo si address no se envía department string - Sí Nombre del departamento; usado solo si address no se envía departmentCode string 2 Sí Código DANE de departamento; usado solo si address no se envía countryCode string - Sí Código ISO 3166-1 alpha-2; usado solo si address no se envía countryName string - Sí Nombre del país; usado solo si address no se envía address (Ver exchangeAddress ) object Sí Dirección estructurada del cliente; tiene prioridad sobre los campos planos si se envía constitutionData (Ver constitutionData ) object Sí (solo persona jurídica, additionalAccountID=1 ) Datos de constitución de la sociedad legalBackgroundCheck string - Sí Resultado de verificación de antecedentes, en texto libre legalBackgroundLocale string - Sí Idioma/locale del resultado; se recomienda ES_CO isPep boolean 1 No Indica si el cliente es Persona Expuesta Políticamente. Si es true, se recomienda diligenciar politicalExposition politicalExposition (Ver politicalExposition ) array Sí Respuestas al cuestionario estándar de exposición política (3 preguntas); nulo si solo se usa el flag isPep
### constitutionData
Tipo: Objeto
Solo aplica para personas jurídicas (dentro de `dueDiligenceCustomer`, cuando additionalAccountID=1).
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción legalConstitutionDate string (fecha) - Sí Formato yyyy-MM-dd; omitir si se desconoce socialCapital number 18,2 Sí Capital social; nulo si no aplica socialCapitalCurrency string 3 Sí Moneda del capital social, usualmente COP shareholdingStructure string - Sí Descripción en texto libre de la estructura accionaria
### politicalExposition
Tipo: Arreglo de objetos
Cuestionario estándar de 3 preguntas de exposición política.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción id string 1 No Identificador de la pregunta: 1, 2 o 3 (conjunto estándar de 3 preguntas) question string - No Texto completo de la pregunta answer string - No SI o NO
# Documento soporte
Estructura del objeto de un documento soporte.
## Ejemplo
```json
{
"format": "Estandar",
"consecutive": "990004322",
"externalNumber": "",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-23",
"dateDue": "2020-1-29",
"dateStart": "2020-1-23",
"dateEnd": "2020-1-29",
"typeOfOperation": "10",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departamentCode": "",
"departamentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETT",
"resolutionNumber": "18760000001",
"resolutionRangeInitial": "990000000",
"resolutionRangeFinal": "995000000",
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"supplier": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "email@email.com",
"phone": "",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2824;2920",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContactName": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"supportDocumentDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": "1285.00",
"quantity": "2",
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "V",
"rate": 10,
"amount": 10
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "Mandante",
"identification": "000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"prepaymentAmount": 68,
"amount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}]
}
```
## Estructura
### supportDocument
Tipo: Objeto
Objeto de un documento soporte.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción format (Ver opciones ) string (Enum) 32 Sí Formato PDF documento consecutive int No Consecutivo del documento soporte externalNumber string 42 Sí Número externo del documento soporte currencyCode string 3 No Tipo de moneda currencyRate (Obligatorio si hay un tipo de moneda extranjera) number 18,6 No Tasa de cambio date date No Fecha de expedición dateDue date Sí Fecha de vencimiento dateStart date Sí Fecha inicial del periodo de facturación dateEnd date Sí Fecha final del periodo de facturación observation string 800 Sí Nota / Observación termDay int Sí Días del termino de pago (Si es pago a contado debe ser 0, si es crédito debe indicar el número de días) paymentMeanCode (Ver códigos ) string 8 Sí Código de medio de pago branch ( branch ) object Sí Objeto de la sucursal resolution ( resolution ) object No Objeto de la resolución supplier ( supplier ) object No Objeto del proveedor supportDocumentDetails ( supportDocumentDetail ) array No Arreglo de objetos del detalle del documento soporte totals ( total ) object No Objeto de los totales del documento soporte discounts ( discount ) array Sí Arreglo de objetos de los descuentos charges ( charge ) array Sí Arreglo de objetos de los cargos
### branch
Tipo: Objeto
Sucursales de facturación, para colocar estos datos en lugar de los configurados en el portal ISV.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción name string 128 Sí Nombre de la sucursal address string 64 Sí Dirección de la sucursal phone string 32 Sí Teléfono de la sucursal countryCode string 8 Sí Código del país countryName string 48 Sí Nombre del país departamentCode string 8 Sí Código del departamento departamentName string 48 Sí Nombre del departamento cityCode string 8 Sí Código de la ciudad cityName string 48 Sí Nombre de la ciudad
### resolution
Tipo: Objeto
Datos de la resolución de facturación electrónica expedida por la DIAN.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción resolutionKey string 256 No Clave técnica de resolución de numeración de la DIAN resolutionPrefix string 8 No Prefijo del de numeración autorizado por la DIAN resolutionNumber int No No. de la resolución resolutionRangeInitial int No Rango inicial de facturación resolutionRangeFinal int No Rango final de facturación resolutionValidFrom date No Fecha inicial de validación de facturación resolutionValidUntil date No Fecha final de validación de facturación
### supplier
Tipo: Objeto
Detalles del proveedor.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción companyName string 128 No Razón social o nombre completo personType (Ver códigos ) string 2 No Tipo de persona regimeType (Ver códigos ) string 2 No Tipo de régimen firstName string 80 No Nombres lastName string 80 No Apellidos identification string 24 No Numero de identificación digitCheck string 1 No Dígito de verificación identificationTypeCode string 4 No Tipo de identificación email string 160 Sí Email phone string 24 Sí Teléfono merchantRegistration string 16 Sí Registro mercantil responsibilities string 500 No Responsabilidades fiscales responsibleFor string 12 Sí Responsable de... Ver códigos economicActivities string 500 Sí Actividades económicas (Separadas por punto y coma) e.g: "2920;2825;2817" billingAddress string 128 Sí DATO DE FACTURACIÓN - Dirección billingCountryName string 48 Sí DATO DE FACTURACIÓN - Nombre del país billingCountryCode string 8 No DATO DE FACTURACIÓN - Código del país billingRegionName string 48 Sí DATO DE FACTURACIÓN - Nombre de la región billingRegionCode string 8 No DATO DE FACTURACIÓN -Código de la región billingCityName string 48 Sí DATO DE FACTURACIÓN - Nombre de la ciudad billingCityCode string 8 Sí DATO DE FACTURACIÓN - Código de la ciudad billingPostalCode string 16 Sí DATO DE FACTURACIÓN - Código postal billingNeighborhood string 40 Sí DATO DE FACTURACIÓN - Barrio billingPhone string 24 Sí DATO DE FACTURACIÓN - Teléfono billingContactName string 160 Sí DATO DE FACTURACIÓN - Nombre contacto shippingAddress string 128 Sí DATO DE ENTREGA - Dirección shippingCountryName string 48 Sí DATO DE ENTREGA - Nombre del país shippingCountryCode string 8 Sí DATO DE ENTREGA - Código del país shippingRegionName string 48 Sí DATO DE ENTREGA - Nombre de la región shippingRegionCode string 8 Sí DATO DE ENTREGA - Código de la región shippingCityName string 48 Sí DATO DE ENTREGA - Nombre de la ciudad shippingCityCode string 8 Sí DATO DE ENTREGA - Código de la ciudad shippingPostalCode string 16 Sí DATO DE ENTREGA - Código postal shippingNeighborhood string 40 Sí DATO DE ENTREGA - Barrio shippingPhone string 24 Sí DATO DE ENTREGA - Teléfono shippingContactName string 160 Sí DATO DE ENTREGA - Nombre contacto
### supportDocumentDetails
Tipo: Objeto
Detalle del documento soporte.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción standardType (Ver códigos ) string 3 Sí Tipo de código estándar DIAN standardCode string 64 Sí Código estándar DIAN itemCode string 32 No Código del producto o servicio itemName string 200 No Nombre del producto o servicio itemModel string 32 Sí Modelo del producto o servicio description string 1024 No Descripción de la venta brandName string 64 Sí Marca del producto o servicio itemCodeSupplier string 32 Sí Código del producto colocado por el proveedor isPresent boolean 1 No Indica si el producto es un obsequio y por tanto el precio es cero isRemmitance boolean 1 Sí Indica si el producto o servicio es una remesa (Sólo para sector de transportes) remmitanceNumber string 32 Sí Número de Radicación de la Remesa entregado por el RNDC (Obligatorio para sector transportes) remmitanceConsecutive string 23 Sí Nro. del consecutivo de la Remesa según codificación interna de cada empresa (Obligatorio para sector transportes) RemmitanceValue int Sí Valor del flete a cobrar por el servicio de transporte de la remesa. (Obligatorio para sector transportes) remmitanceQuantityValue int Sí Valor de cantidad de la carga transportada, debe ser un entero (sin decimales). remmitanceMeasurementUnit (Ver códigos) string 3 Sí Unidad de medida de la carga transportada unitMeasurementCode string 4 No Código de unidad de medida del producto o servicio (NIU por defecto) unitMeasurementName string 64 Sí Nombre de unidad de medida del producto o servicio price number 18,6 No Precio unitario del producto o servicio quantity number 18,6 No Cantidad del producto o servicio discounts ( discount ) array Sí Descuentos sobre los items (Productos o servicios) charges ( charge ) array Sí Cargos adicionales sobre los items (Productos o servicios) taxes ( tax ) array Sí Impuestos sobre los items (Productos o servicios) withholdings ( tax ) array Sí Retenciones sobre los items (Productos o servicios) isvMandante ( mandante ) object Sí Mandante
{% hint style="warning" %}
Los **descuentos y cargos** pueden ser sobre los items o sobre la documento soporte **pero no sobre ambos**.
Si agregas los descuentos y cargos en el detalle serán calculados **sobre los items del documento soporte**, de lo contrario (si son agregados directamente en el objeto del documento soporte), serán calculados **sobre el documento en general**.
{% endhint %}
### discount
Tipo: Arreglo de objetos
Descuentos **sobre el documento**, tenga en cuenta que **si va a realizar descuentos sobre el documento no se pueden realizar sobre el detalle** o sobre cada producto o servicio facturado.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción name string 40 Sí Nombre del descuento type string 1 No Tipo de valor (V: Valor Fijo, P: Porcentaje) rate number 18,2 No Tarifa del descuento (porcentaje o valor) amount number 18,2 No Valor del descuento
### charge
Tipo: Arreglo de objetos
Cargos **sobre el documento**, tenga en cuenta que **si va a realizar cargos sobre el documento no se pueden realizar sobre el detalle** o sobre cada producto o servicio facturado.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción name string 40 Sí Nombre del cargo type string 1 No Tipo de valor (V: Valor Fijo, P: Porcentaje) rate number 18,6 No Tarifa del cargo (porcentaje o valor) amount number 18,6 No Valor del cargo
### tax
Tipo: Arreglo de objetos
Impuestos sobre el item, producto o servicio facturado estos impuestos tenga en cuenta que **son por unidad facturada, no lo calcule por la cantidad**.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción name string 64 No Nombre del impuesto code string 8 No Código del impuesto type string 1 No Tipo del impuesto (V: Valor Fijo, P: Porcentaje, M: Tarifa x 1000) rate number 18,6 No Tarifa o Porcentaje amount number 18,6 No Valor con cada cantidad
### mandante
Tipo: Objeto
Datos del mandante.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción name string 128 No Razón social o nombre identification string 24 No Número de identificación digitCheck string 1 No Dígito de verificación identificationTypeCode string 4 No Tipo de identificación
### total
Tipo: Objeto
Totales del documento.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción amount number 18,6 No Total del documento sin impuestos ni retenciones prepaymentAmount number 18,6 No Valor anticipado aplicado al documento
# Nota débito
Estructura del objeto de una nota débito.
## Ejemplo
```javascript
{
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 990000012,
"externalNumber": "",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-23",
"dateStart": "2020-1-23",
"dateEnd": "2020-1-29",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "Sucursal",
"address": "KR con CLL",
"phone": "000000",
"countryCode": "CO",
"countryName": "COLOMBIA",
"departamentCode": "25",
"departamentName": "Cundinamarca",
"cityCode": "25178",
"cityName": "Chipaque"
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETT",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "email@email.com",
"phone": "",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2824;2920",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContactName": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"unitMeasurementCode": "NIU",
"unitMeasurementName": "",
"price": 1285.00,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "V",
"rate": 10,
"amount": 10
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "Mandante",
"identification": "000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"customFields": [{
"value": "666",
"key": "invoiceId"
}]
}
```
## Estructura
### invoiceNoteDb
Tipo: Objeto
Objeto de una nota débito
Campo Tipo Longitud ¿Es nulo? Descripción format (Ver opciones ) string 32 Sí Formato PDF del documento emailSender string 128 Sí Remitente email concept (Ver códigos ) string 1 No Concepto por el cual se hace la nota débito consecutive int No Consecutivo de la nota externalNumber string 16 S Número externo de la factura (Orden de compra) currencyCode string 3 No Tipo de moneda currencyRate (Obligatorio si hay un tipo de moneda extranjera) number 18,6 No Tasa de cambio date date No Fecha de expedición de la nota dateStart date Sí Fecha inicial del periodo de facturación dateEnd date Sí Fecha final del periodo de facturación typeOfOperation (Ver códigos ) string 2 No Tipo de operación terms string 800 Sí Términos y condiciones remark string 800 Sí Pie de pagina observation string 800 Sí Nota / Observación invoicePrefix string 8 No Prefijo de la factura a la cual se le está realizando la nota crédito invoiceConsecutive int No Consecutivo de la factura a la cual se le está realizando la nota crédito invoiceCufe int No Cufe de la factura a la cual se le está realizando la nota crédito invoiceDate date No Fecha de la factura a la cual se le está realizando la nota crédito branch ( branch ) object Sí Objeto de la sucursal resolution ( resolution ) object No Objeto de la resolución customer ( customer ) object No Objeto del cliente invoiceDetails ( invoiceNoteDetail ) array No Arreglo de objetos del detalle de la nota totals ( total ) array No Objeto de los totales de la nota discounts ( discount ) array Sí Arreglo de objetos de los descuentos charges ( charge ) array Sí Arreglo de objetos de los cargos customFields (customFields ) array Sí Arreglo de objetos de los campos personalizados
### branch
Tipo: Objeto
Sucursales de facturación, para colocar estos datos a cambio de los de la empresa configurados en el portal ISV.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 128 Sí Nombre de la sucursal address string 64 Sí Dirección de la sucursal phone string 32 Sí Teléfono de la sucursal countryCode string 8 Sí Código del país countryName string 48 Sí Nombre del país departamentCode string 8 Sí Código del departamento departamentName string 48 Sí Nombre del departamento cityCode string 8 Sí Código de la ciudad cityName string 48 Sí Nombre de la ciudad
### resolution
Tipo: Objeto
Datos de la resolución de facturación.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción resolutionKey string 256 No Clave de resolución resolutionPrefix string 8 No Prefijo de la resolución resolutionNumber int No No. de la resolución resolutionRangeInitial int No Rango inicial de facturación resolutionRangeFinal int No Rango final de facturación resolutionValidFrom date No Fecha inicial de validación de facturación resolutionValidUntil date No Fecha final de validación de facturación
### customer
Tipo: Objeto
Detalles del cliente.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción companyName string 128 No Razón social o nombre completo personType (Ver códigos ) string 2 No Tipo de persona regimeType (Ver códigos ) string 2 No Tipo de régimen firstName string 80 No Nombres lastName string 80 No Apellidos identification string 24 No Numero de identificación digitCheck string 1 No Dígito de verificación identificationTypeCode string 4 No Tipo de identificación email string 160 Sí Email phone string 24 Sí Teléfono merchantRegistration string 16 Sí Registro mercantil responsibleFor string 12 Sí Responsable de... Ver códigos responsibilities string 500 No Responsabilidades fiscales economicActivities string 500 Sí Actividades económicas (Separadas por punto y coma) e.g. "2920;2825;2817" billingAddress string 128 Sí DATO DE FACTURACIÓN - Dirección billingCountryName string 48 Sí DATO DE FACTURACIÓN - Nombre del país billingCountryCode string 8 No DATO DE FACTURACIÓN - Código del país billingRegionName string 48 Sí DATO DE FACTURACIÓN - Nombre de la región billingRegionCode string 8 No DATO DE FACTURACIÓN -Código de la región billingCityName string 48 Sí DATO DE FACTURACIÓN - Nombre de la ciudad billingCityCode string 8 Sí DATO DE FACTURACIÓN - Código de la ciudad billingPostalCode string 16 Sí DATO DE FACTURACIÓN - Código postal billingNeighborhood string 40 Sí DATO DE FACTURACIÓN - Barrio billingPhone string 24 Sí DATO DE FACTURACIÓN - Teléfono billingContactName string 160 Sí DATO DE FACTURACIÓN - Nombre contacto shippingAddress string 128 Sí DATO DE ENTREGA - Dirección shippingCountryName string 48 Sí DATO DE ENTREGA - Nombre del país shippingCountryCode string 8 Sí DATO DE ENTREGA - Código del país shippingRegionName string 48 Sí DATO DE ENTREGA - Nombre de la región shippingRegionCode string 8 Sí DATO DE ENTREGA - Código de la región shippingCityName string 48 Sí DATO DE ENTREGA - Nombre de la ciudad shippingCityCode string 8 Sí DATO DE ENTREGA - Código de la ciudad shippingPostalCode string 16 Sí DATO DE ENTREGA - Código postal shippingNeighborhood string 40 Sí DATO DE ENTREGA - Barrio shippingPhone string 24 Sí DATO DE ENTREGA - Teléfono shippingContactName string 160 Sí DATO DE ENTREGA - Nombre contacto
### invoiceNoteDetail
Tipo: Objeto
Detalle de la nota débito.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción standardType (Ver códigos ) string 3 Sí Tipo de código estándar DIAN standardCode string 64 Sí Código estándar DIAN itemCode string 32 No Código del producto o servicio itemName string 200 No Nombre del producto o servicio itemModel string 32 Sí Modelo del producto o servicio description string 1024 No Descripción de la venta brandName string 64 Sí Marca del producto o servicio itemCodeSupplier string 32 Sí Código del producto colocado por el proveedor isPresent boolean 1 No Indica si el producto es un obsequio y por tanto el precio es cero unitMeasurementCode string 4 No Código de unidad de medida del producto o servicio (NIU por defecto) unitMeasurementName string 64 Sí Nombre de unidad de medida del producto o servicio price number 18,6 No Precio unitario del producto o servicio quantity number 18,6 No Cantidad del producto o servicio discounts ( IsvDiscount ) array Sí Descuentos sobre los items (Productos o servicios) charges ( IsvCharge ) array Sí Cargos adicionales sobre los items (Productos o servicios) taxes ( IsvTax ) array Sí Impuestos sobre los items (Productos o servicios) withholdings ( IsvTax ) array Sí Retenciones sobre los items (Productos o servicios) isvMandante ( IsvMandante ) object Sí Mandante
{% hint style="warning" %}
Los **descuentos y cargos** pueden ser sobre los items o sobre la nota **pero no sobre ambos**.
Si agregas los descuentos y cargos en el detalle serán calculados **sobre los items de la nota**, de lo contrario (si son agregados directamente en el objeto de la nota), serán calculados **sobre la nota en general**.
{% endhint %}
### discount
Tipo: Arreglo de objetos
Descuentos **sobre la nota**, tenga en cuenta que **si va a realizar descuentos sobre la nota no se pueden realizar sobre el detalle** o sobre cada producto o servicio facturado.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 40 Sí Nombre del descuento type string 1 No Tipo de valor (V: Valor Fijo, P: Porcentaje) rate number 18,2 No Tarifa del descuento (porcentaje o valor) amount number 18,2 No Valor del descuento
### charge
Tipo: Arreglo de objetos
Cargos **sobre la nota**, tenga en cuenta que **si va a realizar cargos sobre la nota no se pueden realizar sobre el detalle** o sobre cada producto o servicio facturado.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 40 Sí Nombre del cargo type string 0 No Tipo de valor (V: Valor Fijo, P: Porcentaje) rate number 18,6 No Tarifa del cargo (porcentaje o valor) amount number 18,6 No Valor del cargo
### tax
Tipo: Arreglo de objetos
Impuestos sobre el item, producto o servicio facturado estos impuestos tenga en cuenta que **son por unidad facturada, no lo calcule por la cantidad**.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 64 No Nombre del impuesto code string 8 No Código del impuesto type string 1 No Tipo del impuesto (V: Valor Fijo, P: Porcentaje, M: Tarifa x 1000) rate number 18,6 No Tarifa o Porcentaje amount number 18,6 No Valor con cada cantidad
### mandante
Tipo: Objeto
Datos del mandante.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 128 No Razón social o nombre identification string 24 No Número de identificación digitCheck string 1 No Dígito de verificación identificationTypeCode string 4 No Tipo de identificación
### total
Tipo: Objeto
Totales de la nota débito.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción amount number 18,6 No Total de la nota sin impuestos ni retenciones prepaymentAmount number 18,6 No Valor anticipado aplicado a la nota
### customFields
Tipo: Arreglo de objetos
Valores personalizados, puedes enviar por ejemplo la key interna de tu factura, “Estos campos no son enviados a la DIAN son de utilidad únicamente para el integrador”.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción key string 64 Sí Llave del campo value string 64 Sí Valor del campo
# Nota crédito
Estructura del objeto de una nota crédito.
## Ejemplo
```javascript
{
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 5,
"externalNumber": "",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-18",
"dateStart": "2020-1-18",
"dateEnd": "2020-1-20",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "Sucursal",
"address": "KR con CLL",
"phone": "000000",
"countryCode": "CO",
"countryName": "COLOMBIA",
"departamentCode": "25",
"departamentName": "Cundinamarca",
"cityCode": "25178",
"cityName": "Chipaque"
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETT",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "email@email.com",
"phone": "",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2824;2920",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContactName": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"unitMeasurementCode": "NIU",
"unitMeasurementName": "",
"price": 1285.00,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "V",
"rate": 10,
"amount": 10
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "Mandante",
"identification": "000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"customFields": [{
"value": "666",
"key": "invoiceId"
}]
}
```
## Estructura
### invoiceNoteCr
Tipo: Objeto
Objeto de una nota crédito.
Campo Tipo Longitud ¿Es nulo? Descripción Campo Tipo Longitud ¿Es nulo? Descripción format (Ver opciones ) string 32 Sí Formato PDF del documento emailSender string 128 Sí Remitente email concept (Ver códigos ) string 1 No Concepto por el cual se hace la nota crédito consecutive int No Consecutivo de la nota externalNumber string 16 S Número externo de la factura (Orden de compra) currencyCode string 3 No Tipo de moneda currencyRate (Obligatorio si hay un tipo de moneda extranjera) number 18,6 No Tasa de cambio date date No Fecha de expedición de la nota dateStart date Sí Fecha inicial del periodo de facturación dateEnd date Sí Fecha final del periodo de facturación typeOfOperation (Ver códigos ) string 2 No Tipo de operación terms string 800 Sí Términos y condiciones remark string 800 Sí Pie de pagina observation string 800 Sí Nota / Observación invoicePrefix string 8 No Prefijo de la factura a la cual se le está realizando la nota crédito invoiceConsecutive int No Consecutivo de la factura a la cual se le está realizando la nota crédito invoiceCufe int No Cufe de la factura a la cual se le está realizando la nota crédito invoiceDate date No Fecha de la factura a la cual se le está realizando la nota crédito branch ( branch ) object Sí Objeto de la sucursal resolution ( resolution ) object No Objeto de la resolución customer ( customer ) object No Objeto del cliente invoiceNoteDetails ( invoiceNoteDetail ) array No Arreglo de objetos del detalle de la nota totals ( total ) array No Objeto de los totales de la nota discounts ( discount ) array Sí Arreglo de objetos de los descuentos charges ( charge ) array Sí Arreglo de objetos de los cargos customFields (customFields ) array Sí Arreglo de objetos de los campos personalizados
### branch
Tipo: Objeto
Sucursales de facturación, para colocar estos datos a cambio de los de la empresa configurados en el portal ISV.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 128 Sí Nombre de la sucursal address string 64 Sí Dirección de la sucursal phone string 32 Sí Teléfono de la sucursal countryCode string 8 Sí Código del país countryName string 48 Sí Nombre del país departamentCode string 8 Sí Código del departamento departamentName string 48 Sí Nombre del departamento cityCode string 8 Sí Código de la ciudad cityName string 48 Sí Nombre de la ciudad
### resolution
Tipo: Objeto
Datos de la resolución de facturación.
Campo Tipo Logitud ¿Puede ser nulo? Descripción Campo Tipo Logitud ¿Puede ser nulo? Descripción resolutionKey string 256 No Clave de resolución resolutionPrefix string 8 No Prefijo de la resolución resolutionNumber int No No. de la resolución resolutionRangeInitial int No Rango inicial de facturación resolutionRangeFinal int No Rango final de facturación resolutionValidFrom date No Fecha inicial de validación de facturación resolutionValidUntil date No Fecha final de validación de facturación
### customer
Tipo: Objeto
Detalles del cliente.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción companyName string 128 No Razón social o nombre completo personType (Ver códigos ) string 2 No Tipo de persona regimeType (Ver códigos ) string 2 No Tipo de régimen firstName string 80 No Nombres lastName string 80 No Apellidos identification string 24 No Numero de identificación digitCheck string 1 No Dígito de verificación identificationTypeCode string 4 No Tipo de identificación email string 160 Sí Email phone string 24 Sí Teléfono merchantRegistration string 16 Sí Registro mercantil responsibleFor string 12 Sí Responsable de... Ver códigos responsibilities string 500 No Responsabilidades fiscales economicActivities string 500 Sí Actividades económicas (Separadas por punto y coma) e.g. "2920;2825;2817" billingAddress string 128 Sí DATO DE FACTURACIÓN - Dirección billingCountryName string 48 Sí DATO DE FACTURACIÓN - Nombre del país billingCountryCode string 8 No DATO DE FACTURACIÓN - Código del país billingRegionName string 48 Sí DATO DE FACTURACIÓN - Nombre de la región billingRegionCode string 8 Sí DATO DE FACTURACIÓN -Código de la región billingCityName string 48 Sí DATO DE FACTURACIÓN - Nombre de la ciudad billingCityCode string 8 Sí DATO DE FACTURACIÓN - Código de la ciudad billingPostalCode string 16 Sí DATO DE FACTURACIÓN - Código postal billingNeighborhood string 40 Sí DATO DE FACTURACIÓN - Barrio billingPhone string 24 Sí DATO DE FACTURACIÓN - Teléfono billingContactName string 160 Sí DATO DE FACTURACIÓN - Nombre contacto shippingAddress string 128 Sí DATO DE ENTREGA - Dirección shippingCountryName string 48 Sí DATO DE ENTREGA - Nombre del país shippingCountryCode string 8 Sí DATO DE ENTREGA - Código del país shippingRegionName string 48 Sí DATO DE ENTREGA - Nombre de la región shippingRegionCode string 8 Sí DATO DE ENTREGA - Código de la región shippingCityName string 48 Sí DATO DE ENTREGA - Nombre de la ciudad shippingCityCode string 8 Sí DATO DE ENTREGA - Código de la ciudad shippingPostalCode string 16 Sí DATO DE ENTREGA - Código postal shippingNeighborhood string 40 Sí DATO DE ENTREGA - Barrio shippingPhone string 24 Sí DATO DE ENTREGA - Teléfono shippingContactName string 160 Sí DATO DE ENTREGA - Nombre contacto
### invoiceNoteDetail
Tipo: Objeto
Detalle de la nota crédito.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción standardType (Ver códigos ) string 3 Sí Tipo de código estándar DIAN standardCode string 64 Sí Código estándar DIAN itemCode string 32 No Código del producto o servicio itemName string 200 No Nombre del producto o servicio itemModel string 32 Sí Modelo del producto o servicio description string 1024 No Descripción de la venta brandName string 64 Sí Marca del producto o servicio itemCodeSupplier string 32 Sí Código del producto colocado por el proveedor isPresent boolean 1 No Indica si el producto es un obsequio y por tanto el precio es cero unitMeasurementCode string 4 No Código de unidad de medida del producto o servicio (NIU por defecto) unitMeasurementName string 64 Sí Nombre de unidad de medida del producto o servicio price number 18,6 No Precio unitario del producto o servicio quantity number 18,6 No Cantidad del producto o servicio discounts ( discount ) array Sí Descuentos sobre los items (Productos o servicios) charges ( charge ) array Sí Cargos adicionales sobre los items (Productos o servicios) taxes ( tax ) array Sí Impuestos sobre los items (Productos o servicios) withholdings ( tax ) array Sí Retenciones sobre los items (Productos o servicios) isvMandante ( mandante ) object Sí Mandante
{% hint style="warning" %}
Los **descuentos y cargos** pueden ser sobre los items o sobre la nota **pero no sobre ambos**.
Si agregas los descuentos y cargos en el detalle serán calculados **sobre los items de la nota**, de lo contrario (si son agregados directamente en el objeto de la nota), serán calculados **sobre la nota en general**.
{% endhint %}
### discount
Tipo: Arreglo de objetos
Descuentos **sobre la nota**, tenga en cuenta que **si va a realizar descuentos sobre la nota no se pueden realizar sobre el detalle** o sobre cada producto o servicio facturado.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 40 Sí Nombre del descuento type string 1 No Tipo de valor (V: Valor Fijo, P: Porcentaje) rate number 18,2 No Tarifa del descuento (porcentaje o valor) amount number 18,2 No Valor del descuento
### charge
Tipo: Arreglo de objetos
Cargos **sobre la nota**, tenga en cuenta que **si va a realizar cargos sobre la nota no se pueden realizar sobre el detalle** o sobre cada producto o servicio facturado.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 40 Sí Nombre del cargo type string 1 No Tipo de valor (V: Valor Fijo, P: Porcentaje) rate number 18,6 No Tarifa del cargo (porcentaje o valor) amount number 18,6 No Valor del cargo
### tax
Tipo: Arreglo de objetos
Impuestos sobre el item, producto o servicio facturado estos impuestos tenga en cuenta que **son por unidad facturada, no lo calcule por la cantidad**.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 64 No Nombre del impuesto code string 8 No Código del impuesto type string 1 No Tipo del impuesto (V: Valor Fijo, P: Porcentaje, M: Tarifa x 1000) rate number 18,6 No Tarifa o Porcentaje amount number 18,6 No Valor con cada cantidad
### mandante
Tipo: Objeto
Datos del mandante.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 128 No Razón social o nombre identification string 24 No Número de identificación digitCheck string 1 No Dígito de verificación identificationTypeCode string 4 No Tipo de identificación
### total
Tipo: Objeto
Totales de la nota crédito.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción amount number 18,6 No Total de la nota sin impuestos ni retenciones prepaymentAmount number 18,6 No Valor anticipado aplicado a la nota
### customFields
Tipo: Arreglo de objetos
Valores personalizados, puedes enviar por ejemplo la key interna de tu factura, “Estos campos no son enviados a la DIAN son de utilidad únicamente para el integrador”.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción key string 64 Sí Llave del campo value string 64 Sí Valor del campo
# Nota de ajuste
Estructura del objeto de una nota de ajuste.
## Ejemplo
```javascript
{
"format": "Estandar",
"concept": "1",
"consecutive": 5,
"externalNumber": "",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-18",
"dateStart": "2020-1-18",
"dateEnd": "2020-1-20",
"notes": [
"string"
],
"supportDocumentPrefix": "ds",
"supportDocumentConsecutive": 990004331,
"supportDocumentCuds": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"supportDocumentDate": "2020-1-18",
"branch": {
"name": "Sucursal",
"address": "KR con CLL",
"phone": "000000",
"countryCode": "CO",
"countryName": "COLOMBIA",
"departamentCode": "25",
"departamentName": "Cundinamarca",
"cityCode": "25178",
"cityName": "Chipaque"
},
"supplier": {
"companyName": "Customer",
"personType": "1",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "email@email.com",
"phone": "",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2824;2920",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContactName": ""
},
"supportDocumentAdjustmentDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"unitMeasurementCode": "NIU",
"unitMeasurementName": "",
"price": 1285.00,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "V",
"rate": 10,
"amount": 10
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "Mandante",
"identification": "000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}]
}
```
## Estructura
### adjustmentNote
Tipo: Objeto
Objeto de una nota de ajuste.
Campo Tipo Longitud ¿Es nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción format (Ver opciones ) string 32 Sí Formato PDF del documento concept (Ver códigos ) string 1 No Concepto por el cual se hace la nota consecutive int No Consecutivo de la nota externalNumber string 16 Sí Número externo de la nota currencyCode string 3 No Tipo de moneda currencyRate (Obligatorio si hay un tipo de moneda extranjera) number 18,6 No Tasa de cambio date date No Fecha de expedición de la nota dateStart date Sí Fecha inicial del periodo de facturación dateEnd date Sí Fecha final del periodo de facturación notes array Sí Nota / Observación supportDocumentPrefix string 8 No Prefijo del documento soporte al cual se le está realizando la nota de ajuste supportDocumentConsecutive int No Consecutivo del documento soporte al cual se le está realizando la nota de ajuste supportDocumentCuds int No CUDS del documento soporte al cual se le está realizando la nota de ajuste supportDocumentDate date No Fecha del documento soporte al cual se le está realizando la nota de ajuste branch ( branch ) object Sí Objeto de la sucursal supplier ( supplier ) object No Objeto del proveedor supportDocumentAdjustmentDetails ( supportDocumentAdjustmentDetail ) array No Arreglo de objetos del detalle de la nota totals ( total ) array No Objeto de los totales de la nota discounts ( discount ) array Sí Arreglo de objetos de los descuentos charges ( charge ) array Sí Arreglo de objetos de los cargos
### branch
Tipo: Objeto
Sucursales de facturación, para colocar estos datos a cambio de los de la empresa configurados en el portal ISV.
Campo Tipo Longitud ¿Es opcional? Descripción Campo Tipo Longitud ¿Es opcional? Descripción name string 128 Sí Nombre de la sucursal address string 64 Sí Dirección de la sucursal phone string 32 Sí Teléfono de la sucursal countryCode string 8 Sí Código del país countryName string 48 Sí Nombre del país departamentCode string 8 Sí Código del departamento departamentName string 48 Sí Nombre del departamento cityCode string 8 Sí Código de la ciudad cityName string 48 Sí Nombre de la ciudad
### supplier
Tipo: Objeto
Detalles del proveedor.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción companyName string 128 No Razón social o nombre completo personType (Ver códigos ) string 2 No Tipo de persona firstName string 80 No Nombres lastName string 80 No Apellidos identification string 24 No Numero de identificación digitCheck string 1 No Dígito de verificación identificationTypeCode string 4 No Tipo de identificación email string 160 Sí Email phone string 24 Sí Teléfono merchantRegistration string 16 Sí Registro mercantil responsibleFor string 12 Sí Responsable de... Ver códigos responsibilities string 500 No Responsabilidades fiscales economicActivities string 500 Sí Actividades económicas (Separadas por punto y coma) e.g. "2920;2825;2817" billingAddress string 128 Sí DATO DE FACTURACIÓN - Dirección billingCountryName string 48 Sí DATO DE FACTURACIÓN - Nombre del país billingCountryCode string 8 No DATO DE FACTURACIÓN - Código del país billingRegionName string 48 Sí DATO DE FACTURACIÓN - Nombre de la región billingRegionCode string 8 Sí DATO DE FACTURACIÓN -Código de la región billingCityName string 48 Sí DATO DE FACTURACIÓN - Nombre de la ciudad billingCityCode string 8 Sí DATO DE FACTURACIÓN - Código de la ciudad billingPostalCode string 16 Sí DATO DE FACTURACIÓN - Código postal billingNeighborhood string 40 Sí DATO DE FACTURACIÓN - Barrio billingPhone string 24 Sí DATO DE FACTURACIÓN - Teléfono billingContactName string 160 Sí DATO DE FACTURACIÓN - Nombre contacto
### supportDocumentAdjustmentDetails
Tipo: Objeto
Detalle de la nota de ajuste.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción standardType (Ver códigos ) string 3 Sí Tipo de código estándar DIAN standardCode string 64 Sí Código estándar DIAN itemCode string 32 No Código del producto o servicio itemName string 200 No Nombre del producto o servicio itemModel string 32 Sí Modelo del producto o servicio description string 1024 No Descripción de la venta brandName string 64 Sí Marca del producto o servicio itemCodeSupplier string 32 Sí Código del producto colocado por el proveedor isPresent boolean 1 No Indica si el producto es un obsequio y por tanto el precio es cero unitMeasurementCode string 4 No Código de unidad de medida del producto o servicio (NIU por defecto) unitMeasurementName string 64 Sí Nombre de unidad de medida del producto o servicio price number 18,6 No Precio unitario del producto o servicio quantity number 18,6 No Cantidad del producto o servicio discounts ( discount ) array Sí Descuentos sobre los items (Productos o servicios) charges ( charge ) array Sí Cargos adicionales sobre los items (Productos o servicios) taxes ( tax ) array Sí Impuestos sobre los items (Productos o servicios) withholdings ( tax ) array Sí Retenciones sobre los items (Productos o servicios) isvMandante ( mandante ) object Sí Mandante
{% hint style="warning" %}
Los **descuentos y cargos** pueden ser sobre los items o sobre la nota **pero no sobre ambos**.
Si agregas los descuentos y cargos en el detalle serán calculados **sobre los items de la nota**, de lo contrario (si son agregados directamente en el objeto de la nota), serán calculados **sobre la nota en general**.
{% endhint %}
### discount
Tipo: Arreglo de objetos
Descuentos **sobre la nota**, tenga en cuenta que **si va a realizar descuentos sobre la nota no se pueden realizar sobre el detalle** o sobre cada producto o servicio facturado.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción name string 40 Sí Nombre del descuento type string 1 No Tipo de valor (V: Valor Fijo, P: Porcentaje) rate number 18,2 No Tarifa del descuento (porcentaje o valor) amount number 18,2 No Valor del descuento
### charge
Tipo: Arreglo de objetos
Cargos **sobre la nota**, tenga en cuenta que **si va a realizar cargos sobre la nota no se pueden realizar sobre el detalle** o sobre cada producto o servicio facturado.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Puede ser nulo? Descripción name string 40 Sí Nombre del cargo type string 1 No Tipo de valor (V: Valor Fijo, P: Porcentaje) rate number 18,6 No Tarifa del cargo (porcentaje o valor) amount number 18,6 No Valor del cargo
### tax
Tipo: Arreglo de objetos
Impuestos sobre el item, producto o servicio facturado estos impuestos tenga en cuenta que **son por unidad facturada, no lo calcule por la cantidad**.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción name string 64 No Nombre del impuesto code string 8 No Código del impuesto type string 1 No Tipo del impuesto (V: Valor Fijo, P: Porcentaje, M: Tarifa x 1000) rate number 18,6 No Tarifa o Porcentaje amount number 18,6 No Valor con cada cantidad
### mandante
Tipo: Objeto
Datos del mandante.
Campo Tipo Longitud ¿Es opcional? Descripción Campo Tipo Longitud ¿Es opcional? Descripción name string 128 No Razón social o nombre identification string 24 No Número de identificación digitCheck string 1 No Dígito de verificación identificationTypeCode string 4 No Tipo de identificación
### total
Tipo: Objeto
Totales de la nota de ajuste.
Campo Tipo Longitud ¿Puede ser nulo? Descripción Campo Tipo Longitud ¿Es opcional? Descripción amount number 18,6 No Total de la nota sin impuestos ni retenciones prepaymentAmount number 18,6 No Valor anticipado aplicado a la nota
# Formatos PDF
En esta página puedes ver los formatos PDF que manejamos
### Estándar:
### Azul
### Continental
### Indigo
### FacturaExportación
### MediaCarta
**Tirilla:**
Fecha de emisión anterior a la fecha de inicio de la autorización de la numeración
|
| FAB07b | Fecha inicial del rango de numeración informado NO corresponde a la fecha inicial de los rangos vigente para el contribuyente. |
| FAB08a | Fecha de emisión posterior a la fecha final de la autorización de numeración EndDate < IssueDate |
| FAB08b | Fecha final del rango de numeración informado no corresponde a la fecha final de los rangos vigente para el contribuyente |
| FAB10b | El prefijo no corresponder al prefijo de la autorización de numeración |
| FAB11a | Valor inicial del rango de no está informado |
| FAB11b | Valor inicial del rango de numeración informado no corresponde a un valor inicial de los rangos vigentes para el contribuyente emisor |
| FAB12a | Valor final del rango de no está informad |
| FAB12b | Valor final del rango de numeración informado no corresponde a un valor final de los rangos vigentes para el contribuyente emisor |
| FAB19a | NIT del Prestador de Servicio no fue informado |
| FAB19b | NIT del Prestador de Servicios no está autorizado para prestar servicios |
| FAB22a | Fue informado que Prestador de Servicios está identificado por NIT y el DV no fue informado en el atributo @schemeID |
| FAB22b | DV del NIT del Prestador de Servicios no está correctamente calculado |
| FAB24a | No se encuentra informado el código de software |
| FAB24b | Identificador del software asignado cuando el software se activa en el Sistema de Facturación Electrónica no corresponde a un software autorizado para este OFE |
| FAB24c | Identificador del software informado se encuentra inactivo |
| FAB27a | No se encuentra el código de seguridad del software |
| FAB27b | Huella no corresponde a un software autorizado para este OFE |
| FAB34 | El DV del NIT no está informado o no es correcto |
| FAB35 | Identificador del tipo de documento de identidad no es igual a 31 |
| FAB36 | No está informado la información del Código QR |
| FAC03 | Solamente puede haber una ocurrencia de un grupo UBLExtension conteniendo el grupo ds:Signature |
| FAD01 | UBLVersionID : no contiene el literal “UBL 2.1” |
| FAD02 | CustomizationID no indica un valor válido para el tipo de operación |
| FAD03 | ProfileID : no contiene el literal “DIAN 2.1: Factura Electrónica de Venta” |
| FAD04 | ProfileExecutionID no indica un valor válido para ambiente de destino del documento (1= Producción ; 2= Prueba) |
| FAD05a | No se permiten caracteres adicionales como espacios o guiones |
| FAD05b | Número de factura es inferior al número inicial del rango de numeración autorizado |
| FAD05c | Número de factura es superior al número final del rango de numeración autorizado |
| FAD05d | Número de factura no esta contenido en el rango de numeración autorizado |
| FAD05e | Número de factura no existe para el número de autorización. |
| FAD06 | Valor del CUFE no esta calculado correctamente |
| FAD07 | @schemeID no indica un valor válido para ambiente de destino del documento (1= Producción; 2= Prueba) |
| FAD08 | No fue utilizado o informado uno de los algoritmos permitidos para el cálculo del CUFE. |
| FAD12a | Código de tipo de factura inválido |
| FAD12b | El código informado no corresponde a un tipo válido para este tipo de documento |
| FAD15a | Código de divisa inválido |
| FAD15b | Código de divisa inválido |
| FAD16 | LineCountNumeric : diferente del número de ocurrencias del grupo /Invoice/cac:InvoiceLine |
| FBI02 | *(Sin mensaje)* |
| FBI03 | ID de ND de referencia no relacionada |
| FBI04 | CUDE de ND referenciada no existe |
| FAI01 | Rechazo por /Invoice/cbc:InvoiceTypeCode = “03” y el grupo /Invoice/cac:AdditionalDocumentR eference no esta informado |
| FAI02 | ID de Documento de referencia no relacionado |
| FAI03 | No esta informado el elemento UUID (CUFE o CUDE) |
| FAJ02a | No se encuentra el tipo de organización del emisor |
| FAJ02b | Emisor debe ser persona natural o jurídica (AccountingSupplierParty/cbc:Addi tionalAccountID) |
| FAJ03 | No se encuentra el grupo Party del emisor |
| FAJ12 | Este código no corresponde a un valor válido de la lista |
| FAJ19 | No se encuentra el grupo PartyTaxScheme |
| FAJ20 | Nombre No informado |
| FAJ21 | NIT no autorizado a facturar electrónicamente |
| FAJ24a | No esta informado el DV del NIT |
| FAJ24b | El DV del NIT no es correcto |
| FAJ25 | El contenido de este atributo no corresponde a uno de los valores posibles de las listas |
| FAJ26 | Responsabilidad informada por emisor no válido según lista |
| FAJ32 | Este código no corresponde a un valor válido de la lista |
| FAJ35 | No se encuentra el grupo Country |
| FAJ36 | Código del país del emisor del documento NO corresponde al literal "CO" |
| FAJ42 | No se encuentra el grupo PartyLegalEntity del emisor |
| FAJ43 | Nombre No informado |
| FAJ44 | NIT no autorizado a facturar electrónicamente |
| FAJ47 | DV del NIT del emisor no informado |
| FAJ48 | El contenido de este atributo no corresponde a 31 |
| FAJ49 | No se encuentra el grupo PartyLegalEntity del emisor |
| FAJ53 | No se ha informado el porcentaje de los participantes del consorcio |
| FAJ54 | No se encuentra el grupo ShareholderParty del emisor |
| FAJ60 | DV del NIT del participante no informado |
| FAJ61 | El contenido de este atributo no corresponde a 31 |
| FAK01 | No se encuentra el grupo AccountingCustomerParty del adquiriente |
| FAK02 | No se encuentra el tipo de organización del receptor |
| FAK03 | No se encuentra el grupo Party del adquiriente |
| FAK20 | Nombre o razón social no informado |
| FAK21 | ID de adquiriente no Informado |
| FAK24 | No esta informado el DV del NIT |
| FAK25 | El DV del NIT no es correcto |
| FAK35 | No se encuentra el grupo Country |
| FAK36 | Código del país del adquiriente del documento NO corresponde a un código de la list |
| FAK42 | Rechazo |
| FAK44 | ID adquiriente no informado |
| FAK47 | DV del NIT del adquiriente no informado |
| FAK48 | El contenido de este atributo no corresponde a uno de los valores posibles de las listas |
| FAM30 | *(Sin mensaje)* |
| FAM32 | Si el transportador es responsable debe informar NIT |
| FAM36 | El contenido de este atributo no corresponde a uno de los valores posibles de las listas |
| FAM46 | No se encuentra el grupo Country |
| FAM47 | Código del país del receptor del documento NO corresponde a un código de la lista |
| FAM58 | DV del NIT del transportador no informado |
| FAM59 | El contenido de este atributo no corresponde a uno de los valores posibles de las listas |
| FAN01 | Rechazo si grupo no informado |
| FAN02 | Método de pago inválido |
| FAN03a | Medio de pago inválido |
| FAN03b | Medio de pago no informado |
| FAN04 | Venta a crédito sin información de fecha en la cual se comprometió el pago |
| FBD02 | Identificación del pago del anticipo |
| FBD03 | El valor del anticipo no puede ser superior al valor total de la factura |
| FBD04 | Remítase a regla FAD15 ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAQ03 | ChargeIndicator contiene información diferente de “true” o “false” |
| FAQ07 | Descuento superior al valor base |
| FAQ08 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAQ10 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAR02 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAR04 | No corresponde a valor en la lista |
| FAR05 | TargetCurrencyBase trae valor diferente a 1.00 |
| FAR06 | *(Sin mensaje)* |
| FAS01a | Existe más de un grupo con información de totales para un mismo tributo en la factura |
| FAS01b | Existe un grupo /Invoice/TaxTotal para uno de los impuestos s IVA (01), INC (04), sin que exista un grupo /Invoice/cac:InvoiceLine con información correspondientes al mismo impuesto. |
| FAS02 | (R) Valor total de un tributo no corresponde a la suma de toda la información correspondiente a cada una de las tarifas informadas en este documento para este tributo |
| FAS03 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAS04 | Debe ser informado un grupo de estos para cada tarifa. |
| FAS05 | *(Sin mensaje)* |
| FAS06 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAS07 | (R) El valor del tributo correspondiente a una de las tarifas correspondientes es diferente del producto del porcentaje aplicado sobre la base imponible.
(R) El valor del tributo correspondiente al precio unitario del impuesto multiplicado por la cantidad de item vendidos
|
| FAS08 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAS09 | Elemento cbc:PerUnitAmount es informado y BaseUnitMeasure no es informado |
| FAS11 | Rechazo por el elemento cbcBaseUnitMeasure NO es informado |
| FAS12 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAS15 | *(Sin mensaje)* |
| FAS16 | *(Sin mensaje)* |
| FAT01 | *(Sin mensaje)* |
| FAT02 | *(Sin mensaje)* |
| FAT03 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAT06 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAT07 | *(Sin mensaje)* |
| FAT08 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAT11 | *(Sin mensaje)* |
| FAT12 | *(Sin mensaje)* |
| FAU01 | *(Sin mensaje)* |
| FAU02 | El Valor Bruto antes de tributos no es igual a la suma de los valores de las líneas de la factura que contienen el valor comercial |
| FAU03 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCod |
| FAU05 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAU06 | Valor Bruto más tributos es diferente a Valor Bruto de la factura que contienen el valor comercial más la Suma de los Tributos de todas las líneas de detalle. |
| FAU07 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAU08 | Total descuentos es diferente de la suma de todos los descuentos aplicados al total de la factura |
| FAU09 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAU10 | Valor del Cargo Total es distinto a la Suma de todos los cargos globales aplicados al total de la factura. |
| FAU11 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAU12 | Valor del Anticipo Total es distinto a la Suma de todos los anticipos o prepagos globales aplicados al total de la factura. |
| FAU13 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al |
| FAU14 | Valor a Pagar de Factura es distinto de la Suma de Valor Bruto más tributos - Valor del Descuento Total + Valor del Cargo Total - Valor del Anticipo Total |
| FAU15 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
### Rechazo: Detalle de la factura
| Código | Mensaje |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| FAV01 | *(Sin mensaje)* |
| FAV04 | No se encuentra el campo cbc:InvoicedQuantity |
| FAV06 | Valor total de la línea, libre de tributos, diferente del producto de la cantidad por el precio unitario, considerados los cargos y los descuentos aplicados en esta línea |
| FAV07 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAW01 | Línea de factura informado con LineExtensionAmount en cero y grupo cac:PricingReference no informado |
| FAW03 | Precio referencial no informado. |
| FAW04 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FBE07 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FBE09 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAX01 | Existe más de un grupo con información de totales para un mismo tributo en una línea de la factura |
| FAX03 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAX06 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAX07 | (R) El valor del tributo correspondiente al precio unitario del impuesto multiplicado por la cantidad de ítem vendidos.
(R) El valor del tributo correspondiente a una de las tarifas correspondientes es diferente del producto del porcentaje aplicado sobre la base imponible.
|
| FAX08 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAX09 | Si el elemento NO es informado o no existe |
| FAX12 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAX13 | *(Sin mensaje)* |
| FAX15 | *(Sin mensaje)* |
| FAX16 | Si el contenido de este elemento no corresponde a un contenido de la columna “Identificador” |
| FAY02 | (R) Valor total de un tributo no corresponde a la suma de todas las información correspondientes a cada una de las tarifas informadas en este documento para este tributo |
| FAY03 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAY05 | *(Sin mensaje)* |
| FAY06 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAY07 | El valor del tributo correspondiente a una de las tarifas es diferente del producto del porcentaje aplicado sobre la base imponible |
| FAY08 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAY09 | *(Sin mensaje)* |
| FAY11 | *(Sin mensaje)* |
| FAY12 | Ver lista de valores posibles en Valores para Tributo (13.2.2)
Rechazo: Si el contenido de este elemento no corresponde a un contenido de la columna “Identificador” (aceptase elemento sin contenido)
|
| FAZ01 | *(Sin mensaje)* |
| FAZ02 | Descripción no informada |
| FAZ09 | StandardItemIdentification no informado |
| FAZ10 | Código del ítem de no esta de acuerdo al estandar informado en @schemID |
| FAZ14 | *(Sin mensaje)* |
| FBA01 | *(Sin mensaje)* |
| FBA02 | *(Sin mensaje)* |
| FBA03 | *(Sin mensaje)* |
| FBA05 | El tipo de operación es mandatos y no se informa la identificación del Mandante |
| FBA06 | No informado el literal “195" |
| FBA07 | DV del NIT del emisor no informado |
| FBA08 | Valor diferente a valores de [Tipo de Identificador Fiscal (13.2.1)](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/factura) |
| FBB01 | No existe elemento |
| FBB02 | No esta informado valor |
| FBB03 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FBB04 | No esta informada la cantidad |
| FBB05 | La unidad de la cantidad utilizada no existe en la lista de unidades |
## Notificación
Los siguientes códigos representan una notificación por parte de la DIAN, sin embargo esto no implica un rechazo.
### Notificación: Encabezado de la factura
| Código | Mensaje |
| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| FAA02 | Las extensiones NO deben usarse para repetir información estandarizada en el UBL-XML de la DIAN FE. Si se detectan malas prácticas en su uso la DIAN podrá limitar el número o las funcionalidades del grupo UBLExtensions |
| FAB10a | No es igual al código de la sucursal correspondiente a este punto de facturación |
| FAB14 | No informado el literal “CO” |
| FAB15 | No informado el literal “6" |
| FAB16 | No informado el literal “United Nations Economic Commission for Europe” |
| FAB17 | No informado el literal “urn:oasis:names:specification:ubl: codelist:gc:CountryIdentificationCo de-2.1” |
| FAB23 | Identificador del tipo de documento de identidad no es igual a 31 |
| FAB25 | No informado el literal “195” |
| FAB26 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| FAB28 | No informado el literal “195” |
| FAB29 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| FAB31 | AuthorizationProviderID no corresponde al NIT de la DIAN (800197268) |
| FAB32 | No informado el literal “195” |
| FAB33 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| FAD09a | Fecha de emisión anterior a la fecha de inicio de la autorización de la numeración |
| FAD09b | Fecha de emisión posterior a la fecha final de la autorización de la numeración |
| FAD10 | Debe ser informada la hora en una zona horaria -5, que es la zona horaria oficial de Colombia. |
| FBH01 | *(Sin mensaje)* |
| FBH02 | *(Sin mensaje)* |
| FBH03 | ID de NC de referencia no relacionada |
| FBH04 | CUDE de NC referenciada no existe |
| FBH05 | Algoritmo no corresponde |
| FBH06 | Fecha NC referenciada anterior a fecha de la factura |
| FBI01 | *(Sin mensaje)* |
| FBI05 | Algoritmo no corresponde |
| FAI04 | Identificador del esquema de identificación |
| FAI05 | *(Sin mensaje)* |
| FAJ05 | No se encuentra el grupo PartyName del emisor |
| FAJ06 | Nombre comercial no informado |
| FAJ07 | No se encuentra el grupo PhysicalLocation del emisor |
| FAJ08 | No fue informado el conjunto formado por los elementos: ID, CityName, CountrySubentity, CountrySubentityCode, AddressLine, Line, Country, IdentificationCode |
| FAJ09 | Este código no corresponde a un valor válido de la lista |
| FAJ10 | El nombre no corresponde un valor válido de la lista |
| FAJ73 | Estructura código no válida |
| FAJ11 | El nombre no corresponde un valor válido de la lista |
| FAJ13 | Grupo de elemento que identifica libremente la dirección |
| FAJ14 | Informar la dirección, sin ciudad ni departamento |
| FAJ15 | No se encuentra el grupo Country |
| FAJ16 | Código del país del emisor del documento NO corresponde al literal "CO" |
| FAJ17 | Nombre del país del emisor del documento NO corresponde al literal “Colombia” |
| FAJ18 | Debe contener el literal “es” |
| FAJ22 | No informado el literal “195” |
| FAJ23 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| FAJ28 | No fue informado el conjunto formado por los elementos: ID, CityName, CountrySubentity, CountrySubentityCode, AddressLine, Line, Country, IdentificationCode |
| FAJ29 | Este código no corresponde a un valor válido de la lista |
| FAJ30 | Este código no corresponde a un valor válido de la lista |
| FAJ74 | Estructura código no valida |
| FAJ31 | El nombre no corresponde un valor válido de la lista |
| FAJ33 | *(Sin mensaje)* |
| FAJ34 | Informar la dirección, sin ciudad ni departamento |
| FAJ37 | Nombre del país del emisor del documento NO corresponde al literal “Colombia” |
| FAJ38 | Debe contener el literal “es” |
| FAJ39 | No se encuentra el grupo TaxScheme del emisor |
| FAJ40 | EL contenido de este elemento no corresponde a un contenido válido según lista correspondiente |
| FAJ41 | EL contenido de este elemento no corresponde al Nombre y código válido. |
| FAJ45 | No informado el literal “195" |
| FAJ46 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales) |
| FAJ50 | El prefijo debe existir. |
| FAJ52 | No se encuentra el grupo ShareholderParty del emisor |
| FAJ55 | No se encuentra el grupo PartyTaxScheme del emisor |
| FAJ56 | No se informó el nombre o razón social |
| FAJ57 | ID del participante del consorcio no esta activo en el RUT |
| FAJ58 | No informado el literal “195” |
| FAJ59 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| FAJ62 | Responsabilidad informada por participantes no válido según lista |
| FAJ64 | No se encuentra el grupo PartyTaxScheme del emisor |
| FAJ65 | EL contenido de este elemento no corresponde a un contenido válido según lista correspondiente |
| FAJ66 | EL contenido de este elemento no corresponde al Nombre y código válido. |
| FAJ71 | Correo electrónico no informado |
| FAK05 | No se encuentra el grupo PartyName del adquiriente |
| FAK06 | Nombre no informado |
| FAK08 | El grupo deberá estar conformado al menos por el conjunto formado por los elementos
|
| FAK09 | Este código no corresponde a un valor válido de la lista |
| FAK10 | El nombre no corresponde un valor válido de la lista |
| FAK57 | Estructura código no valida |
| FAK11 | El nombre no corresponde un valor válido de la lista |
| FAK12 | Este código no corresponde a un valor válido de la lista |
| FAK13 | *(Sin mensaje)* |
| FAK14 | Informar la dirección, sin ciudad ni departamento |
| FAK17 | Nombre del país del receptor del documento No esta en lista |
| FAK18 | Debe contener el literal “es” |
| FAK19 | No se encuentra el grupo PartyTaxScheme |
| FAK22 | No informado el literal “195” |
| FAK23 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| FAK26 | Responsabilidad informada para receptor no válido según lista |
| FAK28 | No se encuentra el grupo RegistrationAddress |
| FAK29 | Este código no corresponde a un valor válido de la lista |
| FAK30 | El nombre no corresponde un valor válido de la lista |
| FAK58 | Estructura código no valida |
| FAK31 | El nombre no corresponde un valor válido de la lista |
| FAK32 | Este código no corresponde a un valor válido de la lista |
| FAK33 | *(Sin mensaje)* |
| FAK34 | Informar la dirección, sin ciudad ni departamento |
| FAK37 | Nombre del país del receptor del documento No esta en lista |
| FAK38 | Debe contener el literal “es” |
| FAK39 | No se encuentra el grupo TaxScheme |
| FAK40 | EL contenido de este elemento no corresponde a un contenido válido de la lista correspondiente |
| FAK41 | EL contenido de este elemento no corresponde al Nombre y código válido. |
| FAK43 | Nombre No informado |
| FAK45 | No informado el literal “195” |
| FAK46 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales) |
| FAK49 | *(Sin mensaje)* |
| FAK49 | *(Sin mensaje)* |
| FAK55 | Correo electrónico no informado |
| FAL01 | *(Sin mensaje)* |
| FAL02 | *(Sin mensaje)* |
| FAL03 | *(Sin mensaje)* |
| FAL04 | No informado el literal “195” |
| FAL05 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales) |
| FAL07 | DV del NIT del emisor no informado |
| FAL06 | El contenido de este atributo no corresponde a uno de los valores posibles de las listas |
| FAM04 | *(Sin mensaje)* |
| FAM05 | Este código no corresponde a un valor válido de la lista |
| FAM06 | El nombre no corresponde un valor válido de la lista |
| FAM68 | Estructura código no valida |
| FAM07 | El nombre no corresponde un valor válido de la lista |
| FAM08 | Este código no corresponde a un valor válido de la lista |
| FAM10 | Informar la dirección, sin ciudad ni departamento |
| FAM11 | No se encuentra el grupo Country |
| FAM12 | Código del país del receptor del documento NO corresponde a un código de la lista |
| FAM13 | Nombre del país del receptor del documento No esta en lista |
| FAM14 | Debe contener el literal “es” |
| FAM16 | *(Sin mensaje)* |
| FAM17 | *(Sin mensaje)* |
| FAM18 | *(Sin mensaje)* |
| FAM19 | El grupo deberá estar conformado al menos por el conjunto formado por los elementos
AddressLine, Line, Country, IdentificationCode
|
| FAM20 | Este código no corresponde a un valor válido de la lista |
| FAM21 | El nombre no corresponde un valor válido de la lista |
| FAM69 | Estructura código no valida |
| FAM22 | El nombre no corresponde un valor válido de la lista |
| FAM23 | Este código no corresponde a un valor válido de la lista |
| FAM24 | *(Sin mensaje)* |
| FAM25 | Informar la dirección, sin ciudad ni departamento |
| FAM26 | No se encuentra el grupo Country |
| FAM27 | Código del país del receptor del documento NO corresponde a un código de la lista |
| FAM28 | Nombre del país No esta en lista |
| FAM29 | Debe contener el literal “es” |
| FAM31 | *(Sin mensaje)* |
| FAM33 | No informado el literal “195” |
| FAM34 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| FAM35 | DV del NIT del transportador no informado |
| FAM37 | Responsabilidad informada para transportador no válido según lista |
| FAM39 | *(Sin mensaje)* |
| FAM40 | Este código no corresponde a un valor válido de la lista |
| FAM41 | El nombre no corresponde un valor válido de la lista |
| FAM70 | Estructura código no valida |
| FAM42 | El nombre no corresponde un valor válido de la lista |
| FAM43 | Este código no corresponde a un valor válido de la lista |
| FAM44 | *(Sin mensaje)* |
| FAM45 | Informar la dirección, sin ciudad ni departamento |
| FAM48 | Nombre del país del receptor del documento No esta en lista |
| FAM49 | Debe contener el literal “es” |
| FAM50 | *(Sin mensaje)* |
| FAM51 | *(Sin mensaje)* |
| FAM52 | *(Sin mensaje)* |
| FAM56 | No informado el literal “195” |
| FAM57 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales) |
| FAM66 | Correo electrónico no informado |
| FBC01 | *(Sin mensaje)* |
| FBC02 | *(Sin mensaje)* |
| FBC03 | *(Sin mensaje)* |
| FBC04 | *(Sin mensaje)* |
| FBC05 | *(Sin mensaje)* |
| FAN05 | *(Sin mensaje)* |
| FBD01 | *(Sin mensaje)* |
| FBD05 | *(Sin mensaje)* |
| FBD06 | *(Sin mensaje)* |
| FBD07 | *(Sin mensaje)* |
| FBD08 | *(Sin mensaje)* |
| FAQ01 | *(Sin mensaje)* |
| FAQ04 | Hay un descuento a nivel de factura y no indicó el código del descuento |
| FAQ05 | No se informa razón del descuento o cargo |
| FAQ06 | Porcentaje que aplica superior al 100% |
| FAQ09 | Valor Base para calcular el descuento o cargo superior al valor total de la factura |
| FAR01 | *(Sin mensaje)* |
| FAR03 | SourceCurrencyBaseRate trae valor diferente a 1.00 |
| FAR07 | Fecha en la que se acordó la tasa de cambio |
| FAG02 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| FAG04 | No corresponde a valor en la lista |
| FAG05 | TargetCurrencyBase trae valor diferente a 1.00 |
| FAS10 | Unidad de medida no informada |
| FAS14 | *(Sin mensaje)* |
| FAS17 | Nombre del tributo
Ver lista de valores posibles en 13.2.2
Rechazo: Si el contenido de este elemento no corresponde al contenido correspondiente de la columna “Nombre”
|
| FAT10 | Tarifa del tributo
En el caso de que el tributo es un porcentaje del valor tributable: informar la tarifa (porcentaje) a ser aplicada a la base imponible
Notificación: Si reporta una tarifa diferente para uno de los tributos enunciados en la Tabla de tarifas por Impuesto (13.3.9)
|
| FAT13 | *(Sin mensaje)* |
### Notificación: Detalle de la factura
| Código | Mensaje |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| FAV02a | Más de un grupo conteniendo el elemento /de:Invoice/de:InvoiceLine/cb c:ID con la misma información o no existe ningún valor. |
| FAV02b | Los números de línea de factura utilizados en los diferentes grupos no son consecutivos, empezando con “1” |
| FAV03 | Nota no informada |
| FAV05 | La unidad de la cantidad utilizada no existe en la lista de unidades |
| FBE02 | *(Sin mensaje)* |
| FBE03 | Remítase a regla ZB01 Validación de esquema |
| FBE04 | *(Sin mensaje)* |
| FBE05 | *(Sin mensaje)* |
| FBE06 | *(Sin mensaje)* |
| FBE08 | *(Sin mensaje)* |
| FAX05 | *(Sin mensaje)* |
| FAX10 | El valor informado no corresponde a un valor válido según lista |
| FAX11 | Si el elemento NO es informado o no existe. |
| FAX14 | Reporta una tarifa diferente para uno de los tributos enunciados en la tabla [Tabla de tarifas por Impuesto (13.3.9)](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/factura) |
| FAX17 | Si el contenido de este elemento no corresponde al contenido correspondiente de la columna “Nombre” |
| FAY01 | Existe más de un grupo con información de totales para un mismo tributo en una línea de la factura |
| FAY10 | Si reporta una tarifa diferente para uno de los tributos enunciados en la [Tabla de tarifas por Impuesto (13.3.9)](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/factura) |
| FAY13 | Si el contenido de este elemento no corresponde al contenido correspondiente de la columna “Nombre” |
| FAZ04 | Debe ser informada la marca del artículo en caso de factura internacional |
| FAZ05 | Debe ser informado el modelo del artículo en caso de factura internacional |
| FAZ06 | SellersItemIdentification debe ser informado |
| FAZ07 | código del vendedor no informado |
| FAZ08 | *(Sin mensaje)* |
| FAZ12 | *(Sin mensaje)* |
| FAZ13 | *(Sin mensaje)* |
| FAZ11 | *(Sin mensaje)* |
| FBF01 | *(Sin mensaje)* |
| FBF02 | *(Sin mensaje)* |
| FBF03 | *(Sin mensaje)* |
| FBA04 | El tipo de operación es mandatos y no se informa NIT Mandantes |
# Nota débito
Mensajes correspondientes a cada código de respuesta de la DIAN para notas débito
## Rechazo
Los siguientes códigos representan rechazo por parte de la DIAN debido a datos incorrectos
### Rechazo: Encabezado de la nota débito
| Código | Mensaje |
| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| DAB03 | Más de un grupo UBLExtension conteniendo el grupo sts:DianExtensions |
| DAB19a | NIT del Prestador de Servicio no fue informado. |
| DAB19b | NIT del Prestador de Servicios no está autorizado para prestar servicios. |
| DAB22a | El DV no fue informado en el atributo @schemeID |
| DAB22b | DV del NIT del Prestador de Servicios no está correctamente calculado. |
| DAB24a | No se encuentra informado el código de software. |
| DAB24b | Identificador del software asignado, cuando el software se activa en el Sistema de Facturación Electrónica no corresponde a un software autorizado para este OFE. |
| DAB24D | Identificador del software informado se encuentra inactivo. |
| DAB27a | No se encuentra el código de seguridad del software. |
| DAB27b | Huella no corresponde a un software autorizado para este OFE. |
| DAB31 | AuthorizationProviderID no corresponde al NIT de la DIAN (800197268). |
| DAB34 | El DV del NIT no esta informado o no es correcto. |
| DAB35 | Identificador del tipo de documento de identidad no es igual a 31. |
| DAB36 | No esta registrada la información del Código QR. |
| DAC03 | Solamente puede haber una ocurrencia de un grupo UBLExtension conteniendo el grupo ds:Signature |
| DAD01 | UBLVersionID : no contiene el literal “UBL 2.1”. |
| DAD02 | CustomizationID no indica un valor válido para el tipo de operación. |
| DAD03 | ProfileID : no contiene el literal “Nota Débito de Factura Electrónica de Venta”. |
| DAD04 | ProfileExecutionID no indica un valor válido para ambiente de destino del documento (1= Producción ; 2= Prueba). |
| DAD06 | Valor del CUDE no está calculado correctamente. |
| DAD07 | @schemeID no indica un valor válido para ambiente de destino del documento (1= Producción ; 2= Prueba |
| DAD08 | No fue utilizado o informado uno de los algoritmos permitidos para el cálculo del CUDE. |
| DAD12a | Código de tipo de Nota Débito inválido. |
| DAD12b | El código informado no corresponde a un tipo válido para este tipo de documento. |
| DAD15a | Código de divisa inválido. |
| DAD15b | Código de divisa inválido. |
| DAD16 | LineCountNumeric : diferente del número de ocurrencias del grupo /DebitNote/cac:DebitNoteLine |
| DBF01 | *(Sin mensaje)* |
| DBF03 | El tipo de Nota Débito informado no se encuentra en la “Lista”. |
| DBI01 | *(Sin mensaje)* |
| DBI02 | *(Sin mensaje)* |
| DBI03 | ID de ND de referencia no relacionada. |
| DBI04 | CUFE de Nota Débito referenciada no existe |
| DBI06 | Fecha Factura Electrónica referenciada posterior a fecha de la Nota Débito. |
| DAJ01 | *(Sin mensaje)* |
| DAJ02a | No se encuentra el tipo de organización del emisor. |
| DAJ02b | Emisor debe ser persona natural o jurídica (AccountingSupplierParty/cbc:A dditionalAccountID) |
| DAJ03 | No se encuentra el grupo Party del emisor. |
| DAJ08 | No fue informado el conjunto formado por los elementos :
ID, CityName, CountrySubentity, CountrySubentityCode,
AddressLine, Line, Country, IdentificationCode
|
| DAJ09 | Este código no corresponde a un valor válido de la lista. |
| DAJ12 | Este código no corresponde a un valor válido de la lista. |
| DAJ15 | No se encuentra el grupo Country. |
| DAJ16 | Código del país del emisor del documento NO corresponde al literal "CO". |
| DAJ19 | No se encuentra el grupo PartyTaxScheme |
| DAJ20 | Nombre NO informado |
| DAJ21 | NIT no autorizado a facturar electrónicamente. |
| DAJ24a | NO esta informado el DV del NIT |
| DAJ24b | El DV del NIT no es correcto. |
| DAJ25 | Debe ser 31. |
| DAJ26 | Responsabilidad informada por emisor no válido según lista. |
| DAJ28 | No fue informado el conjunto formado por los elementos : ID, CityName, CountrySubentity, CountrySubentityCode, AddressLine, Line, Country, IdentificationCode |
| DAJ29 | Este código no corresponde a un valor válido de la lista. |
| DAJ33 | Este código no corresponde a un valor válido de la lista. |
| DAJ35 | No se encuentra el grupo Country |
| DAJ36 | Código del país del emisor del documento NO corresponde al literal "CO". |
| DAJ40 | EL contenido de este elemento no corresponde a un contenido válido |
| DAJ41 | EL contenido de este elemento no corresponde al Nombre y código válido. |
| DAJ42 | No se encuentra el grupo PartyLegalEntity del emisor. |
| DAJ43 | Nombre NO informado |
| DAJ44 | NIT no autorizado a facturar electrónicamente. |
| DAJ47 | DV del NIT del emisor no informado. |
| DAJ48 | Debe ser 31. |
| DAJ49 | No se encuentra el grupo PartyLegalEntity del emisor. |
| DAJ52 | No se encuentra el grupo ShareholderParty del emisor |
| DAJ53 | No se ha informado el procentaje de los participantes del consorcio. |
| DAJ54 | No se encuentra el grupo ShareholderParty del emisor. |
| DAJ55 | No se encuentra el grupo PartyTaxScheme del emisor. |
| DAJ60 | DV del NIT del participante no informado. |
| DAJ61 | Debe ser 31. |
| DAK01 | No se encuentra el grupo AccountingCustomerParty del adquiriente. |
| DAK02 | No se encuentra el tipo de organización del receptor. |
| DAK03 | No se encuentra el grupo Party del adquiriente. |
| DAK08 | El grupo deberá estar conformado al menos por el conjunto de elementos de dirección.
ID, CityName, CountrySubentity, CountrySubentityCode,
|
| DAK15 | No se encuentra el grupo Country |
| DAK16 | Código del país del receptor del documento NO corresponde a un código de la lista. |
| DAK19 | No se encuentra el grupo PartyTaxScheme |
| DAK20 | Nombre o razón social no informado. |
| DAK21 | ID de adquiriente no Informado. |
| DAK24 | No esta informado el DV del NIT. |
| DAK25 | El DV del NIT no es correcto. |
| DAK35 | No se encuentra el grupo Country. |
| DAK36 | El código del país del receptor del documento NO corresponde a un código de la lista. |
| DAK47 | DV del NIT del emisor NO informado. |
| DAK48 | El contenido de este atributo no corresponde a uno de los valores posibles de las “Listas”. |
| DAM11 | No se encuentra el grupo Country. |
| DAM12 | Código del país del receptor del documento NO corresponde a un código de la lista. |
| DAM26 | No se encuentra el grupo Country. |
| DAM27 | Código del país NO corresponde a un código de la lista. |
| DAM30 | *(Sin mensaje)* |
| DAM32 | Si el transportador es responsable debe informar NIT. |
| DAM35 | DV del NIT NO informado. |
| DAM36 | El contenido de este atributo NO corresponde a uno de los valores posibles de las “Listas”. |
| DAM46 | No se encuentra el grupo Country |
| DAM47 | Código del país del receptor del documento NO corresponde a un código de la lista. |
| DAM53 | *(Sin mensaje)* |
| DAM55 | Si transportador es responsable, NIT del transportador. |
| DAM58 | DV del NIT del transportador NO informado. |
| DAM59 | El contenido de este atributo NO corresponde a uno de los valores posibles de las “Listas”. |
| DAM60 | *(Sin mensaje)* |
| DAN01 | Rechazo si grupo no informado |
| DAN02 | Método de pago inválido. |
| DAN03a | Medio de pago inválido. |
| DAN03b | Medio de pago NO informado. |
| DAN04 | Venta a crédito sin información de fecha en la cual se comprometió el pago. |
| DAQ03 | ChargeIndicator contiene información diferente de “true” o “false” |
| DAQ07 | Descuento superior al valor base. |
| DAQ08 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que esté elemento corresponda al mismo valor informado en DocumentCurrencyCode. |
| DAQ10 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| DAR01 | Seguir definición estándar del UBL para este grupo. |
| DAR02 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAS01a | Existe más de un grupo con información de totales para un mismo tributo en la factura. |
| DAS01b | Existe un grupo /CreditNote/TaxTotal para uno de los impuestos s IVA (01), INC (04), sin que exista un grupo /DebitNote/cac:DebitNoteLine con información correspondiente al mismo impuesto. |
| DAS02 | (R) Valor total de un tributo no corresponde a la suma de todos los registros correspondientes a cada una de las tarifas informadas en este documento para este tributo. |
| DAS03 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| DAS04 | Debe ser informado un grupo de estos para cada tarifa. |
| DAS05 | *(Sin mensaje)* |
| DAS06 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAS07 | (R) El valor del tributo correspondiente a una de las tarifas correspondientes es diferente del producto del porcentaje aplicado sobre la base imponible.
(R) El valor del tributo correspondiente al precio unitario del impuesto multiplicado por la cantidad de item vendidos.
|
| DAS08 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAS09 | Elemento cbc:PerUnitAmount es informado y BaseUnitMeasure no es informado. |
| DAS11 | Rechazo por el elemento cbcBaseUnitMeasure NO es infomado. |
| DAS12 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAS13 | *(Sin mensaje)* |
| DAS15 | *(Sin mensaje)* |
| DAS16 | *(Sin mensaje)* |
| DAU01 | *(Sin mensaje)* |
| DAU02 | El Valor Bruto antes de tributos NO es igual a la suma de los valores de las líneas de la factura que contienen el valor comercial. |
| DAU03 | Remitase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAU04 | Base Imponible, es distinto a la suma de los valores de las bases imponibles de todas líneas de detalle. |
| DAU05 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAU06 | Valor Bruto más tributos, es diferente a Valor Bruto de la factura que contienen el valor comercial más la suma de los tributos de todas las líneas de detalle. |
| DAU07 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAU08 | Total descuentos, es diferente de la suma de todos los descuentos aplicados al total de la factura. |
| DAU09 | Remitase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAU10 | Valor del Cargo Total es distinto a la suma de todos los cargos globales aplicados al total de la factura. |
| DAU11 | Remitase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAU12 | Valor del Anticipo Total, es distinto a la Suma de todos los anticipos o prepagos globales aplicados al total de la factura. |
| DAU13 | Remitase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAU14 | Valor a Pagar de Factura, es distinto de la Suma de Valor Bruto más tributos - Valor del Descuento Total + Valor del Cargo Total - Valor del Anticipo Total |
| DAU15 | Remitase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
### Rechazo: detalle de la nota débito
| Código | Mensaje |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| DAV01 | *(Sin mensaje)* |
| DAV04 | No se encuentra el campo cbc:DebitedQuantity |
| DAV06 | Valor total de la línea, libre de tributos, diferente del producto de la cantidad por el precio unitario, considerados los cargos y los descuentos aplicados en esta línea. |
| DAV07 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAW01 | Línea de factura informado con LineExtensionAmount en cero y grupo cac:PricingReference no informado. |
| DAW03 | Precio referencial no informado. |
| DAW04 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DBE07 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DBE09 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAX01 | Existe más de un grupo con información de totales para un mismo tributo en una línea de la factura. |
| DAX02 | El valor total del tributo (X) (/DebitNote/cac:DebitNoteLine/ cac:TaxTotal/cbc:TaxAmount) no corresponde a la suma de todas los datos correspondientes a cada una de las tarifas informadas en este documento para este tributo. |
| DAX03 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que ese elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAX06 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAX07 | (R) El valor del tributo correspondiente al precio unitario del impuesto multiplicado por la cantidad de item vendidos.
(R) El valor del tributo correspondiente a una de las tarifas correspondientes, es diferente del producto del porcentaje aplicado sobre la base imponible.
|
| DAX08 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAX09 | Si el elemento NO es informado o NO existe. |
| DAX12 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAX13 | *(Sin mensaje)* |
| DAX15 | *(Sin mensaje)* |
| DAX16 | Si el contenido de este elemento no corresponde a un contenido de la columna “Identificador” |
| DAZ01 | *(Sin mensaje)* |
| DAZ02 | Descripción no informada. |
| DAZ09 | StandardItemIdentification NO informado |
| DAZ10 | Código del ítem de NO esta de acuerdo al estándar informado en @schemID |
| DBA01 | *(Sin mensaje)* |
| DBA02 | *(Sin mensaje)* |
| DBA03 | *(Sin mensaje)* |
| DBA05 | El tipo de operación es mandatos y NO se informa identificación del Mandante. |
| DBA06 | No informado el literal “195” |
| DBA07 | DV del NIT NO informado. |
| DBA08 | Debe ser un valor de [Documento de identificación (Tipo de Identificador Fiscal) (13.2.1)](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/factura) |
| DBB01 | NO existe elemento |
| DBB02 | NO esta informado valor |
| DBB03 | Remitase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DBB04 | NO esta informada la cantidad. |
| DBB05 | La unidad de la cantidad utilizada no existe en la lista de unidades. |
## Notificación
Los siguientes códigos representan una notificación por parte de la DIAN, sin embargo esto no implica un rechazo.
### Notificación: Encabezado de la nota débito
| Código | Mensaje |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| DAA02 | Las extensiones NO deben usarse para repetir información estandarizada en el UBL-XML de la DIAN FE. Si se detectan malas prácticas en su uso la DIAN podrá limitar el número o las funcionalidades del grupo UBLExtensions |
| DAB14 | No informado el literal “CO”. |
| DAB15 | No informado el literal “6”. |
| DAB16 | No informado el literal “United Nations Economic Commission for Europe”. |
| DAB17 | No informado el literal “urn:oasis:names:specification: ubl:codelist:gc:CountryIdentifica tionCode-2.1”. |
| DAB23 | Identificador del tipo de documento de identidad no es igual a 31 |
| DAB25 | No informado el literal “195”. |
| DAB26 | NO informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)”. |
| DAB28 | No informado el literal “195”. |
| DAB29 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)”. |
| DAB32 | No informado el literal “195”. |
| DAB33 | NO informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)”. |
| DAD10 | Debe ser informada la hora, en una zona horaria -5, que es la zona horaria oficial de Colombia. |
| DBI05 | Algoritmo no corresponde. |
| DAJ05 | No se encuentra el grupo PartyName del emisor. |
| DAJ06 | Nombre comercial no informado. |
| DAJ07 | No se encuentra el grupo PhysicalLocation del emisor. |
| DAJ10 | El nombre no corresponde un valor válido de la lista. |
| DAJ73 | Estructura código no valida |
| DAJ11 | El nombre no corresponde un valor válido de la “Lista”. |
| DAJ13 | *(Sin mensaje)* |
| DAJ14 | Informar la dirección, sin ciudad ni departamento. |
| DAJ17 | Nombre del país del emisor del documento NO corresponde al literal “Colombia”. |
| DAJ18 | Debe contener el literal “es”. |
| DAJ22 | No informado el literal “195”. |
| DAJ23 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)”. |
| DAJ30 | Este código no corresponde a un valor válido de la lista. |
| DAJ74 | Estructura código no valida. |
| DAJ31 | El nombre no corresponde un valor válido de la lista |
| DAJ33 | *(Sin mensaje)* |
| DAJ34 | Informar la dirección, sin ciudad ni departamento. |
| DAJ37 | Nombre del país del emisor del documento NO corresponde al literal “Colombia”. |
| DAJ38 | Debe contener el literal “es” |
| DAJ39 | No se encuentra el grupo TaxScheme del emisor |
| DAJ45 | No informado el literal “195”. |
| DAJ46 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales) |
| DAJ50 | Si la numeración de la nota crédito usa prefijo, se debe informar el prefijo en este campo |
| DAJ56 | No se informó el nombre o razón social. |
| DAJ57 | ID del participante de consorcio no estar registrado en la DIAN. |
| DAJ58 | No informado el literal “195”. |
| DAJ59 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| DAJ62 | Responsabilidad informada por participantes no válido según lista. |
| DAJ64 | No se encuentra el grupo PartyTaxScheme del emisor. |
| DAJ65 | EL contenido de este elemento no corresponde a un contenido válido |
| DAJ66 | EL contenido de este elemento no corresponde al Nombre y código válido. |
| DAJ67 | *(Sin mensaje)* |
| DAJ71 | Correo electrónico no informado. |
| DAK05 | No se encuentra el grupo PartyName del adquiriente. |
| DAK06 | Nombre no informado |
| DAK07 | *(Sin mensaje)* |
| DAK09 | Este código no corresponde a un valor válido de la lista. |
| DAK10 | El nombre no corresponde un valor válido de la lista. |
| DAK57 | Estructura código no valida. |
| DAK11 | El nombre no corresponde un valor válido de la lista. |
| DAK12 | Este código no corresponde a un valor válido de la lista |
| DAK13 | *(Sin mensaje)* |
| DAK14 | Informar la dirección, sin ciudad ni departamento. |
| DAK17 | Nombre del país del receptor del documento No esta en la “Lista”. |
| DAK18 | Debe contener el literal “es” |
| DAK22 | No informado el literal “195”. |
| DAK23 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| DAK26 | La responsabilidad informada para el receptor, no es valida según “Lista”. |
| DAK28 | No se encuentra el grupo RegistrationAddress. |
| DAK29 | Este código no corresponde a un valor válido de la lista. |
| DAK30 | El nombre no corresponde un valor válido de la lista. |
| DAK58 | Estructura código no valida. |
| DAK31 | El nombre NO corresponde un valor válido de la lista. |
| DAK32 | Este código NO corresponde a un valor válido de la lista. |
| DAK33 | *(Sin mensaje)* |
| DAK34 | Informar la dirección, sin ciudad ni departamento. |
| DAK37 | Nombre del país del receptor del documento NO esta en lista. |
| DAK38 | Debe contener el literal “es”. |
| DAK39 | No se encuentra el grupo TaxScheme. |
| DAK40 | EL contenido de este elemento no corresponde a un contenido válido |
| DAK41 | El contenido de este elemento NO corresponde al nombre y código válido. |
| DAK42 | Obligatorio si el adquiriente es responsable. |
| DAK43 | Nombre NO informado |
| DAK44 | ID adquiriente NO informado. |
| DAK45 | No informado el literal “195”. |
| DAK46 | NO informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales) |
| DAK49 | *(Sin mensaje)* |
| DAK51 | *(Sin mensaje)* |
| DAK55 | Correo electrónico NO informado. |
| DAL01 | *(Sin mensaje)* |
| DAL02 | *(Sin mensaje)* |
| DAL03 | *(Sin mensaje)* |
| DAL04 | No informado el literal “195”. |
| DAL05 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales) |
| DAL07 | DV del NIT NO informado |
| DAL06 | El contenido de este atributo NO corresponde a uno de los valores posibles de las listas. |
| DAM01 | *(Sin mensaje)* |
| DAM02 | *(Sin mensaje)* |
| DAM03 | *(Sin mensaje)* |
| DAM04 | *(Sin mensaje)* |
| DAM05 | Este código NO corresponde a un valor válido de la lista. |
| DAM06 | El nombre NO corresponde un valor válido de la lista. |
| DAM68 | Estructura código NO valida. |
| DAM07 | El nombre NO corresponde un valor válido de la lista. |
| DAM08 | Este código NO corresponde a un valor válido de la lista. |
| DAM09 | *(Sin mensaje)* |
| DAM10 | Informar la dirección, sin ciudad ni departamento. |
| DAM13 | Nombre del país del receptor del documento NO esta en la “Lista”. |
| DAM14 | Debe contener el literal “es” |
| DAM15 | *(Sin mensaje)* |
| DAM16 | *(Sin mensaje)* |
| DAM17 | *(Sin mensaje)* |
| DAM18 | *(Sin mensaje)* |
| DAM19 | El grupo deberá estar conformado almenos por el conjunto formado por los elementos
|
| DAM20 | Este código no corresponde a un valor válido de la lista. |
| DAM21 | El nombre NO corresponde un valor válido de la lista |
| DAM69 | Estructura código NO valida. |
| DAM22 | El nombre no corresponde un valor válido de la lista. |
| DAM23 | Este código NO corresponde a un valor válido de la lista. |
| DAM24 | *(Sin mensaje)* |
| DAM25 | Informar la dirección, sin ciudad ni departamento. |
| DAM28 | Nombre del país NO esta en lista. |
| DAM29 | Debe contener el literal “es”. |
| DAM31 | *(Sin mensaje)* |
| DAM33 | No informado el literal “195”. |
| DAM34 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| DAM37 | Responsabilidad informada para transportador NO válido según “Lista”. |
| DAM39 | *(Sin mensaje)* |
| DAM40 | Este código NO corresponde a un valor válido de la lista. |
| DAM41 | El nombre NO corresponde un valor válido de la lista |
| *(Sin código)* | Estructura código no valida |
| DAM42 | El nombre NO corresponde un valor válido de la lista. |
| DAM43 | Este código NO corresponde a un valor válido de la lista |
| DAM44 | *(Sin mensaje)* |
| DAM45 | Informar la dirección, sin ciudad ni departamento. |
| DAM48 | Nombre del país del receptor del documento NO esta en la lista. |
| DAM49 | Debe contener el literal “es” |
| DAM50 | *(Sin mensaje)* |
| DAM51 | *(Sin mensaje)* |
| DAM52 | *(Sin mensaje)* |
| DAM54 | Nombre registrado en el RUT. Si el transportador es persona jurídica y desea utilizar el nombre comercial en el archivo de la factura, debe utilizar el elemento: …//cac:AccountingSupplierParty /cac:Party/cac:PartyName/cbc: Name |
| DAM56 | No informado el literal “195” |
| DAM57 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales) |
| DAM61 | Número de matrícula mercantil NO informado. |
| DBD01 | *(Sin mensaje)* |
| DBD02 | *(Sin mensaje)* |
| DBD03 | *(Sin mensaje)* |
| DBD04 | *(Sin mensaje)* |
| DBD05 | *(Sin mensaje)* |
| DAN05 | *(Sin mensaje)* |
| DAQ01 | *(Sin mensaje)* |
| DAQ02 | *(Sin mensaje)* |
| DAQ04 | Hay un descuento a nivel de factura y NO indicó el código del descuento. |
| DAQ05 | Informado descuento en factura internacional sin información de la respectiva justificación. |
| DAQ06 | Porcentaje que aplica superior al 100%. |
| DAQ09 | Valor Base para calcular el descuento o cargo, superior al valor total de la factura. |
| DAR03 | SourceCurrencyBaseRate trae valor diferente a 1.00 |
| DAR04 | No corresponde a valor en la lista. |
| DAR05 | TargetCurrencyBase trae valor diferente a 1.00 |
| DAR06 | *(Sin mensaje)* |
| DAR07 | Fecha en la que se acordó la tasa de cambio. |
| DAS10 | Unidad de medida no informada. |
| DAS14 | *(Sin mensaje)* |
| DAS17 | *(Sin mensaje)* |
### Notificación: detalle de la nota débito
| Código | Mensaje |
| ------ | --------------------------------------------------------------------------------------------------------------------------- |
| DAV02a | Más de un grupo conteniendo el elemento /DebitNote/DebitNoteLine/cbc:I D con la misma información o no existe ningún valor. |
| DAV02b | Los números de línea de factura utilizados en los diferentes grupos no son consecutivos, empezando con “1”. |
| DAV03 | Nota NO informada |
| DAV05 | La unidad de la cantidad utilizada NO existe en la lista de unidades. |
| DAW02 | *(Sin mensaje)* |
| DAW05 | El valor de campo PriceTypeCode no se encuentra en la lista. |
| DBE01 | *(Sin mensaje)* |
| DBE02 | *(Sin mensaje)* |
| DBE03 | Remitase a regla ZB01 Validación de esquema |
| DBE04 | *(Sin mensaje)* |
| DBE05 | *(Sin mensaje)* |
| DBE06 | *(Sin mensaje)* |
| DBE08 | *(Sin mensaje)* |
| DAX04 | *(Sin mensaje)* |
| DAX05 | *(Sin mensaje)* |
| DAX10 | El valor informado NO corresponde a un valor válido según la “Lista”. |
| DAX11 | Si el elemento NO es infomado o NO existe. |
| DAX14 | Reporta una tarifa diferente para uno de los tributos enunciados en la tabla (13.3.9) |
| DAX17 | Si el contenido de este elemento no corresponde al contenido correspondiente de la columna “Nombre”. |
| DAZ04 | Debe ser informada la marca del artículo en caso de factura internacional. |
| DAZ05 | Debe ser informado el modelo del artículo en caso de factura internacional. |
| DAZ06 | SellersItemIdentification debe ser informado. |
| DAZ07 | Código del vendedor no informado. |
| DAZ08 | *(Sin mensaje)* |
| DAZ12 | *(Sin mensaje)* |
| DAZ13 | *(Sin mensaje)* |
| DAZ14 | *(Sin mensaje)* |
| DAZ11 | *(Sin mensaje)* |
| DBD01 | *(Sin mensaje)* |
| DBD02 | *(Sin mensaje)* |
| DBD03 | *(Sin mensaje)* |
| DBA04 | El tipo de operación es mandatos y no se informa NIT Mandantes |
# Nota crédito
Mensajes correspondientes a cada código de respuesta de la DIAN para notas crédito
## Rechazo
Los siguientes códigos representan rechazo por parte de la DIAN debido a datos incorrectos
### Rechazo: Encabezado de la nota crédito
| Código | Mensaje |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| CAB03 | Más de un grupo UBLExtension conteniendo el grupo sts:DianExtensions |
| CAB19a | NIT del Prestador de Servicio no fue informado |
| CAB19b | NIT del Prestador de Servicios no esta autorizado para prestar servicios |
| CAB22a | Fue informado que Prestador de Servicios esta identificado por NIT y el DV no fue informado en el atributo @schemeID |
| CAB22b | DV del NIT del Prestador de Servicios no esta correctamente calculado |
| CAB24a | No se encuentra informado el código de software |
| CAB24b | Identificador del software asignado cuando el software se activa en el Sistema de Facturación Electrónica no corresponde a un software autorizado para este OFE |
| CAB24c | Identificador del software informado se encuentra inactivo |
| CAB27a | No se encuentra el código de seguridad del software |
| CAB27b | Huella no corresponde a un software autorizado para este OFE |
| CAB31 | AuthorizationProviderID no corresponde al NIT de la DIAN (800197268) |
| CAB34 | El DV del NIT no esta informado o no es correcto |
| CAB35 | Identificador del tipo de documento de identidad no es igual a 31 |
| CAB36 | No esta informado la información del Código QR |
| CAC03 | Solamente puede haber una ocurrencia de un grupo UBLExtension conteniendo el grupo ds:Signature |
| CAD01 | UBLVersionID : no contiene el literal “UBL 2.1” |
| CAD02 | CustomizationID no indica un valor válido para el tipo de operación |
| CAD03 | ProfileID : no contiene el literal “Nota Crédito de Factura Electrónica de Venta” |
| CAD04 | ProfileExecutionID no indica un valor válido para ambiente de destino del documento (1= Producción ; 2= Prueba) |
| CAD06 | Valor del CUDE no esta calculado correctamente |
| CAD07 | @schemeID no indica un valor válido para ambiente de destino del documento (1= Producción ; 2= Prueba) |
| CAD08 | No fue utilizado o informado uno de los algoritmos permitidos para el cálculo del CUDE. |
| CAD12a | Código de tipo de Nota Crédito inválido |
| CAD12b | El código informado no corresponde a un tipo válido para este tipo de documento |
| CAD15a | Código de divisa inválido |
| CAD15b | Código de divisa inválido |
| CAD16 | LineCountNumeric : diferente del número de ocurrencias del grupo /CreditNote/cac:CreditNoteLine |
| CBF01 | *(Sin mensaje)* |
| CBF03 | El tipo de Nota Credito informado no se encuentra en la lista |
| CBI01 | Nota tipo uno a uno y no se informa BillingReference |
| CBI02 | *(Sin mensaje)* |
| CBI03 | ID de ND de referencia no relacionada |
| CBI04 | CUFE de ND referenciada no existe |
| CBI06 | Fecha FE referenciada posterior a fecha de la Nota Créditonota crédito |
| CAJ02a | No se encuentra el tipo de organización del emisor |
| CAJ02b | Emisor debe ser persona natural o jurídica (AccountingSupplierParty/cbc:A dditionalAccountID) |
| CAJ03 | No se encuentra el grupo Party del emisor |
| CAJ08 | No fue informado el conjunto formado por los elementos: ID, CityName, CountrySubentity, CountrySubentityCode, AddressLine, Line, Country, IdentificationCode |
| CAJ09 | Este código no corresponde a un valor válido de la lista |
| CAJ12 | Este código no corresponde a un valor válido de la lista |
| CAJ15 | No se encuentra el grupo Country |
| CAJ16 | Código del país del emisor del documento NO corresponde al literal "CO" |
| CAJ19 | No se encuentra el grupo PartyTaxScheme |
| CAJ20 | Nombre No informado |
| CAJ21 | NIT no autorizado a facturar electrónicamente |
| CAJ24a | No esta informado el DV del NIT |
| CAJ24b | El DV del NIT no es correcto |
| CAJ25 | Debe informar 31 |
| CAJ26 | Responsabilidad informada por emisor no válido según lista |
| CAJ29 | Este código no corresponde a un valor válido de la lista |
| CAJ32 | Este código no corresponde a un valor válido de la lista |
| CAJ35 | No se encuentra el grupo Country |
| CAJ36 | Código del país del emisor del documento NO corresponde al literal "CO" |
| CAJ40 | EL contenido de este elemento no corresponde a un contenido válido |
| CAJ41 | EL contenido de este elemento no corresponde al Nombre y código válido. |
| CAJ42 | No se encuentra el grupo PartyLegalEntity del emisor |
| CAJ43 | Nombre No informado |
| CAJ44 | NIT no autorizado a facturar electrónicamente |
| CAJ47 | DV del NIT del emisor no informado |
| CAJ48 | Debe informar 31 |
| CAJ49 | No se encuentra el grupo PartyLegalEntity del emisor |
| CAJ52 | No se encuentra el grupo ShareholderParty del emisor |
| CAJ53 | No se ha informado el procentaje de los participantes del consorcio |
| CAJ54 | No se encuentra el grupo ShareholderParty del emisor |
| CAJ55 | No se encuentra el grupo PartyTaxScheme del emisor |
| CAJ60 | DV del NIT del participante no informado |
| CAJ61 | Debe informar 31 |
| CAK01 | No se encuentra el grupo AccountingCustomerParty del adquiriente |
| CAK02 | No se encuentra el tipo de organización del receptor |
| CAK03 | No se encuentra el grupo Party del adquiriente |
| CAK15 | No se encuentra el grupo Country |
| CAK16 | Código del país del receptor del documento NO corresponde a un código de la lista |
| CAK19 | No se encuentra el grupo PartyTaxScheme |
| CAK20 | Nombre o razón social no informado |
| CAK21 | ID de adquiriente no Informado |
| CAK24 | No esta informado el DV del NIT |
| CAK25 | El DV del NIT no es correcto |
| CAK35 | No se encuentra el grupo Country |
| CAK36 | Código del país del receptor del documento NO corresponde a un código de la lista |
| CAK47 | DV del NIT del emisor NO informado |
| CAK48 | El contenido de este atributo no corresponde a uno de los valores posibles de las listas |
| CAM11 | No se encuentra el grupo Country. |
| CAM12 | Código del país del receptor del documento NO corresponde a un código de la lista. |
| CAM26 | No se encuentra el grupo Country. |
| CAM27 | Código del país del receptor del documento NO corresponde a un código de la lista. |
| CAM30 | *(Sin mensaje)* |
| CAM32 | Si el transportador es responsable debe informar NIT. |
| CAM35 | DV del NIT del participante no informado. |
| CAM36 | El contenido de este atributo no corresponde a uno de los valores posibles de la “lista”. |
| CAM46 | No se encuentra el grupo Country |
| CAM47 | Código del país del receptor del documento NO corresponde a un código de la lista |
| CAM55 | Si transportador es responsable, NIT del transportador. |
| CAM58 | DV del NIT del transportador no informado. |
| CAM59 | El contenido de este atributo no corresponde a uno de los valores posibles de las “Listas”. |
| CAN01 | Rechazo si grupo no informado |
| CAN02 | Método de pago inválido. |
| CAN03a | Medio de pago inválido. |
| CAN03b | Medio de pago no informado. |
| CAN04 | Venta a crédito sin información de fecha en la cual fue comprometido el pago. |
| CAQ03 | ChargeIndicator contiene información diferente de “true” o “false” |
| CAQ07 | Descuento superior al valor base. |
| CAQ08 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que esté elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAQ10 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAR02 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que esté elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAS01a | Existe más de un grupo con información de totales para un mismo tributo en la factura. |
| CAS01b | Existe un grupo /CreditNote/TaxTotal para uno de los impuestos s IVA (01), INC (04), sin que exista un grupo /CreditNote/cac:CreditNoteLine con información correspondientes al mismo impuesto. |
| CAS02 | (R) Valor total de un tributo no corresponde a la suma de todos los registros correspondientes a cada una de las tarifas informadas en este documento para este tributo. |
| CAS03 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAS04 | Debe ser informado un grupo de estos para cada tarifa. |
| CAS05 | *(Sin mensaje)* |
| CAS06 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAS07 | (R) El valor del tributo que corresponde a una de las tarifas correspondientes, es diferente del producto del porcentaje aplicado sobre la base imponible.
(R) El valor del tributo correspondiente al precio unitario del impuesto multiplicado por la cantidad de item vendidos.
|
| CAS08 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| CAS09 | Elemento: cbc:PerUnitAmount es informado y BaseUnitMeasure no es informado. |
| CAS11 | Rechazo por el elemento cbcBaseUnitMeasure NO es infomado. |
| CAS12 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAS15 | *(Sin mensaje)* |
| CAS16 | *(Sin mensaje)* |
| CAU01 | *(Sin mensaje)* |
| CAU01 | El Valor Bruto antes de tributos no es igual a la suma de los valores de las líneas de la factura que contienen el valor comercial. |
| CAU03 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAU04 | Base Imponible, es distinto a la suma de los valores de las bases imponibles de todas líneas de detalle. |
| CAU05 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAU06 | Valor Bruto más tributos es diferente a Valor Bruto de la factura que contienen el valor comercial más la Suma de los Tributos de todas las líneas de detalle. |
| CAU07 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAU08 | Total descuentos, es diferente de la suma de todos los descuentos aplicados al total de la factura. |
| CAU09 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAU10 | Valor del Cargo Total es distinto a la suma de todos los cargos globales aplicados al total de la factura. |
| CAU11 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAU12 | Valor del Anticipo Total, es distinto a la suma de todos los anticipos o prepagos globales aplicados al total de la factura. |
| CAU13 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAU14 | Valor a Pagar de Factura es distinto de la Suma de Valor Bruto más tributos - Valor del Descuento Total + Valor del Cargo Total - Valor del Anticipo Total |
| CAU15 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
### Rechazo: Detalle de la nota crédito
| Código | Mensaje |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| CAV01 | *(Sin mensaje)* |
| CAV04 | No se encuentra el campo cbc:InvoicedQuantity |
| CAV06 | Valor total de la línea, libre de tributos, diferente del producto de la cantidad por el precio unitario, considerados los cargos y los descuentos aplicados en esta línea. |
| CAV07 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAW01 | Línea de factura informado con LineExtensionAmount en cero y grupo cac:PricingReference no informado |
| CAW03 | Precio referencial no informado. |
| CAW04 | Remítase a la regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CBE09 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAX01 | Existe más de un grupo con información de totales para un mismo tributo en una línea de la factura. |
| CAX02 | El valor total del tributo (X) (/Invoice/cac:InvoiceLine/cac:Ta xTotal/cbc:TaxAmount) no corresponde a la suma de todas las informaciones correspondientes a cada una de las tarifas informadas en este documento para este tributo |
| CAX03 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAX06 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponds al mismo valor informado en DocumentCurrencyCode |
| CAX07 | (R) El valor del tributo correspondiente al precio unitario del impuesto multiplicado por la cantidad de item vendidos.
(R) El valor del tributo correspondiente a una de las tarifas correspondientes es diferente del producto del porcentaje aplicado sobre la base imponible.
|
| CAX08 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAX09 | Si el elemento NO es infomado o no existe. |
| CAX12 | Remítase a la regla FAD15b, ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CAX13 | *(Sin mensaje)* |
| CAX15 | *(Sin mensaje)* |
| CAX16 | Si el contenido de este elemento no corresponde a un contenido de la columna “Identificador”. |
| CAZ01 | *(Sin mensaje)* |
| CAZ02 | Descripción no informada |
| CAZ09 | StandardItemIdentification , no informado. |
| CAZ10 | El código del ítem no esta de acuerdo al estándar informado en @schemID |
| CAZ14 | *(Sin mensaje)* |
| CBA01 | *(Sin mensaje)* |
| CBA02 | *(Sin mensaje)* |
| CBA03 | *(Sin mensaje)* |
| CBA05 | El tipo de operación es mandatos y no se informa identificación del Mandante. |
| CBA06 | No informado el literal “195”. |
| CBA07 | DV del NIT del emisor no informado. |
| CBA08 | Debe ser un valor de [Documento de identificación (Tipo de Identificador Fiscal) (13.2.1)](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/factura) |
| CBB01 | No existe elemento. |
| CBB02 | No está informado valor. |
| CBB03 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| CBB04 | No esta informada la cantidad. |
| CBB05 | La unidad de la cantidad utilizada no existe en la lista de unidades. |
| DAB03 | Más de un grupo UBLExtension conteniendo el grupo sts:DianExtensions |
| DAB19a | NIT del Prestador de Servicio no fue informado. |
| DAB19b | NIT del Prestador de Servicios no está autorizado para prestar servicios. |
| DAB22a | El DV no fue informado en el atributo @schemeID |
| DAB22b | DV del NIT del Prestador de Servicios no está correctamente calculado. |
| DAB24a | No se encuentra informado el código de software. |
| DAB24b | Identificador del software asignado, cuando el software se activa en el Sistema de Facturación Electrónica no corresponde a un software autorizado para este OFE. |
| DAB24D | Identificador del software informado se encuentra inactivo. |
| DAB27a | No se encuentra el código de seguridad del software. |
| DAB27b | Huella no corresponde a un software autorizado para este OFE. |
| DAB31 | AuthorizationProviderID no corresponde al NIT de la DIAN (800197268). |
| DAB34 | El DV del NIT no esta informado o no es correcto. |
| DAB35 | Identificador del tipo de documento de identidad no es igual a 31. |
| DAB36 | No esta registrada la información del Código QR. |
| DAC03 | Solamente puede haber una ocurrencia de un grupo UBLExtension conteniendo el grupo ds:Signature |
| DAD01 | UBLVersionID : no contiene el literal “UBL 2.1”. |
| DAD02 | CustomizationID no indica un valor válido para el tipo de operación. |
| DAD03 | ProfileID : no contiene el literal “Nota Débito de Factura Electrónica de Venta”. |
| DAD04 | ProfileExecutionID no indica un valor válido para ambiente de destino del documento (1= Producción ; 2= Prueba). |
| DAD06 | Valor del CUDE no está calculado correctamente. |
| DAD07 | @schemeID no indica un valor válido para ambiente de destino del documento (1= Producción ; 2= Prueba) |
| DAD08 | No fue utilizado o informado uno de los algoritmos permitidos para el cálculo del CUDE. |
| DAD12a | Código de tipo de Nota Débito inválido. |
| DAD12b | El código informado no corresponde a un tipo válido para este tipo de documento. |
| DAD15a | Código de divisa inválido. |
| DAD15b | Código de divisa inválido. |
| DAD16 | LineCountNumeric : diferente del número de ocurrencias del grupo /DebitNote/cac:DebitNoteLine |
| DBF01 | *(Sin mensaje)* |
| DBF03 | El tipo de Nota Débito informado no se encuentra en la “Lista”. |
| DBI01 | *(Sin mensaje)* |
| DBI02 | *(Sin mensaje)* |
| DBI03 | ID de ND de referencia no relacionada. |
| DBI04 | CUFE de Nota Débito referenciada no existe |
| DBI06 | Fecha Factura Electrónica referenciada posterior a fecha de la Nota Débito. |
| DAJ01 | *(Sin mensaje)* |
| DAJ02a | No se encuentra el tipo de organización del emisor. |
| DAJ02b | Emisor debe ser persona natural o jurídica (AccountingSupplierParty/cbc:A dditionalAccountID) |
| DAJ03 | No se encuentra el grupo Party del emisor. |
| DAJ08 | No fue informado el conjunto formado por los elementos : ID, CityName, CountrySubentity, CountrySubentityCode, AddressLine, Line, Country, IdentificationCode |
| DAJ09 | Este código no corresponde a un valor válido de la lista. |
| DAJ15 | No se encuentra el grupo Country. |
| DAJ16 | Código del país del emisor del documento NO corresponde al literal "CO". |
| DAJ19 | No se encuentra el grupo PartyTaxScheme |
| DAJ20 | Nombre NO informado |
| DAJ21 | NIT no autorizado a facturar electrónicamente. |
| DAJ24a | NO esta informado el DV del NIT |
| DAJ24b | El DV del NIT no es correcto. |
| DAJ25 | Debe ser 31. |
| DAJ26 | Responsabilidad informada por emisor no válido según lista. |
| DAJ28 | No fue informado el conjunto formado por los elementos : ID, CityName, CountrySubentity, CountrySubentityCode, AddressLine, Line, Country, IdentificationCode |
| DAJ29 | Este código no corresponde a un valor válido de la lista. |
| DAJ33 | Este código no corresponde a un valor válido de la lista. |
| DAJ35 | No se encuentra el grupo Country |
| DAJ36 | Código del país del emisor del documento NO corresponde al literal "CO". |
| DAJ40 | EL contenido de este elemento no corresponde a un contenido válido |
| DAJ41 | EL contenido de este elemento no corresponde al Nombre y código válido. |
| DAJ42 | No se encuentra el grupo PartyLegalEntity del emisor. |
| DAJ43 | Nombre NO informado |
| DAJ44 | NIT no autorizado a facturar electrónicamente. |
| DAJ48 | Debe ser 31. |
| DAJ49 | No se encuentra el grupo PartyLegalEntity del emisor. |
| DAJ52 | No se encuentra el grupo ShareholderParty del emisor |
| DAJ53 | No se ha informado el procentaje de los participantes del consorcio. |
| DAJ54 | No se encuentra el grupo ShareholderParty del emisor. |
| DAJ55 | No se encuentra el grupo PartyTaxScheme del emisor. |
| DAJ60 | DV del NIT del participante no informado. |
| DAJ61 | Debe ser 31. |
| DAK01 | No se encuentra el grupo AccountingCustomerParty del adquiriente. |
| DAK02 | No se encuentra el tipo de organización del receptor. |
| DAK03 | No se encuentra el grupo Party del adquiriente. |
| DAK08 | El grupo deberá estar conformado al menos por el conjunto de elementos de dirección.
ID, CityName, CountrySubentity, CountrySubentityCode,
|
| DAK15 | No se encuentra el grupo Country |
| DAK16 | Código del país del receptor del documento NO corresponde a un código de la lista. |
| DAK19 | No se encuentra el grupo PartyTaxScheme |
| DAK20 | Nombre o razón social no informado. |
| DAK21 | ID de adquiriente no Informado. |
| DAK24 | No esta informado el DV del NIT. |
| DAK25 | El DV del NIT no es correcto. |
| DAK35 | No se encuentra el grupo Country. |
| DAK36 | El código del país del receptor del documento NO corresponde a un código de la lista. |
| DAK47 | DV del NIT del emisor NO informado. |
| DAK48 | El contenido de este atributo no corresponde a uno de los valores posibles de las “Listas”. |
| DAM11 | No se encuentra el grupo Country. |
| DAM12 | Código del país del receptor del documento NO corresponde a un código de la lista. |
| DAM26 | No se encuentra el grupo Country. |
| DAM27 | Código del país NO corresponde a un código de la lista. |
| DAM30 | *(Sin mensaje)* |
| DAM32 | Si el transportador es responsable debe informar NIT. |
| DAM35 | DV del NIT NO informado. |
| DAM36 | El contenido de este atributo NO corresponde a uno de los valores posibles de las “Listas”. |
| DAM46 | No se encuentra el grupo Country |
| DAM47 | Código del país del receptor del documento NO corresponde a un código de la lista. |
| DAM53 | *(Sin mensaje)* |
| DAM55 | Si transportador es responsable, NIT del transportador. |
| DAM58 | DV del NIT del transportador NO informado. |
| DAM59 | El contenido de este atributo NO corresponde a uno de los valores posibles de las “Listas”. |
| DAM60 | *(Sin mensaje)* |
| DAN01 | Rechazo si grupo no informado |
| DAN02 | Método de pago inválido. |
| DAN03a | Medio de pago inválido. |
| DAN03b | Medio de pago NO informado. |
| DAN04 | Venta a crédito sin información de fecha en la cual se comprometió el pago. |
| DAQ03 | ChargeIndicator contiene información diferente de “true” o “false |
| DAQ07 | Descuento superior al valor base. |
| DAQ08 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que esté elemento corresponda al mismo valor informado en DocumentCurrencyCode. |
| DAQ10 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| DAR01 | Seguir definición estándar del UBL para este grupo. |
| DAR02 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAS01a | Existe más de un grupo con información de totales para un mismo tributo en la factura. |
| DAS01b | Existe un grupo /CreditNote/TaxTotal para uno de los impuestos s IVA (01), INC (04), sin que exista un grupo /DebitNote/cac:DebitNoteLine con información correspondiente al mismo impuesto. |
| DAS02 | (R) Valor total de un tributo no corresponde a la suma de todos los registros correspondientes a cada una de las tarifas informadas en este documento para este tributo. |
| DAS03 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponder al mismo valor informado en DocumentCurrencyCode |
| DAS04 | Debe ser informado un grupo de estos para cada tarifa. |
| DAS05 | *(Sin mensaje)* |
| DAS06 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAS07 | (R) El valor del tributo correspondiente a una de las tarifas correspondientes es diferente del producto del porcentaje aplicado sobre la base imponible.
(R) El valor del tributo correspondiente al precio unitario del impuesto multiplicado por la cantidad de item vendidos.
|
| DAS08 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAS09 | Elemento cbc:PerUnitAmount es informado y BaseUnitMeasure no es informado. |
| DAS11 | Rechazo por el elemento cbcBaseUnitMeasure NO es infomado. |
| DAS12 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAS13 | *(Sin mensaje)* |
| DAS15 | *(Sin mensaje)* |
| DAS16 | *(Sin mensaje)* |
| DAU01 | *(Sin mensaje)* |
| DAU02 | El Valor Bruto antes de tributos NO es igual a la suma de los valores de las líneas de la factura que contienen el valor comercial. |
| DAU03 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAU04 | Base Imponible, es distinto a la suma de los valores de las bases imponibles de todas líneas de detalle. |
| DAU05 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAU06 | Valor Bruto más tributos, es diferente a Valor Bruto de la factura que contienen el valor comercial más la suma de los tributos de todas las líneas de detalle. |
| DAU07 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAU08 | Total descuentos, es diferente de la suma de todos los descuentos aplicados al total de la factura. |
| DAU09 | Remítase a regla FAD15b ya que al cumplirse dicha regla verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAU10 | Valor del Cargo Total es distinto a la suma de todos los cargos globales aplicados al total de la factura. |
| DAU11 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAU12 | Valor del Anticipo Total, es distinto a la Suma de todos los anticipos o prepagos globales aplicados al total de la factura. |
| DAU13 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
| DAU14 | Valor a Pagar de Factura, es distinto de la Suma de Valor Bruto más tributos - Valor del Descuento Total + Valor del Cargo Total - Valor del Anticipo Total |
| DAU15 | Remítase a regla FAD15b ya que al cumplirse dicha regla, se verifica que este elemento corresponda al mismo valor informado en DocumentCurrencyCode |
## Notificación
Los siguientes códigos representan una notificación por parte de la DIAN, sin embargo esto no implica un rechazo.
### Notificación: Encabezado de la nota crédito
| Código | Mensaje |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CAA02 | Las extensiones NO deben usarse para repetir información estandarizada en el UBL-XML de la DIAN FE. Si se detectan malas prácticas en su uso la DIAN podrá limitar el número o las funcionalidades del grupo UBLExtensions |
| CAB14 | No informado el literal “CO” |
| CAB15 | No informado el literal “6” |
| CAB16 | No informado el literal “United Nations Economic Commission for Europe” |
| CAB17 | No informado el literal “urn:oasis:names:specification: ubl:codelist:gc:CountryIdentifica tionCode-2.1” |
| CAB23 | Identificador del tipo de documento de identidad no es igual a 31 |
| CAB25 | No informado el literal “195” |
| CAB26 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| CAB28 | No informado el literal “195” |
| CAB29 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| CAB32 | No informado el literal “195” |
| CAB33 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| CAD10 | Debe ser informada la hora en una zona horaria -5, que es la zona horaria oficial de Colombia. |
| CBI05 | Algoritmo no corresponde |
| CAJ05 | No se encuentra el grupo PartyName del emisor |
| CAJ06 | Nombre comercial no informado |
| CAJ07 | No se encuentra el grupo PhysicalLocation del emi |
| CAJ10 | El nombre no corresponde un valor válido de la lista |
| CAJ73 | Estructura código no valida |
| CAJ11 | El nombre no corresponde un valor válido de la lista |
| CAJ13 | *(Sin mensaje)* |
| CAJ14 | Informar la dirección, sin ciudad ni departamento |
| CAJ17 | Nombre del país del emisor del documento NO corresponde al literal “Colombia” |
| CAJ18 | Debe contener el literal “es” |
| CAJ22 | No informado el literal “195” |
| CAJ23 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| CAJ30 | Este código no corresponde a un valor válido de la lista |
| CAJ74 | Estructura código no valida |
| CAJ31 | El nombre no corresponde un valor válido de la lista |
| CAJ34 | Informar la dirección, sin ciudad ni departamento |
| CAJ37 | Nombre del país del emisor del documento NO corresponde al literal “Colombia” |
| CAJ38 | Debe contener el literal “es” |
| CAJ39 | No se encuentra el grupo TaxScheme del emisor |
| CAJ45 | No informado el literal “195” |
| CAJ46 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales) |
| CAJ50 | Si la numeracion de la nota credito usa prefijo se debe informar el prefijo en este campo. |
| CAJ56 | No se informó el nombre o razón social |
| CAJ58 | No informado el literal “195” |
| CAJ59 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| CAJ62 | Responsabilidad informada por participantes no válido según lista |
| CAJ64 | No se encuentra el grupo PartyTaxScheme del emisor |
| CAJ65 | EL contenido de este elemento no corresponde a un contenido válido |
| CAJ66 | EL contenido de este elemento no corresponde al Nombre y código válido. |
| CAJ67 | *(Sin mensaje)* |
| CAJ71 | Correo electrónico no informado |
| CAK05 | No se encuentra el grupo PartyName del adquiriente |
| CAK06 | Nombre no informado |
| CAK07 | *(Sin mensaje)* |
| CAK08 | El grupo deberá estar conformado al menos por el conjunto formado por los elementos
ID, CityName, CountrySubentity, CountrySubentityCode,
|
| CAK09 | Este código no corresponde a un valor válido de la lista |
| CAK10 | El nombre no corresponde un valor válido de la lista |
| CAK57 | Estructura código no valida |
| CAK11 | El nombre no corresponde un valor válido de la lista |
| CAK12 | Este código no corresponde a un valor válido de la lista |
| CAK13 | *(Sin mensaje)* |
| CAK14 | Informar la dirección, sin ciudad ni departamento |
| CAK17 | Nombre del país del receptor del documento No esta en lista |
| CAK18 | Debe contener el literal “es” |
| CAK22 | No informado el literal “195” |
| CAK23 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)” |
| CAK29 | Este código no corresponde a un valor válido de la lista |
| CAK30 | El nombre no corresponde un valor válido de la lista |
| CAK58 | Estructura código no valida |
| CAK31 | El nombre no corresponde un valor válido de la lista |
| CAK32 | Este código no corresponde a un valor válido de la lista |
| CAK33 | *(Sin mensaje)* |
| CAK34 | Informar la dirección, sin ciudad ni departamento |
| CAK37 | Nombre del país del receptor del documento No esta en lista |
| CAK38 | Debe contener el literal “es” |
| CAK39 | No se encuentra el grupo TaxScheme |
| CAK40 | EL contenido de este elemento no corresponde a un contenido válido |
| CAK41 | EL contenido de este elemento no corresponde al Nombre y código válido. |
| CAK42 | Obligatorio si adquiriente es responsable |
| CAK43 | Nombre NO informado |
| CAK44 | ID adquiriente no informado |
| CAK45 | NO informado el literal “195” |
| CAK46 | NO informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales) |
| CAK49 | *(Sin mensaje)* |
| CAK51 | *(Sin mensaje)* |
| CAK55 | Correo electrónico no informado |
| CAL01 | *(Sin mensaje)* |
| CAL02 | *(Sin mensaje)* |
| CAL03 | *(Sin mensaje)* |
| CAL04 | No informado el literal “195” |
| CAL05 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales) |
| CAL07 | DV del NIT del autorizado no informado |
| CAL06 | El contenido de este atributo no corresponde a uno de los valores posibles de las listas |
| CAM01 | *(Sin mensaje)* |
| CAM02 | *(Sin mensaje)* |
| CAM03 | *(Sin mensaje)* |
| CAM04 | *(Sin mensaje)* |
| CAM05 | Este código no corresponde a un valor válido de la lista |
| CAM06 | El nombre no corresponde un valor válido de la lista |
| CAM68 | Estructura código no valida |
| CAM07 | El nombre no corresponde un valor válido de la lista |
| CAM08 | Este código no corresponde a un valor válido de la lista |
| CAM09 | *(Sin mensaje)* |
| CAM10 | Informar la dirección, sin ciudad ni departamento |
| CAM13 | Nombre del país del receptor del documento No esta en lista. |
| CAM14 | Debe contener el literal “es” |
| CAM15 | *(Sin mensaje)* |
| CAM16 | *(Sin mensaje)* |
| CAM17 | *(Sin mensaje)* |
| CAM18 | *(Sin mensaje)* |
| CAM19 | El grupo deberá estar conformado por los elementos:
ID, CityName, CountrySubentity, CountrySubentityCode,
|
| CAM20 | Este código no corresponde a un valor registrado dentro la lista. |
| CAM21 | El nombre no corresponde un valor válido de la lista |
| CAM69 | Estructura código no valida |
| CAM22 | El nombre NO corresponde un valor válido de la lista. |
| CAM23 | Este código NO corresponde a un valor válido de la lista. |
| CAM25 | Informar la dirección, sin ciudad ni departamento. |
| CAM28 | Nombre del país del receptor del documento No esta en lista. |
| CAM29 | Debe contener el literal “es”. |
| CAM31 | *(Sin mensaje)* |
| CAM33 | No informado el literal “195”. |
| CAM34 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)”. |
| CAM37 | Responsabilidad informada para transportador no válido según “Lista”. |
| CAM39 | *(Sin mensaje)* |
| CAM40 | Este código no corresponde a un valor registrado en la “Lista”. |
| CAM41 | El nombre no corresponde un valor válido de la “Lista”. |
| CAM70 | Estructura código no válida. |
| CAM42 | El nombre no corresponde un valor registrado en la “lista”. |
| CAM43 | Este código no corresponde a un valor válido de la “Lista” |
| CAM44 | *(Sin mensaje)* |
| CAM45 | Informar la dirección, sin ciudad ni departamento |
| CAM48 | Nombre del país del receptor del documento NO esta en lista. |
| CAM49 | Debe contener el literal “es” |
| CAM50 | *(Sin mensaje)* |
| CAM51 | *(Sin mensaje)* |
| CAM52 | *(Sin mensaje)* |
| CAM53 | *(Sin mensaje)* |
| CAM54 | *(Sin mensaje)* |
| CAM56 | No informado el literal “195”. |
| CAM57 | No informado el literal “CO, DIAN (Dirección de Impuestos y Aduanas Nacionales) |
| CAM60 | *(Sin mensaje)* |
| CBC01 | *(Sin mensaje)* |
| CBC02 | *(Sin mensaje)* |
| CBC03 | *(Sin mensaje)* |
| CBC04 | *(Sin mensaje)* |
| CBC05 | *(Sin mensaje)* |
| CAN05 | *(Sin mensaje)* |
| CAQ01 | *(Sin mensaje)* |
| CAQ02 | *(Sin mensaje)* |
| CAQ04 | Hay un descuento a nivel de factura y no indicó el código del descuento. |
| CAQ05 | Informado descuento en factura internacional sin información de la respectiva justificación. |
| CAQ06 | Porcentaje que aplica superior al 100% |
| CAQ09 | Valor Base para calcular el descuento o cargo superior al valor total de la factura. |
| CAR03 | SourceCurrencyBaseRate trae valor diferente a 1.00 |
| CAR04 | No corresponde a valor en la lista. |
| CAR05 | TargetCurrencyBase trae valor diferente a 1.00 |
| CAR06 | *(Sin mensaje)* |
| CAR07 | Fecha en la que se acordó la tasa de cambio. |
| CAS10 | Unidad de medida no informada. |
| CAS13 | *(Sin mensaje)* |
| CAS14 | *(Sin mensaje)* |
| CAS17 | *(Sin mensaje)* |
####
### Notificación: Detalle de la nota crédito
| Código | Mensaje |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CAV02a | Más de un grupo conteniendo el elemento /de:Invoice/de:InvoiceLine/cbc:I D con la misma información o no existe ningún valor. |
| CAV02b | Los números de línea de factura utilizados en los diferentes grupos no son consecutivos, empezando con “1”. |
| CAV03 | Nota no informada. |
| CAV05 | La unidad de la cantidad utilizada no existe en la lista de unidades. |
| CAW02 | *(Sin mensaje)* |
| CAW05 | El valor de campo PriceTypeCode no se encuentra en la “Lista”. |
| CBE01 | *(Sin mensaje)* |
| CBE02 | *(Sin mensaje)* |
| CBE03 | Remitase a regla ZB01 Validación de esquema |
| CBE04 | *(Sin mensaje)* |
| CBE05 | *(Sin mensaje)* |
| CBE06 | *(Sin mensaje)* |
| CBE08 | *(Sin mensaje)* |
| CAX04 | *(Sin mensaje)* |
| CAX05 | *(Sin mensaje)* |
| CAX10 | El valor informado NO corresponde a un valor registrado en la “Lista”. |
| CAX11 | Si el elemento NO es infomado o no existe. |
| CAX14 | Reporta una tarifa diferente para uno de los tributos enunciados en la [Tabla de tarifas por Impuesto (13.3.9)](/primeros-pasos/estructura-de-los-datos/listas-de-codigos/factura) |
| CAX17 | Si el contenido de este elemento no corresponde al contenido registrado en la columna “Nombre”. |
| CAZ04 | Debe ser informada la marca del artículo en caso de factura internacional. |
| CAZ05 | Debe ser informado el modelo del artículo en caso de factura internacional. |
| CAZ06 | SellersItemIdentification debe ser informado. |
| CAZ07 | Código del vendedor no informado. |
| CAZ08 | *(Sin mensaje)* |
| CAZ12 | *(Sin mensaje)* |
| CAZ13 | *(Sin mensaje)* |
| CAZ11 | *(Sin mensaje)* |
| CBC01 | *(Sin mensaje)* |
| CBC02 | *(Sin mensaje)* |
| CBC03 | *(Sin mensaje)* |
# Errores comunes
Esta sección está destinada para mostrarte los errores más comunes y cómo resolverlos
### 1. Errores de autenticación
Ver lista de respuestas de error
**Errores devueltos en la petición:**
```
The HTTP request was forbidden with client authentication scheme 'Anonymous'.
```
```
Authorization denied
```
#### Ejemplo:
#### Solución:
Este error se debe a que no estás enviando la cabecera de autenticación mencionada en [Generar X-API-KEY](/primeros-pasos/generar-x-api-key), de esta manera:
{% hint style="warning" %}
Esta imagen está sacada del software postman, sin embargo deberás añadir el encabezado en el código de tu petición.
{% endhint %}
### 2. Problemas con la resolución
Ver lista de respuestas de error
**Rechazos DIAN:**
FAB05a: No se encuentra el número de autorización del rango de numeración otorgado
FAB05b: Número de la autorización de la numeración no corresponde a un número de autorización de este contribuyente emisor para este Proveedor de Autorización.
FAB07a: Fecha de emisión anterior a la fecha de inicio de la autorización de la numeración StartDate > IssueDate
FAB07b: Fecha inicial del rango de numeración informado NO corresponde a la fecha inicial de los rangos vigente para el contribuyente.
FAB08a: Fecha de emisión posterior a la fecha final de la autorización de numeración EndDate < IssueDate
FAB08b: Fecha final del rango de numeración informado no corresponde a la fecha final de los rangos vigente para el contribuyente
FAB10b: El prefijo no corresponder al prefijo de la autorización de numeración
FAB11a: Valor inicial del rango de no está informado
FAB11b: Valor inicial del rango de numeración informado no corresponde a un valor inicial de los rangos vigentes para el contribuyente emisor
FAB12a: Valor final del rango de no está informado
FAB12b: Valor final del rango de numeración informado no corresponde a un valor final de los rangos vigentes para el contribuyente emisor
#### Ejemplo:
#### Solución:
Debes verificar que todos los valores dentro del objeto **resolution** sean iguales a los valores de la resolución que estés usando, ya sea la resolución de habilitación o la de producción.
{% hint style="info" %}
Recuerda que puedes consultar tu resolución de producción en la sección **Resoluciones** de la plataforma:
{% endhint %}
### 3. Cufe mal calculado
Ver lista de respuestas de error
FAD06: Valor del CUFE no esta calculado correctamente
#### Ejemplo:
#### Solución:
Para este problema aplica también la solución de [#2.-problemas-con-la-resolucion](#2.-problemas-con-la-resolucion "mention").
Si ello no te funciona puedes intentar verificar que el NIT de tu empresa sea correcto en la sección **Mi Empresa:**
{% hint style="info" %}
En caso de que el NIT sea incorrecto presiona el botón editar en la parte superior derecha para hacer las respectivas modificaciones.
{% endhint %}
### 4. El documento contiene demasiados registros
Ver lista de respuestas de error
Detalle Factura: El documento contiene demasiados registros, considere dividirlo en dos o más documentos.
#### Ejemplo:
#### Solución:
Debes convertir tu documento a varios documentos con sus propios datos, ya que al tener más de 100 detalles es posible que el XML devuelto pese más de 500KB y este es el peso máximo admitido.
# Facturas
Consulta rápidamente a las secciones
{% content-ref url="/pages/-LxNffmCLSWd-q2eaTIn" %}
[Enviar factura en modo pruebas](/pruebas/facturas/enviar-factura-en-modo-pruebas)
{% endcontent-ref %}
# Enviar factura en modo pruebas
Modo pruebas
## Enviar factura
`POST` `https://isv.aliaddo.net/api/v1/public/documents/invoice/test`
Enviar una factura a la DIAN en **modo pruebas**.
#### Path Parameters
| Name | Type | Description |
| ------- | ------ | ----------------- |
| version | string | Versión de la API |
#### Headers
| Name | Type | Description |
| --------- | ------ | -------------------------------------------- |
| x-api-key | string | Token generado previamente para autenticarse |
#### Request Body
| Name | Type | Description |
| ---------- | ------ | -------------------- |
| isvInvoice | string | Objeto de la factura |
{% tabs %}
{% tab title="200 Request completado con éxito" %}
```javascript
{
"id": "string",
"code": "string",
"mode": "string",
"format": "string",
"emailSender": "string",
"testSetId": "string",
"prefix": "string",
"consecutive": 0,
"status": "string",
"statusDate": "2020-01-30T00:00:00",
"sequence": "string",
"externalNumber": "string",
"currencyCode": "string",
"currencyRate": 0,
"date": "2020-01-30T00:00:00",
"dateDue": "2020-01-31T00:00:00",
"dateStart": "2020-01-30T00:00:00",
"dateEnd": "2020-01-31T00:00:00",
"typeOfOperation": "string",
"dueDiligence": "",
"incoterms": "string",
"deliveryTerms": "string",
"terms": "string",
"remark": "string",
"observation": "string",
"cufe": "string",
"qr": "string",
"urlPdf": "string",
"urlXmlDocument": "string",
"urlXmlDocumentZip": "string",
"urlXmlApplicationResponse": "string",
"urlXmlAttachedDocument": "string",
"UrlPdfEncoded": "string",
"UrlXmlEncoded": "string",
"dianDeliveryStatus": "string",
"dianState": "string",
"dianStateReason": "string",
"dianStateDate": "0001-01-01T00:00:00",
"sentEmail": false,
"sentEmailAt": "0001-01-01T00:00:00",
"termDay": 0,
"paymentMeanCode": "string",
"rejectReason": "string",
"hasNotesDb": false,
"hasNotesCr": false,
"branch": {
"name": "string",
"address": "string",
"phone": "string",
"countryCode": "string",
"countryName": "string",
"departamentCode": "string",
"departamentName": "string",
"cityCode": "string",
"cityName": "string"
},
"resolution": {
"resolutionKey": "string",
"resolutionPrefix": "string",
"resolutionNumber": 0,
"resolutionRangeInitial": 0,
"resolutionRangeFinal": 0,
"resolutionValidFrom": "2019-01-19T00:00:00",
"resolutionValidUntil": "2030-01-19T00:00:00"
},
"customer": {
"companyName": "string",
"personType": "string",
"regimeType": "string",
"firstName": "string",
"lastName": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string",
"email": "string",
"phone": "string",
"merchantRegistration": "string",
"responsibilities": "string",
"economicActivities": "string",
"billingAddress": "string",
"billingCountryName": "string",
"billingCountryCode": "string",
"billingRegionName": "string",
"billingRegionCode": "string",
"billingCityName": "string",
"billingCityCode": "string",
"billingPostalCode": "string",
"billingNeighborhood": "string",
"billingPhone": "string",
"billingContactName": "string",
"shippingAddress": "string",
"shippingCountryName": "string",
"shippingCountryCode": "string",
"shippingRegionName": "string",
"shippingRegionCode": "string",
"shippingCityName": "string",
"shippingCityCode": "string",
"shippingPostalCode": "string",
"shippingNeighborhood": "string",
"shippingPhone": "string",
"shippingContactName": "string"
},
"invoiceDetails": [{
"standardType": "string",
"standardCode": "string",
"itemCode": "string",
"itemName": "string",
"itemModel": "string",
"description": "string",
"brandName": "string",
"itemCodeSupplier": "string",
"isPresent": false,
"unitMeasurementCode": "string",
"unitMeasurementName": "string",
"price": 0,
"quantity": 0,
"discountAmount": 0,
"chargeAmount": 0,
"subTotal": 0,
"priceWithAllowanceCharge": 0,
"totalWithAllowanceCharge": 0,
"discounts": [{
"name": "string",
"type": "string",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0,
"amount": 0
}],
"taxes": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0,
"amount": 0,
"base": 0
}],
"withholdings": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0,
"amount": 0,
"base": 0
}],
"isvMandante": {
"name": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string"
}
}],
"totals": {
"amount": 0,
"prepaymentAmount": 0,
"taxesAmount": 0,
"withholdingAmount": 0,
"discountsAmount": 0,
"chargesAmount": 0
},
"discounts": [{
"name": "string",
"type": "string",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0,
"amount": 0
}],
"customFields": [{
"key": "string",
"value": "string"
}],
"createdAt": "0001-01-01T00:00:00",
"updatedAt": "0001-01-01T00:00:00",
"isDue": false
}
```
{% endtab %}
{% tab title="204 " %}
```
No se encontraron resultados de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="400 " %}
```javascript
No se han enviado los tipos de datos requeridos
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using System;
using Newtonsoft.Json;
using RestSharp;
public class Program
{
public static void Main()
{
/**
- Enviar una factura a la DIAN, en modo pruebas
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
var request = new RestRequest("invoice/test", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto factura con resolución ejemplo
var isvInvoice = new
{
code = "01",
format = "Estandar",
emailSender = "email@example.com",
consecutive = 990004332,
externalNumber = "54554",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateDue = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
typeOfOperation = "10",
dueDiligence = "",
incoterms = "",
terms = "",
remark = "",
observation = "",
termDay = 0,
paymentMeanCode = "48",
branch = new {
name = "branch",
address = "Cl6 Cra 66",
phone = "7649813",
countryCode = "CO",
countryName = "Colombia",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "11001",
cityname = "Bogotá, D.c."
},
resolution = new
{
resolutionKey = "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix = "SETT",
resolutionNumber = 18760000001,
resolutionRangeInitial = 990000000,
resolutionRangeFinal = 995000000,
resolutionValidFrom = "2019-01-19",
resolutionValidUntil = "2030-01-19"
},
customer = new
{
companyName = "Customer",
personType = "1",
regimeType = "04",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "",
phone = "0000001",
merchantRegistration = "",
responsibleFor: "ZZ",
responsibilities = "R-99-PN",
economicActivities = "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = "",
shippingAddress = "",
shippingCountryName = "",
shippingCountryCode = "",
shippingRegionName = "",
shippingRegionCode = "",
shippingCityName = "",
shippingCityCode = "",
shippingPostalCode = "",
shippingNeighborhood = "",
shippingPhone = "",
shippingContactName = ""
},
invoiceDetails = new[]{
new {
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
isRemmitance: false,
remmitanceNumber: "",
remmitanceConsecutive: "",
remmitanceValue: 0,
remmitanceQuantityValue: 0,
remmitanceMeasurementUnit: "",
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]{
new {
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]{
new {
name = "",
code = "01",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]{
new {
name = "Iva",
code = "01",
type = "P",
rate = 20,
amount = 6.46
}
},
withholdings = new[]{
new {
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "000001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new {
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new {
name = "",
type = "V",
rate = 10,
amount = 10
}
},
customFields = new[]
{
new KeyValuePair("NombreCampo", "ValorCampo")
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvInvoice), ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mostrar respuesta
Console.WriteLine((int) response.StatusCode);
Console.WriteLine(response.Content);
}
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* - Enviar una factura a la DIAN, en modo pruebas
* - Realizar request por metodo POST
*/
fetch('https://isv.aliaddo.net/api/v1/public/documents/invoice/test', {
method: 'POST',
// Crear objeto factura con resolución de ejemplo
body: JSON.stringify({
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": "990004322",
"externalNumber": "",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-23",
"dateDue": "2020-1-29",
"dateStart": "2020-1-23",
"dateEnd": "2020-1-29",
"typeOfOperation": "10",
"dueDiligence": "",
"incoterms": "",
"deliveryTerms": "",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departamentCode": "",
"departamentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": "18760000001",
"resolutionRangeInitial": "990000000",
"resolutionRangeFinal": "995000000",
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "email@email.com",
"phone": "",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContactName": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"isRemmitance": false,
"remmitanceNumber": "",
"remmitanceConsecutive": "",
"remmitanceValue": 0,
"remmitanceQuantityValue": 0,
"remmitanceMeasurementUnit": "",
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": "1285.00",
"quantity": "2",
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "V",
"rate": 10,
"amount": 10
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "Mandante",
"identification": "000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"prepaymentAmount": 68,
"amount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}
],
"customFields": [{
"value": "666",
"key": "invoiceId"
}]
}),
// Añadir cabeceras a la petición
headers: {
'Content-Type': 'application/json',
'x-api-key': '{{x-api-key}}'
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => res.json())
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el request
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
// Agregar dependencia de GSON para serializar los objetos de Java a JSON
com.google.code.gson
gson
2.8.5
*/
// **** Clase donde se ejecuta el request ****
// Agregue las dependencias de UniRest a su POM como se indica en el código superior
import com.google.gson.*;
import kong.unirest.*;
/*
* - Enviar una factura a la DIAN, en modo pruebas
* - Añada las dependencias de UniRest y GSON a su POM como se muestra en el código de la parte superior
*/
public class Program {
public static void main(String[] args) {
// Crear objeto factura con resolución ejemplo
JsonObject isvInvoice = new JsonObject();
isvInvoice.addProperty("code", "01");
isvInvoice.addProperty("format", "Estandar");
isvInvoice.addProperty("emailSender", "");
isvInvoice.addProperty("consecutive", 990004336);
isvInvoice.addProperty("externalNumber", "54554");
isvInvoice.addProperty("currencyCode", "COP");
isvInvoice.addProperty("currencyRate", 0);
isvInvoice.addProperty("date", "2020-1-20");
isvInvoice.addProperty("dateDue", "2020-1-24");
isvInvoice.addProperty("dateStart", "2020-1-20");
isvInvoice.addProperty("dateEnd", "2020-1-24");
isvInvoice.addProperty("typeOfOperation", "10");
isvInvoice.addProperty("dueDiligence", "");
isvInvoice.addProperty("incoterms", "");
isvInvoice.addProperty("terms", "");
isvInvoice.addProperty("remark", "");
isvInvoice.addProperty("observation", "");
isvInvoice.addProperty("termDay", 0);
isvInvoice.addProperty("paymentCode", 48);
JsonObject branchObj = new JsonObject();
branchObj.addProperty("name", "");
branchObj.addProperty("address", "");
branchObj.addProperty("phone", "");
branchObj.addProperty("countryCode", "");
branchObj.addProperty("countryName", "");
branchObj.addProperty("departmentCode", "");
branchObj.addProperty("departmentName", "");
branchObj.addProperty("cityCode", "");
branchObj.addProperty("cityName", "");
isvInvoice.add("branch", branchObj);
JsonObject resolutionObj = new JsonObject();
resolutionObj.addProperty("resolutionKey", "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c");
resolutionObj.addProperty("resolutionPrefix", "SETP");
resolutionObj.addProperty("resolutionNumber", 18760000001f); // La f indica tipo float
resolutionObj.addProperty("resolutionRangeInitial", 990000000);
resolutionObj.addProperty("resolutionRangeFinal", 995000000);
resolutionObj.addProperty("resolutionValidFrom", "2019-01-19");
resolutionObj.addProperty("resolutionValidUntil", "2030-01-19");
isvInvoice.add("resolution", resolutionObj);
JsonObject customerObj = new JsonObject();
customerObj.addProperty("companyName", "Customer");
customerObj.addProperty("personType", "1");
customerObj.addProperty("regimeType", "04");
customerObj.addProperty("firstName", "Customer");
customerObj.addProperty("lastName", "Customer");
customerObj.addProperty("identification", "000000001");
customerObj.addProperty("digitCheck", "8");
customerObj.addProperty("identificationTypeCode", "13");
customerObj.addProperty("email", "");
customerObj.addProperty("phone", "0000001");
customerObj.addProperty("merchantRegistration", "");
customerObj.addProperty("responsibleFor", "ZZ");
customerObj.addProperty("responsibilities", "R-99-PN");
customerObj.addProperty("economicActivities", "2817;3092");
customerObj.addProperty("billingAddress", "KR con Calle");
customerObj.addProperty("billingCountryName", "Colombia");
customerObj.addProperty("billingCountryCode", "CO");
customerObj.addProperty("billingRegionName", "Cundinamarca");
customerObj.addProperty("billingRegionCode", "25");
customerObj.addProperty("billingCityName", "Chipaque");
customerObj.addProperty("billingCityCode", "25178");
customerObj.addProperty("billingPostalCode", "");
customerObj.addProperty("billingNeighborhood", "");
customerObj.addProperty("billingPhone", "");
customerObj.addProperty("billingContactName", "");
customerObj.addProperty("shippingAddress", "");
customerObj.addProperty("shippingCountryName", "");
customerObj.addProperty("shippingCountryCode", "");
customerObj.addProperty("shippingRegionName", "");
customerObj.addProperty("shippingRegionCode", "");
customerObj.addProperty("shippingCityName", "");
customerObj.addProperty("shippingCityCode", "");
customerObj.addProperty("shippingPostalCode", "");
customerObj.addProperty("shippingNeighborhood", "");
customerObj.addProperty("shippingPhone", "");
customerObj.addProperty("shippingContactName", "");
isvInvoice.add("customer", customerObj);
JsonArray invoiceDetailsArr = new JsonArray();
JsonObject invoiceDetailsObj = new JsonObject();
invoiceDetailsObj.addProperty("standardType", "");
invoiceDetailsObj.addProperty("standardCode", "");
invoiceDetailsObj.addProperty("itemCode", "0001");
invoiceDetailsObj.addProperty("itemName", "Item");
invoiceDetailsObj.addProperty("itemModel", "");
invoiceDetailsObj.addProperty("description", "Item prueba");
invoiceDetailsObj.addProperty("brandName", "");
invoiceDetailsObj.addProperty("itemCodeSupplier", "");
invoiceDetailsObj.addProperty("isPresent", false);
invoiceDetailsObj.addProperty("isRemmitance", false);
invoiceDetailsObj.addProperty("remmitanceNumber", "");
invoiceDetailsObj.addProperty("remmitanceConsecutive", "");
invoiceDetailsObj.addProperty("remmitanceValue", 0);
invoiceDetailsObj.addProperty("remmitanceQuantityValue", 0);
invoiceDetailsObj.addProperty("remmitanceMeasurementUnit", "");
invoiceDetailsObj.addProperty("unitMeasurementCode", "");
invoiceDetailsObj.addProperty("unitMeasurementName", "");
invoiceDetailsObj.addProperty("price", 25);
invoiceDetailsObj.addProperty("quantity", 2);
invoiceDetailsArr.add(invoiceDetailsObj);
JsonArray discountsArr = new JsonArray();
JsonObject discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "V");
discountsObj.addProperty("rate", 1);
discountsObj.addProperty("amount", 1);
discountsArr.add(discountsObj);
invoiceDetailsObj.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "V");
chargesObj.addProperty("rate", 10);
chargesObj.addProperty("amount", 10);
chargesArr.add(chargesObj);
invoiceDetailsObj.add("charges", chargesArr);
JsonArray taxesArr = new JsonArray();
JsonObject taxesObj = new JsonObject();
taxesObj.addProperty("name", "Iva");
taxesObj.addProperty("code", "01");
taxesObj.addProperty("type", "P");
taxesObj.addProperty("rate", 19);
taxesObj.addProperty("amount", 6.46);
taxesArr.add(taxesObj);
invoiceDetailsObj.add("taxes", taxesArr);
JsonArray withholdingsArr = new JsonArray();
JsonObject withholdingsObj = new JsonObject();
withholdingsObj.addProperty("name", "ReteFuente");
withholdingsObj.addProperty("code", "06");
withholdingsObj.addProperty("type", "P");
withholdingsObj.addProperty("rate", 10);
withholdingsObj.addProperty("amount", 3.4);
withholdingsArr.add(withholdingsObj);
invoiceDetailsObj.add("withholdings", withholdingsArr);
JsonObject isvMandanteObj = new JsonObject();
isvMandanteObj.addProperty("name", "Mandante");
isvMandanteObj.addProperty("identification", "00001");
isvMandanteObj.addProperty("digitCheck", "8");
isvMandanteObj.addProperty("identificationTypeCode", "13");
invoiceDetailsObj.add("isvMandante", isvMandanteObj);
isvInvoice.add("invoiceDetails", invoiceDetailsArr);
JsonObject totals = new JsonObject();
totals.addProperty("amount", 68);
totals.addProperty("prepaymentAmount", 0);
isvInvoice.add("totals", totals);
JsonArray invoiceDiscountsArr = new JsonArray();
JsonObject invoiceDiscountsObj = new JsonObject();
invoiceDiscountsObj.addProperty("name", "");
invoiceDiscountsObj.addProperty("type", "");
invoiceDiscountsObj.addProperty("rate", 0);
invoiceDiscountsObj.addProperty("amount", 0);
invoiceDiscountsArr.add(invoiceDiscountsObj);
isvInvoice.add("discounts", invoiceDiscountsArr);
JsonArray invoiceChargesArr = new JsonArray();
JsonObject invoiceChargesObj = new JsonObject();
invoiceChargesObj.addProperty("name", "");
invoiceChargesObj.addProperty("type", "");
invoiceChargesObj.addProperty("rate", 0);
invoiceChargesObj.addProperty("amount", 0);
invoiceChargesArr.add(invoiceChargesObj);
isvInvoice.add("discounts", invoiceChargesArr);
JsonArray customFieldsArr = new JsonArray();
JsonObject customFieldsObj = new JsonObject();
customFieldsObj.addProperty("666", "invoiceId");
customFieldsArr.add(customFieldsObj);
isvInvoice.add("customFields", customFieldsArr);
// Realizar request por metodo POST
HttpRequestWithBody request = Unirest.post("https://isv.aliaddo.net/api/v1/public/documents/invoice/test");
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.header("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.header("content-type", "application/json");
request.header("cache-control", "no-cache");
request.header("accept", "application/json");
// Añadir el objeto de factura
request.body(isvInvoice).asJson()
// Manejar respuesta o error si hay alguno
.ifSuccess(response -> System.out.println("Response: " + "status -> " + response.getStatus() + " Body -> " + response.getBody() ))
.ifFailure(response -> {
System.out.println("Oh No! Status " + response.getStatus());
response.getParsingError().ifPresent(e -> {
System.out.println("Parsing Exception: " + e);
System.out.println("Original body: " + e.getOriginalBody());
});
});
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'01',
'format' => 'Estandar',
'emailSender' => '',
'consecutive' => 990004337,
'externalNumber' => '54554',
'currencyCode' => 'COP',
'currencyRate' => 0,
'date' => '2020-1-22',
'dateDue' => '2020-1-29',
'dateStart' => '2020-1-22',
'dateEnd' => '2020-1-29',
'typeOfOperation' => '10',
'dueDiligence' => '',
'incoterms' => '',
'terms' => '',
'remark' => '',
'observation' => '',
'termDay' => 0,
'paymentMeanCode' => '48',
'branch' => array(
'name' => '',
'address' => '',
'phone' => '',
'countryCode' => '',
'countryName' => '',
'departmentCode' => '',
'departmentName' => '',
'cityCode' => '',
'cityName' => ''
),
'resolution' => array(
'resolutionKey' => 'fc8eac422eba16e22ffd8c6f94b3f40a6e38162c',
'resolutionPrefix' => 'SETP',
'resolutionNumber' => 18760000001,
'resolutionRangeInitial' => 990000000,
'resolutionRangeFinal' => 995000000,
'resolutionValidFrom' => '2019-01-19',
'resolutionValidUntil' => '2030-01-19'
),
'customer' => array(
'companyName' => 'Customer',
'personType' => '1',
'regimeType' => '04',
'firstName' => 'Customer',
'lastName' => 'Customer',
'identification' => '000000001',
'digitCheck' => '8',
'identificationTypeCode' => '13',
'email' => '',
'phone' => '0000001',
'merchantRegistration' => '',
'responsibleFor' => 'ZZ',
'responsibilities' => 'R-99-PN',
'economicActivities' => '2817;3092',
'billingAddress' => 'KR con Calle',
'billingCountryName' => 'Colombia',
'billingCountryCode' => 'CO',
'billingRegionName' => 'Cundinamarca',
'billingRegionCode' => '25',
'billingCityName' => 'Chipaque',
'billingCityCode' => '25178',
'billingPostalCode' => '',
'billingNeighborhood' => '',
'billingPhone' => '',
'billingContactName' => '',
'shippingAddress' => '',
'shippingCountryName' => '',
'shippingCountryCode' => '',
'shippingRegionName' => '',
'shippingRegionCode' => '',
'shippingCityName' => '',
'shippingCityCode' => '',
'shippingPostalCode' => '',
'shippingNeighborhood' => '',
'shippingPhone' => '',
'shippingContactName' => ''
),
'invoiceDetails' => array(
array(
'standardType' => '',
'standardCode' => '',
'itemCode' => '0001',
'itemName' => 'Item',
'itemModel' => '',
'description' => 'Item prueba',
'brandName' => '',
'itemCodeSupplier' => '',
'isPresent' => false,
'isRemmitance' => false,
'remmitanceNumber' => "",
'remmitanceConsecutive' => "",
'remmitanceValue' => 0,
'remmitanceQuantityValue' => 0,
'remmitanceMeasurementUnit' => "",
'unitMeasurementCode' => '',
'unitMeasurementName' => '',
'price' => 25,
'quantity' => 2,
'discounts' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 1,
'amount' => 1
)
),
'charges' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 10,
'amount' => 10
)
),
'taxes' => array(
array(
'name' => 'Iva',
'code' => '01',
'type' => 'P',
'rate' => 19,
'amount' => 6.46
)
),
'withholdings' => array(
array(
'name' => 'ReteFuente',
'code' => '06',
'type' => 'P',
'rate' => 10,
'amount' => 3.4,
)
),
'isvMandante' => array(
'name' => 'Mandante',
'identification' => '000001',
'digitCheck' => '8',
'identificationTypeCode' => '13'
)
)
),
'totals' => array(
'amount' => 68,
'prepaymentAmount' => 0
),
'discounts' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'charges' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'customFields' => array(
array(
'value' => '6666',
'key' => 'invoiceId'
)
)
);
// Serializar la factura a JSON
$isvInvoice = json_encode($invoice);
/**
* - Enviar una factura a la DIAN, en modo pruebas
* - Realizar request por metodo POST
*/
curl_setopt_array($curl, array(
CURLOPT_URL => "https://isv.aliaddo.net/api/v1/public/documents/invoice/test",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => $isvInvoice,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
// Tipo de requerimiento formato json
"content-type: application/json",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Mostar respuesta o error si hubo alguno
if ($err) {
echo "error -> " . $err;
} else {
echo $response;
}
// Terminar petición
curl_close($curl);
?>
```
{% endtab %}
{% tab title="Python" %}
```python
# Importar la librería "requests"
import requests
# - Enviar una factura a la DIAN, en modo pruebas
url = 'https://isv.aliaddo.net/api/v1/public/documents/invoice/test'
# Crear objeto factura con resolución ejemplo
isvInvoice = {
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": 990077341,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateDue": "2020-1-25",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"dueDiligence": "",
"incoterms": "01",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": False,
"isPresent": False,
"isRemmitance": False,
"remmitanceNumber": "",
"remmitanceConsecutive": "",
"remmitanceValue": 0,
"remmitanceQuantityValue": 0,
"remmitanceMeasurementUnit": "",
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# - Realizar request por metodo POST
request = requests.post(url, json=isvInvoice, headers=headers)
# Mostrar respuesta de la petición
print(request.text)
print(request.status_code)
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
# Requerir gemas "rest-client" y "json"
require 'rest-client'
require 'json'
# - Enviar una factura en modo pruebas
url = "https://isv.aliaddo.net/api/v1/public/documents/invoice/test"
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# Crear objeto factura con resolución ejemplo
isvInvoice = {
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": 990077342,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateDue": "2020-1-25",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"dueDiligence": "01",
"incoterms": "01",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"isPresent": false,
"isRemmitance": false,
"remmitanceNumber": "",
"remmitanceConsecutive": "",
"remmitanceValue": 0,
"remmitanceQuantityValue": 0,
"remmitanceMeasurementUnit": "",
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Crear petición con método POST
begin
request = RestClient.post(url, isvInvoice.to_json, headers)
# Manejar error si hay alguno
rescue RestClient::ExceptionWithResponse => e
puts e.response
end
# Imprimir respuesta
puts request
```
{% endtab %}
{% endtabs %}
# Notas débito
Consulta rápidamente a las secciones
{% content-ref url="/pages/-LxNnHdwVw5Kn1aDiyPo" %}
[Enviar nota débito en modo pruebas](/pruebas/notas-debito/enviar-nota-debito-en-modo-pruebas)
{% endcontent-ref %}
# Enviar nota débito en modo pruebas
Modo prueba
## Enviar nota débito
`POST` `https://isv.aliaddo.net/api/v1/public/documents/notes-db/test`
Enviar una nota débito en **modo pruebas** a la DIAN.
#### Path Parameters
| Name | Type | Description |
| ------- | ------ | ----------------- |
| version | string | Versión de la API |
#### Headers
| Name | Type | Description |
| --------- | ------ | ------------------------------------------- |
| x-api-key | string | Token generado previamente para autorizarse |
#### Request Body
| Name | Type | Description |
| ---------------- | ------ | ------------------------ |
| isvInvoiceNoteDb | object | Objeto de la nota débito |
{% tabs %}
{% tab title="200 Request completado con éxito." %}
```javascript
{
"id": "string",
"mode": "string",
"format": "string",
"emailSender": "string",
"testSetId": "string",
"concept": "string",
"prefix": "string",
"consecutive": 0,
"sequence": "string",
"externalNumber": "string",
"currencyCode": "string",
"currencyRate": 0.0,
"date": "2020-01-30T00:00:00",
"dateStart": "2020-01-30T00:00:00",
"dateEnd": "2020-01-31T00:00:00",
"typeOfOperation": "string",
"terms": "string",
"remark": "string",
"observation": "string",
"cufe": "string",
"qr": "string",
"urlPdf": "string",
"urlXmlDocument": "string",
"urlXmlDocumentZip": "string",
"urlXmlApplicationResponse": "string",
"urlXmlAttachedDocument": "string",
"UrlPdfEncoded": "string",
"UrlXmlEncoded": "string",
"dianDeliveryStatus": "string",
"dianState": "string",
"dianStateReason": "string",
"dianStateDate": "0001-01-01T00:00:00",
"sentEmailAt": "0001-01-01T00:00:00",
"invoicePrefix": "string",
"invoiceConsecutive": 0.0,
"invoiceCufe": "string",
"invoiceDate": "2020-01-18T00:00:00",
"branch": {
"name": "string",
"address": "string",
"phone": "string",
"countryCode": "string",
"countryName": "string",
"departamentCode": "string",
"departamentName": "string",
"cityCode": "string",
"cityName": "string"
},
"resolution": {
"resolutionKey": "string",
"resolutionPrefix": "string",
"resolutionNumber": 0.0,
"resolutionRangeInitial": 0.0,
"resolutionRangeFinal": 0.0,
"resolutionValidFrom": "2019-01-19T00:00:00",
"resolutionValidUntil": "2030-01-19T00:00:00"
},
"customer": {
"companyName": "string",
"personType": "string",
"regimeType": "string",
"firstName": "string",
"lastName": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string",
"email": "string",
"phone": "string",
"merchantRegistration": "string",
"responsibilities": "string",
"economicActivties": "string",
"billingAddress": "string",
"billingCountryName": "string",
"billingCountryCode": "string",
"billingRegionName": "string",
"billingRegionCode": "string",
"billingCityName": "string",
"billingCityCode": "string",
"billingPostalCode": "string",
"billingNeighborhood": "string",
"billingPhone": "string",
"billingContactName": "string",
"shippingAddress": "string",
"shippingCountryName": "string",
"shippingCountryCode": "string",
"shippingRegionName": "string",
"shippingRegionCode": "string",
"shippingCityName": "string",
"shippingCityCode": "string",
"shippingPostalCode": "string",
"shippingNeighborhood": "string",
"shippingPhone": "string",
"shippingContactName": "string"
},
"invoiceNoteDetails": [{
"standardType": "string",
"standardCode": "string",
"itemCode": "string",
"itemName": "string",
"itemModel": "string",
"description": "string",
"brandName": "string",
"itemCodeSupplier": "string",
"isPresent": false,
"unitMeasurementCode": "string",
"unitMeasurementName": "string",
"price": 0.0,
"quantity": 0.0,
"discountAmount": 0.0,
"chargeAmount": 0.0,
"subTotal": 0.0,
"priceWithAllowanceCharge": 0.0,
"totalWithAllowanceCharge": 0.0,
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"taxes": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"withholdings": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"isvMandante": {
"name": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string"
}
}],
"totals": {
"amount": 0.0,
"prepaymentAmount": 0.0,
"taxesAmount": 0.0,
"withholdingAmount": 0.0,
"discountsAmount": 0.0,
"chargesAmount": 0.0
},
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"customFields": [{
"key": "string",
"value": "string"
}],
"invoiceConsecutiveWithPrefix": "string"
}
```
{% endtab %}
{% tab title="204 " %}
```
No se encontraron resultados de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="400 " %}
```
No se han enviado los tipos de datos requeridos
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```javascript
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using RestSharp;
using System;
using Newtonsoft.Json;
class Program
{
public static void Main()
{
/**
- Enviar una nota débito en modo pruebas
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
// Realizar request por metodo POST
var request = new RestRequest("/notes-db/test", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto nota débito con resolución ejemplo
var isvInvoiceNoteDb = new
{
format = "Estandar",
emailSender = "",
concept = "1",
consecutive = 990000003,
externalNumber = "",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
typeOfOperation = "01",
terms = "",
remark = "",
observation = "",
invoicePrefix = "inv",
invoiceConsecutive = 990004331,
invoiceCufe = "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
invoiceDate = "2020-1-18",
branch = new
{
name = "Sucursal",
address = "KR con CLL",
phone = "000000",
countryCode = "CO",
countryName = "COLOMBIA",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "25178",
cityName = "Chipaque"
},
resolution = new
{
resolutionKey = "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix = "SETT",
resolutionNumber = 18760000001,
resolutionRangeInitial = 990000000,
resolutionRangeFinal = 995000000,
resolutionValidFrom = "2019-01-19",
resolutionValidUntil = "2030-01-19"
},
customer = new
{
companyName = "Customer",
personType = "1",
regimeType = "04",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "email@email.com",
phone = "0000001",
merchantRegistration = "",
responsibleFor = "ZZ",
responsibilities = "R-99-PN",
economicActivities= "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = "",
shippingAddress = "",
shippingCountryName = "",
shippingCountryCode = "",
shippingRegionName = "",
shippingRegionCode = "",
shippingCityName = "",
shippingCityCode = "",
shippingPostalCode = "",
shippingNeighborhood = "",
shippingPhone = "",
shippingContactName = ""
},
invoiceNoteDetails = new[]
{
new
{
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]
{
new
{
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]
{
new
{
name = "Iva",
code = "01",
type = "P",
rate = 19,
amount = 6.46
}
},
withholdings = new[]
{
new
{
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new
{
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
customFields = new[]
{
new KeyValuePair("NombreCampo", "ValorCampo")
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvInvoiceNoteDb), ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mosttar respuesta
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(response.Content);
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* - Enviar una nota débito en modo pruebas
* - Realizar request por metodo POST
*/
fetch("https://isv.aliaddo.net/api/v1/public/documents/notes-db/test", {
method: "POST",
body: JSON.stringify({
format: "Estandar",
emailSender: "",
concept: "1",
consecutive: 990000012,
externalNumber: "",
currencyCode: "COP",
currencyRate: 0,
date: "2020-1-23",
dateStart: "2020-1-23",
dateEnd: "2020-1-29",
typeOfOperation: "10",
terms: "",
remark: "",
observation: "",
//sentEmailAt: "",
invoicePrefix: "inv",
invoiceConsecutive: 990004331,
invoiceCufe: "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
invoiceDate: "2020-1-18",
branch: {
name: "Sucursal",
address: "KR con CLL",
phone: "000000",
countryCode: "CO",
countryName: "COLOMBIA",
departamentCode: "25",
departamentName: "Cundinamarca",
cityCode: "25178",
cityName: "Chipaque"
},
resolution: {
resolutionKey: "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix: "SETP",
resolutionNumber: 18760000001,
resolutionRangeInitial: 990000000,
resolutionRangeFinal: 995000000,
resolutionValidFrom: "2019-01-19",
resolutionValidUntil: "2030-01-19"
},
customer: {
companyName: "Customer",
personType: "1",
regimeType: "04",
firstName: "Customer",
lastName: "Customer",
identification: "000000001",
digitCheck: "8",
identificationTypeCode: "13",
email: "email@email.com",
phone: "",
merchantRegistration: "",
responsibleFor: "ZZ",
responsibilities: "R-99-PN",
economicActivities: "2817;3092",
billingAddress: "KR con Calle",
billingCountryName: "Colombia",
billingCountryCode: "CO",
billingRegionName: "Cundinamarca",
billingRegionCode: "25",
billingCityName: "Chipaque",
billingCityCode: "25178",
billingPostalCode: "",
billingNeighborhood: "",
billingPhone: "",
billingContactName: "",
shippingAddress: "",
shippingCountryName: "",
shippingCountryCode: "",
shippingRegionName: "",
shippingRegionCode: "",
shippingCityName: "",
shippingCityCode: "",
shippingPostalCode: "",
shippingNeighborhood: "",
shippingPhone: "",
shippingContactName: ""
},
invoiceNoteDetails: [{
standardType: "",
standardCode: "",
itemCode: "0001",
itemName: "Item",
itemModel: "",
description: "Item prueba",
brandName: "",
itemCodeSupplier: "",
isPresent: false,
unitMeasurementCode: "NIU",
unitMeasurementName: "",
price: 1285.00,
quantity: 2,
discounts: [{
name: "",
type: "V",
rate: 1,
amount: 1
}],
charges: [{
name: "",
type: "V",
rate: 10,
amount: 10
}],
taxes: [{
name: "Iva",
code: "01",
type: "V",
rate: 10,
amount: 10
}],
withholdings: [{
name: "ReteFuente",
code: "06",
type: "P",
rate: 10,
amount: 3.4
}],
isvMandante: {
name: "Mandante",
identification: "000001",
digitCheck: "8",
identificationTypeCode: "13"
}
}],
totals: {
amount: 68,
prepaymentAmount: 0
},
discounts: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
charges: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
customFields: [{
value: "666",
key: "invoiceId"
}]
}),
headers: {
'Content-Type': 'application/json',
'x-api-key": "{{x-api-key}}'
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => res.json())
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el request
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
// Agregar dependencia de GSON para serializar los objetos de Java a JSON
com.google.code.gson
gson
2.8.5
*/
// **** Clase donde se ejecuta el request ****
import com.google.gson.*;
import kong.unirest.*;
/*
* - Enviar una nota débito en modo pruebas
* - Añada las dependencias de UniRest y GSON a su POM como se muestra en el código de la parte superior
*/
public class Program {
public static void main(String[] args) {
// Crear objeto de nota débito
JsonObject isvInvoiceNoteDb = new JsonObject();
isvInvoiceNoteDb.addProperty("format", "Estandar");
isvInvoiceNoteDb.addProperty("emailSender", "");
isvInvoiceNoteDb.addProperty("concept", "1");
isvInvoiceNoteDb.addProperty("consecutive", 990000005);
isvInvoiceNoteDb.addProperty("externalNumber", "54554");
isvInvoiceNoteDb.addProperty("currencyCode", "COP");
isvInvoiceNoteDb.addProperty("currencyRate", 0);
isvInvoiceNoteDb.addProperty("date", "2020-1-20");
isvInvoiceNoteDb.addProperty("dateStart", "2020-1-20");
isvInvoiceNoteDb.addProperty("dateEnd", "2020-1-25");
isvInvoiceNoteDb.addProperty("typeOfOperation", "01");
isvInvoiceNoteDb.addProperty("terms", "");
isvInvoiceNoteDb.addProperty("remark", "");
isvInvoiceNoteDb.addProperty("observation", "");
isvInvoiceNoteDb.addProperty("invoicePrefix", "inv");
isvInvoiceNoteDb.addProperty("invoiceConsecutive", 990004331);
isvInvoiceNoteDb.addProperty("invoiceCufe", "cufe");
isvInvoiceNoteDb.addProperty("invoiceDate", "2020-1-18");
JsonObject branchObj = new JsonObject();
branchObj.addProperty("name", "");
branchObj.addProperty("address", "");
branchObj.addProperty("phone", "");
branchObj.addProperty("countryCode", "");
branchObj.addProperty("countryName", "");
branchObj.addProperty("departmentCode", "");
branchObj.addProperty("departmentName", "");
branchObj.addProperty("cityCode", "");
branchObj.addProperty("cityName", "");
isvInvoiceNoteDb.add("branch", branchObj);
JsonObject resolutionObj = new JsonObject();
resolutionObj.addProperty("resolutionKey", "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c");
resolutionObj.addProperty("resolutionPrefix", "SETP");
resolutionObj.addProperty("resolutionNumber", 18760000001f); // La 'f' indica tipo float
resolutionObj.addProperty("resolutionRangeInitial", 990000000);
resolutionObj.addProperty("resolutionRangeFinal", 995000000);
resolutionObj.addProperty("resolutionValidFrom", "2019-01-19");
resolutionObj.addProperty("resolutionValidUntil", "2030-01-19");
isvInvoiceNoteDb.add("resolution", resolutionObj);
JsonObject customerObj = new JsonObject();
customerObj.addProperty("companyName", "Customer");
customerObj.addProperty("personType", "1");
customerObj.addProperty("regimeType", "04");
customerObj.addProperty("firstName", "Customer");
customerObj.addProperty("lastName", "Customer");
customerObj.addProperty("identification", "000000001");
customerObj.addProperty("digitCheck", "8");
customerObj.addProperty("identificationTypeCode", "13");
customerObj.addProperty("email", "");
customerObj.addProperty("phone", "0000001");
customerObj.addProperty("merchantRegistration", "");
customerObj.addProperty("responsibleFor", "ZZ");
customerObj.addProperty("responsibilities", "R-99-PN");
customerObj.addProperty("economicActivities", "2817;3092");
customerObj.addProperty("billingAddress", "KR con Calle");
customerObj.addProperty("billingCountryName", "Colombia");
customerObj.addProperty("billingCountryCode", "CO");
customerObj.addProperty("billingRegionName", "Cundinamarca");
customerObj.addProperty("billingRegionCode", "25");
customerObj.addProperty("billingCityName", "Chipaque");
customerObj.addProperty("billingCityCode", "25178");
customerObj.addProperty("billingPostalCode", "");
customerObj.addProperty("billingNeighborhood", "");
customerObj.addProperty("billingPhone", "");
customerObj.addProperty("billingContactName", "");
customerObj.addProperty("shippingAddress", "");
customerObj.addProperty("shippingCountryName", "");
customerObj.addProperty("shippingCountryCode", "");
customerObj.addProperty("shippingRegionName", "");
customerObj.addProperty("shippingRegionCode", "");
customerObj.addProperty("shippingCityName", "");
customerObj.addProperty("shippingCityCode", "");
customerObj.addProperty("shippingPostalCode", "");
customerObj.addProperty("shippingNeighborhood", "");
customerObj.addProperty("shippingPhone", "");
customerObj.addProperty("shippingContactName", "");
isvInvoiceNoteDb.add("customer", customerObj);
JsonArray invoiceNoteDetailsArr = new JsonArray();
JsonObject invoiceNoteDetailsObj = new JsonObject();
invoiceNoteDetailsObj.addProperty("standardType", "");
invoiceNoteDetailsObj.addProperty("standardCode", "");
invoiceNoteDetailsObj.addProperty("itemCode", "0001");
invoiceNoteDetailsObj.addProperty("itemName", "Item");
invoiceNoteDetailsObj.addProperty("itemModel", "");
invoiceNoteDetailsObj.addProperty("description", "Item prueba");
invoiceNoteDetailsObj.addProperty("brandName", "");
invoiceNoteDetailsObj.addProperty("itemCodeSupplier", "");
invoiceNoteDetailsObj.addProperty("isPresent", false);
invoiceNoteDetailsObj.addProperty("unitMeasurementCode", "");
invoiceNoteDetailsObj.addProperty("unitMeasurementName", "");
invoiceNoteDetailsObj.addProperty("price", 25);
invoiceNoteDetailsObj.addProperty("quantity", 2);
invoiceNoteDetailsArr.add(invoiceNoteDetailsObj);
JsonArray discountsArr = new JsonArray();
JsonObject discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "V");
discountsObj.addProperty("rate", 1);
discountsObj.addProperty("amount", 1);
discountsArr.add(discountsObj);
invoiceNoteDetailsObj.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "V");
chargesObj.addProperty("rate", 10);
chargesObj.addProperty("amount", 10);
chargesArr.add(chargesObj);
invoiceNoteDetailsObj.add("charges", chargesArr);
JsonArray taxesArr = new JsonArray();
JsonObject taxesObj = new JsonObject();
taxesObj.addProperty("name", "Iva");
taxesObj.addProperty("code", "01");
taxesObj.addProperty("type", "P");
taxesObj.addProperty("rate", 19);
taxesObj.addProperty("amount", 6.46);
taxesArr.add(taxesObj);
invoiceNoteDetailsObj.add("taxes", taxesArr);
JsonArray withholdingsArr = new JsonArray();
JsonObject withholdingsObj = new JsonObject();
withholdingsObj.addProperty("name", "ReteFuente");
withholdingsObj.addProperty("code", "06");
withholdingsObj.addProperty("type", "P");
withholdingsObj.addProperty("rate", 10);
withholdingsObj.addProperty("amount", 3.4);
withholdingsArr.add(withholdingsObj);
invoiceNoteDetailsObj.add("withholdings", withholdingsArr);
JsonObject isvMandanteObj = new JsonObject();
isvMandanteObj.addProperty("name", "Mandante");
isvMandanteObj.addProperty("identification","0014");
isvMandanteObj.addProperty("digitCheck", "8");
isvMandanteObj.addProperty("identificationTypeCode", "13");
invoiceNoteDetailsObj.add("isvMandante", isvMandanteObj);
isvInvoiceNoteDb.add("invoiceNoteDetails", invoiceNoteDetailsArr);
JsonObject totals = new JsonObject();
totals.addProperty("amount", 68);
totals.addProperty("prepaymentAmount", 0);
isvInvoiceNoteDb.add("totals", totals);
JsonArray isvInvoiceNoteDbDiscountsArr = new JsonArray();
JsonObject isvInvoiceNoteDbDiscountsObj = new JsonObject();
isvInvoiceNoteDbDiscountsObj.addProperty("name", "");
isvInvoiceNoteDbDiscountsObj.addProperty("type", "");
isvInvoiceNoteDbDiscountsObj.addProperty("rate", 0);
isvInvoiceNoteDbDiscountsObj.addProperty("amount", 0);
isvInvoiceNoteDbDiscountsArr.add(isvInvoiceNoteDbDiscountsObj);
isvInvoiceNoteDb.add("discounts", isvInvoiceNoteDbDiscountsArr);
JsonArray isvInvoiceNoteDbChargesArr = new JsonArray();
JsonObject isvInvoiceNoteDbChargesObj = new JsonObject();
isvInvoiceNoteDbChargesObj.addProperty("name", "");
isvInvoiceNoteDbChargesObj.addProperty("type", "");
isvInvoiceNoteDbChargesObj.addProperty("rate", 0);
isvInvoiceNoteDbChargesObj.addProperty("amount", 0);
isvInvoiceNoteDbChargesArr.add(isvInvoiceNoteDbChargesObj);
isvInvoiceNoteDb.add("charges", isvInvoiceNoteDbChargesArr);
JsonArray customFieldsArr = new JsonArray();
JsonObject customFieldsObj = new JsonObject();
customFieldsObj.addProperty("666", "invoiceId");
customFieldsArr.add(customFieldsObj);
isvInvoiceNoteDb.add("customFields", customFieldsArr);
// Realizar request por metodo POST
HttpRequestWithBody request = Unirest.post("https://isv.aliaddo.net/api/v1/public/documents/notes-db/test");
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.header("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.header("content-type", "application/json");
request.header("cache-control", "no-cache");
request.header("accept", "application/json");
// Añadir el objeto de nota débito
request.body(isvInvoiceNoteDb).asJson()
// Manejar respuesta o error si hay alguno
.ifSuccess(response -> System.out.println("Response: " + "status -> " + response.getStatus() + " Body -> " + response.getBody() ))
.ifFailure(response -> {
System.out.println("Oh No! Status " + response.getStatus());
response.getParsingError().ifPresent(e -> {
System.out.println("Parsing Exception: " + e);
System.out.println("Original body: " + e.getOriginalBody());
});
});
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'Estandar',
'emailSender' => '',
'concept' => '1',
'consecutive' => 990000014,
'externalNumber' => '54554',
'currencyCode' => 'COP',
'currencyRate' => 0,
'date' => '2020-1-22',
'dateStart' => '2020-1-22',
'dateEnd' => '2020-1-25',
'typeOfOperation' => '01',
'terms' => '',
'remark' => '',
'observation' => '',
'invoicePrefix' => 'inv',
'invoiceConsecutive' => 990004331,
'invoiceCufe' => 'aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162',
'invoiceDate' => '2020-1-18',
'branch' => array(
'name' => '',
'address' => '',
'phone' => '',
'countryCode' => '',
'countryName' => '',
'departmentCode' => '',
'departmentName' => '',
'cityCode' => '',
'cityName' => ''
),
'resolution' => array(
'resolutionKey' => 'fc8eac422eba16e22ffd8c6f94b3f40a6e38162c',
'resolutionPrefix' => 'SETP',
'resolutionNumber' => 18760000001,
'resolutionRangeInitial' => 990000000,
'resolutionRangeFinal' => 995000000,
'resolutionValidFrom' => '2019-01-19',
'resolutionValidUntil' => '2030-01-19'
),
'customer' => array(
'companyName' => 'Customer',
'personType' => '1',
'regimeType' => '04',
'firstName' => 'Customer',
'lastName' => 'Customer',
'identification' => '000000001',
'digitCheck' => '8',
'identificationTypeCode' => '13',
'email' => 'email@email.com',
'phone' => '0000001',
'merchantRegistration' => '',
'responsibleFor' => "ZZ",
'responsibilities' => 'R-99-PN',
'economicActivities' => '2817;3092',
'billingAddress' => 'KR con Calle',
'billingCountryName' => 'Colombia',
'billingCountryCode' => 'CO',
'billingRegionName' => 'Cundinamarca',
'billingRegionCode' => '25',
'billingCityName' => 'Chipaque',
'billingCityCode' => '25178',
'billingPostalCode' => '',
'billingNeighborhood' => '',
'billingPhone' => '',
'billingContactName' => '',
'shippingAddress' => '',
'shippingCountryName' => '',
'shippingCountryCode' => '',
'shippingRegionName' => '',
'shippingRegionCode' => '',
'shippingCityName' => '',
'shippingCityCode' => '',
'shippingPostalCode' => '',
'shippingNeighborhood' => '',
'shippingPhone' => '',
'shippingContactName' => ''
),
'invoiceNoteDetails' => array(
array(
'standardType' => '',
'standardCode' => '',
'itemCode' => '0001',
'itemName' => 'Item',
'itemModel' => '',
'description' => 'Item prueba',
'brandName' => '',
'itemCodeSupplier' => '',
'isPresent' => false,
'unitMeasurementCode' => '',
'unitMeasurementName' => '',
'price' => 25,
'quantity' => 2,
'discounts' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 1,
'amount' => 1
)
),
'charges' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 10,
'amount' => 10
)
),
'taxes' => array(
array(
'name' => 'Iva',
'code' => '01',
'type' => 'P',
'rate' => 19,
'amount' => 6.46
)
),
'withholdings' => array(
array(
'name' => 'ReteFuente',
'code' => '06',
'type' => 'P',
'rate' => 10,
'amount' => 3.4,
)
),
'isvMandante' => array(
'name' => 'Mandante',
'identification' => '000001',
'digitCheck' => '8',
'identificationTypeCode' => '13'
)
)
),
'totals' => array(
'amount' => 68,
'prepaymentAmount' => 0
),
'discounts' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'charges' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'customFields' => array(
array(
'value' => '6666',
'key' => 'invoiceId'
)
)
);
// Serializar objeto a JSON
$isvInvoiceNoteDb = json_encode($debitNote);
/**
* /notes-db/test:
* - Enviar una nota débito para set de pruebas, en modo habilitación
* - Realizar request por metodo POST
*/
curl_setopt_array($curl, array(
CURLOPT_URL => "https://isv.aliaddo.net/api/v1/public/documents/notes-db/test",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => $isvInvoiceNoteDb,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
// Tipo de requerimiento formato json
"content-type: application/json",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Mostar respuesta o error si hubo alguno
if ($err) {
echo "error -> " . $err;
} else {
echo $response;
}
// Terminar petición
curl_close($curl);
?>
```
{% endtab %}
{% tab title="Python" %}
```python
# Importar la librería "requests"
import requests
# /notes-db/test:
# - Enviar una nota débito en modo pruebas
url = 'https://isv.aliaddo.net/api/v1/public/documents/notes-db/test'
# Crear objeto de nota débito
debitNote = {
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 9900000021,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customemer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": False,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# - Realizar request por metodo POST
request = requests.post(url, json=debitNote, headers=headers)
# Mostrar respuesta de la petición
print(request.text)
print(request.status_code)
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
# Requerir gemas "rest-client" y "json"
require 'rest-client'
require 'json'
# - Enviar una nota débito en modo pruebas
url = "https://isv.aliaddo.net/api/v1/public/documents/notes-db/test"
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# Crear objeto de nota débito
isvInvoiceNoteDb = {
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 9900000022,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customemer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Crear petición con método POST
begin
request = RestClient.post(url, isvInvoiceNoteDb.to_json, headers)
# Manejar error si hay alguno
rescue RestClient::ExceptionWithResponse => e
puts e.response
end
# Imprimir respuesta
puts request
```
{% endtab %}
{% endtabs %}
# Notas crédito
Consulta rápidamente a las secciones
{% content-ref url="/pages/-LxNsfICHwMbBWaX0fY8" %}
[Enviar nota crédito en modo pruebas](/pruebas/notas-credito/enviar-nota-credito-en-modo-pruebas)
{% endcontent-ref %}
# Enviar nota crédito en modo pruebas
Modo pruebas
## Enviar nota crédito
`POST` `https://isv.aliaddo.net/api/v1/public/documents/notes-cr/test`
Enviar una nota crédito en **modo pruebas** a la DIAN.
#### Path Parameters
| Name | Type | Description |
| ------- | ------ | ----------------- |
| version | string | Versión de la API |
#### Headers
| Name | Type | Description |
| --------- | ------ | ------------------------------------------- |
| x-api-key | string | Token generado previamente para autorizarse |
#### Request Body
| Name | Type | Description |
| ---------------- | ------ | ------------------------- |
| isvInvoiceNoteCr | object | Objeto de la nota crédito |
{% tabs %}
{% tab title="200 Request completado con éxito" %}
```javascript
{
"id": "string",
"mode": "string",
"format": "string",
"emailSender": "string",
"testSetId": "string",
"concept": "string",
"prefix": "string",
"consecutive": 0.0,
"sequence": "string",
"externalNumber": "string",
"currencyCode": "string",
"currencyRate": 0.0,
"date": "2020-01-30T00:00:00",
"dateStart": "2020-01-30T00:00:00",
"dateEnd": "2020-01-31T00:00:00",
"typeOfOperation": "string",
"terms": "string",
"remark": "string",
"observation": "string",
"cufe": "string",
"qr": "string",
"urlPdf": "string",
"urlXmlDocument": "string",
"urlXmlDocumentZip": "string",
"urlXmlApplicationResponse": "string",
"urlXmlAttachedDocument": "string",
"UrlPdfEncoded": "string",
"UrlXmlEncoded": "string",
"dianDeliveryStatus": "string",
"dianState": "string",
"dianStateReason": "string",
"sentEmail": false,
"sentEmailAt": "0001-01-01T00:00:00",
"invoicePrefix": "string",
"invoiceConsecutive": 990005331,
"invoiceCufe": "string",
"invoiceDate": "2020-01-18T00:00:00",
"branch": {
"name": "string",
"address": "string",
"phone": "string",
"countryCode": "string",
"countryName": "string",
"departamentCode": "string",
"departamentName": "string",
"cityCode": "string",
"cityName": "string"
},
"resolution": {
"resolutionKey": "string",
"resolutionPrefix": "string",
"resolutionNumber": 0.0,
"resolutionRangeInitial": 0.0,
"resolutionRangeFinal": 0.0,
"resolutionValidFrom": "2019-01-19T00:00:00",
"resolutionValidUntil": "2030-01-19T00:00:00"
},
"customer": {
"companyName": "string",
"personType": "string",
"regimeType": "string",
"firstName": "string",
"lastName": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string",
"email": "string",
"phone": "string",
"merchantRegistration": "string",
"responsibilities": "string",
"economicActivities": "string",
"billingAddress": "string",
"billingCountryName": "string",
"billingCountryCode": "string",
"billingRegionName": "string",
"billingRegionCode": "string",
"billingCityName": "string",
"billingCityCode": "string",
"billingPostalCode": "string",
"billingNeighborhood": "string",
"billingPhone": "string",
"billingContactName": "string",
"shippingAddress": "string",
"shippingCountryName": "string",
"shippingCountryCode": "string",
"shippingRegionName": "string",
"shippingRegionCode": "string",
"shippingCityName": "string",
"shippingCityCode": "string",
"shippingPostalCode": "string",
"shippingNeighborhood": "string",
"shippingPhone": "string",
"shippingContactName": "string"
},
"invoiceNoteDetails": [{
"standardType": "string",
"standardCode": "string",
"itemCode": "string",
"itemName": "string",
"itemModel": "string",
"description": "string",
"brandName": "string",
"itemCodeSupplier": "string",
"isPresent": false,
"unitMeasurementCode": "string",
"unitMeasurementName": "string",
"price": 0.0,
"quantity": 0.0,
"discountAmount": 0.0,
"chargeAmount": 0.0,
"subTotal": 0.0,
"priceWithAllowanceCharge": 0.0,
"totalWithAllowanceCharge": 0.0,
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"taxes": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"withholdings": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"isvMandante": {
"name": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string"
}
}],
"totals": {
"amount": 0.0,
"prepaymentAmount": 0.0,
"taxesAmount": 0.0,
"withholdingAmount": 0.0,
"discountsAmount": 0.0,
"chargesAmount": 0.0
},
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"customFields": [{
"key": "string",
"value": "string"
}],
"invoiceConsecutiveWithPrefix": "string"
}
```
{% endtab %}
{% tab title="204 " %}
```
No se encontraron resultados de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="400 " %}
```
No se han enviado los tipos de datos requeridos
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using RestSharp;
using System;
using Newtonsoft.Json;
class Program
{
public static void Main()
{
/**
- Enviar una nota crédito en modo pruebas
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
// Realizar request por metodo POST
var request = new RestRequest("/notes-cr/test", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto nota crédito con resolución ejemplo
var isvInvoiceNoteCr = new
{
format = "Estandar",
emailSender = "",
concept = "1",
consecutive = 6,
externalNumber = "",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
typeOfOperation = "01",
terms = "",
remark = "",
observation = "",
invoicePrefix = "inv",
invoiceConsecutive = 990004331,
invoiceCufe = "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
invoiceDate = "2020-1-18",
branch = new
{
name = "Sucursal",
address = "KR con CLL",
phone = "000000",
countryCode = "CO",
countryName = "COLOMBIA",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "25178",
cityName = "Chipaque"
},
resolution = new
{
resolutionKey = "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix = "SETT",
resolutionNumber = 18760000001,
resolutionRangeInitial = 990000000,
resolutionRangeFinal = 995000000,
resolutionValidFrom = "2019-01-19",
resolutionValidUntil = "2030-01-19"
},
customer = new
{
companyName = "Customer",
personType = "1",
regimeType = "04",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "email@email.com",
phone = "0000001",
merchantRegistration = "",
responsibleFor = "ZZ",
responsibilities = "R-99-PN",
economicActivities = "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = "",
shippingAddress = "",
shippingCountryName = "",
shippingCountryCode = "",
shippingRegionName = "",
shippingRegionCode = "",
shippingCityName = "",
shippingCityCode = "",
shippingPostalCode = "",
shippingNeighborhood = "",
shippingPhone = "",
shippingContactName = ""
},
invoiceNoteDetails = new[]
{
new
{
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]
{
new
{
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]
{
new
{
name = "Iva",
code = "01",
type = "P",
rate = 19,
amount = 6.46
}
},
withholdings = new[]
{
new
{
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new
{
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
customFields = new[]
{
new KeyValuePair("NombreCampo", "ValorCampo")
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvInvoiceNoteCr), ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mostrar respuesta
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(response.Content);
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* - Enviar una nota crédito en modo pruebas
* - Realizar request por metodo POST
*/
fetch("https://isv.aliaddo.net/api/v1/public/documents/notes-cr/test", {
method: 'POST',
body: JSON.stringify({
format: "Estandar",
emailSender: "",
concept: "1",
consecutive: 5,
externalNumber: "",
currencyCode: "COP",
currencyRate: 0,
date: "2020-1-18",
dateStart: "2020-1-18",
dateEnd: "2020-1-20",
typeOfOperation: "01",
terms: "",
remark: "",
observation: "",
invoicePrefix: "inv",
invoiceConsecutive: 990004331,
invoiceCufe: "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
invoiceDate: "2020-1-18",
branch: {
name: "Sucursal",
address: "KR con CLL",
phone: "000000",
countryCode: "CO",
countryName: "COLOMBIA",
departamentCode: "25",
departamentName: "Cundinamarca",
cityCode: "25178",
cityName: "Chipaque"
},
resolution: {
resolutionKey: "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix: "SETP",
resolutionNumber: 18760000001,
resolutionRangeInitial: 990000000,
resolutionRangeFinal: 995000000,
resolutionValidFrom: "2019-01-19",
resolutionValidUntil: "2030-01-19"
},
customer: {
companyName: "Customer",
personType: "1",
regimeType: "04",
firstName: "Customer",
lastName: "Customer",
identification: "000000001",
digitCheck: "8",
identificationTypeCode: "13",
email: "email@email.com",
phone: "",
merchantRegistration: "",
responsibleFor: "ZZ",
responsibilities: "R-99-PN",
economicActivities: "2817;3092",
billingAddress: "KR con Calle",
billingCountryName: "Colombia",
billingCountryCode: "CO",
billingRegionName: "Cundinamarca",
billingRegionCode: "25",
billingCityName: "Chipaque",
billingCityCode: "25178",
billingPostalCode: "",
billingNeighborhood: "",
billingPhone: "",
billingContactName: "",
shippingAddress: "",
shippingCountryName: "",
shippingCountryCode: "",
shippingRegionName: "",
shippingRegionCode: "",
shippingCityName: "",
shippingCityCode: "",
shippingPostalCode: "",
shippingNeighborhood: "",
shippingPhone: "",
shippingContactName: ""
},
invoiceNoteDetails: [{
standardType: "",
standardCode: "",
itemCode: "0001",
itemName: "Item",
itemModel: "",
description: "Item prueba",
brandName: "",
itemCodeSupplier: "",
isPresent: false,
unitMeasurementCode: "NIU",
unitMeasurementName: "",
price: 1285.00,
quantity: 2,
discounts: [{
name: "",
type: "V",
rate: 1,
amount: 1
}],
charges: [{
name: "",
type: "V",
rate: 10,
amount: 10
}],
taxes: [{
name: "Iva",
code: "01",
type: "V",
rate: 10,
amount: 10
}],
withholdings: [{
name: "ReteFuente",
code: "06",
type: "P",
rate: 10,
amount: 3.4
}],
isvMandante: {
name: "Mandante",
identification: "000001",
digitCheck: "8",
identificationTypeCode: "13"
}
}],
totals: {
amount: 68,
prepaymentAmount: 0
},
discounts: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
charges: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
customFields: [{
value: "666",
key: "invoiceId"
}]
}),
headers: {
"Content-Type": "application/json",
"x-api-key": "{{x-api-key}}"
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => res.json())
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el request
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
// Agregar dependencia de GSON para serializar los objetos de Java a JSON
com.google.code.gson
gson
2.8.5
*/
// **** Clase donde se ejecuta el request ****
import com.google.gson.*;
import kong.unirest.*;
/*
* - Enviar una nota crédito en modo pruebas
* - Añada las dependencias de UniRest y GSON a su POM como se muestra en el código de la parte superior
*/
public class Program {
public static void main(String[] args) {
JsonObject isvInvoiceNoteCr = new JsonObject();
isvInvoiceNoteCr.addProperty("format", "Estandar");
isvInvoiceNoteCr.addProperty("emailSender", "");
isvInvoiceNoteCr.addProperty("concept", "1");
isvInvoiceNoteCr.addProperty("consecutive", 8);
isvInvoiceNoteCr.addProperty("externalNumber", "54554");
isvInvoiceNoteCr.addProperty("currencyCode", "COP");
isvInvoiceNoteCr.addProperty("currencyRate", 0);
isvInvoiceNoteCr.addProperty("date", "2020-1-20");
isvInvoiceNoteCr.addProperty("dateStart", "2020-1-20");
isvInvoiceNoteCr.addProperty("dateEnd", "2020-1-25");
isvInvoiceNoteCr.addProperty("typeOfOperation", "01");
isvInvoiceNoteCr.addProperty("terms", "");
isvInvoiceNoteCr.addProperty("remark", "");
isvInvoiceNoteCr.addProperty("observation", "");
isvInvoiceNoteCr.addProperty("invoicePrefix", "inv");
isvInvoiceNoteCr.addProperty("invoiceConsecutive", 990004331);
isvInvoiceNoteCr.addProperty("invoiceCufe", "cufe");
isvInvoiceNoteCr.addProperty("invoiceDate", "2020-1-18");
JsonObject branchObj = new JsonObject();
branchObj.addProperty("name", "");
branchObj.addProperty("address", "");
branchObj.addProperty("phone", "");
branchObj.addProperty("countryCode", "");
branchObj.addProperty("countryName", "");
branchObj.addProperty("departmentCode", "");
branchObj.addProperty("departmentName", "");
branchObj.addProperty("cityCode", "");
branchObj.addProperty("cityName", "");
isvInvoiceNoteCr.add("branch", branchObj);
JsonObject resolutionObj = new JsonObject();
resolutionObj.addProperty("resolutionKey", "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c");
resolutionObj.addProperty("resolutionPrefix", "SETP");
resolutionObj.addProperty("resolutionNumber", 18760000001f); // La 'f' indica tipo float
resolutionObj.addProperty("resolutionRangeInitial", 990000000);
resolutionObj.addProperty("resolutionRangeFinal", 995000000);
resolutionObj.addProperty("resolutionValidFrom", "2019-01-19");
resolutionObj.addProperty("resolutionValidUntil", "2030-01-19");
isvInvoiceNoteCr.add("resolution", resolutionObj);
JsonObject customerObj = new JsonObject();
customerObj.addProperty("companyName", "Customer");
customerObj.addProperty("personType", "1");
customerObj.addProperty("regimeType", "04");
customerObj.addProperty("firstName", "Customer");
customerObj.addProperty("lastName", "Customer");
customerObj.addProperty("identification", "000000001");
customerObj.addProperty("digitCheck", "8");
customerObj.addProperty("identificationTypeCode", "13");
customerObj.addProperty("email", "");
customerObj.addProperty("phone", "0000001");
customerObj.addProperty("merchantRegistration", "");
customerObj.addProperty("responsibleFor", "ZZ");
customerObj.addProperty("responsibilities", "R-99-PN");
customerObj.addProperty("economicActivities", "2817;3092");
customerObj.addProperty("billingAddress", "KR con Calle");
customerObj.addProperty("billingCountryName", "Colombia");
customerObj.addProperty("billingCountryCode", "CO");
customerObj.addProperty("billingRegionName", "Cundinamarca");
customerObj.addProperty("billingRegionCode", "25");
customerObj.addProperty("billingCityName", "Chipaque");
customerObj.addProperty("billingCityCode", "25178");
customerObj.addProperty("billingPostalCode", "");
customerObj.addProperty("billingNeighborhood", "");
customerObj.addProperty("billingPhone", "");
customerObj.addProperty("billingContactName", "");
customerObj.addProperty("shippingAddress", "");
customerObj.addProperty("shippingCountryName", "");
customerObj.addProperty("shippingCountryCode", "");
customerObj.addProperty("shippingRegionName", "");
customerObj.addProperty("shippingRegionCode", "");
customerObj.addProperty("shippingCityName", "");
customerObj.addProperty("shippingCityCode", "");
customerObj.addProperty("shippingPostalCode", "");
customerObj.addProperty("shippingNeighborhood", "");
customerObj.addProperty("shippingPhone", "");
customerObj.addProperty("shippingContactName", "");
isvInvoiceNoteCr.add("customer", customerObj);
JsonArray invoiceNoteDetailsArr = new JsonArray();
JsonObject invoiceNoteDetailsObj = new JsonObject();
invoiceNoteDetailsObj.addProperty("standardType", "");
invoiceNoteDetailsObj.addProperty("standardCode", "");
invoiceNoteDetailsObj.addProperty("itemCode", "0001");
invoiceNoteDetailsObj.addProperty("itemName", "Item");
invoiceNoteDetailsObj.addProperty("itemModel", "");
invoiceNoteDetailsObj.addProperty("description", "Item prueba");
invoiceNoteDetailsObj.addProperty("brandName", "");
invoiceNoteDetailsObj.addProperty("itemCodeSupplier", "");
invoiceNoteDetailsObj.addProperty("isPresent", false);
invoiceNoteDetailsObj.addProperty("unitMeasurementCode", "");
invoiceNoteDetailsObj.addProperty("unitMeasurementName", "");
invoiceNoteDetailsObj.addProperty("price", 25);
invoiceNoteDetailsObj.addProperty("quantity", 2);
invoiceNoteDetailsArr.add(invoiceNoteDetailsObj);
JsonArray discountsArr = new JsonArray();
JsonObject discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "V");
discountsObj.addProperty("rate", 1);
discountsObj.addProperty("amount", 1);
discountsArr.add(discountsObj);
invoiceNoteDetailsObj.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "V");
chargesObj.addProperty("rate", 10);
chargesObj.addProperty("amount", 10);
chargesArr.add(chargesObj);
invoiceNoteDetailsObj.add("charges", chargesArr);
JsonArray taxesArr = new JsonArray();
JsonObject taxesObj = new JsonObject();
taxesObj.addProperty("name", "Iva");
taxesObj.addProperty("code", "01");
taxesObj.addProperty("type", "P");
taxesObj.addProperty("rate", 19);
taxesObj.addProperty("amount", 6.46);
taxesArr.add(taxesObj);
invoiceNoteDetailsObj.add("taxes", taxesArr);
JsonArray withholdingsArr = new JsonArray();
JsonObject withholdingsObj = new JsonObject();
withholdingsObj.addProperty("name", "ReteFuente");
withholdingsObj.addProperty("code", "06");
withholdingsObj.addProperty("type", "P");
withholdingsObj.addProperty("rate", 10);
withholdingsObj.addProperty("amount", 3.4);
withholdingsArr.add(withholdingsObj);
invoiceNoteDetailsObj.add("withholdings", withholdingsArr);
JsonObject isvMandanteObj = new JsonObject();
isvMandanteObj.addProperty("name", "Mandante");
isvMandanteObj.addProperty("identification", "0014");
isvMandanteObj.addProperty("digitCheck", "8");
isvMandanteObj.addProperty("identificationTypeCode", "13");
invoiceNoteDetailsObj.add("isvMandante", isvMandanteObj);
isvInvoiceNoteCr.add("invoiceNoteDetails", invoiceNoteDetailsArr);
JsonObject totals = new JsonObject();
totals.addProperty("amount", 68);
totals.addProperty("amount", 68);
totals.addProperty("prepaymentAmount", 0);
isvInvoiceNoteCr.add("totals", totals);
JsonArray isvInvoiceNoteDbDiscountsArr = new JsonArray();
JsonObject isvInvoiceNoteDbDiscountsObj = new JsonObject();
isvInvoiceNoteDbDiscountsObj.addProperty("type", "");
isvInvoiceNoteDbDiscountsObj.addProperty("rate", 0);
isvInvoiceNoteDbDiscountsObj.addProperty("amount", 0);
isvInvoiceNoteDbDiscountsArr.add(isvInvoiceNoteDbDiscountsObj);
isvInvoiceNoteCr.add("discounts", isvInvoiceNoteDbDiscountsArr);
JsonArray isvInvoiceNoteDbChargesArr = new JsonArray();
JsonObject isvInvoiceNoteDbChargesObj = new JsonObject();
isvInvoiceNoteDbChargesObj.addProperty("type", "");
isvInvoiceNoteDbChargesObj.addProperty("rate", 0);
isvInvoiceNoteDbChargesObj.addProperty("amount", 0);
isvInvoiceNoteDbChargesArr.add(isvInvoiceNoteDbChargesObj);
isvInvoiceNoteCr.add("charges", isvInvoiceNoteDbChargesArr);
JsonArray customFieldsArr = new JsonArray();
JsonObject customFieldsObj = new JsonObject();
customFieldsObj.addProperty("666", "invoiceId");
customFieldsArr.add(customFieldsObj);
isvInvoiceNoteCr.add("customFields", customFieldsArr);
// Realizar request por metodo POST
HttpRequestWithBody request = Unirest.post("https://isv.aliaddo.net/api/v1/public/documents/notes-cr/test");
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.header("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.header("content-type", "application/json");
request.header("cache-control", "no-cache");
request.header("accept", "application/json");
// Añadir el objeto de nota crédito
request.body(isvInvoiceNoteCr).asJson()
// Manejar respuesta o error si hay alguno
.ifSuccess(response -> System.out.println("Response: " + "status -> " + response.getStatus() + " Body -> " + response.getBody() ))
.ifFailure(response -> {
System.out.println("Oh No! Status " + response.getStatus());
response.getParsingError().ifPresent(e -> {
System.out.println("Parsing Exception: " + e);
System.out.println("Original body: " + e.getOriginalBody());
});
});
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'Estandar',
'emailSender' => '',
'concept' => '1',
'consecutive' => 8,
'externalNumber' => '54554',
'currencyCode' => 'COP',
'currencyRate' => 0,
'date' => '2020-1-22',
'dateStart' => '2020-1-22',
'dateEnd' => '2020-1-25',
'typeOfOperation' => '01',
'terms' => '',
'remark' => '',
'observation' => '',
'invoicePrefix' => 'inv',
'invoiceConsecutive' => 990004331,
'invoiceCufe' => 'aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162',
'invoiceDate' => '2020-1-18',
'branch' => array(
'name' => '',
'address' => '',
'phone' => '',
'countryCode' => '',
'countryName' => '',
'departmentCode' => '',
'departmentName' => '',
'cityCode' => '',
'cityName' => ''
),
'resolution' => array(
'resolutionKey' => 'fc8eac422eba16e22ffd8c6f94b3f40a6e38162c',
'resolutionPrefix' => 'SETP',
'resolutionNumber' => 18760000001,
'resolutionRangeInitial' => 990000000,
'resolutionRangeFinal' => 995000000,
'resolutionValidFrom' => '2019-01-19',
'resolutionValidUntil' => '2030-01-19'
),
'customer' => array(
'companyName' => 'Customer',
'personType' => '1',
'regimeType' => '04',
'firstName' => 'Customer',
'lastName' => 'Customer',
'identification' => '000000001',
'digitCheck' => '8',
'identificationTypeCode' => '13',
'email' => 'email@email.com',
'phone' => '0000001',
'merchantRegistration' => '',
'responsibleFor' => 'ZZ',
'responsibilities' => 'R-99-PN',
'economicActivities' => '2817;3092',
'billingAddress' => 'KR con Calle',
'billingCountryName' => 'Colombia',
'billingCountryCode' => 'CO',
'billingRegionName' => 'Cundinamarca',
'billingRegionCode' => '25',
'billingCityName' => 'Chipaque',
'billingCityCode' => '25178',
'billingPostalCode' => '',
'billingNeighborhood' => '',
'billingPhone' => '',
'billingContactName' => '',
'shippingAddress' => '',
'shippingCountryName' => '',
'shippingCountryCode' => '',
'shippingRegionName' => '',
'shippingRegionCode' => '',
'shippingCityName' => '',
'shippingCityCode' => '',
'shippingPostalCode' => '',
'shippingNeighborhood' => '',
'shippingPhone' => '',
'shippingContactName' => ''
),
'invoiceNoteDetails' => array(
array(
'standardType' => '',
'standardCode' => '',
'itemCode' => '0001',
'itemName' => 'Item',
'itemModel' => '',
'description' => 'Item prueba',
'brandName' => '',
'itemCodeSupplier' => '',
'isPresent' => false,
'unitMeasurementCode' => '',
'unitMeasurementName' => '',
'price' => 25,
'quantity' => 2,
'discounts' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 1,
'amount' => 1
)
),
'charges' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 10,
'amount' => 10
)
),
'taxes' => array(
array(
'name' => 'Iva',
'code' => '01',
'type' => 'P',
'rate' => 19,
'amount' => 6.46
)
),
'withholdings' => array(
array(
'name' => 'ReteFuente',
'code' => '06',
'type' => 'P',
'rate' => 10,
'amount' => 3.4,
)
),
'isvMandante' => array(
'name' => 'Mandante',
'identification' => '000001',
'digitCheck' => '8',
'identificationTypeCode' => '13'
)
)
),
'totals' => array(
'amount' => 68,
'prepaymentAmount' => 0
),
'discounts' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'charges' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'customFields' => array(
array(
'value' => '6666',
'key' => 'invoiceId'
)
)
);
// Serializar objeto a JSON
$isvInvoiceNoteCr = json_encode($creditNote);
/**
* - Enviar una nota crédito en modo pruebas
* - Realizar request por metodo POST
*/
curl_setopt_array($curl, array
CURLOPT_URL => "https://isv.aliaddo.net/api/v1/public/documents/notes-cr/test",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => $isvInvoiceNoteCr,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
// Tipo de requerimiento formato json
"content-type: application/json",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Mostar respuesta o error si hubo alguno
if ($err) {
echo "cURL Error #" .$err;
} else {
echo $response;
}
// Terminar petición
curl_close($curl);
?>
```
{% endtab %}
{% tab title="Python" %}
```python
# Importar la librería "requests"
import requests
# - Enviar una nota crédito en modo pruebas
url = 'https://isv.aliaddo.net/api/v1/public/documents/notes-cr/test'
# Crear objeto de nota crédito
isvInvoiceNoteCr = {
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 9,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": False,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# - Realizar request por metodo POST
request = requests.post(url, json=isvInvoiceNoteCr, headers=headers)
# Mostrar respuesta de la petición
print(request.text)
print(request.status_code)
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
# Requerir gemas "rest-client" y "json"
require 'rest-client'
require 'json'
# - Enviar una nota débito en modo pruebas
url = "https://isv.aliaddo.net/api/v1/public/documents/notes-cr/test"
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# Crear objeto de nota crédito
isvInvoiceNoteCr = {
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 10,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Crear petición con método POST
begin
request = RestClient.post(url, isvInvoiceNoteCr.to_json, headers)
# Manejar error si hay alguno
rescue RestClient::ExceptionWithResponse => e
puts e.response
end
# Imprimir respuesta
puts request
```
{% endtab %}
{% endtabs %}
# Documento soporte
# Enviar documento soporte en modo pruebas
Modo pruebas
## Enviar documento soporte
`POST` `https://isv.aliaddo.net/api/v1/public/documents/support/test`
Enviar un documento soporte a la DIAN en **modo pruebas**.
#### Path Parameters
| Name | Type | Description |
| ------- | ------ | ----------------- |
| version | string | Versión de la API |
#### Headers
| Name | Type | Description |
| --------- | ------ | -------------------------------------------- |
| x-api-key | string | Token generado previamente para autenticarse |
#### Request Body
| Name | Type | Description |
| ------------------ | ------ | -------------------- |
| isvSupportDocument | string | Objeto del documento |
{% tabs %}
{% tab title="200 Request completado con éxito" %}
```javascript
{
"id": "string",
"cuds": "string",
"qr": "string",
"urlPdf": "string",
"urlPdf": "string",
"dianState": "string", // Procesando, Aprobada o Rechazada
"dianStateDate": "0001-01-01T00:00:00"",
"dianStateReason": "string",
"issueDate": "0001-01-01T00:00:00"
}
```
{% endtab %}
{% tab title="204 " %}
```
No se encontraron resultados de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="400 " %}
```javascript
No se han enviado los tipos de datos requeridos
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using System;
using Newtonsoft.Json;
using RestSharp;
public class Program
{
public static void Main()
{
/**
- Enviar una documento soporte a la DIAN, en modo pruebas
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
var request = new RestRequest("support/test", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto con resolución ejemplo
var isvSupportDocument = new
{
code = "01",
format = "Estandar",
emailSender = "email@example.com",
consecutive = 990004332,
externalNumber = "54554",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateDue = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
typeOfOperation = "10",
incoterms = "",
terms = "",
remark = "",
observation = "",
termDay = 0,
paymentMeanCode = "48",
branch = new {
name = "branch",
address = "Cl6 Cra 66",
phone = "7649813",
countryCode = "CO",
countryName = "Colombia",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "11001",
cityname = "Bogotá, D.c."
},
resolution = new
{
resolutionKey = "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix = "SETT",
resolutionNumber = 18760000001,
resolutionRangeInitial = 990000000,
resolutionRangeFinal = 995000000,
resolutionValidFrom = "2019-01-19",
resolutionValidUntil = "2030-01-19"
},
supplier= new
{
companyName = "Customer",
personType = "1",
regimeType = "04",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "",
phone = "0000001",
merchantRegistration = "",
responsibleFor: "ZZ",
responsibilities = "R-99-PN",
economicActivities = "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = "",
shippingAddress = "",
shippingCountryName = "",
shippingCountryCode = "",
shippingRegionName = "",
shippingRegionCode = "",
shippingCityName = "",
shippingCityCode = "",
shippingPostalCode = "",
shippingNeighborhood = "",
shippingPhone = "",
shippingContactName = ""
},
supportDocumentDetails= new[]{
new {
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
isRemmitance: false,
remmitanceNumber: "",
remmitanceConsecutive: "",
remmitanceValue: 0,
remmitanceQuantityValue: 0,
remmitanceMeasurementUnit: "",
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]{
new {
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]{
new {
name = "",
code = "01",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]{
new {
name = "Iva",
code = "01",
type = "P",
rate = 20,
amount = 6.46
}
},
withholdings = new[]{
new {
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "000001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new {
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new {
name = "",
type = "V",
rate = 10,
amount = 10
}
},
customFields = new[]
{
new KeyValuePair("NombreCampo", "ValorCampo")
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvSupportDocument ), ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mostrar respuesta
Console.WriteLine((int) response.StatusCode);
Console.WriteLine(response.Content);
}
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* - Enviar un documento soporte a la DIAN, en modo pruebas
* - Realizar request por metodo POST
*/
fetch('https://isv.aliaddo.net/api/v1/public/documents/support/test', {
method: 'POST',
// Crear objeto documento soporte con resolución de ejemplo
body: JSON.stringify({
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": "990004322",
"externalNumber": "",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-23",
"dateDue": "2020-1-29",
"dateStart": "2020-1-23",
"dateEnd": "2020-1-29",
"typeOfOperation": "10",
"incoterms": "",
"deliveryTerms": "",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departamentCode": "",
"departamentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETT",
"resolutionNumber": "18760000001",
"resolutionRangeInitial": "990000000",
"resolutionRangeFinal": "995000000",
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"supplier": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "email@email.com",
"phone": "",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContactName": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"supportDocumentDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"isRemmitance": false,
"remmitanceNumber": "",
"remmitanceConsecutive": "",
"remmitanceValue": 0,
"remmitanceQuantityValue": 0,
"remmitanceMeasurementUnit": "",
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": "1285.00",
"quantity": "2",
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "V",
"rate": 10,
"amount": 10
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "Mandante",
"identification": "000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"prepaymentAmount": 68,
"amount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}
],
"customFields": [{
"value": "666",
"key": "personalizado"
}]
}),
// Añadir cabeceras a la petición
headers: {
'Content-Type': 'application/json',
'x-api-key': '{{x-api-key}}'
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => res.json())
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el request
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
// Agregar dependencia de GSON para serializar los objetos de Java a JSON
com.google.code.gson
gson
2.8.5
*/
// **** Clase donde se ejecuta el request ****
// Agregue las dependencias de UniRest a su POM como se indica en el código superior
import com.google.gson.*;
import kong.unirest.*;
/*
* - Enviar un documento soporte a la DIAN, en modo pruebas
* - Añada las dependencias de UniRest y GSON a su POM como se muestra en el código de la parte superior
*/
public class Program {
public static void main(String[] args) {
// Crear objeto documento soporte con resolución ejemplo
JsonObject isvDocument = new JsonObject();
isvDocument.addProperty("code", "01");
isvDocument.addProperty("format", "Estandar");
isvDocument.addProperty("emailSender", "");
isvDocument.addProperty("consecutive", 990004336);
isvDocument.addProperty("externalNumber", "54554");
isvDocument.addProperty("currencyCode", "COP");
isvDocument.addProperty("currencyRate", 0);
isvDocument.addProperty("date", "2020-1-20");
isvDocument.addProperty("dateDue", "2020-1-24");
isvDocument.addProperty("dateStart", "2020-1-20");
isvDocument.addProperty("dateEnd", "2020-1-24");
isvDocument.addProperty("typeOfOperation", "10");
isvDocument.addProperty("incoterms", "");
isvDocument.addProperty("terms", "");
isvDocument.addProperty("remark", "");
isvDocument.addProperty("observation", "");
isvDocument.addProperty("termDay", 0);
isvDocument.addProperty("paymentCode", 48);
JsonObject branchObj = new JsonObject();
branchObj.addProperty("name", "");
branchObj.addProperty("address", "");
branchObj.addProperty("phone", "");
branchObj.addProperty("countryCode", "");
branchObj.addProperty("countryName", "");
branchObj.addProperty("departmentCode", "");
branchObj.addProperty("departmentName", "");
branchObj.addProperty("cityCode", "");
branchObj.addProperty("cityName", "");
isvDocument.add("branch", branchObj);
JsonObject resolutionObj = new JsonObject();
resolutionObj.addProperty("resolutionKey", "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c");
resolutionObj.addProperty("resolutionPrefix", "SETT");
resolutionObj.addProperty("resolutionNumber", 18760000001f); // La f indica tipo float
resolutionObj.addProperty("resolutionRangeInitial", 990000000);
resolutionObj.addProperty("resolutionRangeFinal", 995000000);
resolutionObj.addProperty("resolutionValidFrom", "2019-01-19");
resolutionObj.addProperty("resolutionValidUntil", "2030-01-19");
isvDocument.add("resolution", resolutionObj);
JsonObject supplierObj = new JsonObject();
supplierObj.addProperty("companyName", "Customer");
supplierObj.addProperty("personType", "1");
supplierObj.addProperty("regimeType", "04");
supplierObj.addProperty("firstName", "Customer");
supplierObj.addProperty("lastName", "Customer");
supplierObj.addProperty("identification", "000000001");
supplierObj.addProperty("digitCheck", "8");
supplierObj.addProperty("identificationTypeCode", "13");
supplierObj.addProperty("email", "");
supplierObj.addProperty("phone", "0000001");
supplierObj.addProperty("merchantRegistration", "");
supplierObj.addProperty("responsibleFor", "ZZ");
supplierObj.addProperty("responsibilities", "R-99-PN");
supplierObj.addProperty("economicActivities", "2817;3092");
supplierObj.addProperty("billingAddress", "KR con Calle");
supplierObj.addProperty("billingCountryName", "Colombia");
supplierObj.addProperty("billingCountryCode", "CO");
supplierObj.addProperty("billingRegionName", "Cundinamarca");
supplierObj.addProperty("billingRegionCode", "25");
supplierObj.addProperty("billingCityName", "Chipaque");
supplierObj.addProperty("billingCityCode", "25178");
supplierObj.addProperty("billingPostalCode", "");
supplierObj.addProperty("billingNeighborhood", "");
supplierObj.addProperty("billingPhone", "");
supplierObj.addProperty("billingContactName", "");
supplierObj.addProperty("shippingAddress", "");
supplierObj.addProperty("shippingCountryName", "");
supplierObj.addProperty("shippingCountryCode", "");
supplierObj.addProperty("shippingRegionName", "");
supplierObj.addProperty("shippingRegionCode", "");
supplierObj.addProperty("shippingCityName", "");
supplierObj.addProperty("shippingCityCode", "");
supplierObj.addProperty("shippingPostalCode", "");
supplierObj.addProperty("shippingNeighborhood", "");
supplierObj.addProperty("shippingPhone", "");
supplierObj.addProperty("shippingContactName", "");
isvDocument.add("supplier", supplierObj);
JsonArray isvDocumentDetailsArr = new JsonArray();
JsonObject isvDocumentDetailsObj = new JsonObject();
isvDocumentDetailsObj.addProperty("standardType", "");
isvDocumentDetailsObj.addProperty("standardCode", "");
isvDocumentDetailsObj.addProperty("itemCode", "0001");
isvDocumentDetailsObj.addProperty("itemName", "Item");
isvDocumentDetailsObj.addProperty("itemModel", "");
isvDocumentDetailsObj.addProperty("description", "Item prueba");
isvDocumentDetailsObj.addProperty("brandName", "");
isvDocumentDetailsObj.addProperty("itemCodeSupplier", "");
isvDocumentDetailsObj.addProperty("isPresent", false);
isvDocumentDetailsObj.addProperty("isRemmitance", false);
isvDocumentDetailsObj.addProperty("remmitanceNumber", "");
isvDocumentDetailsObj.addProperty("remmitanceConsecutive", "");
isvDocumentDetailsObj.addProperty("remmitanceValue", 0);
isvDocumentDetailsObj.addProperty("remmitanceQuantityValue", 0);
isvDocumentDetailsObj.addProperty("remmitanceMeasurementUnit", "");
isvDocumentDetailsObj.addProperty("unitMeasurementCode", "");
isvDocumentDetailsObj.addProperty("unitMeasurementName", "");
isvDocumentDetailsObj.addProperty("price", 25);
isvDocumentDetailsObj.addProperty("quantity", 2);
isvDocumentDetailsArr.add(isvDocumentDetailsObj);
JsonArray discountsArr = new JsonArray();
JsonObject discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "V");
discountsObj.addProperty("rate", 1);
discountsObj.addProperty("amount", 1);
discountsArr.add(discountsObj);
isvDocumentDetailsObj.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "V");
chargesObj.addProperty("rate", 10);
chargesObj.addProperty("amount", 10);
chargesArr.add(chargesObj);
isvDocumentDetailsObj.add("charges", chargesArr);
JsonArray taxesArr = new JsonArray();
JsonObject taxesObj = new JsonObject();
taxesObj.addProperty("name", "Iva");
taxesObj.addProperty("code", "01");
taxesObj.addProperty("type", "P");
taxesObj.addProperty("rate", 19);
taxesObj.addProperty("amount", 6.46);
taxesArr.add(taxesObj);
isvDocumentDetailsObj.add("taxes", taxesArr);
JsonArray withholdingsArr = new JsonArray();
JsonObject withholdingsObj = new JsonObject();
withholdingsObj.addProperty("name", "ReteFuente");
withholdingsObj.addProperty("code", "06");
withholdingsObj.addProperty("type", "P");
withholdingsObj.addProperty("rate", 10);
withholdingsObj.addProperty("amount", 3.4);
withholdingsArr.add(withholdingsObj);
isvDocumentDetailsObj.add("withholdings", withholdingsArr);
JsonObject isvMandanteObj = new JsonObject();
isvMandanteObj.addProperty("name", "Mandante");
isvMandanteObj.addProperty("identification", "00001");
isvMandanteObj.addProperty("digitCheck", "8");
isvMandanteObj.addProperty("identificationTypeCode", "13");
isvDocumentDetailsObj.add("isvMandante", isvMandanteObj);
isvDocument.add("documentDetails", isvDocumentDetailsArr);
JsonObject totals = new JsonObject();
totals.addProperty("amount", 68);
totals.addProperty("prepaymentAmount", 0);
isvDocument.add("totals", totals);
JsonArray discountsArr = new JsonArray();
JsonObjectd discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "");
discountsObj.addProperty("rate", 0);
discountsObj.addProperty("amount", 0);
discountsArr.add(discountsObj);
isvDocument.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "");
chargesObj.addProperty("rate", 0);
chargesObj.addProperty("amount", 0);
chargesArr .add(chargesObj);
isvDocument.add("discounts", chargesArr );
JsonArray customFieldsArr = new JsonArray();
JsonObject customFieldsObj = new JsonObject();
customFieldsObj.addProperty("666", "personalizado");
customFieldsArr.add(customFieldsObj);
isvDocument.add("customFields", customFieldsArr);
// Realizar request por metodo POST
HttpRequestWithBody request = Unirest.post("https://isv.aliaddo.net/api/v1/public/documents/support/test");
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.header("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.header("content-type", "application/json");
request.header("cache-control", "no-cache");
request.header("accept", "application/json");
// Añadir el objeto de documento soporte
request.body(isvDocument).asJson()
// Manejar respuesta o error si hay alguno
.ifSuccess(response -> System.out.println("Response: " + "status -> " + response.getStatus() + " Body -> " + response.getBody() ))
.ifFailure(response -> {
System.out.println("Oh No! Status " + response.getStatus());
response.getParsingError().ifPresent(e -> {
System.out.println("Parsing Exception: " + e);
System.out.println("Original body: " + e.getOriginalBody());
});
});
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'01',
'format' => 'Estandar',
'emailSender' => '',
'consecutive' => 990004337,
'externalNumber' => '54554',
'currencyCode' => 'COP',
'currencyRate' => 0,
'date' => '2020-1-22',
'dateDue' => '2020-1-29',
'dateStart' => '2020-1-22',
'dateEnd' => '2020-1-29',
'typeOfOperation' => '10',
'incoterms' => '',
'terms' => '',
'remark' => '',
'observation' => '',
'termDay' => 0,
'paymentMeanCode' => '48',
'branch' => array(
'name' => '',
'address' => '',
'phone' => '',
'countryCode' => '',
'countryName' => '',
'departmentCode' => '',
'departmentName' => '',
'cityCode' => '',
'cityName' => ''
),
'resolution' => array(
'resolutionKey' => 'fc8eac422eba16e22ffd8c6f94b3f40a6e38162c',
'resolutionPrefix' => 'SETT',
'resolutionNumber' => 18760000001,
'resolutionRangeInitial' => 990000000,
'resolutionRangeFinal' => 995000000,
'resolutionValidFrom' => '2019-01-19',
'resolutionValidUntil' => '2030-01-19'
),
'supplier' => array(
'companyName' => 'Customer',
'personType' => '1',
'regimeType' => '04',
'firstName' => 'Customer',
'lastName' => 'Customer',
'identification' => '000000001',
'digitCheck' => '8',
'identificationTypeCode' => '13',
'email' => '',
'phone' => '0000001',
'merchantRegistration' => '',
'responsibleFor' => 'ZZ',
'responsibilities' => 'R-99-PN',
'economicActivities' => '2817;3092',
'billingAddress' => 'KR con Calle',
'billingCountryName' => 'Colombia',
'billingCountryCode' => 'CO',
'billingRegionName' => 'Cundinamarca',
'billingRegionCode' => '25',
'billingCityName' => 'Chipaque',
'billingCityCode' => '25178',
'billingPostalCode' => '',
'billingNeighborhood' => '',
'billingPhone' => '',
'billingContactName' => '',
'shippingAddress' => '',
'shippingCountryName' => '',
'shippingCountryCode' => '',
'shippingRegionName' => '',
'shippingRegionCode' => '',
'shippingCityName' => '',
'shippingCityCode' => '',
'shippingPostalCode' => '',
'shippingNeighborhood' => '',
'shippingPhone' => '',
'shippingContactName' => ''
),
'supportDocumentDetails' => array(
array(
'standardType' => '',
'standardCode' => '',
'itemCode' => '0001',
'itemName' => 'Item',
'itemModel' => '',
'description' => 'Item prueba',
'brandName' => '',
'itemCodeSupplier' => '',
'isPresent' => false,
'isRemmitance' => false,
'remmitanceNumber' => "",
'remmitanceConsecutive' => "",
'remmitanceValue' => 0,
'remmitanceQuantityValue' => 0,
'remmitanceMeasurementUnit' => "",
'unitMeasurementCode' => '',
'unitMeasurementName' => '',
'price' => 25,
'quantity' => 2,
'discounts' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 1,
'amount' => 1
)
),
'charges' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 10,
'amount' => 10
)
),
'taxes' => array(
array(
'name' => 'Iva',
'code' => '01',
'type' => 'P',
'rate' => 19,
'amount' => 6.46
)
),
'withholdings' => array(
array(
'name' => 'ReteFuente',
'code' => '06',
'type' => 'P',
'rate' => 10,
'amount' => 3.4,
)
),
'isvMandante' => array(
'name' => 'Mandante',
'identification' => '000001',
'digitCheck' => '8',
'identificationTypeCode' => '13'
)
)
),
'totals' => array(
'amount' => 68,
'prepaymentAmount' => 0
),
'discounts' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'charges' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'customFields' => array(
array(
'value' => '6666',
'key' => 'personalizado'
)
)
);
// Serializar el documento a JSON
$isvDocument = json_encode($document);
/**
* - Enviar documento soporte a la DIAN, en modo pruebas
* - Realizar request por metodo POST
*/
curl_setopt_array($curl, array(
CURLOPT_URL => "https://isv.aliaddo.net/api/v1/public/documents/support/test",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => $isvDocument,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
// Tipo de requerimiento formato json
"content-type: application/json",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Mostar respuesta o error si hubo alguno
if ($err) {
echo "error -> " . $err;
} else {
echo $response;
}
// Terminar petición
curl_close($curl);
?>
```
{% endtab %}
{% tab title="Python" %}
```python
# Importar la librería "requests"
import requests
# - Enviar documento soporte a la DIAN, en modo pruebas
url = 'https://isv.aliaddo.net/api/v1/public/documents/support/test'
# Crear objeto documento soporte con resolución ejemplo
isvDocument = {
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": 990077341,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateDue": "2020-1-25",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"incoterms": "01",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETT",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"supportDocumentDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": False,
"isPresent": False,
"isRemmitance": False,
"remmitanceNumber": "",
"remmitanceConsecutive": "",
"remmitanceValue": 0,
"remmitanceQuantityValue": 0,
"remmitanceMeasurementUnit": "",
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "personalizado"
}
]
}
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# - Realizar request por metodo POST
request = requests.post(url, json=isvDocument, headers=headers)
# Mostrar respuesta de la petición
print(request.text)
print(request.status_code)
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
# Requerir gemas "rest-client" y "json"
require 'rest-client'
require 'json'
# - Enviar documento soporte en modo pruebas
url = "https://isv.aliaddo.net/api/v1/public/documents/support/test"
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# Crear objeto documento soporte con resolución ejemplo
isvDocument = {
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": 990077342,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateDue": "2020-1-25",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"incoterms": "01",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETT",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"supplier": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"supportDocumentDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"isPresent": false,
"isRemmitance": false,
"remmitanceNumber": "",
"remmitanceConsecutive": "",
"remmitanceValue": 0,
"remmitanceQuantityValue": 0,
"remmitanceMeasurementUnit": "",
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "personalizado"
}
]
}
# Crear petición con método POST
begin
request = RestClient.post(url, isvDocument.to_json, headers)
# Manejar error si hay alguno
rescue RestClient::ExceptionWithResponse => e
puts e.response
end
# Imprimir respuesta
puts request
```
{% endtab %}
{% endtabs %}
# Nota de ajuste
# Enviar nota de ajuste en modo pruebas
Modo pruebas
## Enviar nota de ajuste
`POST` `https://isv.aliaddo.net/api/v1/public/documents/support/adjustments/test`
Enviar una nota de ajuste en **modo pruebas** a la DIAN.
#### Path Parameters
| Name | Type | Description |
| ------- | ------ | ----------------- |
| version | string | Versión de la API |
#### Headers
| Name | Type | Description |
| --------- | ------ | ------------------------------------------- |
| x-api-key | string | Token generado previamente para autorizarse |
#### Request Body
| Name | Type | Description |
| ------------------ | ------ | --------------------------- |
| isvNoteAdjustments | object | Objeto de la nota de ajuste |
{% tabs %}
{% tab title="200 Request completado con éxito" %}
```javascript
{
"id": "string",
"cuds": "string",
"qr": "string",
"urlPdf": "string",
"urlPdf": "string",
"dianState": "string", // Procesando, Aprobada o Rechazada
"dianStateDate": "0001-01-01T00:00:00"",
"dianStateReason": "string",
"issueDate": "0001-01-01T00:00:00"
}
```
{% endtab %}
{% tab title="204 " %}
```
No se encontraron resultados de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="400 " %}
```
No se han enviado los tipos de datos requeridos
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using RestSharp;
using System;
using Newtonsoft.Json;
class Program
{
public static void Main()
{
/**
- Enviar una nota de ajuste en modo pruebas
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
// Realizar request por metodo POST
var request = new RestRequest("/support/test", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto nota de ajuste con resolución ejemplo
var isvNote = new
{
format = "Estandar",
concept = "1",
consecutive = 6,
externalNumber = "",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
notes = new [
"string"
],
supportDocumentPrefix= "asd",
supportDocumentConsecutive = 990004331,
supportDocumentCuds= "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
supportDocumentDate = "2020-1-18",
branch = new
{
name = "Sucursal",
address = "KR con CLL",
phone = "000000",
countryCode = "CO",
countryName = "COLOMBIA",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "25178",
cityName = "Chipaque"
},
supplier = new
{
companyName = "Customer",
personType = "1",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "email@email.com",
phone = "0000001",
merchantRegistration = "",
responsibleFor = "ZZ",
responsibilities = "R-99-PN",
economicActivities = "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = ""
},
supportDocumentAdjustmentDetails = new[]
{
new
{
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
isRemmitance: true,
remmitanceNumber: "",
remmitanceConsecutive: "",
remmitanceValue: 0,
remmitanceQuantityValue: 0,
remmitanceMeasurementUnit: "",
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]
{
new
{
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]
{
new
{
name = "Iva",
code = "01",
type = "P",
rate = 19,
amount = 6.46
}
},
withholdings = new[]
{
new
{
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new
{
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvNote), ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mostrar respuesta
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(response.Content);
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* - Enviar una nota de ajuste en modo pruebas
* - Realizar request por metodo POST
*/
fetch("https://isv.aliaddo.net/api/v1/public/documents/support/test", {
method: 'POST',
body: JSON.stringify({
format: "Estandar",
concept: "1",
consecutive: 5,
externalNumber: "",
currencyCode: "COP",
currencyRate: 0,
date: "2020-1-18",
dateStart: "2020-1-18",
dateEnd: "2020-1-20",
notes: [
"string"
],
supportDocumentPrefix: "asd",
supportDocumentConsecutive: 990004331,
supportDocumentCuds: "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
supportDocumentDate: "2020-1-18",
branch: {
name: "Sucursal",
address: "KR con CLL",
phone: "000000",
countryCode: "CO",
countryName: "COLOMBIA",
departamentCode: "25",
departamentName: "Cundinamarca",
cityCode: "25178",
cityName: "Chipaque"
},
supplier: {
companyName: "Customer",
personType: "1",
firstName: "Customer",
lastName: "Customer",
identification: "000000001",
digitCheck: "8",
identificationTypeCode: "13",
email: "email@email.com",
phone: "",
merchantRegistration: "",
responsibleFor: "ZZ",
responsibilities: "R-99-PN",
economicActivities: "2817;3092",
billingAddress: "KR con Calle",
billingCountryName: "Colombia",
billingCountryCode: "CO",
billingRegionName: "Cundinamarca",
billingRegionCode: "25",
billingCityName: "Chipaque",
billingCityCode: "25178",
billingPostalCode: "",
billingNeighborhood: "",
billingPhone: "",
billingContactName: "",
},
noteDetails: [{
standardType: "",
standardCode: "",
itemCode: "0001",
itemName: "Item",
itemModel: "",
description: "Item prueba",
brandName: "",
itemCodeSupplier: "",
isPresent: false,
unitMeasurementCode: "NIU",
unitMeasurementName: "",
price: 1285.00,
quantity: 2,
discounts: [{
name: "",
type: "V",
rate: 1,
amount: 1
}],
charges: [{
name: "",
type: "V",
rate: 10,
amount: 10
}],
taxes: [{
name: "Iva",
code: "01",
type: "V",
rate: 10,
amount: 10
}],
withholdings: [{
name: "ReteFuente",
code: "06",
type: "P",
rate: 10,
amount: 3.4
}],
isvMandante: {
name: "Mandante",
identification: "000001",
digitCheck: "8",
identificationTypeCode: "13"
}
}],
totals: {
amount: 68,
prepaymentAmount: 0
},
discounts: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
charges: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
]
}),
headers: {
"Content-Type": "application/json",
"x-api-key": "{{x-api-key}}"
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => res.json())
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el request
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
// Agregar dependencia de GSON para serializar los objetos de Java a JSON
com.google.code.gson
gson
2.8.5
*/
// **** Clase donde se ejecuta el request ****
import com.google.gson.*;
import kong.unirest.*;
/*
* - Enviar una nota de ajuste en modo pruebas
* - Añada las dependencias de UniRest y GSON a su POM como se muestra en el código de la parte superior
*/
public class Program {
public static void main(String[] args) {
JsonObject isvNote = new JsonObject();
isvNote.addProperty("format", "Estandar");
isvNote.addProperty("concept", "1");
isvNote.addProperty("consecutive", 8);
isvNote.addProperty("externalNumber", "54554");
isvNote.addProperty("currencyCode", "COP");
isvNote.addProperty("currencyRate", 0);
isvNote.addProperty("date", "2020-1-20");
isvNote.addProperty("dateStart", "2020-1-20");
isvNote.addProperty("dateEnd", "2020-1-25");
isvNote.addProperty("supportDocumentPrefix", "asd");
isvNote.addProperty("supportDocumentConsecutive", 990004331);
isvNote.addProperty("supportDocumentCuds", "cufe");
isvNote.addProperty("supportDocumentDate", "2020-1-18");
JsonObject branchObj = new JsonObject();
branchObj.addProperty("name", "");
branchObj.addProperty("address", "");
branchObj.addProperty("phone", "");
branchObj.addProperty("countryCode", "");
branchObj.addProperty("countryName", "");
branchObj.addProperty("departmentCode", "");
branchObj.addProperty("departmentName", "");
branchObj.addProperty("cityCode", "");
branchObj.addProperty("cityName", "");
isvNote.add("branch", branchObj);
JsonObject supplierObj = new JsonObject();
supplierObj.addProperty("companyName", "Customer");
supplierObj.addProperty("personType", "1");
supplierObj.addProperty("firstName", "Customer");
supplierObj.addProperty("lastName", "Customer");
supplierObj.addProperty("identification", "000000001");
supplierObj.addProperty("digitCheck", "8");
supplierObj.addProperty("identificationTypeCode", "13");
supplierObj.addProperty("email", "");
supplierObj.addProperty("phone", "0000001");
supplierObj.addProperty("merchantRegistration", "");
supplierObj.addProperty("responsibleFor", "ZZ");
supplierObj.addProperty("responsibilities", "R-99-PN");
supplierObj.addProperty("economicActivities", "2817;3092");
supplierObj.addProperty("billingAddress", "KR con Calle");
supplierObj.addProperty("billingCountryName", "Colombia");
supplierObj.addProperty("billingCountryCode", "CO");
supplierObj.addProperty("billingRegionName", "Cundinamarca");
supplierObj.addProperty("billingRegionCode", "25");
supplierObj.addProperty("billingCityName", "Chipaque");
supplierObj.addProperty("billingCityCode", "25178");
supplierObj.addProperty("billingPostalCode", "");
supplierObj.addProperty("billingNeighborhood", "");
supplierObj.addProperty("billingPhone", "");
supplierObj.addProperty("billingContactName", "");
isvNote.add("customer", customerObj);
JsonArray noteDetailsArr = new JsonArray();
JsonObject noteDetailsObj = new JsonObject();
noteDetailsObj.addProperty("standardType", "");
noteDetailsObj.addProperty("standardCode", "");
noteDetailsObj.addProperty("itemCode", "0001");
noteDetailsObj.addProperty("itemName", "Item");
noteDetailsObj.addProperty("itemModel", "");
noteDetailsObj.addProperty("description", "Item prueba");
noteDetailsObj.addProperty("brandName", "");
noteDetailsObj.addProperty("itemCodeSupplier", "");
noteDetailsObj.addProperty("isPresent", false);
noteDetailsObj.addProperty("unitMeasurementCode", "");
noteDetailsObj.addProperty("unitMeasurementName", "");
noteDetailsObj.addProperty("price", 25);
noteDetailsObj.addProperty("quantity", 2);
noteDetailsArr.add(noteDetailsObj);
JsonArray discountsArr = new JsonArray();
JsonObject discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "V");
discountsObj.addProperty("rate", 1);
discountsObj.addProperty("amount", 1);
discountsArr.add(discountsObj);
noteDetailsObj.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "V");
chargesObj.addProperty("rate", 10);
chargesObj.addProperty("amount", 10);
chargesArr.add(chargesObj);
noteDetailsObj.add("charges", chargesArr);
JsonArray taxesArr = new JsonArray();
JsonObject taxesObj = new JsonObject();
taxesObj.addProperty("name", "Iva");
taxesObj.addProperty("code", "01");
taxesObj.addProperty("type", "P");
taxesObj.addProperty("rate", 19);
taxesObj.addProperty("amount", 6.46);
taxesArr.add(taxesObj);
noteDetailsObj.add("taxes", taxesArr);
JsonArray withholdingsArr = new JsonArray();
JsonObject withholdingsObj = new JsonObject();
withholdingsObj.addProperty("name", "ReteFuente");
withholdingsObj.addProperty("code", "06");
withholdingsObj.addProperty("type", "P");
withholdingsObj.addProperty("rate", 10);
withholdingsObj.addProperty("amount", 3.4);
withholdingsArr.add(withholdingsObj);
noteDetailsObj.add("withholdings", withholdingsArr);
JsonObject isvMandanteObj = new JsonObject();
isvMandanteObj.addProperty("name", "Mandante");
isvMandanteObj.addProperty("identification", "0014");
isvMandanteObj.addProperty("digitCheck", "8");
isvMandanteObj.addProperty("identificationTypeCode", "13");
noteDetailsObj.add("isvMandante", isvMandanteObj);
noteDetailsObj.add("noteDetails", noteDetailsArr);
JsonObject totals = new JsonObject();
totals.addProperty("amount", 68);
totals.addProperty("amount", 68);
totals.addProperty("prepaymentAmount", 0);
isvNote.add("totals", totals);
JsonArray isvNoteDiscountsArr = new JsonArray();
JsonObject isvNoteDiscountsObj = new JsonObject();
isvNoteDiscountsObj.addProperty("type", "");
isvNoteDiscountsObj.addProperty("rate", 0);
isvNoteDiscountsObj.addProperty("amount", 0);
isvNoteDiscountsArr .add(isvNoteDiscountsObj);
isvNote.add("discounts", isvNoteDiscountsArr );
JsonArray isvNoteChargesArr = new JsonArray();
JsonObject isvNoteChargesObj = new JsonObject();
isvNoteChargesObj.addProperty("type", "");
isvNoteChargesObj.addProperty("rate", 0);
isvNoteChargesObj.addProperty("amount", 0);
isvNoteChargesArr.add(isvNoteChargesObj );
isvNoteChargesObj.add("charges", isvNoteChargesArr);
// Realizar request por metodo POST
HttpRequestWithBody request = Unirest.post("https://isv.aliaddo.net/api/v1/public/documents/support/test");
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.header("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.header("content-type", "application/json");
request.header("cache-control", "no-cache");
request.header("accept", "application/json");
// Añadir el objeto de nota de ajuste
request.body(isvNote).asJson()
// Manejar respuesta o error si hay alguno
.ifSuccess(response -> System.out.println("Response: " + "status -> " + response.getStatus() + " Body -> " + response.getBody() ))
.ifFailure(response -> {
System.out.println("Oh No! Status " + response.getStatus());
response.getParsingError().ifPresent(e -> {
System.out.println("Parsing Exception: " + e);
System.out.println("Original body: " + e.getOriginalBody());
});
});
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'Estandar',
'concept' => '1',
'consecutive' => 8,
'externalNumber' => '54554',
'currencyCode' => 'COP',
'currencyRate' => 0,
'date' => '2020-1-22',
'dateStart' => '2020-1-22',
'dateEnd' => '2020-1-25',
'documentPrefix' => 'asd',
'supportDocumentConsecutive' => 990004331,
'supportDocumentCuds' => 'aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162',
'supportDocumentDate' => '2020-1-18',
'branch' => array(
'name' => '',
'address' => '',
'phone' => '',
'countryCode' => '',
'countryName' => '',
'departmentCode' => '',
'departmentName' => '',
'cityCode' => '',
'cityName' => ''
),
'supplier' => array(
'companyName' => 'Customer',
'personType' => '1',
'firstName' => 'Customer',
'lastName' => 'Customer',
'identification' => '000000001',
'digitCheck' => '8',
'identificationTypeCode' => '13',
'email' => 'email@email.com',
'phone' => '0000001',
'merchantRegistration' => '',
'responsibleFor' => 'ZZ',
'responsibilities' => 'R-99-PN',
'economicActivities' => '2817;3092',
'billingAddress' => 'KR con Calle',
'billingCountryName' => 'Colombia',
'billingCountryCode' => 'CO',
'billingRegionName' => 'Cundinamarca',
'billingRegionCode' => '25',
'billingCityName' => 'Chipaque',
'billingCityCode' => '25178',
'billingPostalCode' => '',
'billingNeighborhood' => '',
'billingPhone' => '',
'billingContactName' => ''
),
'supportDocumentAdjustmentDetails' => array(
array(
'standardType' => '',
'standardCode' => '',
'itemCode' => '0001',
'itemName' => 'Item',
'itemModel' => '',
'description' => 'Item prueba',
'brandName' => '',
'itemCodeSupplier' => '',
'isPresent' => false,
'unitMeasurementCode' => '',
'unitMeasurementName' => '',
'price' => 25,
'quantity' => 2,
'discounts' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 1,
'amount' => 1
)
),
'charges' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 10,
'amount' => 10
)
),
'taxes' => array(
array(
'name' => 'Iva',
'code' => '01',
'type' => 'P',
'rate' => 19,
'amount' => 6.46
)
),
'withholdings' => array(
array(
'name' => 'ReteFuente',
'code' => '06',
'type' => 'P',
'rate' => 10,
'amount' => 3.4,
)
),
'isvMandante' => array(
'name' => 'Mandante',
'identification' => '000001',
'digitCheck' => '8',
'identificationTypeCode' => '13'
)
)
),
'totals' => array(
'amount' => 68,
'prepaymentAmount' => 0
),
'discounts' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'charges' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
)
);
// Serializar objeto a JSON
$isvNote = json_encode($isvNote);
/**
* - Enviar una nota de ajuste en modo pruebas
* - Realizar request por metodo POST
*/
curl_setopt_array($curl, array
CURLOPT_URL => "https://isv.aliaddo.net/api/v1/public/documents/support/test",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => $isvNote,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
// Tipo de requerimiento formato json
"content-type: application/json",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Mostar respuesta o error si hubo alguno
if ($err) {
echo "cURL Error #" .$err;
} else {
echo $response;
}
// Terminar petición
curl_close($curl);
?>
```
{% endtab %}
{% tab title="Python" %}
```python
# Importar la librería "requests"
import requests
# - Enviar una nota de ajuste en modo pruebas
url = 'https://isv.aliaddo.net/api/v1/public/documents/support/test'
# Crear objeto de nota de ajuste
isvNote = {
"format": "Estandar",
"concept": "1",
"consecutive": 9,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"notes": [
"string"
],
"supportDocumentPrefix": "asd",
"supportDocumentConsecutive": 990004331,
"supportDocumentCuds": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"supportDocumentDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"supplier": {
"companyName": "Customer",
"personType": "1",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": ""
},
"supportDocumentAdjustmentDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": False,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}]
}
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# - Realizar request por metodo POST
request = requests.post(url, json=isvNote, headers=headers)
# Mostrar respuesta de la petición
print(request.text)
print(request.status_code)
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
# Requerir gemas "rest-client" y "json"
require 'rest-client'
require 'json'
# - Enviar una nota de ajuste en modo pruebas
url = "https://isv.aliaddo.net/api/v1/public/documents/support/test"
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# Crear objeto de nota de ajuste
isvNote = {
"format": "Estandar",
"concept": "1",
"consecutive": 10,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"notes": [
"string"
],
"supportDocumentPrefix": "asd",
"supportDocumentConsecutive": 990004331,
"supportDocumentCuds": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"supportDocumentDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"supplier": {
"companyName": "Customer",
"personType": "1",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": ""
},
"supportDocumentAdjustmentDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}]
}
# Crear petición con método POST
begin
request = RestClient.post(url, isvNote.to_json, headers)
# Manejar error si hay alguno
rescue RestClient::ExceptionWithResponse => e
puts e.response
end
# Imprimir respuesta
puts request
```
{% endtab %}
{% endtabs %}
# Facturas
Consulta rápidamente las secciones
{% content-ref url="/pages/-Lq8GmD7VQCctc6n08m4" %}
[Enviar factura para set de pruebas](/habilitacion/facturas/enviar-una-factura-para-set-de-pruebas)
{% endcontent-ref %}
# Enviar factura para set de pruebas
Modo habilitación
## Enviar factura
`POST` `https://isv.aliaddo.net/api/v1/public/documents/invoice/habilitation/{testSetId}`
Este método envía una factura para set de pruebas en **modo habilitación**.
#### Path Parameters
| Name | Type | Description |
| --------- | ------ | -------------------------------- |
| testSetId | string | Identificador del set de pruebas |
| version | string | Versión de la API |
#### Headers
| Name | Type | Description |
| --------- | ------ | ------------------------------------------- |
| x-api-key | string | Token generado previamente para autorizarse |
#### Request Body
| Name | Type | Description |
| ---------- | ------ | -------------------- |
| isvInvoice | object | Objeto de la factura |
{% tabs %}
{% tab title="200 Request completado con éxito" %}
```javascript
{
"id": "string",
"code": "string",
"mode": "string",
"format": "string",
"emailSender": "string",
"testSetId": "string",
"prefix": "string",
"consecutive": 0,
"status": "string",
"statusDate": "2020-01-30T00:00:00",
"sequence": "string",
"externalNumber": "string",
"currencyCode": "string",
"currencyRate": 0,
"date": "2020-01-30T00:00:00",
"dateDue": "2020-01-31T00:00:00",
"dateStart": "2020-01-30T00:00:00",
"dateEnd": "2020-01-31T00:00:00",
"typeOfOperation": "string",
"typeOfOperation": "string",
"incoterms": "string",
"deliveryTerms": "string",
"terms": "string",
"remark": "string",
"observation": "string",
"cufe": "string",
"qr": "string",
"urlPdf": "string",
"urlXmlDocument": "string",
"urlXmlDocumentZip": "string",
"urlXmlApplicationResponse": "string",
"urlXmlAttachedDocument": "string",
"UrlPdfEncoded": "string",
"UrlXmlEncoded": "string",
"dianDeliveryStatus": "string",
"dianState": "string",
"dianStateReason": "string",
"dianStateDate": "0001-01-01T00:00:00",
"sentEmail": false,
"sentEmailAt": "0001-01-01T00:00:00",
"termDay": 0,
"paymentMeanCode": "string",
"rejectReason": "string",
"hasNotesDb": false,
"hasNotesCr": false,
"branch": {
"name": "string",
"address": "string",
"phone": "string",
"countryCode": "string",
"countryName": "string",
"departamentCode": "string",
"departamentName": "string",
"cityCode": "string",
"cityName": "string"
},
"resolution": {
"resolutionKey": "string",
"resolutionPrefix": "string",
"resolutionNumber": 0,
"resolutionRangeInitial": 0,
"resolutionRangeFinal": 0,
"resolutionValidFrom": "2019-01-19T00:00:00",
"resolutionValidUntil": "2030-01-19T00:00:00"
},
"customer": {
"companyName": "string",
"personType": "string",
"regimeType": "string",
"firstName": "string",
"lastName": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string",
"email": "string",
"phone": "string",
"merchantRegistration": "string",
"responsibilities": "string",
"economicActivities": "string",
"billingAddress": "string",
"billingCountryName": "string",
"billingCountryCode": "string",
"billingRegionName": "string",
"billingRegionCode": "string",
"billingCityName": "string",
"billingCityCode": "string",
"billingPostalCode": "string",
"billingNeighborhood": "string",
"billingPhone": "string",
"billingContactName": "string",
"shippingAddress": "string",
"shippingCountryName": "string",
"shippingCountryCode": "string",
"shippingRegionName": "string",
"shippingRegionCode": "string",
"shippingCityName": "string",
"shippingCityCode": "string",
"shippingPostalCode": "string",
"shippingNeighborhood": "string",
"shippingPhone": "string",
"shippingContactName": "string"
},
"invoiceDetails": [{
"standardType": "string",
"standardCode": "string",
"itemCode": "string",
"itemName": "string",
"itemModel": "string",
"description": "string",
"brandName": "string",
"itemCodeSupplier": "string",
"isPresent": false,
"unitMeasurementCode": "string",
"unitMeasurementName": "string",
"price": 0,
"quantity": 0,
"discountAmount": 0,
"chargeAmount": 0,
"subTotal": 0,
"priceWithAllowanceCharge": 0,
"totalWithAllowanceCharge": 0,
"discounts": [{
"name": "string",
"type": "string",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0,
"amount": 0
}],
"taxes": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0,
"amount": 0,
"base": 0
}],
"withholdings": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0,
"amount": 0,
"base": 0
}],
"isvMandante": {
"name": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string"
}
}],
"totals": {
"amount": 0,
"prepaymentAmount": 0,
"taxesAmount": 0,
"withholdingAmount": 0,
"discountsAmount": 0,
"chargesAmount": 0
},
"discounts": [{
"name": "string",
"type": "string",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0,
"amount": 0
}],
"customFields": [{
"key": "string",
"value": "string"
}],
"createdAt": "0001-01-01T00:00:00",
"updatedAt": "0001-01-01T00:00:00",
"isDue": false
}
```
{% endtab %}
{% tab title="204 " %}
```
No se encontraron resultados de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="400 " %}
```
No se han enviado los tipos de datos requeridos
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using System;
using System.Collections.Generic;
using Newtonsoft.Json;
using RestSharp;
namespace ConsoleApp1
{
public class Program
{
public static void Main()
{
/**
/invoice/habilitation/{testSetId}:
- Enviar una factura para set de pruebas, en modo habilitación
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
// Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a la API puede realizarlo con el que esta en este ejemplo
// Realizar request por metodo POST
var request = new RestRequest("/invoice/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto factura con resolución ejemplo
var isvInvoice = new
{
code = "01",
format = "Estandar",
emailSender = "email@example.com",
consecutive = 990004332,
externalNumber = "54554",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateDue = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
typeOfOperation = "10",
dueDiligence = "",
incoterms = "",
terms = "",
remark = "",
observation = "",
termDay = 0,
paymentMeanCode = "48",
branch = new {
name = "branch",
address = "Cl6 Cra 66",
phone = "7649813",
countryCode = "CO",
countryName = "Colombia",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "11001",
cityname = "Bogotá, D.c."
},
resolution = new
{
resolutionKey = "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix = "SETT",
resolutionNumber = 18760000001,
resolutionRangeInitial = 990000000,
resolutionRangeFinal = 995000000,
resolutionValidFrom = "2019-01-19",
resolutionValidUntil = "2030-01-19"
},
customer = new
{
companyName = "Customer",
personType = "1",
regimeType = "04",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "",
phone = "0000001",
merchantRegistration = "",
responsibleFor: "ZZ",
responsibilities = "R-99-PN",
economicActivities = "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = "",
shippingAddress = "",
shippingCountryName = "",
shippingCountryCode = "",
shippingRegionName = "",
shippingRegionCode = "",
shippingCityName = "",
shippingCityCode = "",
shippingPostalCode = "",
shippingNeighborhood = "",
shippingPhone = "",
shippingContactName = ""
},
invoiceDetails = new[]{
new {
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
isRemmitance: false,
remmitanceNumber: "",
remmitanceConsecutive: "",
remmitanceValue: 0,
remmitanceQuantityValue: 0,
remmitanceMeasurementUnit: "",
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]{
new {
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]{
new {
name = "",
code = "01",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]{
new {
name = "Iva",
code = "01",
type = "P",
rate = 20,
amount = 6.46
}
},
withholdings = new[]{
new {
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "000001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new {
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new {
name = "",
type = "V",
rate = 10,
amount = 10
}
},
customFields = new[]
{
new KeyValuePair("NombreCampo", "ValorCampo")
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvInvoice), ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mostrar respuesta
Console.WriteLine((int) response.StatusCode);
Console.WriteLine(response.Content);
}
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* /invoice/habilitation/{testSetId}:
* - Editar una factura para set de pruebas, en modo habilitación
* - Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
* usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
* la API puede realizarlo con el que esta en este ejemplo
* - Realizar request por metodo POST
*/
fetch('https://isv.aliaddo.net/api/v1/public/documents/invoice/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca', {
method: 'POST',
// Crear objeto factura con resolución de ejemplo
body: JSON.stringify({
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": "990004322",
"externalNumber": "",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-23",
"dateDue": "2020-1-29",
"dateStart": "2020-1-23",
"dateEnd": "2020-1-29",
"typeOfOperation": "10",
"dueDiligence": "",
"incoterms": "",
"deliveryTerms": "",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departamentCode": "",
"departamentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": "18760000001",
"resolutionRangeInitial": "990000000",
"resolutionRangeFinal": "995000000",
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "email@email.com",
"phone": "",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContactName": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"isRemmitance": false,
"remmitanceNumber": "",
"remmitanceConsecutive": "",
"remmitanceValue": 0,
"remmitanceQuantityValue": 0,
"remmitanceMeasurementUnit": "",
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": "1285.00",
"quantity": "2",
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "V",
"rate": 10,
"amount": 10
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "Mandante",
"identification": "000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"prepaymentAmount": 68,
"amount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}
],
"customFields": [{
"value": "666",
"key": "invoiceId"
}]
}),
// Añadir cabeceras a la petición
headers: {
'Content-Type': 'application/json',
'x-api-key': '{{x-api-key}}'
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => console.log(res.json()))
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el request
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
// Agregar dependencia de GSON para serializar los objetos de Java a JSON
com.google.code.gson
gson
2.8.5
*/
// **** Clase donde se ejecuta el request ****
// Agregue las dependencias de UniRest a su POM como se indica en el código superior
import com.google.gson.*;
import kong.unirest.*;
/*
* /invoice/{testSetId}:
* - Enviar una factura para set de pruebas, en modo habilitación
* - Añada las dependencias de UniRest y GSON a su POM como se muestra en el código de la parte superior
*/
public class Program {
public static void main(String[] args) {
// Crear objeto factura con resolución ejemplo
JsonObject isvInvoice = new JsonObject();
isvInvoice.addProperty("code", "01");
isvInvoice.addProperty("format", "Estandar");
isvInvoice.addProperty("emailSender", "");
isvInvoice.addProperty("consecutive", 990004336);
isvInvoice.addProperty("externalNumber", "54554");
isvInvoice.addProperty("currencyCode", "COP");
isvInvoice.addProperty("currencyRate", 0);
isvInvoice.addProperty("date", "2020-1-20");
isvInvoice.addProperty("dateDue", "2020-1-24");
isvInvoice.addProperty("dateStart", "2020-1-20");
isvInvoice.addProperty("dateEnd", "2020-1-24");
isvInvoice.addProperty("typeOfOperation", "10");
isvInvoice.addProperty("dueDiligence", "");
isvInvoice.addProperty("incoterms", "");
isvInvoice.addProperty("terms", "");
isvInvoice.addProperty("remark", "");
isvInvoice.addProperty("observation", "");
isvInvoice.addProperty("termDay", 0);
isvInvoice.addProperty("paymentCode", 48);
JsonObject branchObj = new JsonObject();
branchObj.addProperty("name", "");
branchObj.addProperty("address", "");
branchObj.addProperty("phone", "");
branchObj.addProperty("countryCode", "");
branchObj.addProperty("countryName", "");
branchObj.addProperty("departmentCode", "");
branchObj.addProperty("departmentName", "");
branchObj.addProperty("cityCode", "");
branchObj.addProperty("cityName", "");
isvInvoice.add("branch", branchObj);
JsonObject resolutionObj = new JsonObject();
resolutionObj.addProperty("resolutionKey", "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c");
resolutionObj.addProperty("resolutionPrefix", "SETP");
resolutionObj.addProperty("resolutionNumber", 18760000001f); // La f indica tipo float
resolutionObj.addProperty("resolutionRangeInitial", 990000000);
resolutionObj.addProperty("resolutionRangeFinal", 995000000);
resolutionObj.addProperty("resolutionValidFrom", "2019-01-19");
resolutionObj.addProperty("resolutionValidUntil", "2030-01-19");
isvInvoice.add("resolution", resolutionObj);
JsonObject customerObj = new JsonObject();
customerObj.addProperty("companyName", "Customer");
customerObj.addProperty("personType", "1");
customerObj.addProperty("regimeType", "04");
customerObj.addProperty("firstName", "Customer");
customerObj.addProperty("lastName", "Customer");
customerObj.addProperty("identification", "000000001");
customerObj.addProperty("digitCheck", "8");
customerObj.addProperty("identificationTypeCode", "13");
customerObj.addProperty("email", "");
customerObj.addProperty("phone", "0000001");
customerObj.addProperty("merchantRegistration", "");
customerObj.addProperty("responsibleFor", "ZZ");
customerObj.addProperty("responsibilities", "R-99-PN");
customerObj.addProperty("economicActivities", "2817;3092");
customerObj.addProperty("billingAddress", "KR con Calle");
customerObj.addProperty("billingCountryName", "Colombia");
customerObj.addProperty("billingCountryCode", "CO");
customerObj.addProperty("billingRegionName", "Cundinamarca");
customerObj.addProperty("billingRegionCode", "25");
customerObj.addProperty("billingCityName", "Chipaque");
customerObj.addProperty("billingCityCode", "25178");
customerObj.addProperty("billingPostalCode", "");
customerObj.addProperty("billingNeighborhood", "");
customerObj.addProperty("billingPhone", "");
customerObj.addProperty("billingContactName", "");
customerObj.addProperty("shippingAddress", "");
customerObj.addProperty("shippingCountryName", "");
customerObj.addProperty("shippingCountryCode", "");
customerObj.addProperty("shippingRegionName", "");
customerObj.addProperty("shippingRegionCode", "");
customerObj.addProperty("shippingCityName", "");
customerObj.addProperty("shippingCityCode", "");
customerObj.addProperty("shippingPostalCode", "");
customerObj.addProperty("shippingNeighborhood", "");
customerObj.addProperty("shippingPhone", "");
customerObj.addProperty("shippingContactName", "");
isvInvoice.add("customer", customerObj);
JsonArray invoiceDetailsArr = new JsonArray();
JsonObject invoiceDetailsObj = new JsonObject();
invoiceDetailsObj.addProperty("standardType", "");
invoiceDetailsObj.addProperty("standardCode", "");
invoiceDetailsObj.addProperty("itemCode", "0001");
invoiceDetailsObj.addProperty("itemName", "Item");
invoiceDetailsObj.addProperty("itemModel", "");
invoiceDetailsObj.addProperty("description", "Item prueba");
invoiceDetailsObj.addProperty("brandName", "");
invoiceDetailsObj.addProperty("itemCodeSupplier", "");
invoiceDetailsObj.addProperty("isPresent", false);
invoiceDetailsObj.addProperty("isRemmitance", false);
invoiceDetailsObj.addProperty("remmitanceNumber", "");
invoiceDetailsObj.addProperty("remmitanceConsecutive", "");
invoiceDetailsObj.addProperty("remmitanceValue", 0);
invoiceDetailsObj.addProperty("remmitanceQuantityValue", 0);
invoiceDetailsObj.addProperty("remmitanceMeasurementUnit", "");
invoiceDetailsObj.addProperty("unitMeasurementCode", "");
invoiceDetailsObj.addProperty("unitMeasurementName", "");
invoiceDetailsObj.addProperty("price", 25);
invoiceDetailsObj.addProperty("quantity", 2);
invoiceDetailsArr.add(invoiceDetailsObj);
JsonArray discountsArr = new JsonArray();
JsonObject discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "V");
discountsObj.addProperty("rate", 1);
discountsObj.addProperty("amount", 1);
discountsArr.add(discountsObj);
invoiceDetailsObj.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "V");
chargesObj.addProperty("rate", 10);
chargesObj.addProperty("amount", 10);
chargesArr.add(chargesObj);
invoiceDetailsObj.add("charges", chargesArr);
JsonArray taxesArr = new JsonArray();
JsonObject taxesObj = new JsonObject();
taxesObj.addProperty("name", "Iva");
taxesObj.addProperty("code", "01");
taxesObj.addProperty("type", "P");
taxesObj.addProperty("rate", 19);
taxesObj.addProperty("amount", 6.46);
taxesArr.add(taxesObj);
invoiceDetailsObj.add("taxes", taxesArr);
JsonArray withholdingsArr = new JsonArray();
JsonObject withholdingsObj = new JsonObject();
withholdingsObj.addProperty("name", "ReteFuente");
withholdingsObj.addProperty("code", "06");
withholdingsObj.addProperty("type", "P");
withholdingsObj.addProperty("rate", 10);
withholdingsObj.addProperty("amount", 3.4);
withholdingsArr.add(withholdingsObj);
invoiceDetailsObj.add("withholdings", withholdingsArr);
JsonObject isvMandanteObj = new JsonObject();
isvMandanteObj.addProperty("name", "Mandante");
isvMandanteObj.addProperty("identification", "00001");
isvMandanteObj.addProperty("digitCheck", "8");
isvMandanteObj.addProperty("identificationTypeCode", "13");
invoiceDetailsObj.add("isvMandante", isvMandanteObj);
isvInvoice.add("invoiceDetails", invoiceDetailsArr);
JsonObject totals = new JsonObject();
totals.addProperty("amount", 68);
totals.addProperty("prepaymentAmount", 0);
isvInvoice.add("totals", totals);
JsonArray invoiceDiscountsArr = new JsonArray();
JsonObject invoiceDiscountsObj = new JsonObject();
invoiceDiscountsObj.addProperty("name", "");
invoiceDiscountsObj.addProperty("type", "");
invoiceDiscountsObj.addProperty("rate", 0);
invoiceDiscountsObj.addProperty("amount", 0);
invoiceDiscountsArr.add(invoiceDiscountsObj);
isvInvoice.add("discounts", invoiceDiscountsArr);
JsonArray invoiceChargesArr = new JsonArray();
JsonObject invoiceChargesObj = new JsonObject();
invoiceChargesObj.addProperty("name", "");
invoiceChargesObj.addProperty("type", "");
invoiceChargesObj.addProperty("rate", 0);
invoiceChargesObj.addProperty("amount", 0);
invoiceChargesArr.add(invoiceChargesObj);
isvInvoice.add("discounts", invoiceChargesArr);
JsonArray customFieldsArr = new JsonArray();
JsonObject customFieldsObj = new JsonObject();
customFieldsObj.addProperty("666", "invoiceId");
customFieldsArr.add(customFieldsObj);
isvInvoice.add("customFields", customFieldsArr);
/*
* - Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
* usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
* la API puede realizarlo con el que esta en este ejemplo
* - Realizar request por metodo POST
*/
HttpRequestWithBody request = Unirest.post("https://isv.aliaddo.net/api/v1/public/documents/invoice/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca");
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.header("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.header("content-type", "application/json");
request.header("cache-control", "no-cache");
request.header("accept", "application/json");
// Añadir el objeto de factura
request.body(isvInvoice).asJson()
// Manejar respuesta o error si hay alguno
.ifSuccess(response -> System.out.println("Response: " + "status -> " + response.getStatus() + " Body -> " + response.getBody() ))
.ifFailure(response -> {
System.out.println("Oh No! Status " + response.getStatus());
response.getParsingError().ifPresent(e -> {
System.out.println("Parsing Exception: " + e);
System.out.println("Original body: " + e.getOriginalBody());
});
});
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'01',
'format' => 'Estandar',
'emailSender' => '',
'consecutive' => 990004337,
'externalNumber' => '54554',
'currencyCode' => 'COP',
'currencyRate' => 0,
'date' => '2020-1-22',
'dateDue' => '2020-1-29',
'dateStart' => '2020-1-22',
'dateEnd' => '2020-1-29',
'typeOfOperation' => '10',
'dueDiligence' => '',
'incoterms' => '',
'terms' => '',
'remark' => '',
'observation' => '',
'termDay' => 0,
'paymentMeanCode' => '48',
'branch' => array(
'name' => '',
'address' => '',
'phone' => '',
'countryCode' => '',
'countryName' => '',
'departmentCode' => '',
'departmentName' => '',
'cityCode' => '',
'cityName' => ''
),
'resolution' => array(
'resolutionKey' => 'fc8eac422eba16e22ffd8c6f94b3f40a6e38162c',
'resolutionPrefix' => 'SETP',
'resolutionNumber' => 18760000001,
'resolutionRangeInitial' => 990000000,
'resolutionRangeFinal' => 995000000,
'resolutionValidFrom' => '2019-01-19',
'resolutionValidUntil' => '2030-01-19'
),
'customer' => array(
'companyName' => 'Customer',
'personType' => '1',
'regimeType' => '04',
'firstName' => 'Customer',
'lastName' => 'Customer',
'identification' => '000000001',
'digitCheck' => '8',
'identificationTypeCode' => '13',
'email' => '',
'phone' => '0000001',
'merchantRegistration' => '',
'responsibleFor' => 'ZZ',
'responsibilities' => 'R-99-PN',
'economicActivities' => '2817;3092',
'billingAddress' => 'KR con Calle',
'billingCountryName' => 'Colombia',
'billingCountryCode' => 'CO',
'billingRegionName' => 'Cundinamarca',
'billingRegionCode' => '25',
'billingCityName' => 'Chipaque',
'billingCityCode' => '25178',
'billingPostalCode' => '',
'billingNeighborhood' => '',
'billingPhone' => '',
'billingContactName' => '',
'shippingAddress' => '',
'shippingCountryName' => '',
'shippingCountryCode' => '',
'shippingRegionName' => '',
'shippingRegionCode' => '',
'shippingCityName' => '',
'shippingCityCode' => '',
'shippingPostalCode' => '',
'shippingNeighborhood' => '',
'shippingPhone' => '',
'shippingContactName' => ''
),
'invoiceDetails' => array(
array(
'standardType' => '',
'standardCode' => '',
'itemCode' => '0001',
'itemName' => 'Item',
'itemModel' => '',
'description' => 'Item prueba',
'brandName' => '',
'itemCodeSupplier' => '',
'isPresent' => false,
'isRemmitance' => false,
'remmitanceNumber' => "",
'remmitanceConsecutive' => "",
'remmitanceValue' => 0,
'remmitanceQuantityValue' => 0,
'remmitanceMeasurementUnit' => "",
'unitMeasurementCode' => '',
'unitMeasurementName' => '',
'price' => 25,
'quantity' => 2,
'discounts' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 1,
'amount' => 1
)
),
'charges' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 10,
'amount' => 10
)
),
'taxes' => array(
array(
'name' => 'Iva',
'code' => '01',
'type' => 'P',
'rate' => 19,
'amount' => 6.46
)
),
'withholdings' => array(
array(
'name' => 'ReteFuente',
'code' => '06',
'type' => 'P',
'rate' => 10,
'amount' => 3.4,
)
),
'isvMandante' => array(
'name' => 'Mandante',
'identification' => '000001',
'digitCheck' => '8',
'identificationTypeCode' => '13'
)
)
),
'totals' => array(
'amount' => 68,
'prepaymentAmount' => 0
),
'discounts' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'charges' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'customFields' => array(
array(
'value' => '6666',
'key' => 'invoiceId'
)
)
);
// Serializar la factura a JSON
$isvInvoice = json_encode($invoice);
/*
* Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
* usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
* la API puede realizarlo con el que esta en este ejemplo
*/
$testId = '4bf6673a-7a71-496e-8cfd-f7246067e4ca';
/**
* /invoice/habilitation/{testSetId}:
* - Enviar una factura para set de pruebas, en modo habilitación
* - Realizar request por metodo POST
*/
curl_setopt_array($curl, array(
// Añadir parámetro {testId} a la ruta
CURLOPT_URL => "https://isv.aliaddo.net/api/v1/public/documents/invoice/habilitation/$testId",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => $isvInvoice,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
// Tipo de requerimiento formato json
"content-type: application/json",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Terminar petición
curl_close($curl);
// Mostrar respuesta o error si hubo alguno
if ($err) {
echo "cURL Error #" . $err;
} else {
echo $response;
}
?>
```
{% endtab %}
{% tab title="Python" %}
```python
# Importar la librería "requests"
import requests
# /invoice/habilitation/{testSetId}:
# - Enviar una factura para set de pruebas, en modo habilitación
# - Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
# usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
# la API puede realizarlo con el que esta en este ejemplo
url = 'https://isv.aliaddo.net/api/v1/public/documents/invoice/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca'
# Crear objeto factura con resolución ejemplo
isvInvoice = {
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": 990077341,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateDue": "2020-1-25",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"dueDiligence": "",
"incoterms": "01",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": False,
"isPresent": False,
"isRemmitance": False,
"remmitanceNumber": "",
"remmitanceConsecutive": "",
"remmitanceValue": 0,
"remmitanceQuantityValue": 0,
"remmitanceMeasurementUnit": "",
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# - Realizar request por metodo POST
request = requests.post(url, json=isvInvoice, headers=headers)
# Mostrar respuesta de la petición
print(request.text)
print(request.status_code)
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
## Requerir gemas "rest-client" y "json"
require 'rest-client'
require 'json'
# /invoice/habilitation/{testSetId}:
# - Enviar una factura para set de pruebas, en modo habilitación
# - Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
# usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
# la API puede realizarlo con el que está en este ejemplo
url = "https://isv.aliaddo.net/api/v1/public/documents/invoice/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca"
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# Crear objeto factura con resolución ejemplo
isvInvoice = {
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": 990077342,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateDue": "2020-1-25",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"dueDiligence": "",
"incoterms": "01",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"isPresent": false,
"isRemmitance": false,
"remmitanceNumber": "",
"remmitanceConsecutive": "",
"remmitanceValue": 0,
"remmitanceQuantityValue": 0,
"remmitanceMeasurementUnit": "",
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Crear petición con método POST
begin
request = RestClient.post(url, isvInvoice.to_json, headers)
# Manejar error si hay alguno
rescue RestClient::ExceptionWithResponse => e
puts e.response
end
# Imprimir respuesta
puts request
```
{% endtab %}
{% endtabs %}
# Notas débito
Consulta rápidamente las secciones
{% content-ref url="/pages/-LrEwQsb-l0q9XAdDZ7v" %}
[Enviar nota débito para set de pruebas](/habilitacion/notas-debito/enviar-nota-debito-para-set-de-pruebas)
{% endcontent-ref %}
# Enviar nota débito para set de pruebas
Modo habilitación
## Enviar nota débito
`POST` `https://isv.aliaddo.net/api/v1/public/documents/notes-db/habilitation/{testSetId}`
Enviar una nota débito para set de pruebas en **modo habilitación**.
#### Path Parameters
| Name | Type | Description |
| --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| testSetId | string | Id de set de pruebas proporcionado por la DIAN para enviar documentos de prueba en modo habilitación para ser facturador electrónico |
| version | string | Versión de la API |
#### Headers
| Name | Type | Description |
| --------- | ------ | ------------------------------------------- |
| x-api-key | string | Token generado previamente para autorizarse |
#### Request Body
| Name | Type | Description |
| ---------------- | ------ | ------------------------ |
| isvInvoiceNoteDb | object | Objeto de la nota débito |
{% tabs %}
{% tab title="200 Request completado con éxito." %}
```javascript
{
"id": "string",
"mode": "string",
"format": "string",
"emailSender": "string",
"testSetId": "string",
"concept": "string",
"prefix": "string",
"consecutive": 0,
"sequence": "string",
"externalNumber": "string",
"currencyCode": "string",
"currencyRate": 0.0,
"date": "2020-01-30T00:00:00",
"dateStart": "2020-01-30T00:00:00",
"dateEnd": "2020-01-31T00:00:00",
"typeOfOperation": "string",
"terms": "string",
"remark": "string",
"observation": "string",
"cufe": "string",
"qr": "string",
"urlPdf": "string",
"urlXmlDocument": "string",
"urlXmlDocumentZip": "string",
"urlXmlApplicationResponse": "string",
"urlXmlAttachedDocument": "string",
"UrlPdfEncoded": "string",
"UrlXmlEncoded": "string",
"dianDeliveryStatus": "string",
"dianState": "string",
"dianStateReason": "string",
"dianStateDate": "0001-01-01T00:00:00",
"sentEmailAt": "0001-01-01T00:00:00",
"invoicePrefix": "string",
"invoiceConsecutive": 0.0,
"invoiceCufe": "string",
"invoiceDate": "2020-01-18T00:00:00",
"branch": {
"name": "string",
"address": "string",
"phone": "string",
"countryCode": "string",
"countryName": "string",
"departamentCode": "string",
"departamentName": "string",
"cityCode": "string",
"cityName": "string"
},
"resolution": {
"resolutionKey": "string",
"resolutionPrefix": "string",
"resolutionNumber": 0.0,
"resolutionRangeInitial": 0.0,
"resolutionRangeFinal": 0.0,
"resolutionValidFrom": "2019-01-19T00:00:00",
"resolutionValidUntil": "2030-01-19T00:00:00"
},
"customer": {
"companyName": "string",
"personType": "string",
"regimeType": "string",
"firstName": "string",
"lastName": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string",
"email": "string",
"phone": "string",
"merchantRegistration": "string",
"responsibilities": "string",
"economicActivitites": "string",
"billingAddress": "string",
"billingCountryName": "string",
"billingCountryCode": "string",
"billingRegionName": "string",
"billingRegionCode": "string",
"billingCityName": "string",
"billingCityCode": "string",
"billingPostalCode": "string",
"billingNeighborhood": "string",
"billingPhone": "string",
"billingContactName": "string",
"shippingAddress": "string",
"shippingCountryName": "string",
"shippingCountryCode": "string",
"shippingRegionName": "string",
"shippingRegionCode": "string",
"shippingCityName": "string",
"shippingCityCode": "string",
"shippingPostalCode": "string",
"shippingNeighborhood": "string",
"shippingPhone": "string",
"shippingContactName": "string"
},
"invoiceNoteDetails": [{
"standardType": "string",
"standardCode": "string",
"itemCode": "string",
"itemName": "string",
"itemModel": "string",
"description": "string",
"brandName": "string",
"itemCodeSupplier": "string",
"isPresent": false,
"unitMeasurementCode": "string",
"unitMeasurementName": "string",
"price": 0.0,
"quantity": 0.0,
"discountAmount": 0.0,
"chargeAmount": 0.0,
"subTotal": 0.0,
"priceWithAllowanceCharge": 0.0,
"totalWithAllowanceCharge": 0.0,
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"taxes": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"withholdings": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"isvMandante": {
"name": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string"
}
}],
"totals": {
"amount": 0.0,
"prepaymentAmount": 0.0,
"taxesAmount": 0.0,
"withholdingAmount": 0.0,
"discountsAmount": 0.0,
"chargesAmount": 0.0
},
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"customFields": [{
"key": "string",
"value": "string"
}],
"invoiceConsecutiveWithPrefix": "string"
}
```
{% endtab %}
{% tab title="204 " %}
```javascript
No se encontraron resultados de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="400 " %}
```
No se han enviado los tipos de datos requeridos de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using System;
using System.Collections.Generic;
using Newtonsoft.Json;
using RestSharp;
namespace App
{
public class Program
{
public static void Main()
{
/**
/notes-db/habilitation/{testSetId}:
- Enviar una nota débito para set de pruebas, en modo habilitación
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
// Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a la API puede realizarlo con el que esta en este ejemplo
// Realizar request por metodo POST
var request = new RestRequest("/notes-db/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto nota débito con resolución ejemplo
var isvInvoiceNoteDb = new
{
format = "Estandar",
emailSender = "",
concept = "1",
consecutive = 990000003,
externalNumber = "",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
typeOfOperation = "01",
terms = "",
remark = "",
observation = "",
invoicePrefix = "inv",
invoiceConsecutive = 990004331,
invoiceCufe = "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
invoiceDate = "2020-1-18",
branch = new
{
name = "Sucursal",
address = "KR con CLL",
phone = "000000",
countryCode = "CO",
countryName = "COLOMBIA",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "25178",
cityName = "Chipaque"
},
resolution = new
{
resolutionKey = "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix = "SETT",
resolutionNumber = 18760000001,
resolutionRangeInitial = 990000000,
resolutionRangeFinal = 995000000,
resolutionValidFrom = "2019-01-19",
resolutionValidUntil = "2030-01-19"
},
customer = new
{
companyName = "Customer",
personType = "1",
regimeType = "04",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "email@email.com",
phone = "0000001",
merchantRegistration = "",
responsibleFor = "ZZ",
responsibilities = "R-99-PN",
economicActivities = "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = "",
shippingAddress = "",
shippingCountryName = "",
shippingCountryCode = "",
shippingRegionName = "",
shippingRegionCode = "",
shippingCityName = "",
shippingCityCode = "",
shippingPostalCode = "",
shippingNeighborhood = "",
shippingPhone = "",
shippingContactName = ""
},
invoiceNoteDetails = new[]
{
new
{
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]
{
new
{
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]
{
new
{
name = "Iva",
code = "01",
type = "P",
rate = 19,
amount = 6.46
}
},
withholdings = new[]
{
new
{
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new
{
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
customFields = new[]
{
new KeyValuePair("NombreCampo", "ValorCampo")
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvInvoiceNoteDb),
ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mostrar respuesta
Console.WriteLine((int) response.StatusCode);
Console.WriteLine(response.Content);
}
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* /notes-db/habilitation/{testSetId}:
* - Enviar una nota débito para set de pruebas, en modo habilitación
* - Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
* usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
* la API puede realizarlo con el que esta en este ejemplo
* - Realizar request por metodo POST
*/
fetch("https://isv.aliaddo.net/api/v1/public/documents/notes-db/habilitation/c7154e6b-ad6e-4a7f-aaa0-8fafcbe07ce8", {
method: "POST",
body: JSON.stringify({
format: "Estandar",
emailSender: "",
concept: "1",
consecutive: 990000001,
externalNumber: "",
currencyCode: "COP",
currencyRate: 0,
date: "2020-1-18",
dateStart: "2020-1-18",
dateEnd: "2020-1-20",
typeOfOperation: "01",
terms: "",
remark: "",
observation: "",
//sentEmailAt: "",
invoicePrefix: "inv",
invoiceConsecutive: 990004331,
invoiceCufe: "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
invoiceDate: "2020-1-18",
branch: {
name: "Sucursal",
address: "KR con CLL",
phone: "000000",
countryCode: "CO",
countryName: "COLOMBIA",
departamentCode: "25",
departamentName: "Cundinamarca",
cityCode: "25178",
cityName: "Chipaque"
},
resolution: {
resolutionKey: "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix: "SETP",
resolutionNumber: 18760000001,
resolutionRangeInitial: 990000000,
resolutionRangeFinal: 995000000,
resolutionValidFrom: "2019-01-19",
resolutionValidUntil: "2030-01-19"
},
customer: {
companyName: "Customer",
personType: "1",
regimeType: "04",
firstName: "Customer",
lastName: "Customer",
identification: "000000001",
digitCheck: "8",
identificationTypeCode: "13",
email: "email@email.com",
phone: "",
merchantRegistration: "",
responsibleFor: "ZZ",
responsibilities: "R-99-PN",
economicActivities: "2817;3092",
billingAddress: "KR con Calle",
billingCountryName: "Colombia",
billingCountryCode: "CO",
billingRegionName: "Cundinamarca",
billingRegionCode: "25",
billingCityName: "Chipaque",
billingCityCode: "25178",
billingPostalCode: "",
billingNeighborhood: "",
billingPhone: "",
billingContactName: "",
shippingAddress: "",
shippingCountryName: "",
shippingCountryCode: "",
shippingRegionName: "",
shippingRegionCode: "",
shippingCityName: "",
shippingCityCode: "",
shippingPostalCode: "",
shippingNeighborhood: "",
shippingPhone: "",
shippingContactName: ""
},
invoiceNoteDetails: [{
standardType: "",
standardCode: "",
itemCode: "0001",
itemName: "Item",
itemModel: "",
description: "Item prueba",
brandName: "",
itemCodeSupplier: "",
isPresent: false,
unitMeasurementCode: "NIU",
unitMeasurementName: "",
price: 1285.00,
quantity: 2,
discounts: [{
name: "",
type: "V",
rate: 1,
amount: 1
}],
charges: [{
name: "",
type: "V",
rate: 10,
amount: 10
}],
taxes: [{
name: "Iva",
code: "01",
type: "V",
rate: 10,
amount: 10
}],
withholdings: [{
name: "ReteFuente",
code: "06",
type: "P",
rate: 10,
amount: 3.4
}],
isvMandante: {
name: "Mandante",
identification: "000001",
digitCheck: "8",
identificationTypeCode: "13"
}
}],
totals: {
amount: 68,
prepaymentAmount: 0
},
discounts: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
charges: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
customFields: [{
value: "666",
key: "invoiceId"
}]
}),
headers: {
"Content-Type": "application/json",
"x-api-key": "{{x-api-key}}"
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => res.json())
.catch(error => console.error("Error:", error))
.then(response => console.log("Success:", response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el request
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
// Agregar dependencia de GSON para serializar los objetos de Java a JSON
com.google.code.gson
gson
2.8.5
*/
// **** Clase donde se ejecuta el request ****
import com.google.gson.*;
import kong.unirest.*;
/*
* - Enviar una nota débito en modo habilitación
* - Añada las dependencias de UniRest y GSON a su POM como se muestra en el código de la parte superior
*/
public class Program {
public static void main(String[] args) {
// Crear objeto de nota débito
JsonObject isvInvoiceNoteDb = new JsonObject();
isvInvoiceNoteDb.addProperty("format", "Estandar");
isvInvoiceNoteDb.addProperty("emailSender", "");
isvInvoiceNoteDb.addProperty("concept", "1");
isvInvoiceNoteDb.addProperty("consecutive", 990000005);
isvInvoiceNoteDb.addProperty("externalNumber", "54554");
isvInvoiceNoteDb.addProperty("currencyCode", "COP");
isvInvoiceNoteDb.addProperty("currencyRate", 0);
isvInvoiceNoteDb.addProperty("date", "2020-1-20");
isvInvoiceNoteDb.addProperty("dateStart", "2020-1-20");
isvInvoiceNoteDb.addProperty("dateEnd", "2020-1-25");
isvInvoiceNoteDb.addProperty("typeOfOperation", "01");
isvInvoiceNoteDb.addProperty("terms", "");
isvInvoiceNoteDb.addProperty("remark", "");
isvInvoiceNoteDb.addProperty("observation", "");
isvInvoiceNoteDb.addProperty("invoicePrefix", "inv");
isvInvoiceNoteDb.addProperty("invoiceConsecutive", 990004331);
isvInvoiceNoteDb.addProperty("invoiceCufe", "cufe");
isvInvoiceNoteDb.addProperty("invoiceDate", "2020-1-18");
JsonObject branchObj = new JsonObject();
branchObj.addProperty("name", "");
branchObj.addProperty("address", "");
branchObj.addProperty("phone", "");
branchObj.addProperty("countryCode", "");
branchObj.addProperty("countryName", "");
branchObj.addProperty("departmentCode", "");
branchObj.addProperty("departmentName", "");
branchObj.addProperty("cityCode", "");
branchObj.addProperty("cityName", "");
isvInvoiceNoteDb.add("branch", branchObj);
JsonObject resolutionObj = new JsonObject();
resolutionObj.addProperty("resolutionKey", "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c");
resolutionObj.addProperty("resolutionPrefix", "SETP");
resolutionObj.addProperty("resolutionNumber", 18760000001f); // La 'f' indica tipo float
resolutionObj.addProperty("resolutionRangeInitial", 990000000);
resolutionObj.addProperty("resolutionRangeFinal", 995000000);
resolutionObj.addProperty("resolutionValidFrom", "2019-01-19");
resolutionObj.addProperty("resolutionValidUntil", "2030-01-19");
isvInvoiceNoteDb.add("resolution", resolutionObj);
JsonObject customerObj = new JsonObject();
customerObj.addProperty("companyName", "Customer");
customerObj.addProperty("personType", "1");
customerObj.addProperty("regimeType", "04");
customerObj.addProperty("firstName", "Customer");
customerObj.addProperty("lastName", "Customer");
customerObj.addProperty("identification", "000000001");
customerObj.addProperty("digitCheck", "8");
customerObj.addProperty("identificationTypeCode", "13");
customerObj.addProperty("email", "");
customerObj.addProperty("phone", "0000001");
customerObj.addProperty("merchantRegistration", "");
customerObj.addProperty("responsibleFor", "ZZ");
customerObj.addProperty("responsibilities", "R-99-PN");
customerObj.addProperty("economicActivities", "2817;3092");
customerObj.addProperty("billingAddress", "KR con Calle");
customerObj.addProperty("billingCountryName", "Colombia");
customerObj.addProperty("billingCountryCode", "CO");
customerObj.addProperty("billingRegionName", "Cundinamarca");
customerObj.addProperty("billingRegionCode", "25");
customerObj.addProperty("billingCityName", "Chipaque");
customerObj.addProperty("billingCityCode", "25178");
customerObj.addProperty("billingPostalCode", "");
customerObj.addProperty("billingNeighborhood", "");
customerObj.addProperty("billingPhone", "");
customerObj.addProperty("billingContactName", "");
customerObj.addProperty("shippingAddress", "");
customerObj.addProperty("shippingCountryName", "");
customerObj.addProperty("shippingCountryCode", "");
customerObj.addProperty("shippingRegionName", "");
customerObj.addProperty("shippingRegionCode", "");
customerObj.addProperty("shippingCityName", "");
customerObj.addProperty("shippingCityCode", "");
customerObj.addProperty("shippingPostalCode", "");
customerObj.addProperty("shippingNeighborhood", "");
customerObj.addProperty("shippingPhone", "");
customerObj.addProperty("shippingContactName", "");
isvInvoiceNoteDb.add("customer", customerObj);
JsonArray invoiceNoteDetailsArr = new JsonArray();
JsonObject invoiceNoteDetailsObj = new JsonObject();
invoiceNoteDetailsObj.addProperty("standardType", "");
invoiceNoteDetailsObj.addProperty("standardCode", "");
invoiceNoteDetailsObj.addProperty("itemCode", "0001");
invoiceNoteDetailsObj.addProperty("itemName", "Item");
invoiceNoteDetailsObj.addProperty("itemModel", "");
invoiceNoteDetailsObj.addProperty("description", "Item prueba");
invoiceNoteDetailsObj.addProperty("brandName", "");
invoiceNoteDetailsObj.addProperty("itemCodeSupplier", "");
invoiceNoteDetailsObj.addProperty("isPresent", false);
invoiceNoteDetailsObj.addProperty("unitMeasurementCode", "");
invoiceNoteDetailsObj.addProperty("unitMeasurementName", "");
invoiceNoteDetailsObj.addProperty("price", 25);
invoiceNoteDetailsObj.addProperty("quantity", 2);
invoiceNoteDetailsArr.add(invoiceNoteDetailsObj);
JsonArray discountsArr = new JsonArray();
JsonObject discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "V");
discountsObj.addProperty("rate", 1);
discountsObj.addProperty("amount", 1);
discountsArr.add(discountsObj);
invoiceNoteDetailsObj.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "V");
chargesObj.addProperty("rate", 10);
chargesObj.addProperty("amount", 10);
chargesArr.add(chargesObj);
invoiceNoteDetailsObj.add("charges", chargesArr);
JsonArray taxesArr = new JsonArray();
JsonObject taxesObj = new JsonObject();
taxesObj.addProperty("name", "Iva");
taxesObj.addProperty("code", "01");
taxesObj.addProperty("type", "P");
taxesObj.addProperty("rate", 19);
taxesObj.addProperty("amount", 6.46);
taxesArr.add(taxesObj);
invoiceNoteDetailsObj.add("taxes", taxesArr);
JsonArray withholdingsArr = new JsonArray();
JsonObject withholdingsObj = new JsonObject();
withholdingsObj.addProperty("name", "ReteFuente");
withholdingsObj.addProperty("code", "06");
withholdingsObj.addProperty("type", "P");
withholdingsObj.addProperty("rate", 10);
withholdingsObj.addProperty("amount", 3.4);
withholdingsArr.add(withholdingsObj);
invoiceNoteDetailsObj.add("withholdings", withholdingsArr);
JsonObject isvMandanteObj = new JsonObject();
isvMandanteObj.addProperty("name", "Mandante");
isvMandanteObj.addProperty("identification","0014");
isvMandanteObj.addProperty("digitCheck", "8");
isvMandanteObj.addProperty("identificationTypeCode", "13");
invoiceNoteDetailsObj.add("isvMandante", isvMandanteObj);
isvInvoiceNoteDb.add("invoiceNoteDetails", invoiceNoteDetailsArr);
JsonObject totals = new JsonObject();
totals.addProperty("amount", 68);
totals.addProperty("prepaymentAmount", 0);
isvInvoiceNoteDb.add("totals", totals);
JsonArray isvInvoiceNoteDbDiscountsArr = new JsonArray();
JsonObject isvInvoiceNoteDbDiscountsObj = new JsonObject();
isvInvoiceNoteDbDiscountsObj.addProperty("name", "");
isvInvoiceNoteDbDiscountsObj.addProperty("type", "");
isvInvoiceNoteDbDiscountsObj.addProperty("rate", 0);
isvInvoiceNoteDbDiscountsObj.addProperty("amount", 0);
isvInvoiceNoteDbDiscountsArr.add(isvInvoiceNoteDbDiscountsObj);
isvInvoiceNoteDb.add("discounts", isvInvoiceNoteDbDiscountsArr);
JsonArray isvInvoiceNoteDbChargesArr = new JsonArray();
JsonObject isvInvoiceNoteDbChargesObj = new JsonObject();
isvInvoiceNoteDbChargesObj.addProperty("name", "");
isvInvoiceNoteDbChargesObj.addProperty("type", "");
isvInvoiceNoteDbChargesObj.addProperty("rate", 0);
isvInvoiceNoteDbChargesObj.addProperty("amount", 0);
isvInvoiceNoteDbChargesArr.add(isvInvoiceNoteDbChargesObj);
isvInvoiceNoteDb.add("charges", isvInvoiceNoteDbChargesArr);
JsonArray customFieldsArr = new JsonArray();
JsonObject customFieldsObj = new JsonObject();
customFieldsObj.addProperty("666", "invoiceId");
customFieldsArr.add(customFieldsObj);
isvInvoiceNoteDb.add("customFields", customFieldsArr);
/*
* - Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
* usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
* la API puede realizarlo con el que esta en este ejemplo
* - Realizar request por metodo POST
*/
HttpRequestWithBody request = Unirest.post("https://isv.aliaddo.net/api/v1/public/documents/notes-db/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca");
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.header("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.header("content-type", "application/json");
request.header("cache-control", "no-cache");
request.header("accept", "application/json");
// Añadir el objeto de nota débito
request.body(isvInvoiceNoteDb).asJson()
// Manejar respuesta o error si hay alguno
.ifSuccess(response -> System.out.println("Response: " + "status -> " + response.getStatus() + " Body -> " + response.getBody() ))
.ifFailure(response -> {
System.out.println("Oh No! Status " + response.getStatus());
response.getParsingError().ifPresent(e -> {
System.out.println("Parsing Exception: " + e);
System.out.println("Original body: " + e.getOriginalBody());
});
});
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'Estandar',
'emailSender' => '',
'concept' => '1',
'consecutive' => 990000006,
'externalNumber' => '54554',
'currencyCode' => 'COP',
'currencyRate' => 0,
'date' => '2020-1-22',
'dateStart' => '2020-1-22',
'dateEnd' => '2020-1-25',
'typeOfOperation' => '01',
'terms' => '',
'remark' => '',
'observation' => '',
'invoicePrefix' => 'inv',
'invoiceConsecutive' => 990004331,
'invoiceCufe' => 'aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162',
'invoiceDate' => '2020-1-18',
'branch' => array(
'name' => '',
'address' => '',
'phone' => '',
'countryCode' => '',
'countryName' => '',
'departmentCode' => '',
'departmentName' => '',
'cityCode' => '',
'cityName' => ''
),
'resolution' => array(
'resolutionKey' => 'fc8eac422eba16e22ffd8c6f94b3f40a6e38162c',
'resolutionPrefix' => 'SETP',
'resolutionNumber' => 18760000001,
'resolutionRangeInitial' => 990000000,
'resolutionRangeFinal' => 995000000,
'resolutionValidFrom' => '2019-01-19',
'resolutionValidUntil' => '2030-01-19'
),
'customer' => array(
'companyName' => 'Customer',
'personType' => '1',
'regimeType' => '04',
'firstName' => 'Customer',
'lastName' => 'Customer',
'identification' => '000000001',
'digitCheck' => '8',
'identificationTypeCode' => '13',
'email' => 'email@email.com',
'phone' => '0000001',
'merchantRegistration' => '',
'responsibleFor' => "ZZ",
'responsibilities' => 'R-99-PN',
'economicActivities' => '2817;3092',
'billingAddress' => 'KR con Calle',
'billingCountryName' => 'Colombia',
'billingCountryCode' => 'CO',
'billingRegionName' => 'Cundinamarca',
'billingRegionCode' => '25',
'billingCityName' => 'Chipaque',
'billingCityCode' => '25178',
'billingPostalCode' => '',
'billingNeighborhood' => '',
'billingPhone' => '',
'billingContactName' => '',
'shippingAddress' => '',
'shippingCountryName' => '',
'shippingCountryCode' => '',
'shippingRegionName' => '',
'shippingRegionCode' => '',
'shippingCityName' => '',
'shippingCityCode' => '',
'shippingPostalCode' => '',
'shippingNeighborhood' => '',
'shippingPhone' => '',
'shippingContactName' => ''
),
'invoiceNoteDetails' => array(
array(
'standardType' => '',
'standardCode' => '',
'itemCode' => '0001',
'itemName' => 'Item',
'itemModel' => '',
'description' => 'Item prueba',
'brandName' => '',
'itemCodeSupplier' => '',
'isPresent' => false,
'unitMeasurementCode' => '',
'unitMeasurementName' => '',
'price' => 25,
'quantity' => 2,
'discounts' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 1,
'amount' => 1
)
),
'charges' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 10,
'amount' => 10
)
),
'taxes' => array(
array(
'name' => 'Iva',
'code' => '01',
'type' => 'P',
'rate' => 19,
'amount' => 6.46
)
),
'withholdings' => array(
array(
'name' => 'ReteFuente',
'code' => '06',
'type' => 'P',
'rate' => 10,
'amount' => 3.4,
)
),
'isvMandante' => array(
'name' => 'Mandante',
'identification' => '000001',
'digitCheck' => '8',
'identificationTypeCode' => '13'
)
)
),
'totals' => array(
'amount' => 68,
'prepaymentAmount' => 0
),
'discounts' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'charges' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'customFields' => array(
array(
'value' => '6666',
'key' => 'invoiceId'
)
)
);
// Serializar objeto a JSON
$isvInvoiceNoteDb = json_encode($debitNote);
/** Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
* usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
* la API puede realizarlo con el que esta en este ejemplo
*/
$testId = '4bf6673a-7a71-496e-8cfd-f7246067e4ca';
/**
* /notes-db/habilitation/{testSetId}:
* - Enviar una nota débito para set de pruebas, en modo habilitación
* - Realizar request por metodo POST
*/
curl_setopt_array($curl, array(
// Añadir parámetro {testId} a la ruta
CURLOPT_URL => "https://isv.aliaddo.net/api/v1/public/documents/notes-db/habilitation/$testId",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => $isvInvoiceNoteDb,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
// Tipo de requerimiento formato json
"content-type: application/json",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Mostar respuesta o error si hubo alguno
if ($err) {
echo "error -> " . $err;
} else {
echo $response;
}
// Terminar petición
curl_close($curl);
?>
```
{% endtab %}
{% tab title="Python" %}
```python
# Importar la librería "requests"
import requests
# /notes-db/habilitation/{testSetID}:
# - Enviar una nota débito en modo habilitación
# - Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
# usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
# la API puede realizarlo con el que esta en este ejemplo
url = 'https://isv.aliaddo.net/api/v1/public/documents/notes-db/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca'
# Crear objeto de nota débito
debitNote = {
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 9900000020,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customemer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": False,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# - Realizar request por metodo POST
request = requests.post(url, json=debitNote, headers=headers)
# Mostrar respuesta de la petición
print(request.text)
print(request.status_code)
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
# Requerir gemas "rest-client" y "json"
require 'rest-client'
require 'json'
# /notes-db/habilitation/{testSetId}:
# - Enviar una nota débito para set de pruebas, en modo habilitación
# - Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
# usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
# la API puede realizarlo con el que esta en este ejemplo
url = "https://isv.aliaddo.net/api/v1/public/documents/notes-db/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca"
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# Crear objeto de nota débito
debitNote = {
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 9900000017,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customemer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Crear petición con método POST
begin
request = RestClient.post(url, debitNote.to_json, headers)
# Manejar error si hay alguno
rescue RestClient::ExceptionWithResponse => e
puts e.response
end
# Imprimir respuesta
puts request
```
{% endtab %}
{% endtabs %}
# Notas crédito
Consulta rápidamente las secciones
{% content-ref url="/pages/-LrLi9qv-Da4J0iVYcYT" %}
[Enviar nota crédito para set de pruebas](/habilitacion/notas-credito/enviar-nota-credito-para-set-de-pruebas)
{% endcontent-ref %}
# Enviar nota crédito para set de pruebas
Modo habilitación
## Enviar nota crédito
`POST` `https://isv.aliaddo.net/api/v1/public/documents/notes-cr/habilitation/{testSetId}`
Enviar una nota crédito para set de pruebas, en **modo habilitación**.
#### Path Parameters
| Name | Type | Description |
| --------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| testSetId | string | *(UUID)* Id de set de pruebas proporcionado por la DIAN para enviar documentos de prueba en modo habilitación para ser facturador electrónico |
| version | string | Versión de la API |
#### Query Parameters
| Name | Type | Description |
| ---------------- | ------ | ------------------------- |
| isvInvoiceNoteCr | object | Objeto de la nota crédito |
#### Headers
| Name | Type | Description |
| --------- | ------ | ------------------------------------------- |
| x-api-key | string | Token generado previamente para autorizarse |
{% tabs %}
{% tab title="200 Request completado con éxito." %}
```javascript
{
"id": "string",
"mode": "string",
"format": "string",
"emailSender": "string",
"testSetId": "string",
"concept": "string",
"prefix": "string",
"consecutive": 0.0,
"sequence": "string",
"externalNumber": "string",
"currencyCode": "string",
"currencyRate": 0.0,
"date": "2020-01-30T00:00:00",
"dateStart": "2020-01-30T00:00:00",
"dateEnd": "2020-01-31T00:00:00",
"typeOfOperation": "string",
"terms": "string",
"remark": "string",
"observation": "string",
"cufe": "string",
"qr": "string",
"urlPdf": "string",
"urlXmlDocument": "string",
"urlXmlDocumentZip": "string",
"urlXmlApplicationResponse": "string",
"urlXmlAttachedDocument": "string",
"UrlPdfEncoded": "string",
"UrlXmlEncoded": "string",
"dianDeliveryStatus": "string",
"dianState": "string",
"dianStateReason": "string",
"sentEmail": false,
"sentEmailAt": "0001-01-01T00:00:00",
"invoicePrefix": "string",
"invoiceConsecutive": 990005331,
"invoiceCufe": "string",
"invoiceDate": "2020-01-18T00:00:00",
"branch": {
"name": "string",
"address": "string",
"phone": "string",
"countryCode": "string",
"countryName": "string",
"departamentCode": "string",
"departamentName": "string",
"cityCode": "string",
"cityName": "string"
},
"resolution": {
"resolutionKey": "string",
"resolutionPrefix": "string",
"resolutionNumber": 0.0,
"resolutionRangeInitial": 0.0,
"resolutionRangeFinal": 0.0,
"resolutionValidFrom": "2019-01-19T00:00:00",
"resolutionValidUntil": "2030-01-19T00:00:00"
},
"customer": {
"companyName": "string",
"personType": "string",
"regimeType": "string",
"firstName": "string",
"lastName": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string",
"email": "string",
"phone": "string",
"merchantRegistration": "string",
"responsibilities": "string",
"economicActivities": "string",
"billingAddress": "string",
"billingCountryName": "string",
"billingCountryCode": "string",
"billingRegionName": "string",
"billingRegionCode": "string",
"billingCityName": "string",
"billingCityCode": "string",
"billingPostalCode": "string",
"billingNeighborhood": "string",
"billingPhone": "string",
"billingContactName": "string",
"shippingAddress": "string",
"shippingCountryName": "string",
"shippingCountryCode": "string",
"shippingRegionName": "string",
"shippingRegionCode": "string",
"shippingCityName": "string",
"shippingCityCode": "string",
"shippingPostalCode": "string",
"shippingNeighborhood": "string",
"shippingPhone": "string",
"shippingContactName": "string"
},
"invoiceNoteDetails": [{
"standardType": "string",
"standardCode": "string",
"itemCode": "string",
"itemName": "string",
"itemModel": "string",
"description": "string",
"brandName": "string",
"itemCodeSupplier": "string",
"isPresent": false,
"unitMeasurementCode": "string",
"unitMeasurementName": "string",
"price": 0.0,
"quantity": 0.0,
"discountAmount": 0.0,
"chargeAmount": 0.0,
"subTotal": 0.0,
"priceWithAllowanceCharge": 0.0,
"totalWithAllowanceCharge": 0.0,
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"taxes": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"withholdings": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"isvMandante": {
"name": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string"
}
}],
"totals": {
"amount": 0.0,
"prepaymentAmount": 0.0,
"taxesAmount": 0.0,
"withholdingAmount": 0.0,
"discountsAmount": 0.0,
"chargesAmount": 0.0
},
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"customFields": [{
"key": "string",
"value": "string"
}],
"invoiceConsecutiveWithPrefix": "string"
}
```
{% endtab %}
{% tab title="204 " %}
```javascript
No se encontraron resultados de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="400 " %}
```
No se han enviado los tipos de datos requeridosde acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using RestSharp;
using System;
using Newtonsoft.Json;
class Program
{
public static void Main()
{
/**
/notes-cr/habilitation/{testSetId}:
- Enviar una nota crédito para set de pruebas, en modo habilitación
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
// Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a la API puede realizarlo con el que esta en este ejemplo
// Realizar request por metodo POST
var request = new RestRequest("/notes-cr/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto nota débito con resolución ejemplo
var isvInvoiceNoteCr = new
{
format = "Estandar",
emailSender = "",
concept = "1",
consecutive = 6,
externalNumber = "",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
typeOfOperation = "01",
terms = "",
remark = "",
observation = "",
invoicePrefix = "inv",
invoiceConsecutive = 990004331,
invoiceCufe = "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
invoiceDate = "2020-1-18",
branch = new
{
name = "Sucursal",
address = "KR con CLL",
phone = "000000",
countryCode = "CO",
countryName = "COLOMBIA",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "25178",
cityName = "Chipaque"
},
resolution = new
{
resolutionKey = "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix = "SETT",
resolutionNumber = 18760000001,
resolutionRangeInitial = 990000000,
resolutionRangeFinal = 995000000,
resolutionValidFrom = "2019-01-19",
resolutionValidUntil = "2030-01-19"
},
customer = new
{
companyName = "Customer",
personType = "1",
regimeType = "04",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "email@email.com",
phone = "0000001",
merchantRegistration = "",
responsibleFor = "ZZ",
responsibilities = "R-99-PN",
economicActivities= "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = "",
shippingAddress = "",
shippingCountryName = "",
shippingCountryCode = "",
shippingRegionName = "",
shippingRegionCode = "",
shippingCityName = "",
shippingCityCode = "",
shippingPostalCode = "",
shippingNeighborhood = "",
shippingPhone = "",
shippingContactName = ""
},
invoiceNoteDetails = new[]
{
new
{
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]
{
new
{
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]
{
new
{
name = "Iva",
code = "01",
type = "P",
rate = 19,
amount = 6.46
}
},
withholdings = new[]
{
new
{
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new
{
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
customFields = new[]
{
new KeyValuePair("NombreCampo", "ValorCampo")
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvInvoiceNoteCr),
ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mostrar respuesta
Console.WriteLine((int) response.StatusCode);
Console.WriteLine(response.Content);
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* /notes-cr/habilitation/{testSetId}:
* - Enviar una nota crédito para set de pruebas, en modo habilitación
* - Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
* usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
* la API puede realizarlo con el que esta en este ejemplo
* - Realizar request por metodo POST
*/
fetch("https://isv.aliaddo.net/api/v1/public/documents/notes-cr/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca", {
method: "POST",
body: JSON.stringify({
format: "Estandar",
emailSender: "",
concept: "1",
consecutive: 5,
externalNumber: "",
currencyCode: "COP",
currencyRate: 0,
date: "2020-1-18",
dateStart: "2020-1-18",
dateEnd: "2020-1-20",
typeOfOperation: "01",
terms: "",
remark: "",
observation: "",
invoicePrefix: "inv",
invoiceConsecutive: 990004331,
invoiceCufe: "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
invoiceDate: "2020-1-18",
branch: {
name: "Sucursal",
address: "KR con CLL",
phone: "000000",
countryCode: "CO",
countryName: "COLOMBIA",
departamentCode: "25",
departamentName: "Cundinamarca",
cityCode: "25178",
cityName: "Chipaque"
},
resolution: {
resolutionKey: "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix: "SETP",
resolutionNumber: 18760000001,
resolutionRangeInitial: 990000000,
resolutionRangeFinal: 995000000,
resolutionValidFrom: "2019-01-19",
resolutionValidUntil: "2030-01-19"
},
customer: {
companyName: "Customer",
personType: "1",
regimeType: "04",
firstName: "Customer",
lastName: "Customer",
identification: "000000001",
digitCheck: "8",
identificationTypeCode: "13",
email: "email@email.com",
phone: "",
merchantRegistration: "",
responsibleFor: "ZZ",
responsibilities: "R-99-PN",
economicActivities: "2817;3092",
billingAddress: "KR con Calle",
billingCountryName: "Colombia",
billingCountryCode: "CO",
billingRegionName: "Cundinamarca",
billingRegionCode: "25",
billingCityName: "Chipaque",
billingCityCode: "25178",
billingPostalCode: "",
billingNeighborhood: "",
billingPhone: "",
billingContactName: "",
shippingAddress: "",
shippingCountryName: "",
shippingCountryCode: "",
shippingRegionName: "",
shippingRegionCode: "",
shippingCityName: "",
shippingCityCode: "",
shippingPostalCode: "",
shippingNeighborhood: "",
shippingPhone: "",
shippingContactName: ""
},
invoiceNoteDetails: [{
standardType: "",
standardCode: "",
itemCode: "0001",
itemName: "Item",
itemModel: "",
description: "Item prueba",
brandName: "",
itemCodeSupplier: "",
isPresent: false,
unitMeasurementCode: "NIU",
unitMeasurementName: "",
price: 1285.00,
quantity: 2,
discounts: [{
name: "",
type: "V",
rate: 1,
amount: 1
}],
charges: [{
name: "",
type: "V",
rate: 10,
amount: 10
}],
taxes: [{
name: "Iva",
code: "01",
type: "V",
rate: 10,
amount: 10
}],
withholdings: [{
name: "ReteFuente",
code: "06",
type: "P",
rate: 10,
amount: 3.4
}],
isvMandante: {
name: "Mandante",
identification: "000001",
digitCheck: "8",
identificationTypeCode: "13"
}
}],
totals: {
amount: 68,
prepaymentAmount: 0
},
discounts: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
charges: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
customFields: [{
value: "666",
key: "invoiceId"
}]
}),
headers: {
"Content-Type": "application/json",
"x-api-key": "{{x-api-key}}"
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => res.json())
.catch(error => console.error("Error:", error))
.then(response => console.log("Success:", response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el request
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
// Agregar dependencia de GSON para serializar los objetos de Java a JSON
com.google.code.gson
gson
2.8.5
*/
// **** Clase donde se ejecuta el request ****
import com.google.gson.*;
import kong.unirest.*;
/*
* /notes-cr/habilitation/{testSetId}:
* - Enviar una nota crédito en modo habilitación
* - Añada las dependencias de UniRest y GSON a su POM como se muestra en el código de la parte superior
*/
public class Program {
public static void main(String[] args) {
// Crear objeto de nota crédito
JsonObject isvInvoiceNoteCr = new JsonObject();
isvInvoiceNoteCr.addProperty("format", "Estandar");
isvInvoiceNoteCr.addProperty("emailSender", "");
isvInvoiceNoteCr.addProperty("concept", "1");
isvInvoiceNoteCr.addProperty("consecutive", 8);
isvInvoiceNoteCr.addProperty("externalNumber", "54554");
isvInvoiceNoteCr.addProperty("currencyCode", "COP");
isvInvoiceNoteCr.addProperty("currencyRate", 0);
isvInvoiceNoteCr.addProperty("date", "2020-1-20");
isvInvoiceNoteCr.addProperty("dateStart", "2020-1-20");
isvInvoiceNoteCr.addProperty("dateEnd", "2020-1-25");
isvInvoiceNoteCr.addProperty("typeOfOperation", "01");
isvInvoiceNoteCr.addProperty("terms", "");
isvInvoiceNoteCr.addProperty("remark", "");
isvInvoiceNoteCr.addProperty("observation", "");
isvInvoiceNoteCr.addProperty("invoicePrefix", "inv");
isvInvoiceNoteCr.addProperty("invoiceConsecutive", 990004331);
isvInvoiceNoteCr.addProperty("invoiceCufe", "cufe");
isvInvoiceNoteCr.addProperty("invoiceDate", "2020-1-18");
JsonObject branchObj = new JsonObject();
branchObj.addProperty("name", "");
branchObj.addProperty("address", "");
branchObj.addProperty("phone", "");
branchObj.addProperty("countryCode", "");
branchObj.addProperty("countryName", "");
branchObj.addProperty("departmentCode", "");
branchObj.addProperty("departmentName", "");
branchObj.addProperty("cityCode", "");
branchObj.addProperty("cityName", "");
isvInvoiceNoteCr.add("branch", branchObj);
JsonObject resolutionObj = new JsonObject();
resolutionObj.addProperty("resolutionKey", "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c");
resolutionObj.addProperty("resolutionPrefix", "SETP");
resolutionObj.addProperty("resolutionNumber", 18760000001f); // La 'f' indica tipo float
resolutionObj.addProperty("resolutionRangeInitial", 990000000);
resolutionObj.addProperty("resolutionRangeFinal", 995000000);
resolutionObj.addProperty("resolutionValidFrom", "2019-01-19");
resolutionObj.addProperty("resolutionValidUntil", "2030-01-19");
isvInvoiceNoteCr.add("resolution", resolutionObj);
JsonObject customerObj = new JsonObject();
customerObj.addProperty("companyName", "Customer");
customerObj.addProperty("personType", "1");
customerObj.addProperty("regimeType", "04");
customerObj.addProperty("firstName", "Customer");
customerObj.addProperty("lastName", "Customer");
customerObj.addProperty("identification", "000000001");
customerObj.addProperty("digitCheck", "8");
customerObj.addProperty("identificationTypeCode", "13");
customerObj.addProperty("email", "");
customerObj.addProperty("phone", "0000001");
customerObj.addProperty("merchantRegistration", "");
customerObj.addProperty("responsibleFor", "ZZ");
customerObj.addProperty("responsibilities", "R-99-PN");
customerObj.addProperty("economicActivities", "2817;3092");
customerObj.addProperty("billingAddress", "KR con Calle");
customerObj.addProperty("billingCountryName", "Colombia");
customerObj.addProperty("billingCountryCode", "CO");
customerObj.addProperty("billingRegionName", "Cundinamarca");
customerObj.addProperty("billingRegionCode", "25");
customerObj.addProperty("billingCityName", "Chipaque");
customerObj.addProperty("billingCityCode", "25178");
customerObj.addProperty("billingPostalCode", "");
customerObj.addProperty("billingNeighborhood", "");
customerObj.addProperty("billingPhone", "");
customerObj.addProperty("billingContactName", "");
customerObj.addProperty("shippingAddress", "");
customerObj.addProperty("shippingCountryName", "");
customerObj.addProperty("shippingCountryCode", "");
customerObj.addProperty("shippingRegionName", "");
customerObj.addProperty("shippingRegionCode", "");
customerObj.addProperty("shippingCityName", "");
customerObj.addProperty("shippingCityCode", "");
customerObj.addProperty("shippingPostalCode", "");
customerObj.addProperty("shippingNeighborhood", "");
customerObj.addProperty("shippingPhone", "");
customerObj.addProperty("shippingContactName", "");
isvInvoiceNoteCr.add("customer", customerObj);
JsonArray invoiceNoteDetailsArr = new JsonArray();
JsonObject invoiceNoteDetailsObj = new JsonObject();
invoiceNoteDetailsObj.addProperty("standardType", "");
invoiceNoteDetailsObj.addProperty("standardCode", "");
invoiceNoteDetailsObj.addProperty("itemCode", "0001");
invoiceNoteDetailsObj.addProperty("itemName", "Item");
invoiceNoteDetailsObj.addProperty("itemModel", "");
invoiceNoteDetailsObj.addProperty("description", "Item prueba");
invoiceNoteDetailsObj.addProperty("brandName", "");
invoiceNoteDetailsObj.addProperty("itemCodeSupplier", "");
invoiceNoteDetailsObj.addProperty("isPresent", false);
invoiceNoteDetailsObj.addProperty("unitMeasurementCode", "");
invoiceNoteDetailsObj.addProperty("unitMeasurementName", "");
invoiceNoteDetailsObj.addProperty("price", 25);
invoiceNoteDetailsObj.addProperty("quantity", 2);
invoiceNoteDetailsArr.add(invoiceNoteDetailsObj);
JsonArray discountsArr = new JsonArray();
JsonObject discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "V");
discountsObj.addProperty("rate", 1);
discountsObj.addProperty("amount", 1);
discountsArr.add(discountsObj);
invoiceNoteDetailsObj.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "V");
chargesObj.addProperty("rate", 10);
chargesObj.addProperty("amount", 10);
chargesArr.add(chargesObj);
invoiceNoteDetailsObj.add("charges", chargesArr);
JsonArray taxesArr = new JsonArray();
JsonObject taxesObj = new JsonObject();
taxesObj.addProperty("name", "Iva");
taxesObj.addProperty("code", "01");
taxesObj.addProperty("type", "P");
taxesObj.addProperty("rate", 19);
taxesObj.addProperty("amount", 6.46);
taxesArr.add(taxesObj);
invoiceNoteDetailsObj.add("taxes", taxesArr);
JsonArray withholdingsArr = new JsonArray();
JsonObject withholdingsObj = new JsonObject();
withholdingsObj.addProperty("name", "ReteFuente");
withholdingsObj.addProperty("code", "06");
withholdingsObj.addProperty("type", "P");
withholdingsObj.addProperty("rate", 10);
withholdingsObj.addProperty("amount", 3.4);
withholdingsArr.add(withholdingsObj);
invoiceNoteDetailsObj.add("withholdings", withholdingsArr);
JsonObject isvMandanteObj = new JsonObject();
isvMandanteObj.addProperty("name", "Mandante");
isvMandanteObj.addProperty("identification", "0014");
isvMandanteObj.addProperty("digitCheck", "8");
isvMandanteObj.addProperty("identificationTypeCode", "13");
invoiceNoteDetailsObj.add("isvMandante", isvMandanteObj);
isvInvoiceNoteCr.add("invoiceNoteDetails", invoiceNoteDetailsArr);
JsonObject totals = new JsonObject();
totals.addProperty("amount", 68);
totals.addProperty("amount", 68);
totals.addProperty("prepaymentAmount", 0);
isvInvoiceNoteCr.add("totals", totals);
JsonArray isvInvoiceNoteDbDiscountsArr = new JsonArray();
JsonObject isvInvoiceNoteDbDiscountsObj = new JsonObject();
isvInvoiceNoteDbDiscountsObj.addProperty("type", "");
isvInvoiceNoteDbDiscountsObj.addProperty("rate", 0);
isvInvoiceNoteDbDiscountsObj.addProperty("amount", 0);
isvInvoiceNoteDbDiscountsArr.add(isvInvoiceNoteDbDiscountsObj);
isvInvoiceNoteCr.add("discounts", isvInvoiceNoteDbDiscountsArr);
JsonArray isvInvoiceNoteDbChargesArr = new JsonArray();
JsonObject isvInvoiceNoteDbChargesObj = new JsonObject();
isvInvoiceNoteDbChargesObj.addProperty("type", "");
isvInvoiceNoteDbChargesObj.addProperty("rate", 0);
isvInvoiceNoteDbChargesObj.addProperty("amount", 0);
isvInvoiceNoteDbChargesArr.add(isvInvoiceNoteDbChargesObj);
isvInvoiceNoteCr.add("charges", isvInvoiceNoteDbChargesArr);
JsonArray customFieldsArr = new JsonArray();
JsonObject customFieldsObj = new JsonObject();
customFieldsObj.addProperty("666", "invoiceId");
customFieldsArr.add(customFieldsObj);
isvInvoiceNoteCr.add("customFields", customFieldsArr);
/*
* - Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
* usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
* la API puede realizarlo con el que esta en este ejemplo
* - Realizar request por metodo POST
*/
HttpRequestWithBody request = Unirest.post("https://isv.aliaddo.net/api/v1/public/documents/notes-cr/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca");
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.header("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.header("content-type", "application/json");
request.header("cache-control", "no-cache");
request.header("accept", "application/json");
// Añadir el objeto de nota crédito
request.body(isvInvoiceNoteCr).asJson()
// Manejar respuesta o error si hay alguno
.ifSuccess(response -> System.out.println("Response: " + "status -> " + response.getStatus() + " Body -> " + response.getBody()))
.ifFailure(response -> {
System.out.println("Oh No! Status " + response.getStatus());
response.getParsingError().ifPresent(e -> {
System.out.println("Parsing Exception: " + e);
System.out.println("Original body: " + e.getOriginalBody());
});
});
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'Estandar',
'emailSender' => '',
'concept' => '1',
'consecutive' => 8,
'externalNumber' => '54554',
'currencyCode' => 'COP',
'currencyRate' => 0,
'date' => '2020-1-22',
'dateStart' => '2020-1-22',
'dateEnd' => '2020-1-25',
'typeOfOperation' => '01',
'terms' => '',
'remark' => '',
'observation' => '',
'invoicePrefix' => 'inv',
'invoiceConsecutive' => 990004331,
'invoiceCufe' => 'aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162',
'invoiceDate' => '2020-1-18',
'branch' => array(
'name' => '',
'address' => '',
'phone' => '',
'countryCode' => '',
'countryName' => '',
'departmentCode' => '',
'departmentName' => '',
'cityCode' => '',
'cityName' => ''
),
'resolution' => array(
'resolutionKey' => 'fc8eac422eba16e22ffd8c6f94b3f40a6e38162c',
'resolutionPrefix' => 'SETP',
'resolutionNumber' => 18760000001,
'resolutionRangeInitial' => 990000000,
'resolutionRangeFinal' => 995000000,
'resolutionValidFrom' => '2019-01-19',
'resolutionValidUntil' => '2030-01-19'
),
'customer' => array(
'companyName' => 'Customer',
'personType' => '1',
'regimeType' => '04',
'firstName' => 'Customer',
'lastName' => 'Customer',
'identification' => '000000001',
'digitCheck' => '8',
'identificationTypeCode' => '13',
'email' => 'email@email.com',
'phone' => '0000001',
'merchantRegistration' => '',
'responsibleFor' => 'ZZ',
'responsibilities' => 'R-99-PN',
'economicActivities' => '2817;3092',
'billingAddress' => 'KR con Calle',
'billingCountryName' => 'Colombia',
'billingCountryCode' => 'CO',
'billingRegionName' => 'Cundinamarca',
'billingRegionCode' => '25',
'billingCityName' => 'Chipaque',
'billingCityCode' => '25178',
'billingPostalCode' => '',
'billingNeighborhood' => '',
'billingPhone' => '',
'billingContactName' => '',
'shippingAddress' => '',
'shippingCountryName' => '',
'shippingCountryCode' => '',
'shippingRegionName' => '',
'shippingRegionCode' => '',
'shippingCityName' => '',
'shippingCityCode' => '',
'shippingPostalCode' => '',
'shippingNeighborhood' => '',
'shippingPhone' => '',
'shippingContactName' => ''
),
'invoiceNoteDetails' => array(
array(
'standardType' => '',
'standardCode' => '',
'itemCode' => '0001',
'itemName' => 'Item',
'itemModel' => '',
'description' => 'Item prueba',
'brandName' => '',
'itemCodeSupplier' => '',
'isPresent' => false,
'unitMeasurementCode' => '',
'unitMeasurementName' => '',
'price' => 25,
'quantity' => 2,
'discounts' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 1,
'amount' => 1
)
),
'charges' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 10,
'amount' => 10
)
),
'taxes' => array(
array(
'name' => 'Iva',
'code' => '01',
'type' => 'P',
'rate' => 19,
'amount' => 6.46
)
),
'withholdings' => array(
array(
'name' => 'ReteFuente',
'code' => '06',
'type' => 'P',
'rate' => 10,
'amount' => 3.4,
)
),
'isvMandante' => array(
'name' => 'Mandante',
'identification' => '000001',
'digitCheck' => '8',
'identificationTypeCode' => '13'
)
)
),
'totals' => array(
'amount' => 68,
'prepaymentAmount' => 0
),
'discounts' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'charges' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'customFields' => array(
array(
'value' => '6666',
'key' => 'invoiceId'
)
)
);
// Serializar objeto a JSON
$isvInvoiceNoteCr = json_encode($creditNote );
/** Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
* usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
* la API puede realizarlo con el que esta en este ejemplo
*/
$testId = '4bf6673a-7a71-496e-8cfd-f7246067e4ca';
/**
* /notes-cr/habilitation/{testSetId}:
* - Enviar una nota crédito para set de pruebas, en modo habilitación
* - Realizar request por metodo POST
*/
curl_setopt_array($curl, array(
// Añadir parámetro {testId} a la ruta
CURLOPT_URL => "https://isv.aliaddo.net/api/v1/public/documents/notes-cr/habilitation/$testId",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => $isvInvoiceNoteCr,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
// Tipo de requerimiento formato json
"content-type: application/json",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Mostar respuesta o error si hubo alguno
if ($err) {
echo "cURL Error #" .$err;
} else {
echo $response;
}
// Terminar petición
curl_close($curl);
?>
```
{% endtab %}
{% tab title="Python" %}
```python
# Importar la librería "requests"
import requests
# /notes-cr/habilitation/{testSetID}:
# - Enviar una nota crédito en modo habilitación
# - Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
# usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
# la API puede realizarlo con el que esta en este ejemplo
url = 'https://isv.aliaddo.net/api/v1/public/documents/notes-cr/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca'
# Crear objeto de nota crédito
isvInvoiceNoteCr = {
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 9,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": False,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# - Realizar request por metodo POST
request = requests.post(url, json=isvInvoiceNoteCr, headers=headers)
# Mostrar respuesta de la petición
print(request.text)
print(request.status_code)
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
# Requerir gemas "rest-client" y "json"
require 'rest-client'
require 'json'
# /notes-cr/habilitation/{testSetId}:
# - Enviar una nota crédito para set de pruebas, en modo habilitación
# - Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que
# usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a
# la API puede realizarlo con el que esta en este ejemplo
url = "https://isv.aliaddo.net/api/v1/public/documents/notes-cr/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca"
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# Crear objeto de nota crédito
isvInvoiceNoteCr = {
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 10,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Crear petición con método POST
begin
request = RestClient.post(url, isvInvoiceNoteCr.to_json, headers)
# Manejar error si hay alguno
rescue RestClient::ExceptionWithResponse => e
puts e.response
end
# Imprimir respuesta
puts request
```
{% endtab %}
{% endtabs %}
# Facturas
Consulta rápidamente a las secciones
{% content-ref url="/pages/-LqDTU\_Cq4mLIF-x97\_i" %}
[Enviar factura](/produccion/facturas/enviar-factura-a-dian)
{% endcontent-ref %}
# Enviar factura
Modo producción
## Enviar factura
`POST` `https://isv.aliaddo.net/api/v1/public/documents/invoice`
Enviar una factura a la DIAN en **modo producción**.
#### Path Parameters
| Name | Type | Description |
| ------- | ------ | ----------------- |
| version | string | Versión de la API |
#### Headers
| Name | Type | Description |
| --------- | ------ | -------------------------------------------- |
| x-api-key | string | Token generado previamente para autenticarse |
#### Request Body
| Name | Type | Description |
| ---------- | ------ | -------------------- |
| isvInvoice | string | Objeto de la factura |
{% tabs %}
{% tab title="200 Request completado con éxito" %}
```javascript
{
"id": "string",
"code": "string",
"mode": "string",
"format": "string",
"emailSender": "string",
"testSetId": "string",
"prefix": "string",
"consecutive": 0,
"status": "string",
"statusDate": "2020-01-30T00:00:00",
"sequence": "string",
"externalNumber": "string",
"currencyCode": "string",
"currencyRate": 0,
"date": "2020-01-30T00:00:00",
"dateDue": "2020-01-31T00:00:00",
"dateStart": "2020-01-30T00:00:00",
"dateEnd": "2020-01-31T00:00:00",
"typeOfOperation": "string",
"dueDiligence": "string",
"incoterms": "string",
"deliveryTerms": "string",
"terms": "string",
"remark": "string",
"observation": "string",
"cufe": "string",
"qr": "string",
"urlPdf": "string",
"urlXmlDocument": "string",
"urlXmlDocumentZip": "string",
"urlXmlApplicationResponse": "string",
"urlXmlAttachedDocument": "string",
"UrlPdfEncoded": "string",
"UrlXmlEncoded": "string",
"dianDeliveryStatus": "string",
"dianState": "string",
"dianStateReason": "string",
"dianStateDate": "0001-01-01T00:00:00",
"sentEmail": false,
"sentEmailAt": "0001-01-01T00:00:00",
"termDay": 0,
"paymentMeanCode": "string",
"rejectReason": "string",
"hasNotesDb": false,
"hasNotesCr": false,
"branch": {
"name": "string",
"address": "string",
"phone": "string",
"countryCode": "string",
"countryName": "string",
"departamentCode": "string",
"departamentName": "string",
"cityCode": "string",
"cityName": "string"
},
"resolution": {
"resolutionKey": "string",
"resolutionPrefix": "string",
"resolutionNumber": 0,
"resolutionRangeInitial": 0,
"resolutionRangeFinal": 0,
"resolutionValidFrom": "2019-01-19T00:00:00",
"resolutionValidUntil": "2030-01-19T00:00:00"
},
"customer": {
"companyName": "string",
"personType": "string",
"regimeType": "string",
"firstName": "string",
"lastName": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string",
"email": "string",
"phone": "string",
"merchantRegistration": "string",
"responsibilities": "string",
"economicActivities": "string",
"billingAddress": "string",
"billingCountryName": "string",
"billingCountryCode": "string",
"billingRegionName": "string",
"billingRegionCode": "string",
"billingCityName": "string",
"billingCityCode": "string",
"billingPostalCode": "string",
"billingNeighborhood": "string",
"billingPhone": "string",
"billingContactName": "string",
"shippingAddress": "string",
"shippingCountryName": "string",
"shippingCountryCode": "string",
"shippingRegionName": "string",
"shippingRegionCode": "string",
"shippingCityName": "string",
"shippingCityCode": "string",
"shippingPostalCode": "string",
"shippingNeighborhood": "string",
"shippingPhone": "string",
"shippingContactName": "string"
},
"invoiceDetails": [{
"standardType": "string",
"standardCode": "string",
"itemCode": "string",
"itemName": "string",
"itemModel": "string",
"description": "string",
"brandName": "string",
"itemCodeSupplier": "string",
"isPresent": false,
"unitMeasurementCode": "string",
"unitMeasurementName": "string",
"price": 0,
"quantity": 0,
"discountAmount": 0,
"chargeAmount": 0,
"subTotal": 0,
"priceWithAllowanceCharge": 0,
"totalWithAllowanceCharge": 0,
"discounts": [{
"name": "string",
"type": "string",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0,
"amount": 0
}],
"taxes": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0,
"amount": 0,
"base": 0
}],
"withholdings": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0,
"amount": 0,
"base": 0
}],
"isvMandante": {
"name": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string"
}
}],
"totals": {
"amount": 0,
"prepaymentAmount": 0,
"taxesAmount": 0,
"withholdingAmount": 0,
"discountsAmount": 0,
"chargesAmount": 0
},
"discounts": [{
"name": "string",
"type": "string",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0,
"amount": 0
}],
"customFields": [{
"key": "string",
"value": "string"
}],
"createdAt": "0001-01-01T00:00:00",
"updatedAt": "0001-01-01T00:00:00",
"isDue": false
}
```
{% endtab %}
{% tab title="204 " %}
```
No se encontraron resultados de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="400 " %}
```javascript
No se han enviado los tipos de datos requeridos
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using System;
using Newtonsoft.Json;
using RestSharp;
public class Program
{
public static void Main()
{
/**
- Enviar una factura a la DIAN, en modo producción
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
// Realizar request por metodo POST
var request = new RestRequest("/invoice", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto factura con resolución ejemplo
var isvInvoice = new
{
code = "01",
format = "Estandar",
emailSender = "email@example.com",
consecutive = 990004332,
externalNumber = "54554",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateDue = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
typeOfOperation = "10",
dueDiligence = "",
incoterms = "",
terms = "",
remark = "",
observation = "",
termDay = 0,
paymentMeanCode = "48",
branch = new {
name = "branch",
address = "Cl6 Cra 66",
phone = "7649813",
countryCode = "CO",
countryName = "Colombia",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "11001",
cityname = "Bogotá, D.c."
},
resolution = new
{
resolutionKey = "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix = "SETT",
resolutionNumber = 18760000001,
resolutionRangeInitial = 990000000,
resolutionRangeFinal = 995000000,
resolutionValidFrom = "2019-01-19",
resolutionValidUntil = "2030-01-19"
},
customer = new
{
companyName = "Customer",
personType = "1",
regimeType = "04",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "",
phone = "0000001",
merchantRegistration = "",
responsibleFor: "ZZ",
responsibilities = "R-99-PN",
economicActivities = "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = "",
shippingAddress = "",
shippingCountryName = "",
shippingCountryCode = "",
shippingRegionName = "",
shippingRegionCode = "",
shippingCityName = "",
shippingCityCode = "",
shippingPostalCode = "",
shippingNeighborhood = "",
shippingPhone = "",
shippingContactName = ""
},
invoiceDetails = new[]{
new {
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
isRemmitance: false,
remmitanceNumber: "",
remmitanceConsecutive: "",
remmitanceValue: 0,
remmitanceQuantityValue: 0,
remmitanceMeasurementUnit: "",
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]{
new {
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]{
new {
name = "",
code = "01",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]{
new {
name = "Iva",
code = "01",
type = "P",
rate = 20,
amount = 6.46
}
},
withholdings = new[]{
new {
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "000001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new {
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new {
name = "",
type = "V",
rate = 10,
amount = 10
}
},
customFields = new[]
{
new KeyValuePair("NombreCampo", "ValorCampo")
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvInvoice), ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mostrar respuesta
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(response.Content);
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* - Enviar una factura a la DIAN, en modo producción
* - Realizar request por metodo POST
*/
fetch('https://isv.aliaddo.net/api/v1/public/documents/invoice', {
method: 'POST',
// Crear objeto factura con resolución de ejemplo
body: JSON.stringify({
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": "990004322",
"externalNumber": "",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-23",
"dateDue": "2020-1-29",
"dateStart": "2020-1-23",
"dateEnd": "2020-1-29",
"typeOfOperation": "10",
"dueDiligence": "",
"incoterms": "",
"deliveryTerms": "",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departamentCode": "",
"departamentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": "18760000001",
"resolutionRangeInitial": "990000000",
"resolutionRangeFinal": "995000000",
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "email@email.com",
"phone": "",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContactName": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"isRemmitance": false,
"remmitanceNumber": "",
"remmitanceConsecutive": "",
"remmitanceValue": 0,
"remmitanceQuantityValue": 0,
"remmitanceMeasurementUnit": "",
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": "1285.00",
"quantity": "2",
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "V",
"rate": 10,
"amount": 10
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "Mandante",
"identification": "000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"prepaymentAmount": 68,
"amount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}
],
"customFields": [{
"value": "666",
"key": "invoiceId"
}]
}),
// Añadir cabeceras a la petición
headers: {
'Content-Type': 'application/json',
'x-api-key': '{{x-api-key}}'
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => res.json())
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el request
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
// Agregar dependencia de GSON para serializar los objetos de Java a JSON
com.google.code.gson
gson
2.8.5
*/
// **** Clase donde se ejecuta el request ****
// Agregue las dependencias de UniRest a su POM como se indica en el código superior
import com.google.gson.*;
import kong.unirest.*;
/*
* - Enviar una factura a la DIAN, en modo producción
* - Añada las dependencias de UniRest y GSON a su POM como se muestra en el código de la parte superior
*/
public class Program {
public static void main(String[] args) {
// Crear objeto factura con resolución ejemplo
JsonObject isvInvoice = new JsonObject();
isvInvoice.addProperty("code", "01");
isvInvoice.addProperty("format", "Estandar");
isvInvoice.addProperty("emailSender", "");
isvInvoice.addProperty("consecutive", 990004336);
isvInvoice.addProperty("externalNumber", "54554");
isvInvoice.addProperty("currencyCode", "COP");
isvInvoice.addProperty("currencyRate", 0);
isvInvoice.addProperty("date", "2020-1-20");
isvInvoice.addProperty("dateDue", "2020-1-24");
isvInvoice.addProperty("dateStart", "2020-1-20");
isvInvoice.addProperty("dateEnd", "2020-1-24");
isvInvoice.addProperty("typeOfOperation", "10");
isvInvoice.addProperty("dueDiligence", "");
isvInvoice.addProperty("incoterms", "");
isvInvoice.addProperty("terms", "");
isvInvoice.addProperty("remark", "");
isvInvoice.addProperty("observation", "");
isvInvoice.addProperty("termDay", 0);
isvInvoice.addProperty("paymentCode", 48);
JsonObject branchObj = new JsonObject();
branchObj.addProperty("name", "");
branchObj.addProperty("address", "");
branchObj.addProperty("phone", "");
branchObj.addProperty("countryCode", "");
branchObj.addProperty("countryName", "");
branchObj.addProperty("departmentCode", "");
branchObj.addProperty("departmentName", "");
branchObj.addProperty("cityCode", "");
branchObj.addProperty("cityName", "");
isvInvoice.add("branch", branchObj);
JsonObject resolutionObj = new JsonObject();
resolutionObj.addProperty("resolutionKey", "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c");
resolutionObj.addProperty("resolutionPrefix", "SETP");
resolutionObj.addProperty("resolutionNumber", 18760000001f); // La f indica tipo float
resolutionObj.addProperty("resolutionRangeInitial", 990000000);
resolutionObj.addProperty("resolutionRangeFinal", 995000000);
resolutionObj.addProperty("resolutionValidFrom", "2019-01-19");
resolutionObj.addProperty("resolutionValidUntil", "2030-01-19");
isvInvoice.add("resolution", resolutionObj);
JsonObject customerObj = new JsonObject();
customerObj.addProperty("companyName", "Customer");
customerObj.addProperty("personType", "1");
customerObj.addProperty("regimeType", "04");
customerObj.addProperty("firstName", "Customer");
customerObj.addProperty("lastName", "Customer");
customerObj.addProperty("identification", "000000001");
customerObj.addProperty("digitCheck", "8");
customerObj.addProperty("identificationTypeCode", "13");
customerObj.addProperty("email", "");
customerObj.addProperty("phone", "0000001");
customerObj.addProperty("merchantRegistration", "");
customerObj.addProperty("responsibleFor", "ZZ");
customerObj.addProperty("responsibilities", "R-99-PN");
customerObj.addProperty("economicActivities", "2817;3092");
customerObj.addProperty("billingAddress", "KR con Calle");
customerObj.addProperty("billingCountryName", "Colombia");
customerObj.addProperty("billingCountryCode", "CO");
customerObj.addProperty("billingRegionName", "Cundinamarca");
customerObj.addProperty("billingRegionCode", "25");
customerObj.addProperty("billingCityName", "Chipaque");
customerObj.addProperty("billingCityCode", "25178");
customerObj.addProperty("billingPostalCode", "");
customerObj.addProperty("billingNeighborhood", "");
customerObj.addProperty("billingPhone", "");
customerObj.addProperty("billingContactName", "");
customerObj.addProperty("shippingAddress", "");
customerObj.addProperty("shippingCountryName", "");
customerObj.addProperty("shippingCountryCode", "");
customerObj.addProperty("shippingRegionName", "");
customerObj.addProperty("shippingRegionCode", "");
customerObj.addProperty("shippingCityName", "");
customerObj.addProperty("shippingCityCode", "");
customerObj.addProperty("shippingPostalCode", "");
customerObj.addProperty("shippingNeighborhood", "");
customerObj.addProperty("shippingPhone", "");
customerObj.addProperty("shippingContactName", "");
isvInvoice.add("customer", customerObj);
JsonArray invoiceDetailsArr = new JsonArray();
JsonObject invoiceDetailsObj = new JsonObject();
invoiceDetailsObj.addProperty("standardType", "");
invoiceDetailsObj.addProperty("standardCode", "");
invoiceDetailsObj.addProperty("itemCode", "0001");
invoiceDetailsObj.addProperty("itemName", "Item");
invoiceDetailsObj.addProperty("itemModel", "");
invoiceDetailsObj.addProperty("description", "Item prueba");
invoiceDetailsObj.addProperty("brandName", "");
invoiceDetailsObj.addProperty("itemCodeSupplier", "");
invoiceDetailsObj.addProperty("isPresent", false);
invoiceDetailsObj.addProperty("isRemmitance", false);
invoiceDetailsObj.addProperty("remmitanceNumber", "");
invoiceDetailsObj.addProperty("remmitanceConsecutive", "");
invoiceDetailsObj.addProperty("remmitanceValue", 0);
invoiceDetailsObj.addProperty("remmitanceQuantityValue", 0);
invoiceDetailsObj.addProperty("remmitanceMeasurementUnit", "");
invoiceDetailsObj.addProperty("unitMeasurementCode", "");
invoiceDetailsObj.addProperty("unitMeasurementName", "");
invoiceDetailsObj.addProperty("price", 25);
invoiceDetailsObj.addProperty("quantity", 2);
invoiceDetailsArr.add(invoiceDetailsObj);
JsonArray discountsArr = new JsonArray();
JsonObject discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "V");
discountsObj.addProperty("rate", 1);
discountsObj.addProperty("amount", 1);
discountsArr.add(discountsObj);
invoiceDetailsObj.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "V");
chargesObj.addProperty("rate", 10);
chargesObj.addProperty("amount", 10);
chargesArr.add(chargesObj);
invoiceDetailsObj.add("charges", chargesArr);
JsonArray taxesArr = new JsonArray();
JsonObject taxesObj = new JsonObject();
taxesObj.addProperty("name", "Iva");
taxesObj.addProperty("code", "01");
taxesObj.addProperty("type", "P");
taxesObj.addProperty("rate", 19);
taxesObj.addProperty("amount", 6.46);
taxesArr.add(taxesObj);
invoiceDetailsObj.add("taxes", taxesArr);
JsonArray withholdingsArr = new JsonArray();
JsonObject withholdingsObj = new JsonObject();
withholdingsObj.addProperty("name", "ReteFuente");
withholdingsObj.addProperty("code", "06");
withholdingsObj.addProperty("type", "P");
withholdingsObj.addProperty("rate", 10);
withholdingsObj.addProperty("amount", 3.4);
withholdingsArr.add(withholdingsObj);
invoiceDetailsObj.add("withholdings", withholdingsArr);
JsonObject isvMandanteObj = new JsonObject();
isvMandanteObj.addProperty("name", "Mandante");
isvMandanteObj.addProperty("identification", "00001");
isvMandanteObj.addProperty("digitCheck", "8");
isvMandanteObj.addProperty("identificationTypeCode", "13");
invoiceDetailsObj.add("isvMandante", isvMandanteObj);
isvInvoice.add("invoiceDetails", invoiceDetailsArr);
JsonObject totals = new JsonObject();
totals.addProperty("amount", 68);
totals.addProperty("prepaymentAmount", 0);
isvInvoice.add("totals", totals);
JsonArray invoiceDiscountsArr = new JsonArray();
JsonObject invoiceDiscountsObj = new JsonObject();
invoiceDiscountsObj.addProperty("name", "");
invoiceDiscountsObj.addProperty("type", "");
invoiceDiscountsObj.addProperty("rate", 0);
invoiceDiscountsObj.addProperty("amount", 0);
invoiceDiscountsArr.add(invoiceDiscountsObj);
isvInvoice.add("discounts", invoiceDiscountsArr);
JsonArray invoiceChargesArr = new JsonArray();
JsonObject invoiceChargesObj = new JsonObject();
invoiceChargesObj.addProperty("name", "");
invoiceChargesObj.addProperty("type", "");
invoiceChargesObj.addProperty("rate", 0);
invoiceChargesObj.addProperty("amount", 0);
invoiceChargesArr.add(invoiceChargesObj);
isvInvoice.add("discounts", invoiceChargesArr);
JsonArray customFieldsArr = new JsonArray();
JsonObject customFieldsObj = new JsonObject();
customFieldsObj.addProperty("666", "invoiceId");
customFieldsArr.add(customFieldsObj);
isvInvoice.add("customFields", customFieldsArr);
JsonArray customFieldsArr = new JsonArray();
JsonObject customFieldsObj = new JsonObject();
customFieldsObj.addProperty("666", "invoiceId");
customFieldsArr.add(customFieldsObj);
isvInvoice.add("customFields", customFieldsArr);
// Realizar request por metodo POST
HttpRequestWithBody request = Unirest.post("https://isv.aliaddo.net/api/v1/public/documents/invoice");
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.header("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.header("content-type", "application/json");
request.header("cache-control", "no-cache");
request.header("accept", "application/json");
// Añadir el objeto de factura
request.body(isvInvoice).asJson()
// Manejar respuesta o error si hay alguno
.ifSuccess(response -> System.out.println("Response: " + "status -> " + response.getStatus() + " Body -> " + response.getBody() ))
.ifFailure(response -> {
System.out.println("Oh No! Status " + response.getStatus());
response.getParsingError().ifPresent(e -> {
System.out.println("Parsing Exception: " + e);
System.out.println("Original body: " + e.getOriginalBody());
});
});
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'01',
'format' => 'Estandar',
'emailSender' => '',
'consecutive' => 990004337,
'externalNumber' => '54554',
'currencyCode' => 'COP',
'currencyRate' => 0,
'date' => '2020-1-22',
'dateDue' => '2020-1-29',
'dateStart' => '2020-1-22',
'dateEnd' => '2020-1-29',
'typeOfOperation' => '10',
'dueDiligence' => '',
'incoterms' => '',
'terms' => '',
'remark' => '',
'observation' => '',
'termDay' => 0,
'paymentMeanCode' => '48',
'branch' => array(
'name' => '',
'address' => '',
'phone' => '',
'countryCode' => '',
'countryName' => '',
'departmentCode' => '',
'departmentName' => '',
'cityCode' => '',
'cityName' => ''
),
'resolution' => array(
'resolutionKey' => 'fc8eac422eba16e22ffd8c6f94b3f40a6e38162c',
'resolutionPrefix' => 'SETP',
'resolutionNumber' => 18760000001,
'resolutionRangeInitial' => 990000000,
'resolutionRangeFinal' => 995000000,
'resolutionValidFrom' => '2019-01-19',
'resolutionValidUntil' => '2030-01-19'
),
'customer' => array(
'companyName' => 'Customer',
'personType' => '1',
'regimeType' => '04',
'firstName' => 'Customer',
'lastName' => 'Customer',
'identification' => '000000001',
'digitCheck' => '8',
'identificationTypeCode' => '13',
'email' => '',
'phone' => '0000001',
'merchantRegistration' => '',
'responsibleFor' => 'ZZ',
'responsibilities' => 'R-99-PN',
'economicActivities' => '2817;3092',
'billingAddress' => 'KR con Calle',
'billingCountryName' => 'Colombia',
'billingCountryCode' => 'CO',
'billingRegionName' => 'Cundinamarca',
'billingRegionCode' => '25',
'billingCityName' => 'Chipaque',
'billingCityCode' => '25178',
'billingPostalCode' => '',
'billingNeighborhood' => '',
'billingPhone' => '',
'billingContactName' => '',
'shippingAddress' => '',
'shippingCountryName' => '',
'shippingCountryCode' => '',
'shippingRegionName' => '',
'shippingRegionCode' => '',
'shippingCityName' => '',
'shippingCityCode' => '',
'shippingPostalCode' => '',
'shippingNeighborhood' => '',
'shippingPhone' => '',
'shippingContactName' => ''
),
'invoiceDetails' => array(
array(
'standardType' => '',
'standardCode' => '',
'itemCode' => '0001',
'itemName' => 'Item',
'itemModel' => '',
'description' => 'Item prueba',
'brandName' => '',
'itemCodeSupplier' => '',
'isPresent' => false,
'isRemmitance' => false,
'remmitanceNumber' => "",
'remmitanceConsecutive' => "",
'remmitanceValue' => 0,
'remmitanceQuantityValue' => 0,
'remmitanceMeasurementUnit' => "",
'unitMeasurementCode' => '',
'unitMeasurementName' => '',
'price' => 25,
'quantity' => 2,
'discounts' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 1,
'amount' => 1
)
),
'charges' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 10,
'amount' => 10
)
),
'taxes' => array(
array(
'name' => 'Iva',
'code' => '01',
'type' => 'P',
'rate' => 19,
'amount' => 6.46
)
),
'withholdings' => array(
array(
'name' => 'ReteFuente',
'code' => '06',
'type' => 'P',
'rate' => 10,
'amount' => 3.4,
)
),
'isvMandante' => array(
'name' => 'Mandante',
'identification' => '000001',
'digitCheck' => '8',
'identificationTypeCode' => '13'
)
)
),
'totals' => array(
'amount' => 68,
'prepaymentAmount' => 0
),
'discounts' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'charges' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'customFields' => array(
array(
'value' => '6666',
'key' => 'invoiceId'
)
)
);
// Serializar la factura a JSON
$isvInvoice = json_encode($invoice);
/**
* - Enviar una factura a la DIAN, en modo producción
* - Realizar request por metodo POST
*/
curl_setopt_array($curl, array(
CURLOPT_URL => "https://isv.aliaddo.net/api/v1/public/documents/invoice",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => $isvInvoice,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
// Tipo de requerimiento formato json
"content-type: application/json",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Mostar respuesta o error si hubo alguno
if ($err) {
echo "error -> " . $err;
} else {
echo $response;
}
// Terminar petición
curl_close($curl);
?>
```
{% endtab %}
{% tab title="Python" %}
```python
# Importar la librería "requests"
import requests
# - Enviar una factura a la DIAN, en modo producción
url = 'https://isv.aliaddo.net/api/v1/public/documents/invoice'
# Crear objeto factura con resolución ejemplo
isvInvoice = {
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": 990077341,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateDue": "2020-1-25",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"dueDiligence": "",
"incoterms": "01",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": False,
"isPresent": False,
"isRemmitance": False,
"remmitanceNumber": "",
"remmitanceConsecutive": "",
"remmitanceValue": 0,
"remmitanceQuantityValue": 0,
"remmitanceMeasurementUnit": "",
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# - Realizar request por metodo POST
request = requests.post(url, json=isvInvoice, headers=headers)
# Mostrar respuesta de la petición
print(request.text)
print(request.status_code)
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
# Requerir gemas "rest-client" y "json"
require 'rest-client'
require 'json'
# - Enviar una factura en modo producción
url = "https://isv.aliaddo.net/api/v1/public/documents/invoice"
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# Crear objeto factura con resolución ejemplo
isvInvoice = {
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": 990077342,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateDue": "2020-1-25",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"dueDiligence": "",
"incoterms": "01",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"isPresent": false,
"isRemmitance": false,
"remmitanceNumber": "",
"remmitanceConsecutive": "",
"remmitanceValue": 0,
"remmitanceQuantityValue": 0,
"remmitanceMeasurementUnit": "",
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Crear petición con método POST
begin
request = RestClient.post(url, isvInvoice.to_json, headers)
# Manejar error si hay alguno
rescue RestClient::ExceptionWithResponse => e
puts e.response
end
# Imprimir respuesta
puts request
```
{% endtab %}
{% endtabs %}
# Notas débito
Consulta rápidamente las secciones
{% content-ref url="/pages/-LrPEHWdbAJnFvSKDe21" %}
[Enviar nota débito](/produccion/notas-debito/enviar-nota-debito)
{% endcontent-ref %}
# Enviar nota débito
Modo producción
## Enviar nota débito
`POST` `https://isv.aliaddo.net/api/v1/public/documents/invoice`
Enviar una nota débito en **modo producción** a la DIAN.
#### Path Parameters
| Name | Type | Description |
| ------- | ------ | ----------------- |
| version | string | Versión de la API |
#### Headers
| Name | Type | Description |
| --------- | ------ | ------------------------------------------- |
| x-api-key | string | Token generado previamente para autorizarse |
#### Request Body
| Name | Type | Description |
| ---------------- | ------ | ------------------------ |
| isvInvoiceNoteDb | object | Objeto de la nota débito |
{% tabs %}
{% tab title="200 Request completado con éxito." %}
```javascript
{
"id": "string",
"mode": "string",
"format": "string",
"emailSender": "string",
"testSetId": "string",
"concept": "string",
"prefix": "string",
"consecutive": 0,
"sequence": "string",
"externalNumber": "string",
"currencyCode": "string",
"currencyRate": 0.0,
"date": "2020-01-30T00:00:00",
"dateStart": "2020-01-30T00:00:00",
"dateEnd": "2020-01-31T00:00:00",
"typeOfOperation": "string",
"terms": "string",
"remark": "string",
"observation": "string",
"cufe": "string",
"qr": "string",
"urlPdf": "string",
"urlXmlDocument": "string",
"urlXmlDocumentZip": "string",
"urlXmlApplicationResponse": "string",
"urlXmlAttachedDocument": "string",
"UrlPdfEncoded": "string",
"UrlXmlEncoded": "string",
"dianDeliveryStatus": "string",
"dianState": "string",
"dianStateReason": "string",
"dianStateDate": "0001-01-01T00:00:00",
"sentEmailAt": "0001-01-01T00:00:00",
"invoicePrefix": "string",
"invoiceConsecutive": 0.0,
"invoiceCufe": "string",
"invoiceDate": "2020-01-18T00:00:00",
"branch": {
"name": "string",
"address": "string",
"phone": "string",
"countryCode": "string",
"countryName": "string",
"departamentCode": "string",
"departamentName": "string",
"cityCode": "string",
"cityName": "string"
},
"resolution": {
"resolutionKey": "string",
"resolutionPrefix": "string",
"resolutionNumber": 0.0,
"resolutionRangeInitial": 0.0,
"resolutionRangeFinal": 0.0,
"resolutionValidFrom": "2019-01-19T00:00:00",
"resolutionValidUntil": "2030-01-19T00:00:00"
},
"customer": {
"companyName": "string",
"personType": "string",
"regimeType": "string",
"firstName": "string",
"lastName": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string",
"email": "string",
"phone": "string",
"merchantRegistration": "string",
"responsibilities": "string",
"economicActivities": "string",
"billingAddress": "string",
"billingCountryName": "string",
"billingCountryCode": "string",
"billingRegionName": "string",
"billingRegionCode": "string",
"billingCityName": "string",
"billingCityCode": "string",
"billingPostalCode": "string",
"billingNeighborhood": "string",
"billingPhone": "string",
"billingContactName": "string",
"shippingAddress": "string",
"shippingCountryName": "string",
"shippingCountryCode": "string",
"shippingRegionName": "string",
"shippingRegionCode": "string",
"shippingCityName": "string",
"shippingCityCode": "string",
"shippingPostalCode": "string",
"shippingNeighborhood": "string",
"shippingPhone": "string",
"shippingContactName": "string"
},
"invoiceNoteDetails": [{
"standardType": "string",
"standardCode": "string",
"itemCode": "string",
"itemName": "string",
"itemModel": "string",
"description": "string",
"brandName": "string",
"itemCodeSupplier": "string",
"isPresent": false,
"unitMeasurementCode": "string",
"unitMeasurementName": "string",
"price": 0.0,
"quantity": 0.0,
"discountAmount": 0.0,
"chargeAmount": 0.0,
"subTotal": 0.0,
"priceWithAllowanceCharge": 0.0,
"totalWithAllowanceCharge": 0.0,
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"taxes": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"withholdings": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"isvMandante": {
"name": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string"
}
}],
"totals": {
"amount": 0.0,
"prepaymentAmount": 0.0,
"taxesAmount": 0.0,
"withholdingAmount": 0.0,
"discountsAmount": 0.0,
"chargesAmount": 0.0
},
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"customFields": [{
"key": "string",
"value": "string"
}],
"invoiceConsecutiveWithPrefix": "string"
}
```
{% endtab %}
{% tab title="204 " %}
```
No se encontraron resultados de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="400 " %}
```
No se han enviado los tipos de datos requeridos
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```javascript
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using RestSharp;
using System;
using Newtonsoft.Json;
class Program
{
public static void Main()
{
/**
- Enviar una nota débito en modo producción
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
// Realizar request por metodo POST
var request = new RestRequest("/notes-db", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto nota débito con resolución ejemplo
var isvInvoiceNoteDb = new
{
format = "Estandar",
emailSender = "",
concept = "1",
consecutive = 990000003,
externalNumber = "",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
typeOfOperation = "01",
terms = "",
remark = "",
observation = "",
invoicePrefix = "inv",
invoiceConsecutive = 990004331,
invoiceCufe = "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
invoiceDate = "2020-1-18",
branch = new
{
name = "Sucursal",
address = "KR con CLL",
phone = "000000",
countryCode = "CO",
countryName = "COLOMBIA",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "25178",
cityName = "Chipaque"
},
resolution = new
{
resolutionKey = "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix = "SETT",
resolutionNumber = 18760000001,
resolutionRangeInitial = 990000000,
resolutionRangeFinal = 995000000,
resolutionValidFrom = "2019-01-19",
resolutionValidUntil = "2030-01-19"
},
customer = new
{
companyName = "Customer",
personType = "1",
regimeType = "04",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "email@email.com",
phone = "0000001",
merchantRegistration = "",
responsibleFor = "ZZ",
responsibilities = "R-99-PN",
economicActivities= "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = "",
shippingAddress = "",
shippingCountryName = "",
shippingCountryCode = "",
shippingRegionName = "",
shippingRegionCode = "",
shippingCityName = "",
shippingCityCode = "",
shippingPostalCode = "",
shippingNeighborhood = "",
shippingPhone = "",
shippingContactName = ""
},
invoiceNoteDetails = new[]
{
new
{
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]
{
new
{
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]
{
new
{
name = "Iva",
code = "01",
type = "P",
rate = 19,
amount = 6.46
}
},
withholdings = new[]
{
new
{
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new
{
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
customFields = new[]
{
new KeyValuePair("NombreCampo", "ValorCampo")
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvInvoiceNoteDb), ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mostrar respuesta
Console.WriteLine((int) response.StatusCode);
Console.WriteLine(response.Content);
}
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* - Enviar una nota débito en modo producción
* - Realizar request por metodo POST
*/
fetch("https://isv.aliaddo.net/api/v1/public/documents/notes-db", {
method: 'POST',
body: JSON.stringify({
format: "Estandar",
emailSender: "",
concept: "1",
consecutive: 990000012,
externalNumber: "",
currencyCode: "COP",
currencyRate: 0,
date: "2020-1-23",
dateStart: "2020-1-23",
dateEnd: "2020-1-29",
typeOfOperation: "01",
terms: "",
remark: "",
observation: "",
//sentEmailAt: "",
invoicePrefix: "inv",
invoiceConsecutive: 990004331,
invoiceCufe: "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
invoiceDate: "2020-1-18",
branch: {
name: "Sucursal",
address: "KR con CLL",
phone: "000000",
countryCode: "CO",
countryName: "COLOMBIA",
departamentCode: "25",
departamentName: "Cundinamarca",
cityCode: "25178",
cityName: "Chipaque"
},
resolution: {
resolutionKey: "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix: "SETP",
resolutionNumber: 18760000001,
resolutionRangeInitial: 990000000,
resolutionRangeFinal: 995000000,
resolutionValidFrom: "2019-01-19",
resolutionValidUntil: "2030-01-19"
},
customer: {
companyName: "Customer",
personType: "1",
regimeType: "04",
firstName: "Customer",
lastName: "Customer",
identification: "000000001",
digitCheck: "8",
identificationTypeCode: "13",
email: "email@email.com",
phone: "",
merchantRegistration: "",
responsibleFor: "ZZ",
responsibilities: "R-99-PN",
economicActivities: "2817;3092",
billingAddress: "KR con Calle",
billingCountryName: "Colombia",
billingCountryCode: "CO",
billingRegionName: "Cundinamarca",
billingRegionCode: "25",
billingCityName: "Chipaque",
billingCityCode: "25178",
billingPostalCode: "",
billingNeighborhood: "",
billingPhone: "",
billingContactName: "",
shippingAddress: "",
shippingCountryName: "",
shippingCountryCode: "",
shippingRegionName: "",
shippingRegionCode: "",
shippingCityName: "",
shippingCityCode: "",
shippingPostalCode: "",
shippingNeighborhood: "",
shippingPhone: "",
shippingContactName: ""
},
invoiceNoteDetails: [{
standardType: "",
standardCode: "",
itemCode: "0001",
itemName: "Item",
itemModel: "",
description: "Item prueba",
brandName: "",
itemCodeSupplier: "",
isPresent: false,
unitMeasurementCode: "NIU",
unitMeasurementName: "",
price: 1285.00,
quantity: 2,
discounts: [{
name: "",
type: "V",
rate: 1,
amount: 1
}],
charges: [{
name: "",
type: "V",
rate: 10,
amount: 10
}],
taxes: [{
name: "Iva",
code: "01",
type: "V",
rate: 10,
amount: 10
}],
withholdings: [{
name: "ReteFuente",
code: "06",
type: "P",
rate: 10,
amount: 3.4
}],
isvMandante: {
name: "Mandante",
identification: "000001",
digitCheck: "8",
identificationTypeCode: "13"
}
}],
totals: {
amount: 68,
prepaymentAmount: 0
},
discounts: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
charges: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
customFields: [{
value: "666",
key: "invoiceId"
}]
}),
headers: {
'Content-Type': 'application/json',
'x-api-key": "{{x-api-key}}'
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => res.json())
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el request
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
// Agregar dependencia de GSON para serializar los objetos de Java a JSON
com.google.code.gson
gson
2.8.5
*/
// **** Clase donde se ejecuta el request ****
import com.google.gson.*;
import kong.unirest.*;
/*
* - Enviar una nota débito en modo producción
* - Añada las dependencias de UniRest y GSON a su POM como se muestra en el código de la parte superior
*/
public class Program {
public static void main(String[] args) {
// Crear objeto de nota débito
JsonObject isvInvoiceNoteDb = new JsonObject();
isvInvoiceNoteDb.addProperty("format", "Estandar");
isvInvoiceNoteDb.addProperty("emailSender", "");
isvInvoiceNoteDb.addProperty("concept", "1");
isvInvoiceNoteDb.addProperty("consecutive", 990000005);
isvInvoiceNoteDb.addProperty("externalNumber", "54554");
isvInvoiceNoteDb.addProperty("currencyCode", "COP");
isvInvoiceNoteDb.addProperty("currencyRate", 0);
isvInvoiceNoteDb.addProperty("date", "2020-1-20");
isvInvoiceNoteDb.addProperty("dateStart", "2020-1-20");
isvInvoiceNoteDb.addProperty("dateEnd", "2020-1-25");
isvInvoiceNoteDb.addProperty("typeOfOperation", "01");
isvInvoiceNoteDb.addProperty("terms", "");
isvInvoiceNoteDb.addProperty("remark", "");
isvInvoiceNoteDb.addProperty("observation", "");
isvInvoiceNoteDb.addProperty("invoicePrefix", "inv");
isvInvoiceNoteDb.addProperty("invoiceConsecutive", 990004331);
isvInvoiceNoteDb.addProperty("invoiceCufe", "cufe");
isvInvoiceNoteDb.addProperty("invoiceDate", "2020-1-18");
JsonObject branchObj = new JsonObject();
branchObj.addProperty("name", "");
branchObj.addProperty("address", "");
branchObj.addProperty("phone", "");
branchObj.addProperty("countryCode", "");
branchObj.addProperty("countryName", "");
branchObj.addProperty("departmentCode", "");
branchObj.addProperty("departmentName", "");
branchObj.addProperty("cityCode", "");
branchObj.addProperty("cityName", "");
isvInvoiceNoteDb.add("branch", branchObj);
JsonObject resolutionObj = new JsonObject();
resolutionObj.addProperty("resolutionKey", "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c");
resolutionObj.addProperty("resolutionPrefix", "SETP");
resolutionObj.addProperty("resolutionNumber", 18760000001f); // La 'f' indica tipo float
resolutionObj.addProperty("resolutionRangeInitial", 990000000);
resolutionObj.addProperty("resolutionRangeFinal", 995000000);
resolutionObj.addProperty("resolutionValidFrom", "2019-01-19");
resolutionObj.addProperty("resolutionValidUntil", "2030-01-19");
isvInvoiceNoteDb.add("resolution", resolutionObj);
JsonObject customerObj = new JsonObject();
customerObj.addProperty("companyName", "Customer");
customerObj.addProperty("personType", "1");
customerObj.addProperty("regimeType", "04");
customerObj.addProperty("firstName", "Customer");
customerObj.addProperty("lastName", "Customer");
customerObj.addProperty("identification", "000000001");
customerObj.addProperty("digitCheck", "8");
customerObj.addProperty("identificationTypeCode", "13");
customerObj.addProperty("email", "");
customerObj.addProperty("phone", "0000001");
customerObj.addProperty("merchantRegistration", "");
customerObj.addProperty("responsibleFor", "ZZ");
customerObj.addProperty("responsibilities", "R-99-PN");
customerObj.addProperty("economicActivities", "2817;3092");
customerObj.addProperty("billingAddress", "KR con Calle");
customerObj.addProperty("billingCountryName", "Colombia");
customerObj.addProperty("billingCountryCode", "CO");
customerObj.addProperty("billingRegionName", "Cundinamarca");
customerObj.addProperty("billingRegionCode", "25");
customerObj.addProperty("billingCityName", "Chipaque");
customerObj.addProperty("billingCityCode", "25178");
customerObj.addProperty("billingPostalCode", "");
customerObj.addProperty("billingNeighborhood", "");
customerObj.addProperty("billingPhone", "");
customerObj.addProperty("billingContactName", "");
customerObj.addProperty("shippingAddress", "");
customerObj.addProperty("shippingCountryName", "");
customerObj.addProperty("shippingCountryCode", "");
customerObj.addProperty("shippingRegionName", "");
customerObj.addProperty("shippingRegionCode", "");
customerObj.addProperty("shippingCityName", "");
customerObj.addProperty("shippingCityCode", "");
customerObj.addProperty("shippingPostalCode", "");
customerObj.addProperty("shippingNeighborhood", "");
customerObj.addProperty("shippingPhone", "");
customerObj.addProperty("shippingContactName", "");
isvInvoiceNoteDb.add("customer", customerObj);
JsonArray invoiceNoteDetailsArr = new JsonArray();
JsonObject invoiceNoteDetailsObj = new JsonObject();
invoiceNoteDetailsObj.addProperty("standardType", "");
invoiceNoteDetailsObj.addProperty("standardCode", "");
invoiceNoteDetailsObj.addProperty("itemCode", "0001");
invoiceNoteDetailsObj.addProperty("itemName", "Item");
invoiceNoteDetailsObj.addProperty("itemModel", "");
invoiceNoteDetailsObj.addProperty("description", "Item prueba");
invoiceNoteDetailsObj.addProperty("brandName", "");
invoiceNoteDetailsObj.addProperty("itemCodeSupplier", "");
invoiceNoteDetailsObj.addProperty("isPresent", false);
invoiceNoteDetailsObj.addProperty("unitMeasurementCode", "");
invoiceNoteDetailsObj.addProperty("unitMeasurementName", "");
invoiceNoteDetailsObj.addProperty("price", 25);
invoiceNoteDetailsObj.addProperty("quantity", 2);
invoiceNoteDetailsArr.add(invoiceNoteDetailsObj);
JsonArray discountsArr = new JsonArray();
JsonObject discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "V");
discountsObj.addProperty("rate", 1);
discountsObj.addProperty("amount", 1);
discountsArr.add(discountsObj);
invoiceNoteDetailsObj.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "V");
chargesObj.addProperty("rate", 10);
chargesObj.addProperty("amount", 10);
chargesArr.add(chargesObj);
invoiceNoteDetailsObj.add("charges", chargesArr);
JsonArray taxesArr = new JsonArray();
JsonObject taxesObj = new JsonObject();
taxesObj.addProperty("name", "Iva");
taxesObj.addProperty("code", "01");
taxesObj.addProperty("type", "P");
taxesObj.addProperty("rate", 19);
taxesObj.addProperty("amount", 6.46);
taxesArr.add(taxesObj);
invoiceNoteDetailsObj.add("taxes", taxesArr);
JsonArray withholdingsArr = new JsonArray();
JsonObject withholdingsObj = new JsonObject();
withholdingsObj.addProperty("name", "ReteFuente");
withholdingsObj.addProperty("code", "06");
withholdingsObj.addProperty("type", "P");
withholdingsObj.addProperty("rate", 10);
withholdingsObj.addProperty("amount", 3.4);
withholdingsArr.add(withholdingsObj);
invoiceNoteDetailsObj.add("withholdings", withholdingsArr);
JsonObject isvMandanteObj = new JsonObject();
isvMandanteObj.addProperty("name", "Mandante");
isvMandanteObj.addProperty("identification","0014");
isvMandanteObj.addProperty("digitCheck", "8");
isvMandanteObj.addProperty("identificationTypeCode", "13");
invoiceNoteDetailsObj.add("isvMandante", isvMandanteObj);
isvInvoiceNoteDb.add("invoiceNoteDetails", invoiceNoteDetailsArr);
JsonObject totals = new JsonObject();
totals.addProperty("amount", 68);
totals.addProperty("prepaymentAmount", 0);
isvInvoiceNoteDb.add("totals", totals);
JsonArray isvInvoiceNoteDbDiscountsArr = new JsonArray();
JsonObject isvInvoiceNoteDbDiscountsObj = new JsonObject();
isvInvoiceNoteDbDiscountsObj.addProperty("name", "");
isvInvoiceNoteDbDiscountsObj.addProperty("type", "");
isvInvoiceNoteDbDiscountsObj.addProperty("rate", 0);
isvInvoiceNoteDbDiscountsObj.addProperty("amount", 0);
isvInvoiceNoteDbDiscountsArr.add(isvInvoiceNoteDbDiscountsObj);
isvInvoiceNoteDb.add("discounts", isvInvoiceNoteDbDiscountsArr);
JsonArray isvInvoiceNoteDbChargesArr = new JsonArray();
JsonObject isvInvoiceNoteDbChargesObj = new JsonObject();
isvInvoiceNoteDbChargesObj.addProperty("name", "");
isvInvoiceNoteDbChargesObj.addProperty("type", "");
isvInvoiceNoteDbChargesObj.addProperty("rate", 0);
isvInvoiceNoteDbChargesObj.addProperty("amount", 0);
isvInvoiceNoteDbChargesArr.add(isvInvoiceNoteDbChargesObj);
isvInvoiceNoteDb.add("charges", isvInvoiceNoteDbChargesArr);
JsonArray customFieldsArr = new JsonArray();
JsonObject customFieldsObj = new JsonObject();
customFieldsObj.addProperty("666", "invoiceId");
customFieldsArr.add(customFieldsObj);
isvInvoiceNoteDb.add("customFields", customFieldsArr);
// Realizar request por metodo POST
HttpRequestWithBody request = Unirest.post("https://isv.aliaddo.net/api/v1/public/documents/notes-db");
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.header("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.header("content-type", "application/json");
request.header("cache-control", "no-cache");
request.header("accept", "application/json");
// Añadir el objeto de nota débito
request.body(isvInvoiceNoteDb).asJson()
// Manejar respuesta o error si hay alguno
.ifSuccess(response -> System.out.println("Response: " + "status -> " + response.getStatus() + " Body -> " + response.getBody()))
.ifFailure(response -> {
System.out.println("Oh No! Status " + response.getStatus());
response.getParsingError().ifPresent(e -> {
System.out.println("Parsing Exception: " + e);
System.out.println("Original body: " + e.getOriginalBody());
});
});
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'Estandar',
'emailSender' => '',
'concept' => '1',
'consecutive' => 990000014,
'externalNumber' => '54554',
'currencyCode' => 'COP',
'currencyRate' => 0,
'date' => '2020-1-22',
'dateStart' => '2020-1-22',
'dateEnd' => '2020-1-25',
'typeOfOperation' => '01',
'terms' => '',
'remark' => '',
'observation' => '',
'invoicePrefix' => 'inv',
'invoiceConsecutive' => 990004331,
'invoiceCufe' => 'aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162',
'invoiceDate' => '2020-1-18',
'branch' => array(
'name' => '',
'address' => '',
'phone' => '',
'countryCode' => '',
'countryName' => '',
'departmentCode' => '',
'departmentName' => '',
'cityCode' => '',
'cityName' => ''
),
'resolution' => array(
'resolutionKey' => 'fc8eac422eba16e22ffd8c6f94b3f40a6e38162c',
'resolutionPrefix' => 'SETP',
'resolutionNumber' => 18760000001,
'resolutionRangeInitial' => 990000000,
'resolutionRangeFinal' => 995000000,
'resolutionValidFrom' => '2019-01-19',
'resolutionValidUntil' => '2030-01-19'
),
'customer' => array(
'companyName' => 'Customer',
'personType' => '1',
'regimeType' => '04',
'firstName' => 'Customer',
'lastName' => 'Customer',
'identification' => '000000001',
'digitCheck' => '8',
'identificationTypeCode' => '13',
'email' => 'email@email.com',
'phone' => '0000001',
'merchantRegistration' => '',
'responsibleFor' => 'ZZ',
'responsibilities' => 'R-99-PN',
'economicActivities' => '2817;3092',
'billingAddress' => 'KR con Calle',
'billingCountryName' => 'Colombia',
'billingCountryCode' => 'CO',
'billingRegionName' => 'Cundinamarca',
'billingRegionCode' => '25',
'billingCityName' => 'Chipaque',
'billingCityCode' => '25178',
'billingPostalCode' => '',
'billingNeighborhood' => '',
'billingPhone' => '',
'billingContactName' => '',
'shippingAddress' => '',
'shippingCountryName' => '',
'shippingCountryCode' => '',
'shippingRegionName' => '',
'shippingRegionCode' => '',
'shippingCityName' => '',
'shippingCityCode' => '',
'shippingPostalCode' => '',
'shippingNeighborhood' => '',
'shippingPhone' => '',
'shippingContactName' => ''
),
'invoiceNoteDetails' => array(
array(
'standardType' => '',
'standardCode' => '',
'itemCode' => '0001',
'itemName' => 'Item',
'itemModel' => '',
'description' => 'Item prueba',
'brandName' => '',
'itemCodeSupplier' => '',
'isPresent' => false,
'unitMeasurementCode' => '',
'unitMeasurementName' => '',
'price' => 25,
'quantity' => 2,
'discounts' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 1,
'amount' => 1
)
),
'charges' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 10,
'amount' => 10
)
),
'taxes' => array(
array(
'name' => 'Iva',
'code' => '01',
'type' => 'P',
'rate' => 19,
'amount' => 6.46
)
),
'withholdings' => array(
array(
'name' => 'ReteFuente',
'code' => '06',
'type' => 'P',
'rate' => 10,
'amount' => 3.4,
)
),
'isvMandante' => array(
'name' => 'Mandante',
'identification' => '000001',
'digitCheck' => '8',
'identificationTypeCode' => '13'
)
)
),
'totals' => array(
'amount' => 68,
'prepaymentAmount' => 0
),
'discounts' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'charges' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'customFields' => array(
array(
'value' => '6666',
'key' => 'invoiceId'
)
)
);
// Serializar objeto a JSON
$isvInvoiceNoteDb = json_encode($debitNote);
/**
* - Enviar una nota débito en modo producción
* - Realizar request por metodo POST
*/
curl_setopt_array($curl, array(
CURLOPT_URL => "https://isv.aliaddo.net/api/v1/public/documents/notes-db",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => $isvInvoiceNoteDb,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
// Tipo de requerimiento formato json
"content-type: application/json",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Mostar respuesta o error si hubo alguno
if ($err) {
echo "error -> " . $err;
} else {
echo $response;
}
// Terminar petición
curl_close($curl);
?>
```
{% endtab %}
{% tab title="Python" %}
```python
# Importar la librería "requests"
import requests
# - Enviar una nota débito en modo producción
url = 'https://isv.aliaddo.net/api/v1/public/documents/notes-db'
# Crear objeto de nota débito
isvInvoiceNoteDb = {
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 9900000021,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customemer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": False,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# - Realizar request por metodo POST
request = requests.post(url, json=isvInvoiceNoteDb, headers=headers)
# Mostrar respuesta de la petición
print(request.text)
print(request.status_code)
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
# Requerir gemas "rest-client" y "json"
require 'rest-client'
require 'json'
# - Enviar una nota débito en modo producción
url = "https://isv.aliaddo.net/api/v1/public/documents/notes-db"
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# Crear objeto de nota débito
isvInvoiceNoteDb = {
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 9900000022,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customemer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Crear petición con método POST
begin
request = RestClient.post(url, isvInvoiceNoteDb.to_json, headers)
# Manejar error si hay alguno
rescue RestClient::ExceptionWithResponse => e
puts e.response
end
# Imprimir respuesta
puts request
```
{% endtab %}
{% endtabs %}
# Notas crédito
Consulta rápidamente las secciones
{% content-ref url="/pages/-LrPGPzPeamPEZ8Pzqrg" %}
[Enviar nota crédito](/produccion/notas-credito/enviar-nota-credito)
{% endcontent-ref %}
# Enviar nota crédito
Modo producción
## Enviar nota crédito
`POST` `https://isv.aliaddo.net/api/v1/public/documents/notes-cr`
Enviar una nota crédito en **modo producción** a la DIAN.
#### Path Parameters
| Name | Type | Description |
| ------- | ------ | ----------------- |
| version | string | Versión de la API |
#### Headers
| Name | Type | Description |
| --------- | ------ | ------------------------------------------- |
| x-api-key | string | Token generado previamente para autorizarse |
#### Request Body
| Name | Type | Description |
| ---------------- | ------ | ------------------------- |
| isvInvoiceNoteCr | object | Objeto de la nota crédito |
{% tabs %}
{% tab title="200 Request completado con éxito" %}
```javascript
{
"id": "string",
"mode": "string",
"format": "string",
"emailSender": "string",
"testSetId": "string",
"concept": "string",
"prefix": "string",
"consecutive": 0.0,
"sequence": "string",
"externalNumber": "string",
"currencyCode": "string",
"currencyRate": 0.0,
"date": "2020-01-30T00:00:00",
"dateStart": "2020-01-30T00:00:00",
"dateEnd": "2020-01-31T00:00:00",
"typeOfOperation": "string",
"terms": "string",
"remark": "string",
"observation": "string",
"cufe": "string",
"qr": "string",
"urlPdf": "string",
"urlXmlDocument": "string",
"urlXmlDocumentZip": "string",
"urlXmlApplicationResponse": "string",
"urlXmlAttachedDocument": "string",
"UrlPdfEncoded": "string",
"UrlXmlEncoded": "string",
"dianDeliveryStatus": "string",
"dianState": "string",
"dianStateReason": "string",
"sentEmail": false,
"sentEmailAt": "0001-01-01T00:00:00",
"invoicePrefix": "string",
"invoiceConsecutive": 990005331,
"invoiceCufe": "string",
"invoiceDate": "2020-01-18T00:00:00",
"branch": {
"name": "string",
"address": "string",
"phone": "string",
"countryCode": "string",
"countryName": "string",
"departamentCode": "string",
"departamentName": "string",
"cityCode": "string",
"cityName": "string"
},
"resolution": {
"resolutionKey": "string",
"resolutionPrefix": "string",
"resolutionNumber": 0.0,
"resolutionRangeInitial": 0.0,
"resolutionRangeFinal": 0.0,
"resolutionValidFrom": "2019-01-19T00:00:00",
"resolutionValidUntil": "2030-01-19T00:00:00"
},
"customer": {
"companyName": "string",
"personType": "string",
"regimeType": "string",
"firstName": "string",
"lastName": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string",
"email": "string",
"phone": "string",
"merchantRegistration": "string",
"responsibilities": "string",
"economicActivities": "string",
"billingAddress": "string",
"billingCountryName": "string",
"billingCountryCode": "string",
"billingRegionName": "string",
"billingRegionCode": "string",
"billingCityName": "string",
"billingCityCode": "string",
"billingPostalCode": "string",
"billingNeighborhood": "string",
"billingPhone": "string",
"billingContactName": "string",
"shippingAddress": "string",
"shippingCountryName": "string",
"shippingCountryCode": "string",
"shippingRegionName": "string",
"shippingRegionCode": "string",
"shippingCityName": "string",
"shippingCityCode": "string",
"shippingPostalCode": "string",
"shippingNeighborhood": "string",
"shippingPhone": "string",
"shippingContactName": "string"
},
"invoiceNoteDetails": [{
"standardType": "string",
"standardCode": "string",
"itemCode": "string",
"itemName": "string",
"itemModel": "string",
"description": "string",
"brandName": "string",
"itemCodeSupplier": "string",
"isPresent": false,
"unitMeasurementCode": "string",
"unitMeasurementName": "string",
"price": 0.0,
"quantity": 0.0,
"discountAmount": 0.0,
"chargeAmount": 0.0,
"subTotal": 0.0,
"priceWithAllowanceCharge": 0.0,
"totalWithAllowanceCharge": 0.0,
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"taxes": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"withholdings": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"isvMandante": {
"name": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string"
}
}],
"totals": {
"amount": 0.0,
"prepaymentAmount": 0.0,
"taxesAmount": 0.0,
"withholdingAmount": 0.0,
"discountsAmount": 0.0,
"chargesAmount": 0.0
},
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"customFields": [{
"key": "string",
"value": "string"
}],
"invoiceConsecutiveWithPrefix": "string"
}
```
{% endtab %}
{% tab title="204 " %}
```
No se encontraron resultados de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="400 " %}
```
No se han enviado los tipos de datos requeridos
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using RestSharp;
using System;
using Newtonsoft.Json;
class Program
{
public static void Main()
{
/**
- Enviar una nota crédito en modo producción
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
// Realizar request por metodo POST
var request = new RestRequest("/notes-cr", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto nota crédito con resolución ejemplo
var isvInvoiceNoteCr = new
{
format = "Estandar",
emailSender = "",
concept = "1",
consecutive = 6,
externalNumber = "",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
typeOfOperation = "01",
terms = "",
remark = "",
observation = "",
invoicePrefix = "inv",
invoiceConsecutive = 990004331,
invoiceCufe = "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
invoiceDate = "2020-1-18",
branch = new
{
name = "Sucursal",
address = "KR con CLL",
phone = "000000",
countryCode = "CO",
countryName = "COLOMBIA",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "25178",
cityName = "Chipaque"
},
resolution = new
{
resolutionKey = "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix = "SETT",
resolutionNumber = 18760000001,
resolutionRangeInitial = 990000000,
resolutionRangeFinal = 995000000,
resolutionValidFrom = "2019-01-19",
resolutionValidUntil = "2030-01-19"
},
customer = new
{
companyName = "Customer",
personType = "1",
regimeType = "04",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "email@email.com",
phone = "0000001",
merchantRegistration = "",
responsibleFor = "ZZ",
responsibilities = "R-99-PN",
economicActivities= "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = "",
shippingAddress = "",
shippingCountryName = "",
shippingCountryCode = "",
shippingRegionName = "",
shippingRegionCode = "",
shippingCityName = "",
shippingCityCode = "",
shippingPostalCode = "",
shippingNeighborhood = "",
shippingPhone = "",
shippingContactName = ""
},
invoiceNoteDetails = new[]
{
new
{
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]
{
new
{
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]
{
new
{
name = "Iva",
code = "01",
type = "P",
rate = 19,
amount = 6.46
}
},
withholdings = new[]
{
new
{
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new
{
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
customFields = new[]
{
new KeyValuePair("NombreCampo", "ValorCampo")
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvInvoiceNoteCr), ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mostrar respuesta
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(response.Content);
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* - Enviar una nota crédito en modo producción
* - Realizar request por metodo POST
*/
fetch("https://isv.aliaddo.net/api/v1/public/documents/notes-cr", {
method: 'POST',
body: JSON.stringify({
format: "Estandar",
emailSender: "",
concept: "1",
consecutive: 5,
externalNumber: "",
currencyCode: "COP",
currencyRate: 0,
date: "2020-1-18",
dateStart: "2020-1-18",
dateEnd: "2020-1-20",
typeOfOperation: "01",
terms: "",
remark: "",
observation: "",
invoicePrefix: "inv",
invoiceConsecutive: 990004331,
invoiceCufe: "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
invoiceDate: "2020-1-18",
branch: {
name: "Sucursal",
address: "KR con CLL",
phone: "000000",
countryCode: "CO",
countryName: "COLOMBIA",
departamentCode: "25",
departamentName: "Cundinamarca",
cityCode: "25178",
cityName: "Chipaque"
},
resolution: {
resolutionKey: "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix: "SETP",
resolutionNumber: 18760000001,
resolutionRangeInitial: 990000000,
resolutionRangeFinal: 995000000,
resolutionValidFrom: "2019-01-19",
resolutionValidUntil: "2030-01-19"
},
customer: {
companyName: "Customer",
personType: "1",
regimeType: "04",
firstName: "Customer",
lastName: "Customer",
identification: "000000001",
digitCheck: "8",
identificationTypeCode: "13",
email: "email@email.com",
phone: "",
merchantRegistration: "",
responsibleFor: "ZZ",
responsibilities: "R-99-PN",
economicActivities: "2817;3092",
billingAddress: "KR con Calle",
billingCountryName: "Colombia",
billingCountryCode: "CO",
billingRegionName: "Cundinamarca",
billingRegionCode: "25",
billingCityName: "Chipaque",
billingCityCode: "25178",
billingPostalCode: "",
billingNeighborhood: "",
billingPhone: "",
billingContactName: "",
shippingAddress: "",
shippingCountryName: "",
shippingCountryCode: "",
shippingRegionName: "",
shippingRegionCode: "",
shippingCityName: "",
shippingCityCode: "",
shippingPostalCode: "",
shippingNeighborhood: "",
shippingPhone: "",
shippingContactName: ""
},
invoiceNoteDetails: [{
standardType: "",
standardCode: "",
itemCode: "0001",
itemName: "Item",
itemModel: "",
description: "Item prueba",
brandName: "",
itemCodeSupplier: "",
isPresent: false,
unitMeasurementCode: "NIU",
unitMeasurementName: "",
price: 1285.00,
quantity: 2,
discounts: [{
name: "",
type: "V",
rate: 1,
amount: 1
}],
charges: [{
name: "",
type: "V",
rate: 10,
amount: 10
}],
taxes: [{
name: "Iva",
code: "01",
type: "V",
rate: 10,
amount: 10
}],
withholdings: [{
name: "ReteFuente",
code: "06",
type: "P",
rate: 10,
amount: 3.4
}],
isvMandante: {
name: "Mandante",
identification: "000001",
digitCheck: "8",
identificationTypeCode: "13"
}
}],
totals: {
amount: 68,
prepaymentAmount: 0
},
discounts: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
charges: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
customFields: [{
value: "666",
key: "invoiceId"
}]
}),
headers: {
"Content-Type": "application/json",
"x-api-key": "{{x-api-key}}"
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => res.json())
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el request
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
// Agregar dependencia de GSON para serializar los objetos de Java a JSON
com.google.code.gson
gson
2.8.5
*/
// **** Clase donde se ejecuta el request ****
import com.google.gson.*;
import kong.unirest.*;
/*
* - Enviar una nota crédito en modo producción
* - Añada las dependencias de UniRest y GSON a su POM como se muestra en el código de la parte superior
*/
public class Program {
public static void main(String[] args) {
JsonObject isvInvoiceNoteCr = new JsonObject();
isvInvoiceNoteCr.addProperty("format", "Estandar");
isvInvoiceNoteCr.addProperty("emailSender", "");
isvInvoiceNoteCr.addProperty("concept", "1");
isvInvoiceNoteCr.addProperty("consecutive", 8);
isvInvoiceNoteCr.addProperty("externalNumber", "54554");
isvInvoiceNoteCr.addProperty("currencyCode", "COP");
isvInvoiceNoteCr.addProperty("currencyRate", 0);
isvInvoiceNoteCr.addProperty("date", "2020-1-20");
isvInvoiceNoteCr.addProperty("dateStart", "2020-1-20");
isvInvoiceNoteCr.addProperty("dateEnd", "2020-1-25");
isvInvoiceNoteCr.addProperty("typeOfOperation", "01");
isvInvoiceNoteCr.addProperty("terms", "");
isvInvoiceNoteCr.addProperty("remark", "");
isvInvoiceNoteCr.addProperty("observation", "");
isvInvoiceNoteCr.addProperty("invoicePrefix", "inv");
isvInvoiceNoteCr.addProperty("invoiceConsecutive", 990004331);
isvInvoiceNoteCr.addProperty("invoiceCufe", "cufe");
isvInvoiceNoteCr.addProperty("invoiceDate", "2020-1-18");
JsonObject branchObj = new JsonObject();
branchObj.addProperty("name", "");
branchObj.addProperty("address", "");
branchObj.addProperty("phone", "");
branchObj.addProperty("countryCode", "");
branchObj.addProperty("countryName", "");
branchObj.addProperty("departmentCode", "");
branchObj.addProperty("departmentName", "");
branchObj.addProperty("cityCode", "");
branchObj.addProperty("cityName", "");
isvInvoiceNoteCr.add("branch", branchObj);
JsonObject resolutionObj = new JsonObject();
resolutionObj.addProperty("resolutionKey", "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c");
resolutionObj.addProperty("resolutionPrefix", "SETP");
resolutionObj.addProperty("resolutionNumber", 18760000001f); // La 'f' indica tipo float
resolutionObj.addProperty("resolutionRangeInitial", 990000000);
resolutionObj.addProperty("resolutionRangeFinal", 995000000);
resolutionObj.addProperty("resolutionValidFrom", "2019-01-19");
resolutionObj.addProperty("resolutionValidUntil", "2030-01-19");
isvInvoiceNoteCr.add("resolution", resolutionObj);
JsonObject customerObj = new JsonObject();
customerObj.addProperty("companyName", "Customer");
customerObj.addProperty("personType", "1");
customerObj.addProperty("regimeType", "04");
customerObj.addProperty("firstName", "Customer");
customerObj.addProperty("lastName", "Customer");
customerObj.addProperty("identification", "000000001");
customerObj.addProperty("digitCheck", "8");
customerObj.addProperty("identificationTypeCode", "13");
customerObj.addProperty("email", "");
customerObj.addProperty("phone", "0000001");
customerObj.addProperty("merchantRegistration", "");
customerObj.addProperty("responsibleFor", "ZZ");
customerObj.addProperty("responsibilities", "R-99-PN");
customerObj.addProperty("economicActivities", "2817;3092");
customerObj.addProperty("billingAddress", "KR con Calle");
customerObj.addProperty("billingCountryName", "Colombia");
customerObj.addProperty("billingCountryCode", "CO");
customerObj.addProperty("billingRegionName", "Cundinamarca");
customerObj.addProperty("billingRegionCode", "25");
customerObj.addProperty("billingCityName", "Chipaque");
customerObj.addProperty("billingCityCode", "25178");
customerObj.addProperty("billingPostalCode", "");
customerObj.addProperty("billingNeighborhood", "");
customerObj.addProperty("billingPhone", "");
customerObj.addProperty("billingContactName", "");
customerObj.addProperty("shippingAddress", "");
customerObj.addProperty("shippingCountryName", "");
customerObj.addProperty("shippingCountryCode", "");
customerObj.addProperty("shippingRegionName", "");
customerObj.addProperty("shippingRegionCode", "");
customerObj.addProperty("shippingCityName", "");
customerObj.addProperty("shippingCityCode", "");
customerObj.addProperty("shippingPostalCode", "");
customerObj.addProperty("shippingNeighborhood", "");
customerObj.addProperty("shippingPhone", "");
customerObj.addProperty("shippingContactName", "");
isvInvoiceNoteCr.add("customer", customerObj);
JsonArray invoiceNoteDetailsArr = new JsonArray();
JsonObject invoiceNoteDetailsObj = new JsonObject();
invoiceNoteDetailsObj.addProperty("standardType", "");
invoiceNoteDetailsObj.addProperty("standardCode", "");
invoiceNoteDetailsObj.addProperty("itemCode", "0001");
invoiceNoteDetailsObj.addProperty("itemName", "Item");
invoiceNoteDetailsObj.addProperty("itemModel", "");
invoiceNoteDetailsObj.addProperty("description", "Item prueba");
invoiceNoteDetailsObj.addProperty("brandName", "");
invoiceNoteDetailsObj.addProperty("itemCodeSupplier", "");
invoiceNoteDetailsObj.addProperty("isPresent", false);
invoiceNoteDetailsObj.addProperty("unitMeasurementCode", "");
invoiceNoteDetailsObj.addProperty("unitMeasurementName", "");
invoiceNoteDetailsObj.addProperty("price", 25);
invoiceNoteDetailsObj.addProperty("quantity", 2);
invoiceNoteDetailsArr.add(invoiceNoteDetailsObj);
JsonArray discountsArr = new JsonArray();
JsonObject discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "V");
discountsObj.addProperty("rate", 1);
discountsObj.addProperty("amount", 1);
discountsArr.add(discountsObj);
invoiceNoteDetailsObj.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "V");
chargesObj.addProperty("rate", 10);
chargesObj.addProperty("amount", 10);
chargesArr.add(chargesObj);
invoiceNoteDetailsObj.add("charges", chargesArr);
JsonArray taxesArr = new JsonArray();
JsonObject taxesObj = new JsonObject();
taxesObj.addProperty("name", "Iva");
taxesObj.addProperty("code", "01");
taxesObj.addProperty("type", "P");
taxesObj.addProperty("rate", 19);
taxesObj.addProperty("amount", 6.46);
taxesArr.add(taxesObj);
invoiceNoteDetailsObj.add("taxes", taxesArr);
JsonArray withholdingsArr = new JsonArray();
JsonObject withholdingsObj = new JsonObject();
withholdingsObj.addProperty("name", "ReteFuente");
withholdingsObj.addProperty("code", "06");
withholdingsObj.addProperty("type", "P");
withholdingsObj.addProperty("rate", 10);
withholdingsObj.addProperty("amount", 3.4);
withholdingsArr.add(withholdingsObj);
invoiceNoteDetailsObj.add("withholdings", withholdingsArr);
JsonObject isvMandanteObj = new JsonObject();
isvMandanteObj.addProperty("name", "Mandante");
isvMandanteObj.addProperty("identification", "0014");
isvMandanteObj.addProperty("digitCheck", "8");
isvMandanteObj.addProperty("identificationTypeCode", "13");
invoiceNoteDetailsObj.add("isvMandante", isvMandanteObj);
isvInvoiceNoteCr.add("invoiceNoteDetails", invoiceNoteDetailsArr);
JsonObject totals = new JsonObject();
totals.addProperty("amount", 68);
totals.addProperty("amount", 68);
totals.addProperty("prepaymentAmount", 0);
isvInvoiceNoteCr.add("totals", totals);
JsonArray isvInvoiceNoteDbDiscountsArr = new JsonArray();
JsonObject isvInvoiceNoteDbDiscountsObj = new JsonObject();
isvInvoiceNoteDbDiscountsObj.addProperty("type", "");
isvInvoiceNoteDbDiscountsObj.addProperty("rate", 0);
isvInvoiceNoteDbDiscountsObj.addProperty("amount", 0);
isvInvoiceNoteDbDiscountsArr.add(isvInvoiceNoteDbDiscountsObj);
isvInvoiceNoteCr.add("discounts", isvInvoiceNoteDbDiscountsArr);
JsonArray isvInvoiceNoteDbChargesArr = new JsonArray();
JsonObject isvInvoiceNoteDbChargesObj = new JsonObject();
isvInvoiceNoteDbChargesObj.addProperty("type", "");
isvInvoiceNoteDbChargesObj.addProperty("rate", 0);
isvInvoiceNoteDbChargesObj.addProperty("amount", 0);
isvInvoiceNoteDbChargesArr.add(isvInvoiceNoteDbChargesObj);
isvInvoiceNoteCr.add("charges", isvInvoiceNoteDbChargesArr);
JsonArray customFieldsArr = new JsonArray();
JsonObject customFieldsObj = new JsonObject();
customFieldsObj.addProperty("666", "invoiceId");
customFieldsArr.add(customFieldsObj);
isvInvoiceNoteCr.add("customFields", customFieldsArr);
// Realizar request por metodo POST
HttpRequestWithBody request = Unirest.post("https://isv.aliaddo.net/api/v1/public/documents/notes-cr");
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.header("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.header("content-type", "application/json");
request.header("cache-control", "no-cache");
request.header("accept", "application/json");
// Añadir el objeto de nota crédito
request.body(isvInvoiceNoteCr).asJson()
// Manejar respuesta o error si hay alguno
.ifSuccess(response -> System.out.println("Response: " + "status -> " + response.getStatus() + " Body -> " + response.getBody()))
.ifFailure(response -> {
System.out.println("Oh No! Status " + response.getStatus());
response.getParsingError().ifPresent(e -> {
System.out.println("Parsing Exception: " + e);
System.out.println("Original body: " + e.getOriginalBody());
});
});
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'Estandar',
'emailSender' => '',
'concept' => '1',
'consecutive' => 8,
'externalNumber' => '54554',
'currencyCode' => 'COP',
'currencyRate' => 0,
'date' => '2020-1-22',
'dateStart' => '2020-1-22',
'dateEnd' => '2020-1-25',
'typeOfOperation' => '01',
'terms' => '',
'remark' => '',
'observation' => '',
'invoicePrefix' => 'inv',
'invoiceConsecutive' => 990004331,
'invoiceCufe' => 'aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162',
'invoiceDate' => '2020-1-18',
'branch' => array(
'name' => '',
'address' => '',
'phone' => '',
'countryCode' => '',
'countryName' => '',
'departmentCode' => '',
'departmentName' => '',
'cityCode' => '',
'cityName' => ''
),
'resolution' => array(
'resolutionKey' => 'fc8eac422eba16e22ffd8c6f94b3f40a6e38162c',
'resolutionPrefix' => 'SETP',
'resolutionNumber' => 18760000001,
'resolutionRangeInitial' => 990000000,
'resolutionRangeFinal' => 995000000,
'resolutionValidFrom' => '2019-01-19',
'resolutionValidUntil' => '2030-01-19'
),
'customer' => array(
'companyName' => 'Customer',
'personType' => '1',
'regimeType' => '04',
'firstName' => 'Customer',
'lastName' => 'Customer',
'identification' => '000000001',
'digitCheck' => '8',
'identificationTypeCode' => '13',
'email' => 'email@email.com',
'phone' => '0000001',
'merchantRegistration' => '',
'responsibleFor' => "ZZ",
'responsibilities' => 'R-99-PN',
'economicActivities' => '2817;3092',
'billingAddress' => 'KR con Calle',
'billingCountryName' => 'Colombia',
'billingCountryCode' => 'CO',
'billingRegionName' => 'Cundinamarca',
'billingRegionCode' => '25',
'billingCityName' => 'Chipaque',
'billingCityCode' => '25178',
'billingPostalCode' => '',
'billingNeighborhood' => '',
'billingPhone' => '',
'billingContactName' => '',
'shippingAddress' => '',
'shippingCountryName' => '',
'shippingCountryCode' => '',
'shippingRegionName' => '',
'shippingRegionCode' => '',
'shippingCityName' => '',
'shippingCityCode' => '',
'shippingPostalCode' => '',
'shippingNeighborhood' => '',
'shippingPhone' => '',
'shippingContactName' => ''
),
'invoiceNoteDetails' => array(
array(
'standardType' => '',
'standardCode' => '',
'itemCode' => '0001',
'itemName' => 'Item',
'itemModel' => '',
'description' => 'Item prueba',
'brandName' => '',
'itemCodeSupplier' => '',
'isPresent' => false,
'unitMeasurementCode' => '',
'unitMeasurementName' => '',
'price' => 25,
'quantity' => 2,
'discounts' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 1,
'amount' => 1
)
),
'charges' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 10,
'amount' => 10
)
),
'taxes' => array(
array(
'name' => 'Iva',
'code' => '01',
'type' => 'P',
'rate' => 19,
'amount' => 6.46
)
),
'withholdings' => array(
array(
'name' => 'ReteFuente',
'code' => '06',
'type' => 'P',
'rate' => 10,
'amount' => 3.4,
)
),
'isvMandante' => array(
'name' => 'Mandante',
'identification' => '000001',
'digitCheck' => '8',
'identificationTypeCode' => '13'
)
)
),
'totals' => array(
'amount' => 68,
'prepaymentAmount' => 0
),
'discounts' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'charges' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'customFields' => array(
array(
'value' => '6666',
'key' => 'invoiceId'
)
)
);
// Serializar objeto a JSON
$isvInvoiceNoteCr = json_encode($creditNote );
/**
* - Enviar una nota crédito en modo producción
* - Realizar request por metodo POST
*/
curl_setopt_array($curl, array
CURLOPT_URL => "https://isv.aliaddo.net/api/v1/public/documents/notes-cr",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => $isvInvoiceNoteCr,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
// Tipo de requerimiento formato json
"content-type: application/json",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Mostar respuesta o error si hubo alguno
if ($err) {
echo "cURL Error #" .$err;
} else {
echo $response;
}
// Terminar petición
curl_close($curl);
?>
```
{% endtab %}
{% tab title="Python" %}
```python
# Importar la librería "requests"
import requests
# - Enviar una nota crédito en modo producción
url = 'https://isv.aliaddo.net/api/v1/public/documents/notes-cr'
# Crear objeto de nota crédito
isvInvoiceNoteCr = {
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 9,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": False,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# - Realizar request por metodo POST
request = requests.post(url, json=isvInvoiceNoteCr, headers=headers)
# Mostrar respuesta de la petición
print(request.text)
print(request.status_code)
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
# Requerir gemas "rest-client" y "json"
require 'rest-client'
require 'json'
# - Enviar una nota débito en modo producción
url = "https://isv.aliaddo.net/api/v1/public/documents/notes-cr"
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# Crear objeto de nota crédito
isvInvoiceNoteCr = {
"format": "Estandar",
"emailSender": "",
"concept": "1",
"consecutive": 10,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"typeOfOperation": "01",
"terms": "",
"remark": "",
"observation": "",
"invoicePrefix": "inv",
"invoiceConsecutive": 990004331,
"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"invoiceDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"customer": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"invoiceNoteDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"customFields": [
{
"value": "666",
"key": "invoiceId"
}
]
}
# Crear petición con método POST
begin
request = RestClient.post(url, isvInvoiceNoteCr.to_json, headers)
# Manejar error si hay alguno
rescue RestClient::ExceptionWithResponse => e
puts e.response
end
# Imprimir respuesta
puts request
```
{% endtab %}
{% endtabs %}
# Documento soporte
Consulta rápidamente a las secciones
{% content-ref url="/pages/-LqDTU\_Cq4mLIF-x97\_i" %}
[Enviar factura](/produccion/facturas/enviar-factura-a-dian)
{% endcontent-ref %}
# Enviar documento soporte
Modo producción
## Enviar documento soporte
`POST` `https://isv.aliaddo.net/api/v1/public/documents/support`
Enviar documento soporte a la DIAN en **modo producción**.
#### Path Parameters
| Name | Type | Description |
| ------- | ------ | ----------------- |
| version | string | Versión de la API |
#### Headers
| Name | Type | Description |
| --------- | ------ | -------------------------------------------- |
| x-api-key | string | Token generado previamente para autenticarse |
#### Request Body
| Name | Type | Description |
| ------------------ | ------ | -------------------- |
| isvSupportDocument | string | Objeto del documento |
{% tabs %}
{% tab title="200 Request completado con éxito" %}
```javascript
{
"id": "string",
"cuds": "string",
"qr": "string",
"urlPdf": "string",
"urlPdf": "string",
"dianState": "string", // Procesando, Aprobada o Rechazada
"dianStateDate": "0001-01-01T00:00:00"",
"dianStateReason": "string",
"issueDate": "0001-01-01T00:00:00"
}
```
{% endtab %}
{% tab title="204 " %}
```
No se encontraron resultados de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="400 " %}
```javascript
No se han enviado los tipos de datos requeridos
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using System;
using Newtonsoft.Json;
using RestSharp;
public class Program
{
public static void Main()
{
/**
- Enviar documento soporte a la DIAN, en modo producción
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
// Realizar request por metodo POST
var request = new RestRequest("/support", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto documento con resolución ejemplo
var isvDocument = new
{
code = "01",
format = "Estandar",
emailSender = "email@example.com",
consecutive = 990004332,
externalNumber = "54554",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateDue = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
typeOfOperation = "10",
incoterms = "",
terms = "",
remark = "",
observation = "",
termDay = 0,
paymentMeanCode = "48",
branch = new {
name = "branch",
address = "Cl6 Cra 66",
phone = "7649813",
countryCode = "CO",
countryName = "Colombia",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "11001",
cityname = "Bogotá, D.c."
},
resolution = new
{
resolutionKey = "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix = "SETT",
resolutionNumber = 18760000001,
resolutionRangeInitial = 990000000,
resolutionRangeFinal = 995000000,
resolutionValidFrom = "2019-01-19",
resolutionValidUntil = "2030-01-19"
},
supplier = new
{
companyName = "Customer",
personType = "1",
regimeType = "04",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "",
phone = "0000001",
merchantRegistration = "",
responsibleFor: "ZZ",
responsibilities = "R-99-PN",
economicActivities = "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = "",
shippingAddress = "",
shippingCountryName = "",
shippingCountryCode = "",
shippingRegionName = "",
shippingRegionCode = "",
shippingCityName = "",
shippingCityCode = "",
shippingPostalCode = "",
shippingNeighborhood = "",
shippingPhone = "",
shippingContactName = ""
},
supportDocumentDetails = new[]{
new {
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
isRemmitance: false,
remmitanceNumber: "",
remmitanceConsecutive: "",
remmitanceValue: 0,
remmitanceQuantityValue: 0,
remmitanceMeasurementUnit: "",
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]{
new {
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]{
new {
name = "",
code = "01",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]{
new {
name = "Iva",
code = "01",
type = "P",
rate = 20,
amount = 6.46
}
},
withholdings = new[]{
new {
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "000001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new {
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new {
name = "",
type = "V",
rate = 10,
amount = 10
}
},
customFields = new[]
{
new KeyValuePair("NombreCampo", "ValorCampo")
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvDocument), ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mostrar respuesta
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(response.Content);
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* - Enviar un documento soporte a la DIAN, en modo producción
* - Realizar request por metodo POST
*/
fetch('https://isv.aliaddo.net/api/v1/public/documents/support', {
method: 'POST',
// Crear objeto de documento soporte con resolución de ejemplo
body: JSON.stringify({
"code": "01",
"format": "Estandar",
"emailSender": "",
"consecutive": "990004322",
"externalNumber": "",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-23",
"dateDue": "2020-1-29",
"dateStart": "2020-1-23",
"dateEnd": "2020-1-29",
"typeOfOperation": "10",
"incoterms": "",
"deliveryTerms": "",
"terms": "",
"remark": "",
"observation": "",
"termDay": 0,
"paymentMeanCode": "48",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departamentCode": "",
"departamentName": "",
"cityCode": "",
"cityName": ""
},
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETT",
"resolutionNumber": "18760000001",
"resolutionRangeInitial": "990000000",
"resolutionRangeFinal": "995000000",
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
},
"supplier": {
"companyName": "Customer",
"personType": "1",
"regimeType": "04",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "email@email.com",
"phone": "",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContactName": "",
"shippingAddress": "",
"shippingCountryName": "",
"shippingCountryCode": "",
"shippingRegionName": "",
"shippingRegionCode": "",
"shippingCityName": "",
"shippingCityCode": "",
"shippingPostalCode": "",
"shippingNeighborhood": "",
"shippingPhone": "",
"shippingContactName": ""
},
"supportDocumentDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"isRemmitance": false,
"remmitanceNumber": "",
"remmitanceConsecutive": "",
"remmitanceValue": 0,
"remmitanceQuantityValue": 0,
"remmitanceMeasurementUnit": "",
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": "1285.00",
"quantity": "2",
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "V",
"rate": 10,
"amount": 10
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "Mandante",
"identification": "000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"prepaymentAmount": 68,
"amount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}
],
"customFields": [{
"value": "666",
"key": "personalizado"
}]
}),
// Añadir cabeceras a la petición
headers: {
'Content-Type': 'application/json',
'x-api-key': '{{x-api-key}}'
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => res.json())
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el request
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
// Agregar dependencia de GSON para serializar los objetos de Java a JSON
com.google.code.gson
gson
2.8.5
*/
// **** Clase donde se ejecuta el request ****
// Agregue las dependencias de UniRest a su POM como se indica en el código superior
import com.google.gson.*;
import kong.unirest.*;
/*
* - Enviar una factura a la DIAN, en modo producción
* - Añada las dependencias de UniRest y GSON a su POM como se muestra en el código de la parte superior
*/
public class Program {
public static void main(String[] args) {
// Crear objeto factura con resolución ejemplo
JsonObject isvDocument = new JsonObject();
isvDocument.addProperty("code", "01");
isvDocument.addProperty("format", "Estandar");
isvDocument.addProperty("emailSender", "");
isvDocument.addProperty("consecutive", 990004336);
isvDocument.addProperty("externalNumber", "54554");
isvDocument.addProperty("currencyCode", "COP");
isvDocument.addProperty("currencyRate", 0);
isvDocument.addProperty("date", "2020-1-20");
isvDocument.addProperty("dateDue", "2020-1-24");
isvDocument.addProperty("dateStart", "2020-1-20");
isvDocument.addProperty("dateEnd", "2020-1-24");
isvDocument.addProperty("typeOfOperation", "10");
isvDocument.addProperty("incoterms", "");
isvDocument.addProperty("terms", "");
isvDocument.addProperty("remark", "");
isvDocument.addProperty("observation", "");
isvDocument.addProperty("termDay", 0);
isvDocument.addProperty("paymentCode", 48);
JsonObject branchObj = new JsonObject();
branchObj.addProperty("name", "");
branchObj.addProperty("address", "");
branchObj.addProperty("phone", "");
branchObj.addProperty("countryCode", "");
branchObj.addProperty("countryName", "");
branchObj.addProperty("departmentCode", "");
branchObj.addProperty("departmentName", "");
branchObj.addProperty("cityCode", "");
branchObj.addProperty("cityName", "");
isvDocument.add("branch", branchObj);
JsonObject resolutionObj = new JsonObject();
resolutionObj.addProperty("resolutionKey", "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c");
resolutionObj.addProperty("resolutionPrefix", "SETT");
resolutionObj.addProperty("resolutionNumber", 18760000001f); // La f indica tipo float
resolutionObj.addProperty("resolutionRangeInitial", 990000000);
resolutionObj.addProperty("resolutionRangeFinal", 995000000);
resolutionObj.addProperty("resolutionValidFrom", "2019-01-19");
resolutionObj.addProperty("resolutionValidUntil", "2030-01-19");
isvDocument.add("resolution", resolutionObj);
JsonObject supplierObj = new JsonObject();
supplierObj.addProperty("companyName", "Customer");
supplierObj.addProperty("personType", "1");
supplierObj.addProperty("regimeType", "04");
supplierObj.addProperty("firstName", "Customer");
supplierObj.addProperty("lastName", "Customer");
supplierObj.addProperty("identification", "000000001");
supplierObj.addProperty("digitCheck", "8");
supplierObj.addProperty("identificationTypeCode", "13");
supplierObj.addProperty("email", "");
supplierObj.addProperty("phone", "0000001");
supplierObj.addProperty("merchantRegistration", "");
supplierObj.addProperty("responsibleFor", "ZZ");
supplierObj.addProperty("responsibilities", "R-99-PN");
supplierObj.addProperty("economicActivities", "2817;3092");
supplierObj.addProperty("billingAddress", "KR con Calle");
supplierObj.addProperty("billingCountryName", "Colombia");
supplierObj.addProperty("billingCountryCode", "CO");
supplierObj.addProperty("billingRegionName", "Cundinamarca");
supplierObj.addProperty("billingRegionCode", "25");
supplierObj.addProperty("billingCityName", "Chipaque");
supplierObj.addProperty("billingCityCode", "25178");
supplierObj.addProperty("billingPostalCode", "");
supplierObj.addProperty("billingNeighborhood", "");
supplierObj.addProperty("billingPhone", "");
supplierObj.addProperty("billingContactName", "");
supplierObj.addProperty("shippingAddress", "");
supplierObj.addProperty("shippingCountryName", "");
supplierObj.addProperty("shippingCountryCode", "");
supplierObj.addProperty("shippingRegionName", "");
supplierObj.addProperty("shippingRegionCode", "");
supplierObj.addProperty("shippingCityName", "");
supplierObj.addProperty("shippingCityCode", "");
supplierObj.addProperty("shippingPostalCode", "");
supplierObj.addProperty("shippingNeighborhood", "");
supplierObj.addProperty("shippingPhone", "");
supplierObj.addProperty("shippingContactName", "");
isvDocument.add("supplier", supplierObj);
JsonArray documentDetailsArr = new JsonArray();
JsonObject documentDetailsObj = new JsonObject();
documentDetailsObj.addProperty("standardType", "");
documentDetailsObj.addProperty("standardCode", "");
documentDetailsObj.addProperty("itemCode", "0001");
documentDetailsObj.addProperty("itemName", "Item");
documentDetailsObj.addProperty("itemModel", "");
documentDetailsObj.addProperty("description", "Item prueba");
documentDetailsObj.addProperty("brandName", "");
documentDetailsObj.addProperty("itemCodeSupplier", "");
documentDetailsObj.addProperty("isPresent", false);
documentDetailsObj.addProperty("isRemmitance", false);
documentDetailsObj.addProperty("remmitanceNumber", "");
documentDetailsObj.addProperty("remmitanceConsecutive", "");
documentDetailsObj.addProperty("remmitanceValue", 0);
documentDetailsObj.addProperty("remmitanceQuantityValue", 0);
documentDetailsObj.addProperty("remmitanceMeasurementUnit", "");
documentDetailsObj.addProperty("unitMeasurementCode", "");
documentDetailsObj.addProperty("unitMeasurementName", "");
documentDetailsObj.addProperty("price", 25);
documentDetailsObj.addProperty("quantity", 2);
documentDetailsObj.add(documentDetailsObj );
JsonArray discountsArr = new JsonArray();
JsonObject discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "V");
discountsObj.addProperty("rate", 1);
discountsObj.addProperty("amount", 1);
discountsArr.add(discountsObj);
documentDetailsObj.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "V");
chargesObj.addProperty("rate", 10);
chargesObj.addProperty("amount", 10);
chargesArr.add(chargesObj);
documentDetailsObj.add("charges", chargesArr);
JsonArray taxesArr = new JsonArray();
JsonObject taxesObj = new JsonObject();
taxesObj.addProperty("name", "Iva");
taxesObj.addProperty("code", "01");
taxesObj.addProperty("type", "P");
taxesObj.addProperty("rate", 19);
taxesObj.addProperty("amount", 6.46);
taxesArr.add(taxesObj);
documentDetailsObj.add("taxes", taxesArr);
JsonArray withholdingsArr = new JsonArray();
JsonObject withholdingsObj = new JsonObject();
withholdingsObj.addProperty("name", "ReteFuente");
withholdingsObj.addProperty("code", "06");
withholdingsObj.addProperty("type", "P");
withholdingsObj.addProperty("rate", 10);
withholdingsObj.addProperty("amount", 3.4);
withholdingsArr.add(withholdingsObj);
documentDetailsObj.add("withholdings", withholdingsArr);
JsonObject isvMandanteObj = new JsonObject();
isvMandanteObj.addProperty("name", "Mandante");
isvMandanteObj.addProperty("identification", "00001");
isvMandanteObj.addProperty("digitCheck", "8");
isvMandanteObj.addProperty("identificationTypeCode", "13");
documentDetailsObj.add("isvMandante", isvMandanteObj);
isvDocument.add("documentDetails", documentDetailsArr);
JsonObject totals = new JsonObject();
totals.addProperty("amount", 68);
totals.addProperty("prepaymentAmount", 0);
isvDocument.add("totals", totals);
JsonArray documentDiscountsArr = new JsonArray();
JsonObject documentDiscountsObj = new JsonObject();
documentDiscountsObj.addProperty("name", "");
documentDiscountsObj.addProperty("type", "");
documentDiscountsObj.addProperty("rate", 0);
documentDiscountsObj.addProperty("amount", 0);
invoiceDiscountsArr.add(invoiceDiscountsObj);
isvInvoice.add("discounts", invoiceDiscountsArr);
JsonArray documentChargesArr = new JsonArray();
JsonObject documentChargesObj = new JsonObject();
documentChargesObj.addProperty("name", "");
documentChargesObj.addProperty("type", "");
documentChargesObj.addProperty("rate", 0);
documentChargesObj.addProperty("amount", 0);
documentChargesArr.add(documentChargesObj);
isvDocument.add("discounts", documentChargesArr);
JsonArray customFieldsArr = new JsonArray();
JsonObject customFieldsObj = new JsonObject();
customFieldsObj.addProperty("666", "personalizado");
customFieldsArr.add(customFieldsObj);
isvDocument.add("customFields", customFieldsArr);
JsonArray customFieldsArr = new JsonArray();
JsonObject customFieldsObj = new JsonObject();
customFieldsObj.addProperty("666", "personalizado");
customFieldsArr.add(customFieldsObj);
isvDocument.add("customFields", customFieldsArr);
// Realizar request por metodo POST
HttpRequestWithBody request = Unirest.post("https://isv.aliaddo.net/api/v1/public/documents/support");
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.header("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.header("content-type", "application/json");
request.header("cache-control", "no-cache");
request.header("accept", "application/json");
// Añadir el objeto de documento soporte
request.body(isvDocument).asJson()
// Manejar respuesta o error si hay alguno
.ifSuccess(response -> System.out.println("Response: " + "status -> " + response.getStatus() + " Body -> " + response.getBody() ))
.ifFailure(response -> {
System.out.println("Oh No! Status " + response.getStatus());
response.getParsingError().ifPresent(e -> {
System.out.println("Parsing Exception: " + e);
System.out.println("Original body: " + e.getOriginalBody());
});
});
}
}
```
{% endtab %}
{% tab title="PHP" %}
<?php
// Asegúrese de contar con la librería cURL
// Inicializar la petición
$curl = curl_init();
// Agregando objeto documento soporte con resolución ejemplo
$document = array(
'code' => '01',
'format' => 'Estandar',
'emailSender' => '',
'consecutive' => 990004337,
'externalNumber' => '54554',
'currencyCode' => 'COP',
'currencyRate' => 0,
'date' => '2020-1-22',
'dateDue' => '2020-1-29',
'dateStart' => '2020-1-22',
'dateEnd' => '2020-1-29',
'typeOfOperation' => '10',
'incoterms' => '',
'terms' => '',
'remark' => '',
'observation' => '',
'termDay' => 0,
'paymentMeanCode' => '48',
'branch' => array(
'name' => '',
'address' => '',
'phone' => '',
'countryCode' => '',
'countryName' => '',
'departmentCode' => '',
'departmentName' => '',
'cityCode' => '',
'cityName' => ''
),
'resolution' => array(
'resolutionKey' => 'fc8eac422eba16e22ffd8c6f94b3f40a6e38162c',
'resolutionPrefix' => 'SETT',
'resolutionNumber' => 18760000001,
'resolutionRangeInitial' => 990000000,
'resolutionRangeFinal' => 995000000,
'resolutionValidFrom' => '2019-01-19',
'resolutionValidUntil' => '2030-01-19'
),
'supplier' => array(
'companyName' => 'Customer',
'personType' => '1',
'regimeType' => '04',
'firstName' => 'Customer',
'lastName' => 'Customer',
'identification' => '000000001',
'digitCheck' => '8',
'identificationTypeCode' => '13',
'email' => '',
'phone' => '0000001',
'merchantRegistration' => '',
'responsibleFor' => 'ZZ',
'responsibilities' => 'R-99-PN',
'economicActivities' => '2817;3092',
'billingAddress' => 'KR con Calle',
'billingCountryName' => 'Colombia',
'billingCountryCode' => 'CO',
'billingRegionName' => 'Cundinamarca',
'billingRegionCode' => '25',
'billingCityName' => 'Chipaque',
'billingCityCode' => '25178',
'billingPostalCode' => '',
'billingNeighborhood' => '',
'billingPhone' => '',
'billingContactName' => '',
'shippingAddress' => '',
'shippingCountryName' => '',
'shippingCountryCode' => '',
'shippingRegionName' => '',
'shippingRegionCode' => '',
'shippingCityName' => '',
'shippingCityCode' => '',
'shippingPostalCode' => '',
'shippingNeighborhood' => '',
'shippingPhone' => '',
'shippingContactName' => ''
),
'supportDocumentDetails' => array(
array(
'standardType' => '',
'standardCode' => '',
'itemCode' => '0001',
'itemName' => 'Item',
'itemModel' => '',
'description' => 'Item prueba',
'brandName' => '',
'itemCodeSupplier' => '',
'isPresent' => false,
'isRemmitance' => false,
'remmitanceNumber' => "",
'remmitanceConsecutive' => "",
'remmitanceValue' => 0,
'remmitanceQuantityValue' => 0,
'remmitanceMeasurementUnit' => "",
'unitMeasurementCode' => '',
'unitMeasurementName' => '',
'price' => 25,
'quantity' => 2,
'discounts' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 1,
'amount' => 1
)
),
'charges' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 10,
'amount' => 10
)
),
'taxes' => array(
array(
'name' => 'Iva',
'code' => '01',
'type' => 'P',
'rate' => 19,
'amount' => 6.46
)
),
'withholdings' => array(
array(
'name' => 'ReteFuente',
'code' => '06',
'type' => 'P',
'rate' => 10,
'amount' => 3.4,
)
),
'isvMandante' => array(
'name' => 'Mandante',
'identification' => '000001',
'digitCheck' => '8',
'identificationTypeCode' => '13'
)
)
),
'totals' => array(
'amount' => 68,
'prepaymentAmount' => 0
),
'discounts' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'charges' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'customFields' => array(
array(
'value' => '6666',
'key' => 'personalizado'
)
)
);
// Serializar documento a JSON
$isvDocument = json_encode($document);
/**
* - Enviar documento soporte a la DIAN, en modo producción
* - Realizar request por metodo POST
*/
curl_setopt_array($curl, array(
CURLOPT_URL => "https://isv.aliaddo.net/api/v1/public/documents/support",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => $isvDocument,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
// Tipo de requerimiento formato json
"content-type: application/json",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Mostar respuesta o error si hubo alguno
if ($err) {
echo "error -> " . $err;
} else {
echo $response;
}
// Terminar petición
curl_close($curl);
?>
`POST` `https://isv.aliaddo.net/api/v1/public/documents/support/adjustments`
Enviar una nota de ajuste en **modo producción** a la DIAN.
#### Path Parameters
| Name | Type | Description |
| ------- | ------ | ----------------- |
| version | string | Versión de la API |
#### Headers
| Name | Type | Description |
| --------- | ------ | ------------------------------------------- |
| x-api-key | string | Token generado previamente para autorizarse |
#### Request Body
| Name | Type | Description |
| ------------------ | ------ | --------------------------- |
| isvNoteAdjustments | object | Objeto de la nota de ajuste |
{% tabs %}
{% tab title="200 Request completado con éxito" %}
```javascript
{
"id": "string",
"cuds": "string",
"qr": "string",
"urlPdf": "string",
"urlPdf": "string",
"dianState": "string", // Procesando, Aprobada o Rechazada
"dianStateDate": "0001-01-01T00:00:00"",
"dianStateReason": "string",
"issueDate": "0001-01-01T00:00:00"
}
```
{% endtab %}
{% tab title="204 " %}
```
No se encontraron resultados de acuerdo a los criterios de busqueda
```
{% endtab %}
{% tab title="400 " %}
```
No se han enviado los tipos de datos requeridos
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using RestSharp;
using System;
using Newtonsoft.Json;
class Program
{
public static void Main()
{
/**
- Enviar una nota de ajuste en modo producción
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
// Realizar request por metodo POST
var request = new RestRequest("/support", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto nota de ajuste con resolución ejemplo
var isvNote = new
{
format = "Estandar",
concept = "1",
consecutive = 6,
externalNumber = "",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
notes = new [
"string"
],
supportDocumentPrefix= "inv",
supportDocumentConsecutive = 990004331,
supportDocumentCuds= "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
supportDocumentDate = "2020-1-18",
branch = new
{
name = "Sucursal",
address = "KR con CLL",
phone = "000000",
countryCode = "CO",
countryName = "COLOMBIA",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "25178",
cityName = "Chipaque"
},
supplier = new
{
companyName = "Customer",
personType = "1",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "email@email.com",
phone = "0000001",
merchantRegistration = "",
responsibleFor = "ZZ",
responsibilities = "R-99-PN",
economicActivities = "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = ""
},
supportDocumentAdjustmentDetails = new[]
{
new
{
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
isRemmitance: true,
remmitanceNumber: "",
remmitanceConsecutive: "",
remmitanceValue: 0,
remmitanceQuantityValue: 0,
remmitanceMeasurementUnit: "",
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]
{
new
{
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]
{
new
{
name = "Iva",
code = "01",
type = "P",
rate = 19,
amount = 6.46
}
},
withholdings = new[]
{
new
{
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new
{
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvNote), ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mostrar respuesta
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(response.Content);
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* - Enviar una nota de ajuste en modo producción
* - Realizar request por metodo POST
*/
fetch("https://isv.aliaddo.net/api/v1/public/documents/support", {
method: 'POST',
body: JSON.stringify({
format: "Estandar",
concept: "1",
consecutive: 5,
externalNumber: "",
currencyCode: "COP",
currencyRate: 0,
date: "2020-1-18",
dateStart: "2020-1-18",
dateEnd: "2020-1-20",
notes: [
"string"
],
supportDocumentPrefix: "asd",
supportDocumentConsecutive: 990004331,
supportDocumentCuds: "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
supportDocumentDate: "2020-1-18",
branch: {
name: "Sucursal",
address: "KR con CLL",
phone: "000000",
countryCode: "CO",
countryName: "COLOMBIA",
departamentCode: "25",
departamentName: "Cundinamarca",
cityCode: "25178",
cityName: "Chipaque"
},
supplier: {
companyName: "Customer",
personType: "1",
firstName: "Customer",
lastName: "Customer",
identification: "000000001",
digitCheck: "8",
identificationTypeCode: "13",
email: "email@email.com",
phone: "",
merchantRegistration: "",
responsibleFor: "ZZ",
responsibilities: "R-99-PN",
economicActivities: "2817;3092",
billingAddress: "KR con Calle",
billingCountryName: "Colombia",
billingCountryCode: "CO",
billingRegionName: "Cundinamarca",
billingRegionCode: "25",
billingCityName: "Chipaque",
billingCityCode: "25178",
billingPostalCode: "",
billingNeighborhood: "",
billingPhone: "",
billingContactName: "",
},
noteDetails: [{
standardType: "",
standardCode: "",
itemCode: "0001",
itemName: "Item",
itemModel: "",
description: "Item prueba",
brandName: "",
itemCodeSupplier: "",
isPresent: false,
unitMeasurementCode: "NIU",
unitMeasurementName: "",
price: 1285.00,
quantity: 2,
discounts: [{
name: "",
type: "V",
rate: 1,
amount: 1
}],
charges: [{
name: "",
type: "V",
rate: 10,
amount: 10
}],
taxes: [{
name: "Iva",
code: "01",
type: "V",
rate: 10,
amount: 10
}],
withholdings: [{
name: "ReteFuente",
code: "06",
type: "P",
rate: 10,
amount: 3.4
}],
isvMandante: {
name: "Mandante",
identification: "000001",
digitCheck: "8",
identificationTypeCode: "13"
}
}],
totals: {
amount: 68,
prepaymentAmount: 0
},
discounts: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
],
charges: [
{
name: "",
type: "",
rate: 0,
amount: 0
}
]
}),
headers: {
"Content-Type": "application/json",
"x-api-key": "{{x-api-key}}"
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => res.json())
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el request
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
// Agregar dependencia de GSON para serializar los objetos de Java a JSON
com.google.code.gson
gson
2.8.5
*/
// **** Clase donde se ejecuta el request ****
import com.google.gson.*;
import kong.unirest.*;
/*
* - Enviar una nota de ajuste en modo producción
* - Añada las dependencias de UniRest y GSON a su POM como se muestra en el código de la parte superior
*/
public class Program {
public static void main(String[] args) {
JsonObject isvNote = new JsonObject();
isvNote.addProperty("format", "Estandar");
isvNote.addProperty("concept", "1");
isvNote.addProperty("consecutive", 8);
isvNote.addProperty("externalNumber", "54554");
isvNote.addProperty("currencyCode", "COP");
isvNote.addProperty("currencyRate", 0);
isvNote.addProperty("date", "2020-1-20");
isvNote.addProperty("dateStart", "2020-1-20");
isvNote.addProperty("dateEnd", "2020-1-25");
isvNote.addProperty("supportDocumentPrefix", "asd");
isvNote.addProperty("supportDocumentConsecutive", 990004331);
isvNote.addProperty("supportDocumentCuds", "cufe");
isvNote.addProperty("supportDocumentDate", "2020-1-18");
JsonObject branchObj = new JsonObject();
branchObj.addProperty("name", "");
branchObj.addProperty("address", "");
branchObj.addProperty("phone", "");
branchObj.addProperty("countryCode", "");
branchObj.addProperty("countryName", "");
branchObj.addProperty("departmentCode", "");
branchObj.addProperty("departmentName", "");
branchObj.addProperty("cityCode", "");
branchObj.addProperty("cityName", "");
isvNote.add("branch", branchObj);
JsonObject supplierObj = new JsonObject();
supplierObj.addProperty("companyName", "Customer");
supplierObj.addProperty("personType", "1");
supplierObj.addProperty("firstName", "Customer");
supplierObj.addProperty("lastName", "Customer");
supplierObj.addProperty("identification", "000000001");
supplierObj.addProperty("digitCheck", "8");
supplierObj.addProperty("identificationTypeCode", "13");
supplierObj.addProperty("email", "");
supplierObj.addProperty("phone", "0000001");
supplierObj.addProperty("merchantRegistration", "");
supplierObj.addProperty("responsibleFor", "ZZ");
supplierObj.addProperty("responsibilities", "R-99-PN");
supplierObj.addProperty("economicActivities", "2817;3092");
supplierObj.addProperty("billingAddress", "KR con Calle");
supplierObj.addProperty("billingCountryName", "Colombia");
supplierObj.addProperty("billingCountryCode", "CO");
supplierObj.addProperty("billingRegionName", "Cundinamarca");
supplierObj.addProperty("billingRegionCode", "25");
supplierObj.addProperty("billingCityName", "Chipaque");
supplierObj.addProperty("billingCityCode", "25178");
supplierObj.addProperty("billingPostalCode", "");
supplierObj.addProperty("billingNeighborhood", "");
supplierObj.addProperty("billingPhone", "");
supplierObj.addProperty("billingContactName", "");
isvNote.add("customer", customerObj);
JsonArray noteDetailsArr = new JsonArray();
JsonObject noteDetailsObj = new JsonObject();
noteDetailsObj.addProperty("standardType", "");
noteDetailsObj.addProperty("standardCode", "");
noteDetailsObj.addProperty("itemCode", "0001");
noteDetailsObj.addProperty("itemName", "Item");
noteDetailsObj.addProperty("itemModel", "");
noteDetailsObj.addProperty("description", "Item prueba");
noteDetailsObj.addProperty("brandName", "");
noteDetailsObj.addProperty("itemCodeSupplier", "");
noteDetailsObj.addProperty("isPresent", false);
noteDetailsObj.addProperty("unitMeasurementCode", "");
noteDetailsObj.addProperty("unitMeasurementName", "");
noteDetailsObj.addProperty("price", 25);
noteDetailsObj.addProperty("quantity", 2);
noteDetailsArr.add(noteDetailsObj);
JsonArray discountsArr = new JsonArray();
JsonObject discountsObj = new JsonObject();
discountsObj.addProperty("name", "");
discountsObj.addProperty("type", "V");
discountsObj.addProperty("rate", 1);
discountsObj.addProperty("amount", 1);
discountsArr.add(discountsObj);
noteDetailsObj.add("discounts", discountsArr);
JsonArray chargesArr = new JsonArray();
JsonObject chargesObj = new JsonObject();
chargesObj.addProperty("name", "");
chargesObj.addProperty("type", "V");
chargesObj.addProperty("rate", 10);
chargesObj.addProperty("amount", 10);
chargesArr.add(chargesObj);
noteDetailsObj.add("charges", chargesArr);
JsonArray taxesArr = new JsonArray();
JsonObject taxesObj = new JsonObject();
taxesObj.addProperty("name", "Iva");
taxesObj.addProperty("code", "01");
taxesObj.addProperty("type", "P");
taxesObj.addProperty("rate", 19);
taxesObj.addProperty("amount", 6.46);
taxesArr.add(taxesObj);
noteDetailsObj.add("taxes", taxesArr);
JsonArray withholdingsArr = new JsonArray();
JsonObject withholdingsObj = new JsonObject();
withholdingsObj.addProperty("name", "ReteFuente");
withholdingsObj.addProperty("code", "06");
withholdingsObj.addProperty("type", "P");
withholdingsObj.addProperty("rate", 10);
withholdingsObj.addProperty("amount", 3.4);
withholdingsArr.add(withholdingsObj);
noteDetailsObj.add("withholdings", withholdingsArr);
JsonObject isvMandanteObj = new JsonObject();
isvMandanteObj.addProperty("name", "Mandante");
isvMandanteObj.addProperty("identification", "0014");
isvMandanteObj.addProperty("digitCheck", "8");
isvMandanteObj.addProperty("identificationTypeCode", "13");
noteDetailsObj.add("isvMandante", isvMandanteObj);
noteDetailsObj.add("noteDetails", noteDetailsArr);
JsonObject totals = new JsonObject();
totals.addProperty("amount", 68);
totals.addProperty("amount", 68);
totals.addProperty("prepaymentAmount", 0);
isvNote.add("totals", totals);
JsonArray isvNoteDiscountsArr = new JsonArray();
JsonObject isvNoteDiscountsObj = new JsonObject();
isvNoteDiscountsObj.addProperty("type", "");
isvNoteDiscountsObj.addProperty("rate", 0);
isvNoteDiscountsObj.addProperty("amount", 0);
isvNoteDiscountsArr .add(isvNoteDiscountsObj);
isvNote.add("discounts", isvNoteDiscountsArr );
JsonArray isvNoteChargesArr = new JsonArray();
JsonObject isvNoteChargesObj = new JsonObject();
isvNoteChargesObj.addProperty("type", "");
isvNoteChargesObj.addProperty("rate", 0);
isvNoteChargesObj.addProperty("amount", 0);
isvNoteChargesArr.add(isvNoteChargesObj );
isvNoteChargesObj.add("charges", isvNoteChargesArr);
// Realizar request por metodo POST
HttpRequestWithBody request = Unirest.post("https://isv.aliaddo.net/api/v1/public/documents/support");
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.header("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.header("content-type", "application/json");
request.header("cache-control", "no-cache");
request.header("accept", "application/json");
// Añadir el objeto de nota de ajuste
request.body(isvNote).asJson()
// Manejar respuesta o error si hay alguno
.ifSuccess(response -> System.out.println("Response: " + "status -> " + response.getStatus() + " Body -> " + response.getBody()))
.ifFailure(response -> {
System.out.println("Oh No! Status " + response.getStatus());
response.getParsingError().ifPresent(e -> {
System.out.println("Parsing Exception: " + e);
System.out.println("Original body: " + e.getOriginalBody());
});
});
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'Estandar',
'concept' => '1',
'consecutive' => 8,
'externalNumber' => '54554',
'currencyCode' => 'COP',
'currencyRate' => 0,
'date' => '2020-1-22',
'dateStart' => '2020-1-22',
'dateEnd' => '2020-1-25',
'documentPrefix' => 'asd',
'supportDocumentConsecutive' => 990004331,
'supportDocumentCuds' => 'aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162',
'supportDocumentDate' => '2020-1-18',
'branch' => array(
'name' => '',
'address' => '',
'phone' => '',
'countryCode' => '',
'countryName' => '',
'departmentCode' => '',
'departmentName' => '',
'cityCode' => '',
'cityName' => ''
),
'supplier' => array(
'companyName' => 'Customer',
'personType' => '1',
'firstName' => 'Customer',
'lastName' => 'Customer',
'identification' => '000000001',
'digitCheck' => '8',
'identificationTypeCode' => '13',
'email' => 'email@email.com',
'phone' => '0000001',
'merchantRegistration' => '',
'responsibleFor' => 'ZZ',
'responsibilities' => 'R-99-PN',
'economicActivities' => '2817;3092',
'billingAddress' => 'KR con Calle',
'billingCountryName' => 'Colombia',
'billingCountryCode' => 'CO',
'billingRegionName' => 'Cundinamarca',
'billingRegionCode' => '25',
'billingCityName' => 'Chipaque',
'billingCityCode' => '25178',
'billingPostalCode' => '',
'billingNeighborhood' => '',
'billingPhone' => '',
'billingContactName' => ''
),
'supportDocumentAdjustmentDetails' => array(
array(
'standardType' => '',
'standardCode' => '',
'itemCode' => '0001',
'itemName' => 'Item',
'itemModel' => '',
'description' => 'Item prueba',
'brandName' => '',
'itemCodeSupplier' => '',
'isPresent' => false,
'unitMeasurementCode' => '',
'unitMeasurementName' => '',
'price' => 25,
'quantity' => 2,
'discounts' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 1,
'amount' => 1
)
),
'charges' => array(
array(
'name' => '',
'type' => 'V',
'rate' => 10,
'amount' => 10
)
),
'taxes' => array(
array(
'name' => 'Iva',
'code' => '01',
'type' => 'P',
'rate' => 19,
'amount' => 6.46
)
),
'withholdings' => array(
array(
'name' => 'ReteFuente',
'code' => '06',
'type' => 'P',
'rate' => 10,
'amount' => 3.4,
)
),
'isvMandante' => array(
'name' => 'Mandante',
'identification' => '000001',
'digitCheck' => '8',
'identificationTypeCode' => '13'
)
)
),
'totals' => array(
'amount' => 68,
'prepaymentAmount' => 0
),
'discounts' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
),
'charges' => array(
array(
'name' => '',
'type' => '',
'rate' => 0,
'amount' => 0
)
)
);
// Serializar objeto a JSON
$isvNote = json_encode($note);
/**
* - Enviar una nota de ajuste en modo producción
* - Realizar request por metodo POST
*/
curl_setopt_array($curl, array
CURLOPT_URL => "https://isv.aliaddo.net/api/v1/public/documents/support",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => $isvNote,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
// Tipo de requerimiento formato json
"content-type: application/json",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Mostar respuesta o error si hubo alguno
if ($err) {
echo "cURL Error #" .$err;
} else {
echo $response;
}
// Terminar petición
curl_close($curl);
?>
```
{% endtab %}
{% tab title="Python" %}
```python
# Importar la librería "requests"
import requests
# - Enviar una nota de ajuste en modo producción
url = 'https://isv.aliaddo.net/api/v1/public/documents/support'
# Crear objeto de nota de ajuste
isvNote = {
"format": "Estandar",
"concept": "1",
"consecutive": 9,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"notes": [
"string"
],
"supportDocumentPrefix": "asd",
"supportDocumentConsecutive": 990004331,
"supportDocumentCuds": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"supportDocumentDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"supplier": {
"companyName": "Customer",
"personType": "1",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": ""
},
"supportDocumentAdjustmentDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": False,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "MAndante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}]
}
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# - Realizar request por metodo POST
request = requests.post(url, json=isvNote, headers=headers)
# Mostrar respuesta de la petición
print(request.text)
print(request.status_code)
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
# Requerir gemas "rest-client" y "json"
require 'rest-client'
require 'json'
# - Enviar una nota de ajuste en modo producción
url = "https://isv.aliaddo.net/api/v1/public/documents/support"
# Tipo de requerimiento formato json
headers = {
"content-type": "application/json",
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# Crear objeto de nota de ajuste
isvNote = {
"format": "Estandar",
"concept": "1",
"consecutive": 10,
"externalNumber": "54554",
"currencyCode": "COP",
"currencyRate": 0,
"date": "2020-1-22",
"dateStart": "2020-1-22",
"dateEnd": "2020-1-25",
"notes": [
"string"
],
"supportDocumentPrefix": "asd",
"supportDocumentConsecutive": 990004331,
"supportDocumentCuds": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
"supportDocumentDate": "2020-1-18",
"branch": {
"name": "",
"address": "",
"phone": "",
"countryCode": "",
"countryName": "",
"departmentCode": "",
"departmentName": "",
"cityCode": "",
"cityName": ""
},
"supplier": {
"companyName": "Customer",
"personType": "1",
"firstName": "Customer",
"lastName": "Customer",
"identification": "000000001",
"digitCheck": "8",
"identificationTypeCode": "13",
"email": "",
"phone": "0000001",
"merchantRegistration": "",
"responsibleFor": "ZZ",
"responsibilities": "R-99-PN",
"economicActivities": "2817;3092",
"billingAddress": "KR con Calle",
"billingCountryName": "Colombia",
"billingCountryCode": "CO",
"billingRegionName": "Cundinamarca",
"billingRegionCode": "25",
"billingCityName": "Chipaque",
"billingCityCode": "25178",
"billingPostalCode": "",
"billingNeighborhood": "",
"billingPhone": "",
"billingContact": ""
},
"supportDocumentAdjustmentDetails": [{
"standardType": "",
"standardCode": "",
"itemCode": "0001",
"itemName": "Item",
"itemModel": "",
"description": "Item prueba",
"brandName": "",
"itemCodeSupplier": "",
"isPresent": false,
"unitMeasurementCode": "",
"unitMeasurementName": "",
"price": 25,
"quantity": 2,
"discounts": [{
"name": "",
"type": "V",
"rate": 1,
"amount": 1
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}],
"taxes": [{
"name": "Iva",
"code": "01",
"type": "P",
"rate": 19,
"amount": 6.46
}],
"withholdings": [{
"name": "ReteFuente",
"code": "06",
"type": "P",
"rate": 10,
"amount": 3.4
}],
"isvMandante": {
"name": "Mandante",
"identification": "00000000001",
"digitCheck": "8",
"identificationTypeCode": "13"
}
}],
"totals": {
"amount": 68,
"prepaymentAmount": 0
},
"discounts": [{
"name": "",
"type": "",
"rate": 0,
"amount": 0
}],
"charges": [{
"name": "",
"type": "V",
"rate": 10,
"amount": 10
}]
}
# Crear petición con método POST
begin
request = RestClient.post(url, isvNote.to_json, headers)
# Manejar error si hay alguno
rescue RestClient::ExceptionWithResponse => e
puts e.response
end
# Imprimir respuesta
puts request
```
{% endtab %}
{% endtabs %}
# Resoluciones
En nuestra API tienes la posibilidad de consultar las resoluciones creadas dentro del portal ISV.
La estructura del objeto de una resolución es el siguiente (Este ejemplo corresponde a la resolución de pruebas que provee la DIAN de forma genérica):
```javascript
"resolution": {
"resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"resolutionPrefix": "SETP",
"resolutionNumber": 18760000001,
"resolutionRangeInitial": 990000000,
"resolutionRangeFinal": 995000000,
"resolutionValidFrom": "2019-01-19",
"resolutionValidUntil": "2030-01-19"
}
```
# Consultar resoluciones
## Consultar resoluciones
`GET` `https://isv.aliaddo.net/api/v1/public/documents/resolutions`
Este método devuelve las resoluciones.
#### Path Parameters
| Name | Type | Description |
| ------- | ------ | ---------------------------- |
| version | string | Indica la versión de la API. |
#### Headers
| Name | Type | Description |
| --------- | ------ | --------------------------------------------- |
| x-api-key | string | Token generado previamente para autenticarse. |
{% tabs %}
{% tab title="200 " %}
```javascript
{
"resolutionKey": "string",
"resolutionPrefix": "string",
"resolutionNumber": 0,
"resolutionRangeInitial": 0,
"resolutionRangeFinal": 0,
"resolutionValidFrom": "2019-01-19T00:00:00",
"resolutionValidUntil": "2030-01-19T00:00:00"
}
```
{% endtab %}
{% tab title="400 " %}
```
No se han enviado los tipos de datos requeridos
```
{% endtab %}
{% tab title="401 " %}
```
No esta autorizado para realizar el requerimiento a este metodo, debe enviar el token generado en el token
```
{% endtab %}
{% tab title="500 " %}
```
Se ha producido un incidente al validar el documento
```
{% endtab %}
{% endtabs %}
### Código de ejemplo
{% tabs %}
{% tab title="C#" %}
```csharp
using System;
using Newtonsoft.Json;
using RestSharp;
public class Program
{
public static void Main()
{
/**
* /resolutions
* - Consultar resoluciones
* - Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
* - Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
// Realizar request por metodo GET
var request = new RestRequest("/resolutions", Method.GET);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Imprimir respuesta
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(response.Content);
}
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
/*
* /resolutions
* - Consultar resoluciones
* - Realizar request por metodo GET
*/
fetch('https://isv.aliaddo.net/api/v1/public/documents/resolutions', {
method: 'GET',
// Añadir cabeceras a la petición
headers: {
'Content-Type': 'application/json',
'x-api-key': '{{x-api-key}}'
}
})
// Manejar petición en caso de que haya sido exitosa o fallida
.then(res => res.json())
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response))
```
{% endtab %}
{% tab title="Java" %}
```java
/* Agregue este código a su POM
***** CONTENIDO DEL POM *****
maven-assembly-plugin
// Clase donde se ejecuta el GET
Program
jar-with-dependencies
org.apache.maven.plugins
maven-compiler-plugin
10
10
// Agregar dependencia de UniRest para manejar los request
com.konghq
unirest-java
3.1.00
*/
// **** Clase donde se ejecuta el request ****
// Agregue las dependencias de UniRest a su POM como se indica en el código superior
import kong.unirest.*;
public class Program {
public static void main(String[] args) {
/*
* /resolutions
* - Consultar resolutiones
* - Realizar request por método GET
*/
HttpResponse request = Unirest.get("https://isv.aliaddo.net/api/v1/public/documents/resolutions").
header("accept", "application/json").
header("cache-control", "no-cache").
header("x-api-key", "{{x-api-key}}").
asJson();
// Imprimir la respuesta
System.out.println(request.getBody().getObject().toString(2));
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
"https://isv.aliaddo.net/api/v1/public/documents/resolutions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => array(
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key: {{x-api-key}}",
"cache-control: no-cache",
"accept: application/json"
)
));
// Ejecutar la petición
$response = curl_exec($curl);
// Almacenar error en caso de que exista
$err = curl_error($curl);
// Mostrar respuesta o error si hubo alguno
if ($err) {
echo "cURL Error #" .$err;
} else {
echo $response;
}
// Terminar petición
curl_close($curl);
?>
```
{% endtab %}
{% tab title="Python" %}
```python
# Importar la librería "requests"
import requests
# /resolutions
# - Consultar resoluciones
url = 'https://isv.aliaddo.net/api/v1/public/documents/resolutions'
# Tipo de requerimiento formato json
headers = {
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"x-api-key": "{{x-api-key}}"
}
# - Realizar request por metodo GET
request = requests.get(url, headers=headers)
# Mostrar respuesta de la petición
print(request.text)
print(request.status_code)
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
# Importar la gema "rest-client"
require 'rest-client'
# /resolutions
# - Consultar resoluciones
url = "https://isv.aliaddo.net/api/v1/public/documents/resolutions"
# Tipo de requerimiento formato json
headers = {
"cache-control": "no-cache",
"accept": "application/json",
# Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
"authorization": "{{x-api-key}}"
}
# Ejecutar request
begin
request = RestClient.get(url, headers)
# Manejar error si hay alguno
rescue RestClient::ExceptionWithResponse => e
puts e.response
end
# Imprirmir respuesta
puts request
```
{% endtab %}
{% endtabs %}
# Consideraciones sobre el archivo plano
El archivo plano es un documento en formato **CSV delimitado por punto y coma (;)** con el cual se pueden importar registros masivamente al portal **ISV**.
Con el archivo plano tienes la facilidad de importar tus facturas, notas débito y notas crédito habiéndolas creado en una aplicación que permita guardar un archivo con extensión **.csv**.
Para poder usar archivos planos en nuestro portal debes tener en cuenta lo siguiente:
* Los archivos **.csv** deben tener sus "items" separados por punto y coma **(;)**. Si la aplicación que usas para crear el archivo plano tiene configurada la delimitación por comas **(,)**, *e.g.* Microsoft Excel, deberás cambiar dicha configuración como se indica [***aquí***](https://excel.facilparami.com/2016/06/guardar-archivo-csv-excel-separado-punto-coma/) ***(Realizar el proceso hasta la tercera imagen)***.
* Los campos con valores numéricos obligatorios y opcionales deben cómo mínimo tener un cero `0` ya que estos campos no pueden estar vacíos.
* El archivo plano tiene su propia estructura, cómo se indica [***aquí***](/archivo-plano-.csv/estructura-del-archivo-plano)***.***
* El archivo plano puede tener un tamaño máximo de **3MB (MegaBytes)**.
* El archivo plano no tiene relación alguna con la **API***.*
* Los documentos que vas a importar (Facturas, notas crédito / débito) tienen un encabezado que es donde se indica toda la información relacionada con tu empresa, tu cliente, entre otros. Estos documentos también tienen un detalle que es donde se indica todo lo relacionado con los productos a facturar.
* Los códigos que identifican algunos valores, cómo por ejemplo los tipos de documento, aplican tanto para la API como para el Archivo Plano.
* La descripción **Tipo de registro** indica qué tipo de documento estamos haciendo:
* **INV** = Factura de venta
* **INC** = Nota crédito
* **IND** = Nota débito
* **DTL** = Detalle del documento (Aplica para todos los tipos de documento)
### Organización interna del archivo plano
Los archivos planos tienen una organización como la siguiente:
#### Descripción del encabezado:
La primera línea indica la descripción de cada uno de los valores del encabezado del documento:
#### Descripción del detalle:
La segunda línea indica la descripción de los valores del detalle del documento:
#### Valores del encabezado:
La tercera línea es la que tiene los valores del encabezado del documento acorde a la descripción de la primera línea.
#### Valores del detalle:
La cuarta línea indica los valores del detalle del documento acorde a la descripción de la segunda línea:
{% hint style="warning" %}
La primer y segunda línea sólo son indicativas, es decir, sólo sirven cómo guía para que puedas saber qué valor va en qué columna, por lo que debes eliminar dichas líneas (línea 1 y 2) antes de cargar el archivo.
{% endhint %}
{% hint style="info" %}
Se pueden incluir ilimitados detalles por cada encabezado.
{% endhint %}
{% hint style="info" %}
Se pueden incluir ilimitados documentos **del mismo tipo** dentro de un solo archivo plano.
Esto se hace creando un nuevo encabezado junto con sus respectivos detalles, como se muestra a continuación:
{% endhint %}
# Estructura del archivo plano
Ingresa al enlace correspondiente al tipo de documento que quieres importar por medio de archivo plano.
{% content-ref url="/pages/-M-Ft1xCoQ1C5bhDDjJE" %}
[Factura](/archivo-plano-.csv/estructura-del-archivo-plano/factura)
{% endcontent-ref %}
{% content-ref url="/pages/-M-Ft0CqKC\_VYf2DaIUu" %}
[Nota crédito](/archivo-plano-.csv/estructura-del-archivo-plano/nota-credito)
{% endcontent-ref %}
{% content-ref url="/pages/-M-Ft1QhoNrO1D8L71cI" %}
[Nota débito](/archivo-plano-.csv/estructura-del-archivo-plano/nota-debito)
{% endcontent-ref %}
# Factura
La estructura del archivo plano para crear una factura es la siguiente:
### Encabezado
Número de columna y nombre del campo Descripción Códigos Tipo Este campo es requerido Ancho del campo Número de columna y nombre del campo Descripción Códigos Tipo Este campo es requerido Ancho del campo 1.Tipo registro Debe ir "INV" para indicar que es el encabezado de una factura Cadena de caracteres Si 3 2.Tipo de documento factura DIAN Código del tipo de factura Ver códigos Cadena de caracteres Si 2 3.Formato pdf documento Formato pdf documento Ver códigos Cadena de caracteres Si 4.Consecutivo factura Consecutivo factura Numérico Si 5.Número externo de las factura Consecutivo factura Númerico 6.Tipo moneda Código tipo de moneda Ver códigos Cadena de caracteres 3 7.TRM del día cuando la factura es en moneda extranjera TRM de los valores factura Numérico 3 8.Fecha de expedición de la factura Fecha en que expidió la factura, formato yyyy-MM-dd (2010-01-31) Fecha Si 10 9.Fecha de vencimiento de la factura Fecha en que se vence la factura, formato yyyy-MM-dd (2010-01-31) Fecha 10 10.Fecha inicial del periodo de facturación Fecha inicio en que se inició el periodo a facturar, formato yyyy-MM-dd (2010-01-31) Fecha 10 11.Fecha final del periodo de facturación Fecha fin en que se finaliza el periodo a facturar, formato yyyy-MM-dd (2010-01-31) Fecha 10 12.Tipo de operación Tipo de operación Ver códigos Cadena de caracteres Si 2 13.Código de condición de entrega Código de condición de entrega, Es requerido cuando el tipo se llena el tipo de operación y el tipo de documento factura DIAN es igual a "02":"Factura de exportación" Ver códigos Cadena de caracteres 3 14.Términos y condiciones Términos y condiciones del documento Cadena de caracteres 800 15.Pie de página Pie de página Cadena de caracteres 800 16.Nota / Observación Notas u observaciones del documento Cadena de caracteres 800 17.Días termino de pago Días termino de pago Numérico 18.(Sucursal) Nombre Nombre de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres 19.(Sucursal) Dirección Dirección de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres 20.(Sucursal) Teléfono Teléfono de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres 21.(Sucursal) Código país Código país de la sucursal para sobrescribir los datos de la empresa Ver códigos Cadena de caracteres 22.(Sucursal) Nombre país Nombre país de la sucursal para sobrescribir los datos de la empresa Ver códigos Cadena de caracteres 23.(Sucursal) Código departamento Código departamento de la sucursal para sobrescribir los datos de la empresa Ver códigos Cadena de caracteres 24.(Sucursal) Nombre departamento Nombre departamento de la sucursal para sobrescribir los datos de la empresa Ver códigos Cadena de caracteres 25.(Sucursal) Código ciudad Código ciudad de la sucursal para sobrescribir los datos de la empresa Ver códigos Cadena de caracteres 26.(Sucursal) Nombre ciudad Nombre ciudad de la sucursal para sobrescribir los datos de la empresa Ver códigos Cadena de caracteres 27.(Resolución) Clave de la resolución Llave de la resolución proporcionada por la DIAN Cadena de caracteres Si 28.(Resolución) Prefijo de la resolución Prefijo de facturación Cadena de caracteres Si 29.(Resolución) Número de la resolución Número de la resolución proporcionado por DIAN Numérico Si 30.(Resolución) Rango inicial de facturación Rango inicial de facturación habilitado Numérico Si 31.(Resolución) Rango final de facturación Rango final de facturación habilitado Numérico Si 32.(Resolución) Fecha inicial de validación de facturación Fecha inicial de de validación de facturación, formato yyyy-MM-dd (2010-01-31) Fecha Si 33.(Resolución) Fecha final de validación de facturación Fecha final de de validación de facturación, formato yyyy-MM-dd (2010-01-31) Fecha Si 34.(Cliente) Razón social o nombre completo Razón social o nombre completo Cadena de caracteres Si 35.(Cliente) Tipo persona Tipo persona Ver códigos Cadena de caracteres Si 1 36.(Cliente) Tipo de régimen Tipo de régimen Ver códigos Cadena de caracteres Si 2 37.(Cliente) Nombres Nombres Cadena de caracteres Si 38.(Cliente) Apellidos Apellidos Cadena de caracteres 39.(Cliente) Número documento identificación Número documento identificación Cadena de caracteres Si 40.(Cliente) Dígito de verificación Dígito de verificación Cadena de caracteres Si 41.(Cliente) Tipo de identificación Tipo de identificación Ver códigos Cadena de caracteres Si 2 42.(Cliente) Email/correo electrónico Email/correo electrónico Cadena de caracteres 43.(Cliente) Teléfono Teléfono Cadena de caracteres 44.(Cliente) Registro mercantil Registro mercantil Cadena de caracteres 45.(Cliente) Responsabilidades fiscales Responsabilidades fiscales Ver códigos Cadena de caracteres Si 46.(Cliente-Facturación) Dirección (Facturación) Dirección facturación Cadena de caracteres Si 47.(Cliente-Facturación) Nombre del país (Facturación) Nombre del país facturación Ver códigos Cadena de caracteres Si 48.(Cliente-Facturación) Código del país (Facturación) Código del país Ver códigos Cadena de caracteres Si 2 49.(Cliente-Facturación) Nombre de la región (Facturación) Nombre del departamento Ver códigos Cadena de caracteres Si 50.(Cliente-Facturación) Código de la región (Facturación) Código del departamento Ver códigos Cadena de caracteres 2 51.(Cliente-Facturación) Nombre de la ciudad (Facturación) Nombre del municipio Ver códigos Cadena de caracteres Si 52.(Cliente-Facturación) Código de la ciudad (Facturación) Código del municipio Ver códigos Cadena de caracteres 5 53.(Cliente-Facturación) Código postal (Facturación) Código postal Cadena de caracteres 54.(Cliente-Facturación) Barrio (Facturación) Barrio Cadena de caracteres 55.(Cliente-Facturación) Teléfono (Facturación) Teléfono Cadena de caracteres 56.(Cliente-Facturación) Nombre contacto (Facturación) Nombre contacto Cadena de caracteres 57.(Cliente-Datos-Entrega) Dirección (Datos-Entrega) Dirección facturación Cadena de caracteres Si 58.(Cliente-Datos-Entrega) Nombre del país (Datos-Entrega) Nombre del país facturación Ver códigos Cadena de caracteres Si 59.(Cliente-Datos-Entrega) Código del país (Datos-Entrega) Código del país Ver códigos Cadena de caracteres Si 2 60.(Cliente-Datos-Entrega) Nombre de la región (Datos-Entrega) Nombre del departamento Ver códigos Cadena de caracteres Si 61.(Cliente-Datos-Entrega) Código de la región (Datos-Entrega) Código del departamento Ver códigos Cadena de caracteres 2 62.(Cliente-Datos-Entrega) Nombre de la ciudad (Datos-Entrega) Nombre del municipio Ver códigos Cadena de caracteres Si 63.(Cliente-Datos-Entrega) Código de la ciudad (Datos-Entrega) Código del municipio Ver códigos Cadena de caracteres 5 64.(Cliente-Datos-Entrega) Código postal (Datos-Entrega) Código postal Cadena de caracteres 65.(Cliente-Datos-Entrega) Barrio (Datos-Entrega) Barrio Cadena de caracteres 66.(Cliente-Datos-Entrega) Teléfono (Datos-Entrega) Teléfono Cadena de caracteres 67.(Cliente-Datos-Entrega) Nombre contacto (Datos-Entrega) Nombre contacto Cadena de caracteres 68.(Total) Subtotal sin impuestos ni retenciones Subtotal sin impuestos ni retenciones Numérico Si 69.(Total) Anticipos Anticipos Numérico Si 70.(Total) impuestos Impuestos Numérico Si 71.(Total) Retenciones Retenciones Numérico Si 72.Medio de pago Medio de pago Ver códigos Cadena de caracteres
### Detalle
Número de columna y nombre del campo Descripción Códigos Tipo Este campo es requerido Ancho del campo Número de columna y nombre del campo Descripción Códigos Tipo Este campo es requerido Ancho del campo 1.Tipo registro Debe ir "DTL" para indicar que es un detalle de factura Cadena de caracteres Si 3 2.Código ítem Indique el código del ítem, producto o servicio que esta facturando Cadena de caracteres Si 3.Nombre servicio/producto Nombre servicio/producto que esta facturando Cadena de caracteres Si 4.Modelo del producto o servicio Modelo del producto o servicio que esta facturando Cadena de caracteres 5.Descripción de la venta Descripción de la venta Cadena de caracteres 6.Marca del producto o servicio Marca del producto o servicio Cadena de caracteres 7.Código del producto colocado por el proveedor Código del producto colocado por el proveedor Cadena de caracteres 8.Es un regalo Es un regalo Booleano Si 9.Precio unitario Precio unitario Numérico Si 10.Cantidad Cantidad Numérico Si 11.Valor total de los descuentos aplicados Valor total de los descuentos aplicados Numérico 12.Valor total de los cargos aplicados Valor total de los cargos aplicados Numérico 13.(Descuento) Tipo valor Tipo valor Ver códigos Cadena de caracteres 1 14.(Descuento) Tarifa Tarifa Numérico 15.(Descuento) Valor Valor Numérico 16.(Cargos) Tipo valor Tipo valor Ver códigos Cadena de caracteres 1 17.(Cargos) Tarifa Tarifa, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual. Numérico 18.(Cargos) Valor Valor, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual Numérico 19.Impuestos Lista de impuestos separados por barra vertical "|" y valores separados por dos puntos ":", de la siguiente forma "Tipo Valor:Código impuesto: Tarifa impuesto:Valor Impuesto" Ejemplo: P:01:Iva:19:19000 , tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual, para el tipo de valor están las siguientes opciones: "V": Valor, "P": Porcentaje, "M": Por mil Ver códigos Numérico 20.Retenciones Lista de retenciones separados por barra vertical "|" y valores separados por dos puntos ":", de la siguiente forma "Tipo Valor:Código impuesto: Tarifa impuesto:Valor Impuesto" Ejemplo: P:01:ReteIva:2:2000 , tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual, para el tipo de valor están las siguientes opciones: "V": Valor, "P": Porcentaje, "M": Por mil Ver códigos Numérico 21.(Mandante) Nombre Nombre del mandante Cadena de caracteres 22.(Mandante) Identificación Identificación Cadena de caracteres 23.(Mandante) Dígito de verificación Dígito de verificación Cadena de caracteres 24.(Mandante) Tipo de identificación Tipo de identificación Ver códigos Cadena de caracteres 25.Tipo de código estándar DIAN Tipo de código estándar DIAN Ver códigos Cadena de caracteres 26.Código estándar DIAN Código estándar DIAN Cadena de caracteres
# Nota débito
La estructura del archivo plano para crear una nota débito es la siguiente:
### Encabezado
Número de la columna y nombre del campo Descripción Códigos Tipo Este campo es requerido Ancho del campo Número de la columna y nombre del campo Descripción Códigos Tipo Este campo es requerido Ancho del campo 1.Tipo registro Debe ir "IND" para indicar que es el encabezado de una nota débito Cadena de caracteres Si 3 2.Concepto nota débito Concepto nota débito Ver códigos Cadena de caracteres Si 2 3.Formato pdf documento Formato pdf documento Ver códigos Cadena de caracteres Si 4.Prefijo nota débito Campo (obsoleto) no se debe diligenciar, debes llenar el prefijo de resolución para asignar prefijo a la nota Cadena de caracteres Si 5.Consecutivo nota débito Consecutivo nota débito Numérico Si 6.Número externo de las facturas (Orden de compra) Consecutivo factura Numérico No 7.Tipo moneda Código tipo de moneda Ver códigos Cadena de caracteres No 3 8.TRM del día cuando la factura es en moneda extranjera TRM de los valores factura Numérico No 3 9.Fecha de la nota débito Fecha en que expidió la nota débito, formato yyyy-MM-dd (2010-01-31) Fecha Si 10 10.Fecha inicial del periodo de facturación Fecha incio en que se inició el periodo a facturar, formato yyyy-MM-dd (2010-01-31) Fecha No 10 11.Fecha final del periodo de facturación Fecha fin en que se finaliza el periodo a facturar, formato yyyy-MM-dd (2010-01-31) Fecha No 10 12.Tipo de operación Tipo de operación Ver códigos Cadena de caracteres Si 2 13.Terminos y condiciones Terminos y condiciones del documento Cadena de caracteres No 800 14.Pie de página Pie de página Cadena de caracteres No 800 15.Nota / Observación Notas u observaciones del documento Cadena de caracteres No 800 16.(Factura) Prefijo de la factura Prefijo de la factura a la cual se le esta realizando la nota débito Cadena de caracteres No 17.(Factura) Consecutivo de la factura Consecutivo de la factura a la cual se le esta realizando la nota débito Cadena de caracteres No 18.(Factura) Cufe de la factura Cufe de la factura Cadena de caracteres No 19.(Factura) Fecha de la factura Fecha de la factura, formato yyyy-MM-dd (2010-01-31) Cadena de caracteres No 20.(Sucursal) Nombre Nombre de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres No 21.(Sucursal) Dirección Dirección de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres No 22.(Sucursal) Teléfono Teléfono de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres No 23.(Sucursal) Código país Código país de la sucursal para sobrescribir los datos de la empresa Ver códigos Cadena de caracteres No 24.(Sucursal) Nombre país Nombre país de la sucursal para sobrescribir los datos de la empresa Ver códigos Cadena de caracteres No 25.(Sucursal) Código departamento Código departamento de la sucursal para sobrescribir los datos de la empresa Ver códigos Cadena de caracteres No 26.(Sucursal) Nombre departamento Nombre departamento de la sucursal para sobrescribir los datos de la empresa Ver códigos Cadena de caracteres No 27.(Sucursal) Código ciudad Código ciudad de la sucursal para sobrescribir los datos de la empresa Ver códigos Cadena de caracteres No 28.(Sucursal) Nombre ciudad Nombre ciudad de la sucursal para sobrescribir los datos de la empresa Ver códigos Cadena de caracteres No 29.(Resolución) Clave de la resolución Llave de la resolución proporcionada por la DIAN Cadena de caracteres Si 30.(Resolución) Prefijo de la resolución Prefijo de la nota. Cadena de caracteres Si 31.(Resolución) Número de la resolución Número de la resolución proporcionado por DIAN Numérico Si 32.(Resolución) Rango inicial de facturación Rango inicial de facturación habilitado Numérico Si 33.(Resolución) Rango final de facturación Rango final de facturación habilitado Numérico Si 34.(Resolución) Fecha inicial de validación de facturación Fecha inicial de de validación de facturación, formato yyyy-MM-dd (2010-01-31) Fecha Si 35.(Resolución) Fecha final de validación de facturación Fecha final de de validación de facturación, formato yyyy-MM-dd (2010-01-31) Fecha Si 36.(Cliente) Razón social o nombre completo Razón social o nombre completo Cadena de caracteres Si 37.(Cliente) Tipo persona Tipo persona Ver códigos Cadena de caracteres Si 1 38.(Cliente) Tipo de régimen Tipo de régimen Ver códigos Cadena de caracteres Si 2 39.(Cliente) Nombres Nombres Cadena de caracteres Si 40.(Cliente) Apellidos Apellidos Cadena de caracteres No 41.(Cliente) Número documento identificación Número documento identificación Cadena de caracteres Si 42.(Cliente) Dígito de verificación Dígito de verificación Cadena de caracteres Si 43.(Cliente) Tipo de identificación Tipo de identificación Ver códigos Cadena de caracteres Si 2 44.(Cliente) Email/correo electrónico Email/correo electrónico Cadena de caracteres No 45.(Cliente) Teléfono Teléfono Cadena de caracteres No 46.(Cliente) Registro mercantil Registro mercantil Cadena de caracteres No 47.(Cliente) Responsabilidades fiscales Responsabilidades fiscales Ver códigos Cadena de caracteres Si 48.(Cliente-Facturación) Dirección (Facturación) Dirección facturación Cadena de caracteres Si 49.(Cliente-Facturación) Nombre del país (Facturación) Nombre del país facturación Ver códigos Cadena de caracteres Si 50.(Cliente-Facturación) Código del país (Facturación) Código del país Ver códigos Cadena de caracteres Si 2 51.(Cliente-Facturación) Nombre de la región (Facturación) Nombre del departamento Ver códigos Cadena de caracteres Si 52.(Cliente-Facturación) Código de la región (Facturación) Código del departamento Ver códigos Cadena de caracteres No 2 53.(Cliente-Facturación) Nombre de la ciudad (Facturación) Nombre del municipio Ver códigos Cadena de caracteres Si 54.(Cliente-Facturación) Código de la ciudad (Facturación) Código del municipio Ver códigos Cadena de caracteres No 5 55.(Cliente-Facturación) Código postal (Facturación) Código postal Cadena de caracteres No 56.(Cliente-Facturacion) Barrio (Facturación) Barrio Cadena de caracteres No 57.(Cliente-Facturacion) Telefono (Facturación) Télefono Cadena de caracteres No 58.(Cliente-Facturacion) Nombre contacto (Facturación) Barrio Cadena de caracteres No 59.(Cliente-Datos-Entrega) Dirección (Datos-Entrega) Dirección facturación Cadena de caracteres Si 60.(Cliente-Datos-Entrega) Nombre del país (Datos-Entrega) Nombre del país facturación Ver códigos Cadena de caracteres Si 61.(Cliente-Datos-Entrega) Código del país (Datos-Entrega) Código del país Ver códigos Cadena de caracteres Si 2 62.(Cliente-Datos-Entrega) Nombre de la región (Datos-Entrega) Nombre del departamento Ver códigos Cadena de caracteres Si 63.(Cliente-Datos-Entrega) Código de la región (Datos-Entrega) Código del departamento Ver códigos Cadena de caracteres No 2 64.(Cliente-Datos-Entrega) Nombre de la ciudad (Datos-Entrega) Nombre del municipio Ver códigos Cadena de caracteres Si 65.(Cliente-Datos-Entrega) Código de la ciudad (Datos-Entrega) Código del municipio Ver códigos Cadena de caracteres No 5 66.(Cliente-Datos-Entrega) Código postal (Datos-Entrega) Código postal Cadena de caracteres No 67.(Cliente-Datos-Entrega) Barrio (Datos-Entrega) Barrio Cadena de caracteres No 68.(Cliente-Datos-Entrega) Teléfono Teléfono de entrega Cadena de caracteres No 69.(Cliente-Datos-Entrega) Nombre contacto Contacto para entrega al cliente Cadena de caracteres No 70.(Total) Subtotal sin impuestos ni retenciones Subtotal sin impuestos ni retenciones Numérico Si 71.(Total) Anticipos Anticipos Numérico Si 72.(Total) impuestos Impuestos Numérico Si 73.(Total) Retenciones Retenciones Numérico Si
### Detalle
Número de la columna y nombre del campo Descripción Códigos Tipo Este campo es requerido Ancho del campo Número de la columna y nombre del campo Descripción Códigos Tipo Este campo es requerido Ancho del campo 1.Tipo registro Debe ir "DTL" para indicar que es un detalle de factura Cadena de caracteres Si 3 2.Código ítem Indique el código del ítem, producto o servicio que esta facturando Cadena de caracteres Si 3.Nombre servicio/producto Nombre servicio/producto que esta facturando Cadena de caracteres Si 4.Modelo del producto o servicio Modelo del producto o servicio que esta facturando Cadena de caracteres No 5.Descripción de la venta Descripción de la venta Cadena de caracteres No 6.Marca del producto o servicio Marca del producto o servicio Cadena de caracteres No 7.Código del producto colocado por el proveedor Código del producto colocado por el proveedor Cadena de caracteres No 8.Es un regalo Es un regalo Booleano Si 9.Precio unitario Precio unitario Numérico Si 10.Cantidad Cantidad Numérico Si 11.Valor total de los descuentos aplicados Valor total de los descuentos aplicados Numérico No 12.Valor total de los cargos aplicados Valor total de los cargos aplicados Numérico No 13.(Descuento) Tipo valor Tipo valor Ver códigos Cadena de caracteres Si 1 14.(Descuento) Tarifa Tarifa Numérico Si 15.(Descuento) Valor Valor Numérico Si 16.(Cargos) Tipo valor Tipo valor Ver códigos Cadena de caracteres Si 1 17.(Cargos) Tarifa Tarifa, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual. Numérico Si 18.(Cargos) Valor Valor, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual Numérico Si 19.Impuestos Lista de impuestos separados por barra vertical "|" y valores separados por dos puntos ":", de la siguiente forma "Tipo Valor:Código impuesto: Tarifa impuesto:Valor Impuesto" Ejemplo: P:01:Iva:19:19000, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual, para el tipo de valor están las siguientes opciones: "V": Valor, "P": Porcentaje, "M": Por mil Ver códigos Numérico No 20.Retenciones Lista de retenciones separados por barra vertical "|" y valores separados por dos puntos ":", de la siguiente forma "Tipo Valor:Código impuesto: Tarifa impuesto:Valor Impuesto" Ejemplo: P:01:ReteIva:2:2000, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual, para el tipo de valor están las siguientes opciones: "V": Valor, "P": Porcentaje, "M": Por mil Ver códigos Numérico No 21.(Mandante) Nombre Nombre del mandante Cadena de caracteres No 22.(Mandante) Identificación Identificación Cadena de caracteres No 23.(Mandante) Dígito de verificación Dígito de verificación Cadena de caracteres No 24.(Mandante) Tipo de identificación Tipo de identificación Ver códigos Cadena de caracteres No
# Nota crédito
La estructura del archivo plano para una nota crédito es la siguiente:
### Encabezado
Campo Descripción Códigos Tipo Este campo es requerido Ancho del campo Campo Descripción Códigos Tipo Este campo es requerido Ancho del campo 1.Tipo registro Debe ir "INC" para indicar que es el encabezado de una nota crédito Cadena de caracteres Si 3 2.Concepto nota crédito Concepto nota crédito Ver códigos Cadena de caracteres Si 2 3.Formato pdf documento Formato pdf documento Ver códigos Cadena de caracteres Si 4.Prefijo nota crédito Campo (obsoleto) dejar vacío Cadena de caracteres Si 5.Consecutivo nota crédito Campo (obsoleto) no se debe diligenciar, debes llenar el prefijo de resolución para asignar prefijo a la nota Numérico Si 6.Número externo de las factura Consecutivo factura Numérico No 7.Tipo moneda Código tipo de moneda Ver códigos Cadena de caracteres No 3 8.TRM del día cuando la factura es en moneda extranjera TRM de los valores factura Numérico No 3 9.Fecha de expedición de la nota crédito Fecha en que expidió la nota crédito, formato yyyy-MM-dd (2010-01-31) Fecha Si 10 10.Fecha inicial del periodo de facturación Fecha inicio en que se inició el periodo a facturar, formato yyyy-MM-dd (2010-01-31) Fecha No 10 11.Fecha final del periodo de facturación Fecha fin en que se finaliza el periodo a facturar, formato yyyy-MM-dd (2010-01-31) Fecha No 10 12.Tipo de operación Tipo de operación Ver códigos Cadena de caracteres Si 2 13.Términos y condiciones Términos y condiciones del documento Cadena de caracteres No 800 14.Pie de página Pie de página Cadena de caracteres No 800 15.Nota / Observación Notas u observaciones del documento Cadena de caracteres No 800 16.(Factura) Prefijo de la factura Prefijo de la factura a la cual se le esta realizando la nota crédito Cadena de caracteres No 17.(Factura) Consecutivo de la factura Consecutivo de la factura a la cual se le esta realizando la nota crédito Cadena de caracteres No 18.(Factura) Cufe de la factura Cufe de la factura Cadena de caracteres No 19.(Factura) Fecha de la factura Fecha de la factura, formato yyyy-MM-dd (2010-01-31) Cadena de caracteres No 20.(Sucursal) Nombre Nombre de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres No 21.(Sucursal) Dirección Dirección de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres No 22.(Sucursal) Teléfono Teléfono de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres No 23.(Sucursal) Código país Código país de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres No 24.(Sucursal) Nombre país Nombre país de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres No 25.(Sucursal) Código departamento Código departamento de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres No 26.(Sucursal) Nombre departamento Nombre departamento de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres No 27.(Sucursal) Código ciudad Código ciudad de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres No 28.(Sucursal) Nombre ciudad Nombre ciudad de la sucursal para sobrescribir los datos de la empresa Cadena de caracteres No 29.(Resolución) Clave de la resolución Llave de la resolución proporcionada por la DIAN Cadena de caracteres Si 30.(Resolución) Prefijo de la resolución Prefijo con el que va a quedar la nota crédito Cadena de caracteres Si 31.(Resolución) Número de la resolución Número de la resolución proporcionado por DIAN Numérico Si 32.(Resolución) Rango inicial de facturación Rango inicial de facturación habilitado Numérico Si 33.(Resolución) Rango final de facturación Rango final de facturación habilitado Numérico Si 34.(Resolución) Fecha inicial de validación de facturación Fecha inicial de de validación de facturación, formato yyyy-MM-dd (2010-01-31) Fecha Si 35.(Resolución) Fecha final de validación de facturación Fecha final de de validación de facturación, formato yyyy-MM-dd (2010-01-31) Fecha Si 36.(Cliente) Razón social o nombre completo Razón social o nombre completo Cadena de caracteres Si 37.(Cliente) Tipo persona Tipo persona Ver códigos Cadena de caracteres Si 1 38.(Cliente) Tipo de régimen Tipo de régimen Ver códigos Cadena de caracteres Si 2 39.(Cliente) Nombres Nombres Cadena de caracteres Si 40.(Cliente) Apellidos Apellidos Cadena de caracteres No 41.(Cliente) Número documento identificación Número documento identificación Cadena de caracteres Si 42.(Cliente) Dígito de verificación Dígito de verificación Cadena de caracteres Si 43.(Cliente) Tipo de identificación Tipo de identificación Ver códigos Cadena de caracteres Si 2 44.(Cliente) Email/correo electrónico Email/correo electrónico Cadena de caracteres No 45.(Cliente) Teléfono Teléfono Cadena de caracteres No 46.(Cliente) Registro mercantil Registro mercantil Cadena de caracteres No 47.(Cliente) Responsabilidades fiscales Responsabilidades fiscales Ver códigos Cadena de caracteres Si 48.(Cliente-Facturación) Dirección (Facturación) Dirección facturación Cadena de caracteres Si 49.(Cliente-Facturación) Nombre del país (Facturación) Nombre del país facturación Ver códigos Cadena de caracteres Si 50.(Cliente-Facturación) Código del país (Facturación) Código del país Ver códigos Cadena de caracteres Si 2 51.(Cliente-Facturación) Nombre de la región (Facturación) Nombre del departamento Ver códigos Cadena de caracteres Si 52.(Cliente-Facturación) Código de la región (Facturación) Código del departamento Ver códigos Cadena de caracteres No 2 53.(Cliente-Facturación) Nombre de la ciudad (Facturación) Nombre del municipio Ver códigos Cadena de caracteres Si 54.(Cliente-Facturación) Código de la ciudad (Facturación) Código del municipio Ver códigos Cadena de caracteres No 5 55.(Cliente-Facturación) Código postal (Facturación) Código postal Cadena de caracteres No 56.(Cliente-Facturación) Barrio (Facturación) Barrio Cadena de caracteres No 57.(Cliente-Facturacion) Telefono (Facturación) Teléfono Cadena de caracteres No 58.(Cliente-Facturacion) Nombre contacto (Facturación) Nombre Contacto Cadena de caractere No 59.(Cliente-Datos-Entrega) Dirección (Datos-Entrega) Dirección facturación Cadena de caracteres Si 60.(Cliente-Datos-Entrega) Nombre del país (Datos-Entrega) Nombre del país facturación Ver códigos Cadena de caracteres Si 61.(Cliente-Datos-Entrega) Código del país (Datos-Entrega) Código del país Ver códigos Cadena de caracteres Si 2 62.(Cliente-Datos-Entrega) Nombre de la región (Datos-Entrega) Nombre del departamento Ver códigos Cadena de caracteres Si 63.(Cliente-Datos-Entrega) Código de la región (Datos-Entrega) Código del departamento Ver códigos Cadena de caracteres No 2 64.(Cliente-Datos-Entrega) Nombre de la ciudad (Datos-Entrega) Nombre del municipio Ver códigos Cadena de caracteres Si 65.(Cliente-Datos-Entrega) Código de la ciudad (Datos-Entrega) Código del municipio Ver códigos Cadena de caracteres No 5 66.(Cliente-Datos-Entrega) Código postal (Datos-Entrega) Código postal Cadena de caracteres No 67.(Cliente-Datos-Entrega) Barrio (Datos-Entrega) Barrio Cadena de caracteres No 68.(Cliente-Datos-Entrega) Teléfono Teléfono de entrega Cadena de caracteres No 69.(Cliente-Datos-Entrega) Nombre contacto Contacto para entrega al cliente Cadena de caracteres No 70.(Total) Subtotal sin impuestos ni retenciones Subtotal sin impuestos ni retenciones Numérico Si 71.(Total) Anticipos Anticipos Numérico Si 72.(Total) impuestos Impuestos Numérico Si 73.(Total) Retenciones Retenciones Numérico Si
### Detalle
Campo Descripción Códigos Tipo Este campo es requerido Ancho del campo Campo Descripción Códigos Tipo Este campo es requerido Ancho del campo 1.Tipo registro Debe ir "DTL" para indicar que es un detalle de factura Cadena de caracteres Si 3 2.Código ítem Indique el código del ítem, producto o servicio que esta facturando Cadena de caracteres Si 3.Nombre servicio/producto Nombre servicio/producto que esta facturando Cadena de caracteres Si 4.Modelo del producto o servicio Modelo del producto o servicio que esta facturando Cadena de caracteres No 5.Descripción de la venta Descripción de la venta Cadena de caracteres No 6.Marca del producto o servicio Marca del producto o servicio Cadena de caracteres No 7.Código del producto colocado por el proveedor Código del producto colocado por el proveedor Cadena de caracteres No 8.Es un regalo Es un regalo Booleano Si 9.Precio unitario Precio unitario Numérico Si 10.Cantidad Cantidad Numérico Si 11.Valor total de los descuentos aplicados Valor total de los descuentos aplicados Numérico No 12.Valor total de los cargos aplicados Valor total de los cargos aplicados Numérico No 13.(Descuento) Tipo valor Tipo valor Ver códigos Cadena de caracteres Si 1 14.(Descuento) Tarifa Tarifa Numérico Si 15.(Descuento) Valor Valor Numérico Si 16.(Cargos) Tipo valor Tipo valor Ver códigos Cadena de caracteres Si 1 17.(Cargos) Tarifa Tarifa, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual. Numérico Si 18.(Cargos) Valor Valor, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual Numérico Si 19.Impuestos Lista de impuestos separados por barra vertical "|" y valores separados por dos puntos ":", de la siguiente forma "Tipo Valor:Código impuesto: Tarifa impuesto:Valor Impuesto" Ejemplo: P:01:Iva:19:19000, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual, para el tipo de valor están las siguientes opciones: "V": Valor, "P": Porcentaje, "M": Por mil Ver códigos Numérico No 20.Retenciones Lista de retenciones separados por barra vertical "|" y valores separados por dos puntos ":", de la siguiente forma "Tipo Valor:Código impuesto: Tarifa impuesto:Valor Impuesto" Ejemplo: P:01:ReteIva:2:2000, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual, para el tipo de valor están las siguientes opciones: "V": Valor, "P": Porcentaje, "M": Por mil Ver códigos Numérico No 21.(Mandante) Nombre Nombre del mandante Cadena de caracteres No 22.(Mandante) Identificación Identificación Cadena de caracteres No 23.(Mandante) Dígito de verificación Dígito de verificación Cadena de caracteres No 24.(Mandante) Tipo de identificación Tipo de identificación Ver códigos Cadena de caracteres No
# Importar archivo plano
### Proceso de importación
El primer paso para subir un archivo plano es haber iniciado sesión en la plataforma de **ALIADDO ISV.**
Una vez hayas iniciado sesión deberás hacer lo siguiente para importar el archivo:
{% tabs %}
{% tab title="Factura" %}
1. Ve al panel izquierdo y selecciona **Importar Facturas**
2\. Esta es la pantalla de importación, descarga la plantilla de ejemplo inicialmente como se describe en la siguiente imagen.
A continuación veremos los puntos enumerados en la imagen anterior:
1. Da clic en este espacio para seleccionar las facturas a importar (Revisa que su estructura y sus datos estén perfectamente antes de este paso).
2. Selecciona si quieres crear las facturas que se encuentran en el archivo, o editar los registros que previamente han sido creados.
3. Ingresa el identificador del set de pruebas de la DIAN si es que estás importando facturas para hacer el proceso de habilitación.
4. Da clic en este botón para importar las facturas.
5. Aquí puedes consultar el histórico de las facturas importadas.
{% endtab %}
{% tab title="Nota débito" %}
1. Ve al panel izquierdo y selecciona **Importar Notas Débito.**
2\. Esta es la pantalla de importación, descarga la plantilla de ejemplo inicialmente como se describe en la siguiente imagen.
A continuación veremos los puntos enumerados en la imagen anterior:
1. Da clic en este espacio para seleccionar las notas débito a importar (Revisa que su estructura y sus datos estén perfectamente antes de este paso).
2. Selecciona si quieres crear las notas débito que se encuentran en el archivo, o editar los registros que previamente han sido creados.
3. Ingresa el identificador del set de pruebas de la DIAN si es que estás importando notas débito para hacer el proceso de habilitación.
4. Da clic en este botón para importar las notas débito.
5. Aquí puedes consultar el histórico de las notas débito importadas.
{% endtab %}
{% tab title="Nota crédito" %}
1. Ve al panel izquierdo y selecciona **Importar Notas Crédito.**
2\. Esta es la pantalla de importación, descarga la plantilla de ejemplo inicialmente como se describe en la siguiente imagen.
A continuación veremos los puntos enumerados en la imagen anterior:
1. Da clic en este espacio para seleccionar las notas crédito a importar (Revisa que su estructura y sus datos estén perfectamente antes de este paso).
2. Selecciona si quieres crear las notas crédito que se encuentran en el archivo, o editar los registros que previamente han sido creados.
3. Ingresa el identificador del set de pruebas de la DIAN si es que estás importando notas crédito para hacer el proceso de habilitación.
4. Da clic en este botón para importar las notas crédito.
5. Aquí puedes consultar el histórico de las notas crédito importadas.
{% endtab %}
{% endtabs %}
### Proceso de validación
Al enviar un archivo plano este entra en una cola de tareas en la que procesa dicho archivo para verificar su correcta composición, en caso de que el archivo esté correcto va a ser enviado a la DIAN para su posterior validación, si por otra parte el archivo tiene algún error, el sistema lo indicará de la siguiente forma:
Para ver los errores debes dar clic en **Ver Log**.
Se desplegará una lista con los errores detectados para que realices las correcciones respectivas.
