Manual de uso para conector de integración
Afacturar Electrónicamente
- Fecha de creación: 06/06/2018 18:36:00
- Última actualización: 08/08/2019
- Por: Teleinte
- Email: info@teleinte.com
Esta interfaz de programación es una API RESTful que se usa para entregar información a la plataforma Afacturar, en la cual se hacen las validaciones necesarias para poder procesar, construir y firmar documentos electrónicos que se entregarán a la DIAN, a los adquirientes (compradores) y a otras entidades si se requiere.
Para realizar una búsqueda puede usar el buscador del navegador (teclas Ctrl + F en Windows y Cmd + F en Mac).
Información General
Endpoints
Todas las llamadas a la API deben comenzar con la URL base para cada uno de los ambientes disponibles:
| Pruebas | https://servicios-pruebas.afacturar.com/api/vp/ |
| Habilitación | https://servicios-habilitacion.afacturar.com/api/vp/ |
| Producción | https://servicios.afacturar.com/api/vp/ |
RESTful
La API de Afacturar es RESTful.
Algunas consideraciones para tener en cuenta:
- La API utiliza Tokens para la autentificación
- Las peticiones de la API deben ser realizadas con peticiones GET o POST según el caso
- Puedes considerar todas las respuestas que no sean devueltas con un código HTTP 200 como un error.
- Todas las respuestas son devueltas en formato JSON
Categorías de la API
- Factura de venta (Factura Nacional)
- Nota crédito
- Nota débito
- Factura de contingencia
- Factura de mandato
- Transacciones
Interactuar con la API
Si quieres probar nuestra API de una manera rápida te recomendamos el uso de PostMan. Postman es una extensión de Google Chrome que permite interactuar con HTTP API's de forma sencilla a través de una interfaz amigable para construir peticiones y obtener respuestas.
| Lenguaje | HTTP client libraries |
|---|---|
| PHP | cURL |
| Python | urlLib2 + MultipartPostHandler |
Novedades (Releases)
2020-08-05
- Cambio en la documentación de los tipos de factura, según el anexo tecnico 1.7 - Resolución 042, para los documentos electronicos
2020-07-31
- Cambio en la documentación de las responsbilidades, según el anexo tecnico 1.7 - Resolución 042, para los documentos electronicos
2020-06-26
- Nueva versión del DLL, ....ver más
2020-06-16
- Nueva versión del DLL, ....ver más
2020-06-08
- Factura de contingencia: En el grupo detalle_factura, adición de marca, modelo y codificacion_estandar, ....ver más
- Factura de mandato: En el grupo detalle_factura, adición de marca, modelo y codificacion_estandar, ....ver más
- Nota crédito: En el grupo detalle_factura, adición de marca, modelo y codificacion_estandar, ....ver más
- Nota débito: En el grupo detalle_factura, adición de marca, modelo y codificacion_estandar, ....ver más
2020-06-02
- Factura nacional: En el grupo detalle_factura, adición de marca, modelo y codificacion_estandar, ....ver más
Especificaciones técnicas
Los tipo de datos que son parametrizados deben ser los que estan en las listas correspondientes
- moneda
- tipo_factura
- metodo_de_pago
- tipo_de_pago
- tipo_contribuyente
- tipo_regimen
- tipo_identificacion
- pais
- departamento
- ciudad
- resp_calidades_atributos
- usuario_aduanero
- unidad_de_cantidad
- cod_precio_referencia
- impuestos_detalle -> codigo_impuesto
- retenciones_detalle -> codigo
- impuestos -> codigo_impuesto
- impuestos -> porcentaje_impuesto
- retenciones -> codigo
- codigo_descuento
- tipo_ambiente_dian
Un documento puede tener descuento a nivel de documento o nivel de detalle no los dos al tiempo
Un documento puede tener recargos a nivel de documento o nivel de detalle no los dos al tiempo
Un documento puede tener retenciones a nivel de documento o nivel de detalle no los dos al tiempo
Los valores calculados se deben enviar con dos decimales realizando el redondeo
Especificación detallada de las limitaciones que se deben tener en cuenta para validación previa
| Json | Descripción |
|---|---|
| Facturas->encabezado->id_factura |
|
| Facturas->encabezado->fecha | La fecha del documento no debe ser menor de 36 horas a la fecha actual |
| Facturas->encabezado->numero_resolucion_facturacion | La numeración de la factura debe estar registrada en SOFE. |
| Facturas->encabezado->fecha_vencimiento | Si el metodo de pago es crédito la fecha de vencimiento es obligatoria |
| Facturas->informacion_adquiriente->nombre | Si el tipo de contribuyente es persona juridica, la razon social es obligatoria.
Si el tipo de contr es persona natural, el primer nombre y los apellidos son obligatorios |
| Facturas->informacion_adquiriente->departamento | Si el pais es CO, el departamento debe ser de los de la lista de parametrización |
| Facturas->informacion_adquiriente->ciudad | Si el pais es CO, el código de la ciudad depende del departamento selecciona, debe ser de los de la lista de parametrización |
| Facturas->informacion_adquiriente->nombre | Si el tipo de contribuyente es persona juridica, la razon social es obligatoria.
Si el tipo de contr es persona natural, el primer nombre y los apellidos son obligatorios |
| Facturas->detalle_factura->numero_linea |
|
| Facturas->detalle_factura->cargo_descuento->valor_cargo_descuento | Se valida la operacion ((porcentaje_cargo_descuento * valor_base_cargo_descuento)/100), si los campos estan diligenciados |
| Facturas->detalle_factura->impuestos_detalle->valor_impuesto | Se valida la operacion ((porcentaje_impuesto * valor_base_impuesto)/100) |
| Facturas->detalle_factura->retenciones_detalle->valor_retenido | Se valida la operacion ((porcentaje * valor_base)/100) |
| Facturas->detalle_factura->valor_total_detalle_con_cargo_descuento |
|
| Facturas->detalle_factura->valor_total_detalle |
|
Factura Nacional
Especificación detallada para recibir información de factura para ser procesadas en la plataforma
Histórico de cambios
| Versión | Cambios | Fecha de liberación |
|---|---|---|
| 2.6 | En la variable detalle_factura se adiciono las variables marca, modelo y codificacion_estandar. Estas variables se utilizan para tener mas información de los productos y/o servicios, permitiendo a los clientes codificar productos y servicios de forma clara, basandose en estándares acordados por la industria los cuales facilitan el comercio entre empresas y gobierno | 02 de junio de 2020 |
| 2.5 | En la variable informacion_adquiriente -> correo_electronico permitir varias direcciones de correo. Se debe tener en cuenta que la primera dirección de correo es la utilizada para el envio de la notificación al adquiriente. | 08 de mayo de 2020 |
| 2.4 |
Se adiciono la variable nota_detalle en el objeto detalle_factura, para colocar información adicional al detalle y para cumplir con un requisito de facturas AUI, para ello en los detalles en el item de Admistración, en la descripción se debe enviar la palabra clave ADMINISTRACION y en la variable nota_detalle el objeto del contrato.
Ejemplo: |
24 de marzo de 2020 |
| 2.3 | Los PDFs que se reciben en base64 se adiciono en generalidades -> rg_px_cufe y rg_px_qr, la opción de mostrar_en, para indicar si el QR y el CUFE/CUDE debe pintarse en la primera pagina o en todas. | 05 de Marzo de 2020 |
| 2.2 |
Se agregó el nombre del país, departamento y ciudad para mostrar en la representación gráfica.
El tipo de pago ZZZ se cambio por -999 para validar datos tipo numérico como dato de entrada. |
16 de Octubre de 2019 |
| 2.1 | Adición de variables. Cambio de nombre de variables que sean legibles. | 27 de Agosto de 2019 |
| 2 | Ajustes de validación previa | 09 de Agosto de 2019 |
POST
/factura_nacional
documento_obligado:
000000000
testSetId:
Número entregado en la DIAN para la Habilitación.
Este parametro es soló para habilitación.
data:
{
"facturas": [{
"encabezado": {
"id_factura": "",
"fecha": "",
"hora": "",
"nota": ["{'':'','':'','':'','':'','':'','':''}"],
"moneda": "",
"tipo_factura": #,
"metodo_de_pago": ##,
"tipo_de_pago": ##,
"identificador_de_pago": "",
"numero_resolucion_facturacion": "",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": ""
},
"periodo_facturacion":{
"fecha_inicio":"",
"fecha_fin":"",
},
"cambio_de_moneda":{
"fecha_cambio":"",
"codigo":"",
"valor_base_trm":"0.00"
},
"informacion_adquiriente": {
"tipo_contribuyente": #,
"tipo_regimen": #,
"tipo_identificacion":#,
"identificacion": ""
"correo_electronico": "",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "",
"nombre_pais": "",
"departamento": "",
"nombre_departamento": "",
"zona": "",
"ciudad": "",
"nombre_ciudad": "",
"direccion": "",
"RUT": {
"resp_calidades_atributos": ["",""],
"usuario_aduanero": [""]
}
},
"detalle_factura": [{
"numero_linea": #,
"cantidad": #,
"unidad_de_cantidad":"" ,
"valor_unitario": "0.00",
"descripcion": "",
"nota_detalle": "",
"marca": "",
"modelo": "",
"codificacion_estandar": {
"cod_grupo_bien_servicio": "",
"nombre_grupo_bien_servicio": "",
"cod_segmento_bien_servicio": "",
"cod_bien_servicio": ""
},
"regalo": {
"es_regalo": "",
"cod_precio_referencia": #,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": "",
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": #,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [{
"codigo": #,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}],
"valores_unitarios":{
"valor_descuento":"0.00",
"valor_con_descuento":"0.00",
"valor_impuesto_1":"0.00",
"valor_impuesto_2":"0.00",
"valor_impuesto_3":"0.00",
"valor_impuesto_4":"0.00",
"valor_reteiva":"0.00",
"valor_retefuente":"0.00",
"valor_reteica":"0.00",
"valor_a_pagar":"0.00"
},
"valor_total_detalle_con_cargo_descuento": "0.00",
"valor_total_detalle": "0.00"
}],
"impuestos": [{
"codigo_impuesto": #,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "0.00",
"valor_total_impuesto": "0.00"
}],
"retenciones":[{
"codigo": #,
"porcentaje":"0.00",
"valor_base":"0.00",
"valor_retenido":"0.00"
}],
"recargos": [{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}],
"descuentos": [{
"codigo_descuento": #,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}],
"valor_factura": {
"valor_base": "0.00",
"valor_base_calculo_impuestos": "0.00",
"valor_base_mas_impuestos"": "0.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "0.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "0.00",
"valor_total_a_pagar": "0.00"
}
}],
"generalidades": {
"tipo_ambiente_dian": #,
"version": #,
"identificador_transmision": "",
"rg_tipo":"",
"rg_base_64":"",
"rg_px_qr": {
"x":"",
"y":"",
"size":"",
"mostrar_en":""
},
"rg_px_cufe": {
"x":"",
"y":"",
"size":"",
"mostrar_en":""
},
"rg_url_pdf_propio":"",
"notificacion": {
"es_automatico":"",
"correo_obligado":"",
"asunto":"",
"con_copia":""
},
"integrador": {
"nombre":"",
"tipo":"",
"webhook": ""
}
}
}
encabezado
id_factura
Descripción:
Número de documento: Número de factura o factura cambiaria. Consecutivo de factura autorizados por la DIAN
Tipo de dato:
String
Especificaciones:
No se permiten caracteres adicionales como espacios o guiones.
Obligatorio:
Si
fecha
Descripción:
Fecha de emisión de la factura a efectos fiscales.
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Si
hora
Descripción:
Hora de emisión de la factura
Tipo de dato:
Time
Especificaciones:
HH24:MM:SS
Obligatorio:
Si
nota
Descripción:
Las notas se van a distribuir en un formato similar a JSON, en el cual se cambia la comilla doble por sencilla, tanto en el nombre de la variable, como en su valor, esto debido a la restricción de algunos caracteres especiales que no son soportados en este campo.
Este JSON termina siendo un STRING que se debe enviar dividido en las posiciones del array de nota, de acuerdo con las restricciones que defina la DIAN:
A la fecha (2019-01-11) existe una restricción de enviar como mínimo 15 caracteres(*)
La estructura a utilizar es:
{'variable_1': 'valor_1', 'variable_2':'valor_2'}Ejemplos:
Enviar valores nulos o vacíos
nota[0] = "{‘variable_1': 'null', 'variable_2':'valor_2', 'variable_3':''}"
División del STRING en varias posiciones del array
nota[0] = "{‘variable_1': 'null', 'variab"
nota[1] = "le_2':'valor_2', 'variable_3':''}"
El API genera la concatenación del STRING y lo convierte a formato JSON y realiza la respectiva validación.
Hay que tener en cuenta que los caracteres (comilla sencilla, backslash, backslash comilla sencilla ) no se deben enviar, porque no son soportados en el API.
Si alguna variable es diferente a las del listado de especificaciones, se debe consultar con el personal de operación de Teleinte S.A.S, para realizar la respectiva validación, y en caso que no exista una variable, se estudiará el caso para determinar la adición o no de la variable que cumpla con la descripción requerida.
(*) Estas restricciones pueden cambiar en cualquier momento por parte de la DIAN, de acuerdo al nuevo proceso que estandarización y validación que están estableciendo.
Tipo de dato:
Array
Especificaciones:
El listado de la estandarización de las variables se puede ver aqui
Obligatorio:
Si
moneda
Descripción:
Divisa aplicable a toda la factura
Tipo de dato:
Parametrizado
Especificaciones:
COP- Colombia, USD - dolares. Inf adicional Ver
Obligatorio:
Si
tipo_factura
Descripción:
Tipo de Factura
Tipo de dato:
Parametrizado
Especificaciones:
9= Servicios AIU
10= Estandar
Obligatorio:
Si
metodo_de_pago
Descripción:
Método de pago
Tipo de dato:
Parametrizado
Especificaciones:
1 = Contado
2 = Crédito
Obligatorio:
Si
tipo_de_pago
Descripción:
Código correspondiente al medio de pago
Tipo de dato:
Parametrizado
Obligatorio:
Si
identificador_de_pago
Descripción:
Identificador de pago o número de referencia de pago
Tipo de dato:
String
Especificaciones:
Obligatorio:
No
numero_resolucion_facturacion
Descripción:
Número del código de la resolución otorgada para la numeración. Debe corresponder a un número de autorización del contribuyente emisor
Tipo de dato:
String
Especificaciones:
18 caracteres
Obligatorio:
Si
fecha_vencimiento
Descripción:
Fecha de vencimiento. Obligatorio si el método de pago es crédito
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
No
numero_orden
Descripción:
Número de orden
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
prefijo
Descripción:
Prefijo de la resolución registrado para la numeración.
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si
informacion_adquiriente
tipo_contribuyente
Descripción:
Tipo de identificación Tributaria o similar de la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
1= Persona juridica
2= Persona natural
Obligatorio:
Si
tipo_regimen
Descripción:
Régimen al que pertenece la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
0= Simplificado
2= Común
Obligatorio:
Si
tipo_identificacion
Descripción:
Tipo de documento de identificación de la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
11= Registro civil
12= Tarjeta de identidad
13= Cedula ciudadania
21= Tarjeta de extranjería
22= Cedula de extranjería
31= NIT
41= Pasaporte
42= Documento de identificación extranjero
Obligatorio:
Si
identificacion
Descripción:
Número completo de la identificación de la empresa o persona
Tipo de dato:
String
Especificaciones:
Alfanumérico
Obligatorio:
Si
correo_electronico
Descripción:
Lista de direcciones de correo electronico, separadas por punto y coma ';'. Para el envio de las notificaciones al adquiriente se va tomar la primera dirección de correo.
Tipo de dato:
Especificaciones:
xxxx@xx.xx;yyyy@yy.yy
Obligatorio:
Si
numero_movil
Descripción:
Número de móvil para el envio de notificaciones
Tipo de dato:
String
Especificaciones:
3111111111
Obligatorio:
No
nombre
Descripción:
Nombre comercial del emisor
Tipo de dato:
array
Especificaciones:
Depende del tipo de contribuyente.
Persona juridica {razon_social}.
Persona natural {primer_nombre, segundo_nombre, apellidos}
Obligatorio:
Si
razon_social
Descripción:
Nombre comercial
Tipo de dato:
Alfanumérico
Especificaciones:
Opcional dependiendo el tipo de contribuyente. Si es NIT es obligatorio
Obligatorio:
Si es persona juridica
primer_nombre
Descripción:
Primer nombre
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si es persona natural
segundo_nombre
Descripción:
Segundo nombre
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
apellido
Descripción:
Apellidos
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si es persona natural
pais
Descripción:
Código dentificador del país. Código alfa-2 asignado al pais
Tipo de dato:
Parametrizado
Especificaciones:
Estandar ISO 3166-1. Inf adicional Ver
Obligatorio:
Si
nombre_pais
Descripción:
Nombre del país.
Tipo de dato:
String
Especificaciones:
Estandar ISO 3166-1. Inf adicional Ver
Obligatorio:
No
departamento
Descripción:
Codigo del departamento, son las subdivisiones administrativas del país (CO). Fue publicada en 1998 y actualizada por última vez en el sexto boletín de la primera edición en 2004.
Si no corresponde a Colombia debe ir el nombre de la ciudad o estado
Tipo de dato:
Parametrizado
Especificaciones:
ISO 3166-2:CO. Inf adicional Ver
Obligatorio:
Si
nombre_departamento
Descripción:
Nombre del departamento
Tipo de dato:
String
Especificaciones:
ISO 3166-2:CO. Inf adicional Ver
Obligatorio:
No
ciudad
Descripción:
Código del municipio ó ciudad ó subdivisión de tercer nivel.
Tipo de dato:
Parametrizado
Especificaciones:
Inf adicional Ver
Obligatorio:
Si
nombre_ciudad
Descripción:
Nombre del municipio ó ciudad ó subdivisión de tercer nivel.
Tipo de dato:
String
Especificaciones:
Inf adicional Ver
Obligatorio:
No
zona
Descripción:
Nombre de la subdivisión de la ciudad
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
direccion
Descripción:
Elemento de texto libre, que el emisor puede elegir utilizar para poner toda la información de la dirección
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 10 caracteres
Obligatorio:
Si
RUT
Descripción:
Información del RUT - Registro Unico Tributario. Responsabilidades, Calidades y Atributos, numeral 53 y Usuarios aduaneros, numeral 54.
Tipo de dato:
array
Especificaciones:
Parametrizable
Obligatorio:
Si
resp_calidades_atributos
Descripción:
Lista de codigos de las responsabilidades, calidades y atributos registrados en el RUT, numeral 53
Tipo de dato:
Array
Especificaciones:
Parametrizado.Inf adicional Ver
Obligatorio:
Si
usuario_aduanero
Descripción:
Lista de codigos usuarios aduaneros registrados en el RUT, numeral 54
Tipo de dato:
Array
Especificaciones:
Vacio
Obligatorio:
No
detalle_factura
numero_linea
Descripción:
Número de Línea
Tipo de dato:
Numerico
Especificaciones:
1...n
Obligatorio:
Si
cantidad
Descripción:
(Cant) Cantidad de productos o servicios solicitados. Número de unidades servidas/prestadas.
Tipo de dato:
Numerico
Especificaciones:
...n
Obligatorio:
Si
unidad_de_cantidad
Descripción:
Unidad de la cantidad del artículo solicitiado
Tipo de dato:
Parametrizado
Obligatorio:
Si
valor_unitario
Descripción:
(VU) Es el precio por unidad de cada bien o servicio antes de aplicar los impuestos o descuento. El valor base es el precio de un activo fijo a efectos impositivos. El valor base es el precio base de un activo sobre el cual se calcula la depreciación y la amortización
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
descripcion
Descripción:
Descripción del artículo o servicio a que se refiere esta línea de la factura
Tipo de dato:
Alfanumérico
Especificaciones:
Mínimo de 2 caracteres
Obligatorio:
Si
nota_detalle
Descripción:
Información adicional: Texto libre, relativo al documento. Para el caso de facturas por contratos de servicio tipo AIU, se debe enviar incluir el objeto del contrato facturado
Tipo de dato:
Alfanumérico
Especificaciones:
Mínimo de 2 caracteres
Obligatorio:
Si
marca
Descripción:
Marca: Marca del artículo
Tipo de dato:
String
Especificaciones:
Obligatorio:
Si
modelo
Descripción:
Modelo: Modelo del artículo
Tipo de dato:
String
Especificaciones:
Obligatorio:
Si
codificacion_estandar
Descripción:
Identificación del producto o servicio de acuerdo con un estandar acordado por la industria, los cuales facilitan el comercio entre empresas y gobierno.
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
cod_grupo_bien_servicio
Descripción:
Tipo de estandar de codificación utilizado para la clasificación de los productos o servicios.
UNSPSC - United Nations Standard Products and Services Code® - Código Estándar de Productos y Servicios de Naciones Unidas. Ver documentación
GTIN - Números Globales de Identificación de Productos.Estructura de los códigos GTIN:
999 - Códigos libres o autónomosCorresponden a la codificación que las empresas cuentan en sus sistemas para la identificación inequívoca de los bienes o servicios que prestan.
Tipo de dato:
Parametrizado
Especificaciones:
1 -> UNSPSC
10 -> GTIN
20 -> Partida Arancelarias
999 -> Estándar de adopción del contribuyente
Obligatorio:
Si
nombre_grupo_bien_servicio
Descripción:
Nombre de la codificación utilizada para la clasificación de los productos o servicios
Tipo de dato:
Parametrizado
Especificaciones:
UNSPSC -> 1
GTIN -> 10
Partida Arancelarias -> 20
Estándar de adopción del contribuyente -> 999
Obligatorio:
Si
cod_segmento_bien_servicio
Descripción:
Codigo del segmento.
Tipo de dato:
String
Especificaciones:
Dependen del grupo del bien o servicio. Información adicional Ver
Obligatorio:
Si
cod_bien_servicio
Descripción:
Codigo del bien o servicio
Tipo de dato:
String
Especificaciones:
Dependen del segmento del bien o servicio. Información adicional Ver
Obligatorio:
Si
regalo
Descripción:
Indicador de si el ítem es gratuito o no
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
es_regalo
Descripción:
Describe si el articulo es un regalo o muestra comercial
Tipo de dato:
Boolean
Especificaciones:
true o false
Obligatorio:
Si
cod_precio_referencia
Descripción:
Código del tipo de precio informado
Tipo de dato:
Parametrizado
Especificaciones:
1 = Valor comercial
2 = Valor en inventarios
3 = Otro valor
0 = En el caso que no sea regalo
Obligatorio:
Si
precio_referencia
Descripción:
Precio de referencia para línea que no contienen valor comercial.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
cargo_descuento
Descripción:
Información relacionada con un cargo o un descuento
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
es_descuento
Descripción:
Indica que el elemento es un Cargo y no un descuento
Descuento es true cuando es un descuento, un Crédito descuenta el valor del ítem
Cargo es false cuando es un recargo, es un Débito aumenta el valor del item.
Tipo de dato:
Boolean
Especificaciones:
True o false
Obligatorio:
Si
porcentaje_cargo_descuento
Descripción:
Porcentaje de descuento o cargo a la linea de la factura
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_cargo_descuento
Descripción:
Valor Base para calcular el descuento o el cargo
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_cargo_descuento
Descripción:
Valor del descuento o el cargo
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
impuestos_detalle
Descripción:
Información relacionada con el impuesto aplicado a la linea de detalle
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
codigo_impuesto
Descripción:
Identificador del tributo
Tipo de dato:
Parametrizado
Especificaciones:
1= IVA
2= Impuesto al consumo
3= ICA
4= Impuesto nacional al consumo
0= Excluido de IVA
Obligatorio:
Si
porcentaje_impuesto
Descripción:
Tarifa del tributo. Porcentaje del valor tributable a ser aplicada a la base imponible de la linea de detalle. Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base_impuesto
Descripción:
(VU-VD)*Cant). Base Imponible sobre la que se calcula el valor del tributo. Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_impuesto
Descripción:
(((VU-VD)*Cant) * %Imp). Valor del tributo: producto del porcentaje aplicado sobre la base imponible.Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
retenciones_detalle
Descripción:
Información relacionada con los tributos retenidos en la linea de detalle
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
codigo
Descripción:
Identificador de las retenciónes
Tipo de dato:
Parametrizado
Especificaciones:
5= ReteIVA
6= ReteFuente
7= ReteICA
0= No tiene retenciónes
Obligatorio:
Si
porcentaje
Descripción:
Tarifa del tributo retenido. Porcentaje del valor tributable retenido a ser aplicada a la base imponible de la linea de detalle.
Tipo de dato:
Parametrizado ReteFuente - ReteIVA
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base
Descripción:
La base gravable es el valor sobre el cual se aplica la tarifa de la retención
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_retenido
Descripción:
Valor del tributo: producto del porcentaje aplicado sobre la base imponible
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valores_unitarios
Descripción:
Información relacionada con el valor por producto de la linea de detalle, los datos recibidos son utilizados para la representación grafica cuando sea necesario
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
valor_descuento
Descripción:
Valor del descuento aplicado a un producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_con_descuento
Descripción:
Valor del producto aplicando el descuento de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_1
Descripción:
Valor de la base imponible (IVA) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_2
Descripción:
Valor de la base imponible (Impuesto al consumo) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_3
Descripción:
Valor de la base imponible (ICA) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_4
Descripción:
Valor de la base imponible (Impuesto nacional al consumo) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_reteiva
Descripción:
Valor retenido de Reteiva del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_retefuente
Descripción:
Valor retenido de Retefuente del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_reteica
Descripción:
Valor retenido de Reteica del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_a_pagar
Descripción:
Valor total del producto de la linea de detalle, incluyendo descuentos, retenciónes e impuestos
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_total_detalle_con_cargo_descuento
Descripción:
(((VU * Cant)- VD)+VR). Valor total de la linea de detalle incluyendo el descuento y el recargo si aplica
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_detalle
Descripción:
(VU*Cant). Valor total de la linea de detalle sin incluir descuentos, retenciónes o impuestos.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
impuestos
codigo_impuesto
Descripción:
Es la clase que se utiliza para describir el esquema del impuesto
Tipo de dato:
Parametrizado
Especificaciones:
01= IVA
02= Impuesto al consumo
03= ICA
04= Impuesto nacional al consumo
0= Excluido de IVA
Obligatorio:
Si
porcentaje_impuesto
Descripción:
Número de importe del impuesto retenido. Si hay algun item excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base_calculo_impuesto
Descripción:
Base Imponible sobre la que se calcula la retención de impuesto. Si hay algun item excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto
Descripción:
Importe del impuesto retenido. Si hay algun item excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
retenciones
codigo
Descripción:
Identificador de las retenciónes
Tipo de dato:
Parametrizado
Especificaciones:
5= ReteIVA
6= ReteFuente
7= ReteICA
0= No tiene retenciónes
Obligatorio:
No
porcentaje
Descripción:
Importe del impuesto retenido al total de la factura
Tipo de dato:
Parametrizado ReteFuente - ReteIVA
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
No
valor_base
Descripción:
La base gravable es el valor sobre el cual se aplica la tarifa de la retención
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_retenido
Descripción:
Valor total de la retención por factura
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
recargos
nombre_recargo
Descripción:
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
porcentaje_recargo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_base_calculo_recargo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_total_recargo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
descuentos
codigo_descuento
Descripción:
Numero utilizado para categorizar el tipo de descuento otorgado
Tipo de dato:
Parametrizado
Especificaciones:
00= Descuento por impuesto asumido
01= Pague uno lleve otro02= Descuentos contractulales
03= Descuento por pronto pago
04= Envío gratis
05= Descuentos escpecíficos por inventarios
06= Descuento por monto de compras
07= Descuento de temporada
08= Descuento por acturalización de productos / servicios
09= Descuento general
10= Descuento por volumen
11= Otro descuento
99= No aplica descuento
Obligatorio:
Si
porcentaje_descuento
Descripción:
Número del descuento
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_calculo_descuento
Descripción:
Valor Base para calcular el descuento
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_descuento
Descripción:
Valor total del descuento
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_factura
valor_base
Descripción:
Total Valor Bruto antes de tributos: Total valor bruto, suma de los valores brutos de las líneas de la factura incluyendo descuentos mas recargos, es decir la suma de todas las lineas de detalle de los valor_total_detalle_con_cargo_descuento.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_calculo_impuestos
Descripción:
Total Valor Base Imponible : Base imponible para el cálculo de los tributos
tiene que ser la suma de los valores de las bases imponibles de todas líneas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_mas_impuestos
Descripción:
Total de Valor Bruto más tributos
El Valor Bruto más tributos tiene que ser igual 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.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_anticipo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_descuento_total
Descripción:
Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
El Valor del Descuento Total es igual a la Suma de todos los descuentos globales aplicados al total de la factura.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_1
Descripción:
Suma de todos los impuestos 1 aplicados a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_2
Descripción:
Suma de todos los impuestos 2 aplicados a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_3
Descripción:
Tipo de dato:
Suma de todos los impuestos 3 aplicados a nivel de las lineas de detalle
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_4
Descripción:
Tipo de dato:
Suma de todos los impuestos 4 aplicados a nivel de las lineas de detalle
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_reteiva
Descripción:
Suma de todos los reteiva a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_retefuente
Descripción:
Suma de todos los retefuente a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_reteica
Descripción:
Suma de todos los reteica a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_factura
Descripción:
Valor Total de factura: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems)+valor de impuestos + valor cargos – valor descuentos – valor anticipos
El Valor a total de Factura es igual a la Suma de Valor Bruto más tributos - Valor del Descuento Total + Valor del Cargo Total - Valor del Anticipo Total
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_a_pagar
Descripción:
Valor total a pagar: El valor a total de factura es igual a la suma de valor bruto + impuestos - retenciónes - valor del descuento total + valor del cargo total - valor del anticipo total
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
generalidades
tipo_ambiente_dian
Descripción:
Ambiente de la DIAN al que se destina el documento enviado.
Tipo de dato:
Parametrizable
Especificaciones:
1= Producción
2= Pruebas
Obligatorio:
Si
version
Descripción:
Identificación consecutiva de la especificación
Tipo de dato:
Decimal
Especificaciones:
Obligatorio:
Si
identificador_transmision
Descripción:
Código único para identificar el paquete transmitido
Tipo de dato:
Alfanumérico
Especificaciones:
Obligatorio:
Mínimo 5 caracteres
rg_base_64
Descripción:
Pdf del documento elecronico en base 64
Tipo de dato:
Alfanumérico
Especificaciones:
Obligatorio:
Mínimo 5 caracteres
rg_tipo
Descripción:
Si se envia rg_base_64, identificar si el tipo de archivo es HTML o PDF. Si el ERP se encarga de generar el PDF incluyendo el QR y el CUFE, se debe identificar como PDF_PROPIO
Tipo de dato:
Parametrizable
Especificaciones:
HTML
PDF
PDF_PROPIO
Obligatorio:
Si hay información en rg_base_64 debe ir HTML o PDF
rg_px_qr
Descripción:
Información para ubicar el QR dentro del documento envido en base 64
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si se envia el rg_base_64
x
Descripción:
Posicionamiento en x dentro de la representación grafica
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en x desde la posición (0,0)
Obligatorio:
No
y
Descripción:
Posicionamiento en y dentro de la representación grafica
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en y desde la posición (0,0)
Obligatorio:
No
size
Descripción:
Tamaño del qr
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
mostrar_en
Descripción:
Identificador de si el QR en el PDF se pinta en la primera pagina o en todas
Tipo de dato:
Parametrizable
Especificaciones:
PRIMERA_PAGINA,TODAS
Obligatorio:
No
rg_px_cufe
Descripción:
Información de configuración de CUFE en la representación grafica
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si se envia el rg_base_64
x
Descripción:
Posicionamiento en x(abscisas) en el plano cartesiano en el cuarto cuadrante, es decir las columnas empezando de 0.
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en x desde la posición (0,0)
Obligatorio:
No
y
Descripción:
Posicionamiento en y(ordenadas) en el plano cartesiano en el cuarto cuadrante, es decir las filas empezando de 0.
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en y desde la posición (0,0)
Obligatorio:
No
size
Descripción:
Tamaño de la letra
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
mostrar_en
Descripción:
Identificador de si el CUFE/CUDE en el PDF se pinta en la primera pagina o en todas
Tipo de dato:
Parametrizable
Especificaciones:
PRIMERA_PAGINA,TODAS
Obligatorio:
No
rg_url_pdf_propio
Descripción:
Si en rg_tipo esta definido como PDF_PROPIO, se debe enviar la URL donde esta alojado el pdf generado por el integrador en su infraestructura, garantizando que ésta sea de acceso público.
Tipo de dato:
String
Especificaciones:
URL
Obligatorio:
Si rg_tipo es igual a PDF_PROPIO
notificacion
Descripción:
Información de configuración de envio de notificaciones. Los campos de notificación son obligatorios en caso que sea de forma automatica.
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
es_automatico
Descripción:
Indicar si la notificación es enviada de forma automatica
Tipo de dato:
Parametrizado
Especificaciones:
S o N
Obligatorio:
No
correo_obligado
Descripción:
Dirección de correo del obligado
Tipo de dato:
Especificaciones:
xxx@xx.xxx
Obligatorio:
No
asunto
Descripción:
Texto para el envio de las notificaciones
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
con_copia
Descripción:
Tamaño de la letra
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
integrador
Descripción:
Información de quien envia la información
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
nombre
Descripción:
Nombre de quien realiza la integración
Tipo de dato:
Parametrizado
Especificaciones:
S o N
Obligatorio:
Si
tipo
Descripción:
Codigo del medio usado para realizar la integración
Tipo de dato:
Parametrizado
Especificaciones:
MOVIL
WEB
DLL
EXCEL
ERP-XXXXXXXXX
Obligatorio:
Si
webhook
Descripción:
URL para notificar cuando ha ocurrido un evento. Esta se utiliza cuando los codigos de error del retorno del API son 28,20.
Tipo de dato:
String
Especificaciones:
URL con portocolo de seguridad - HTTPS
Obligatorio:
No
cambio_de_moneda
fecha_cambio
Descripción:
Fecha del cambio de la moneda.
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Si la moneda de origen es diferente de COP
codigo
Descripción:
La moneda de referencia para el tipo de cambio; La moneda a partir de la cual se realiza el cambio.
Tipo de dato:
Parametrizado
Especificaciones:
COP- Colombia, USD - dolares. Inf adicional Ver
Obligatorio:
Si la moneda de origen es diferente de COP
valor_base_trm
Descripción:
Tasa de cambio del día de emisión o expedición del documento.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si la moneda de origen es diferente de COP
periodo_facturacion
fecha_inicio
Descripción:
Periodo de Facturación: Intervalo de fechas a las que referencia la factura, por ejemplo servicios públicos, contratos de arrendamiento, matriculas en educación, etc. Fecha de inicio del periodo de facturación
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Opcional, si se utiliza es obligatorio
fecha_fin
Descripción:
Periodo de Facturación: Intervalo de fechas a las que referencia la factura, por ejemplo servicios públicos, contratos de arrendamiento, matriculas en educación, etc. Fecha de fin del periodo de facturación
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Opcional, si se utiliza es obligatorio
- Ejemplo 1. Factura con un detalle de cantidad un e impuesto del 19%
- Ejemplo 2. Factura con varios detalles de cantidad uno y con diferentes impuestos de IVA e impuesto nacional al consumo
- Ejemplo 3. Factura con varios detalles con cantidad mayor que uno y con diferentes impuestos de IVA, ICA, impuesto nacional al consumo
- Ejemplo 4. Factura con un detalle exento de IVA y otros detalles con impuestos
- Ejemplo 5. Factura con adquiriente persona natural
- Ejemplo 6. Factura con descuento a nivel de detalles
- Ejemplo 7. Factura con descuento a nivel de la factura
- Ejemplo 8. Factura con retenciones a nivel de la factura - RETEIVA
- Ejemplo 9. Factura con retenciones a nivel de detalle de la factura - RETEIVA, RETEFUENTE
- Ejemplo 10. Factura con un detalle como regalo
- Ejemplo 11. Factura AIU
- Ejemplo 12. Factura AIU con retenciones
- Ejemplo 13. Factura con recargos a nivel de factura
- Ejemplo 14. Factura con recargos a nivel de detalle de factura
- Ejemplo 15. Factura con varios recargos
- Ejemplo 16. Factura con moneda diferente de COP
- Ejemplo 17. Factura con moneda diferente de COP y persona natural con cedula de extranjeria y residencia en Colombia
- Ejemplo 18. Factura con periodo de facturación
- Ejemplo 19. Factura con un detalle excluido de IVA y otros detalles con impuestos
Ejemplo 1.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000474",
"fecha": "2019-08-01",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-07-03",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "600000.00",
"valor_base_mas_impuestos": "714000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "114000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "714000.00",
"valor_total_a_pagar": "714000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 2.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000475",
"fecha": "2019-08-02",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-07-03",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "60000.00",
"descripcion": "Provisión ",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "60000.00",
"valor_impuesto": "9600.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "60000.00",
"valor_total_detalle": "60000.00"
},
{
"numero_linea": 3,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "50000.00",
"descripcion": "Provisión ",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_impuesto": "50000.00",
"valor_impuesto": "4000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "50000.00",
"valor_total_detalle": "50000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "60000.00",
"valor_total_impuesto": "9600.00"
},
{
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_calculo_impuesto": "50000.00",
"valor_total_impuesto": "4000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "710000.00",
"valor_base_calculo_impuestos": "710000.00",
"valor_base_mas_impuestos": "837600.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "123600.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "4000.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "837600.00",
"valor_total_a_pagar": "837600.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 3.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000476",
"fecha": "2019-08-01",
"hora": "12:25:30",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 10,
"identificador_de_pago": "",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "3005211254",
"nombre": {
"razon_social": "PIXELPRO S.A.S.\t",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 4,
"valor_unitario": "480000.00",
"unidad_de_cantidad": "94",
"descripcion": "Configuración inicial afacturar ",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1920000.00",
"valor_impuesto": "364800.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1920000.00",
"valor_total_detalle": "1920000.00"
},
{
"numero_linea": 2,
"cantidad": 168,
"unidad_de_cantidad": "94",
"valor_unitario": "10000.00",
"descripcion": "Servicio2",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "1680000.00",
"valor_impuesto": "268800.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1680000.00",
"valor_total_detalle": "1680000.00"
},
{
"numero_linea": 3,
"cantidad": 23,
"unidad_de_cantidad": "94",
"valor_unitario": "5000.00",
"descripcion": "Servicio1",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "5.00",
"valor_base_impuesto": "115000.00",
"valor_impuesto": "5750.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "115000.00",
"valor_total_detalle": "115000.00"
},
{
"numero_linea": 4,
"cantidad": 3,
"unidad_de_cantidad": "94",
"valor_unitario": "52000.00",
"descripcion": "Servicio4",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_impuesto": "156000.00",
"valor_impuesto": "12480.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "156000.00",
"valor_total_detalle": "156000.00"
},
{
"numero_linea": 5,
"cantidad": 12,
"unidad_de_cantidad": "94",
"valor_unitario": "58000.00",
"descripcion": "Servicio 4 - 16",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 4,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "696000.00",
"valor_impuesto": "111360.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "696000.00",
"valor_total_detalle": "696000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1920000.00",
"valor_total_impuesto": "364800.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "1680000.00",
"valor_total_impuesto": "268800.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "5.00",
"valor_base_calculo_impuesto": "115000.00",
"valor_total_impuesto": "5750.00"
},
{
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_calculo_impuesto": "156000.00",
"valor_total_impuesto": "12480.00"
},
{
"codigo_impuesto": 4,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "696000.00",
"valor_total_impuesto": "111360.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "4567000.00",
"valor_base_calculo_impuestos": "4567000.00",
"valor_base_mas_impuestos": "5330190.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "639350.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "123840.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "5330190.00",
"valor_total_a_pagar": "5330190.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 4.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000478",
"fecha": "2019-08-01",
"hora": "12:37:32",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 10,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "3015223786",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 4,
"valor_unitario": "36000.00",
"unidad_de_cantidad": "94",
"descripcion": "Servicio Exento",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "144000.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "144000.00",
"valor_total_detalle": "144000.00"
},
{
"numero_linea": 2,
"cantidad": 3,
"valor_unitario": "480000.00",
"unidad_de_cantidad": "94",
"descripcion": "Configuración inicial afacturar ",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1440000.00",
"valor_impuesto": "273600.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1440000.00",
"valor_total_detalle": "1440000.00"
},
{
"numero_linea": 3,
"cantidad": 23,
"valor_unitario": "3500.00",
"unidad_de_cantidad": "94",
"descripcion": "R-PI34-SW-K9",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "80500.00",
"valor_impuesto": "15295.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "80500.00",
"valor_total_detalle": "80500.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "144000.00",
"valor_total_impuesto": "0.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1520500.00",
"valor_total_impuesto": "288895.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "1664500.00",
"valor_base_calculo_impuestos": "1664500.00",
"valor_base_mas_impuestos": "1953395.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "288895.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "1953395.00",
"valor_total_a_pagar": "1953395.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 5.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000480",
"fecha": "2019-08-01",
"hora": "15:01:50",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 10,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 2,
"tipo_regimen": 0,
"tipo_identificacion": 13,
"identificacion": "52984786",
"correo_electronico": "info@teleinte.com",
"numero_movil": "3103103100",
"nombre": {
"razon_social": "",
"primer_nombre": "Maria",
"segundo_nombre": "Liliana",
"apellido": "Perez"
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"valor_unitario": "750000.00",
"unidad_de_cantidad": "94",
"descripcion": "SRV-ITL-PSSAV Servicios",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "750000.00",
"valor_impuesto": "142500.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "750000.00",
"valor_total_detalle": "750000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "750000.00",
"valor_total_impuesto": "142500.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "750000.00",
"valor_base_calculo_impuestos": "750000.00",
"valor_base_mas_impuestos": "892500.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "142500.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "892500.00",
"valor_total_a_pagar": "892500.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 6.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000481",
"fecha": "2019-08-01",
"hora": "08:37:32",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 10,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "31031031031",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "36000.00",
"descripcion": "Servicio Exento",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": true,
"porcentaje_cargo_descuento": "10.00",
"valor_base_cargo_descuento": "36000.00",
"valor_cargo_descuento": "3600.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "32400.00",
"valor_impuesto": "6156.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "32400.00",
"valor_total_detalle": "36000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "75000.00",
"descripcion": "Servicio descuento",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": true,
"porcentaje_cargo_descuento": "20.00",
"valor_base_cargo_descuento": "75000.00",
"valor_cargo_descuento": "15000.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "60000.00",
"valor_impuesto": "9600.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "60000.00",
"valor_total_detalle": "75000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "32400.00",
"valor_total_impuesto": "6156.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "60000.00",
"valor_total_impuesto": "9600.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "92400.00",
"valor_base_calculo_impuestos": "92400.00",
"valor_base_mas_impuestos": "108156.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "15756.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "108156.00",
"valor_total_a_pagar": "108156.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 7.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000482",
"fecha": "2019-08-01",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-07-03",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 11,
"porcentaje_descuento": "10.00",
"valor_base_calculo_descuento": "600000.00",
"valor_total_descuento": "60000.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "600000.00",
"valor_base_mas_impuestos": "714000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "60000.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "114000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "654000.00",
"valor_total_a_pagar": "654000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 8.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000483",
"fecha": "2019-08-01",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-07-03",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
}
],
"retenciones": [
{
"codigo": 5,
"porcentaje": "15.00",
"valor_base": "600000.00",
"valor_retenido": "90000.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "600000.00",
"valor_base_mas_impuestos": "714000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "114000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "90000.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "714000.00",
"valor_total_a_pagar": "624000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 9.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000501",
"fecha": "2019-08-13",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-07-03",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "187000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "187000.00",
"valor_impuesto": "35530.00"
},
"retenciones_detalle": [
{
"codigo": 5,
"porcentaje": "15.00",
"valor_base": "35530.00",
"valor_retenido": "5329.50"
},
{
"codigo": 6,
"porcentaje": "10.00",
"valor_base": "187000.00",
"valor_retenido": "18700.00"
}
],
"valor_total_detalle_con_cargo_descuento": "187000.00",
"valor_total_detalle": "187000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "1000000.00",
"descripcion": "Servicio de provisión inicial",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "1000000.00",
"valor_impuesto": "160000.00"
},
"retenciones_detalle": [
{
"codigo": 5,
"porcentaje": "15.00",
"valor_base": "160000.00",
"valor_retenido": "24000.00"
},
{
"codigo": 6,
"porcentaje": "4.00",
"valor_base": "1000000.00",
"valor_retenido": "40000.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1000000.00",
"valor_total_detalle": "1000000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "187000.00",
"valor_total_impuesto": "35530.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "1000000.00",
"valor_total_impuesto": "160000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "1187000.00",
"valor_base_calculo_impuestos": "1187000.00",
"valor_base_mas_impuestos": "1382530.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "195530.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "29329.50",
"valor_total_retefuente": "58700.00",
"valor_total_reteica": "0.00",
"total_factura": "1382530.00",
"valor_total_a_pagar": "1382530.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 10.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000485",
"fecha": "2019-08-01",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-07-03",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": "",
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"valor_unitario": "0.00",
"unidad_de_cantidad": "94",
"descripcion": "Servicio de provisión inicial",
"regalo": {
"es_regalo": true,
"cod_precio_referencia": 3,
"precio_referencia": "1000000.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "1000000.00",
"valor_impuesto": "160000.00"
},
"retenciones_detalle": [
{
"codigo": "",
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "0.00",
"valor_total_detalle": "0.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "1000000.00",
"valor_total_impuesto": "160000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "1600000.00",
"valor_base_mas_impuestos": "874000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "274000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "874000.00",
"valor_total_a_pagar": "874000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 11.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000486",
"fecha": "2019-08-01",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "ADMINISTRACION",
"nota_detalle": "Prestación de servicios",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "60000.00",
"descripcion": "Regalo",
"regalo": {
"es_regalo": true,
"cod_precio_referencia": 1,
"precio_referencia": "60000.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "0.00",
"valor_total_detalle": "0.00"
},
{
"numero_linea": 3,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "60000.00",
"descripcion": "Utilidad",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "60000.00",
"valor_impuesto": "11400.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "60000.00",
"valor_total_detalle": "60000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "60000.00",
"valor_total_impuesto": "11400.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "660000.00",
"valor_base_calculo_impuestos": "60000.00",
"valor_base_mas_impuestos": "671400.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "11400.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "671400.00",
"valor_total_a_pagar": "671400.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 12.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000487",
"fecha": "2019-08-01",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10 ",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2985,
"unidad_de_cantidad": "94",
"valor_unitario": "1682.00",
"descripcion": "Materiales de excavacion",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "5020770.00",
"valor_total_detalle": "5020770.00"
},
{
"numero_linea": 2,
"cantidad": 795,
"unidad_de_cantidad": "94",
"valor_unitario": "2045.00",
"descripcion": "Excavacion",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1625775.00",
"valor_total_detalle": "1625775.00"
},
{
"numero_linea": 3,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "332327.25",
"descripcion": "ADMINISTRACION",
"nota_detalle": "Prestación de servicios",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "332327.25",
"valor_total_detalle": "332327.25"
},
{
"numero_linea": 4,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "66465.45",
"descripcion": "Imprevisto",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "66465.45",
"valor_total_detalle": "66465.45"
},
{
"numero_linea": 5,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "332327.25",
"descripcion": "Utilidad",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "332327.25",
"valor_impuesto": "63142.18"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "332327.25",
"valor_total_detalle": "332327.25"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "332327.25",
"valor_total_impuesto": "63142.18"
}
],
"descuentos": [
{
"codigo_descuento": 0,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"retenciones": [
{
"codigo": 6,
"porcentaje": "2.00",
"valor_base": "7377664.95",
"valor_retenido": "147553.30"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "7377664.95",
"valor_base_calculo_impuestos": "332327.25",
"valor_base_mas_impuestos": "7440807.13",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "63142.18",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "147553.30",
"valor_total_reteica": "0.00",
"total_factura": "7440807.13",
"valor_total_a_pagar": "7440807.13"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 13.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000488",
"fecha": "2019-08-01",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 2,
"tipo_regimen": 0,
"tipo_identificacion": 22,
"identificacion": "392546",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "Andres ",
"segundo_nombre": "",
"apellido": "Perez"
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10 ",
"RUT": {
"resp_calidades_atributos": [
"O-99"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"unidad_de_cantidad": "94",
"valor_unitario": "15000.00",
"descripcion": "Materiales de excavacion",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "30000.00",
"valor_impuesto": "5700.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "30000.00",
"valor_total_detalle": "30000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "30000.00",
"valor_total_impuesto": "5700.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "Prueba de recargo",
"porcentaje_recargo": "2.00",
"valor_base_calculo_recargo": "30000.00",
"valor_total_recargo": "600.00"
}
],
"descuentos": [
{
"codigo_descuento": 0,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "30000.00",
"valor_base_calculo_impuestos": "30000.00",
"valor_base_mas_impuestos": "35700.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "600.00",
"valor_total_impuesto_1": "5700.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "36300.00",
"valor_total_a_pagar": "36300.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 14.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000489",
"fecha": "2019-08-01",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 2,
"tipo_regimen": 0,
"tipo_identificacion": 22,
"identificacion": "392546",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "Andres ",
"segundo_nombre": "",
"apellido": "Perez"
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "10000.00",
"descripcion": "Materiales de excavacion",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "2.00",
"valor_base_cargo_descuento": "10000.00",
"valor_cargo_descuento": "200.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "10200.00",
"valor_impuesto": "1938.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "10200.00",
"valor_total_detalle": "10200.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "10200.00",
"valor_total_impuesto": "1938.00"
}
],
"descuentos": [
{
"codigo_descuento": 0,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "10200.00",
"valor_base_calculo_impuestos": "10200.00",
"valor_base_mas_impuestos": "12138.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "1938.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "12138.00",
"valor_total_a_pagar": "12138.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 15.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000490",
"fecha": "2019-08-01",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 2,
"tipo_regimen": 0,
"tipo_identificacion": 22,
"identificacion": "392546",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "Andres ",
"segundo_nombre": "",
"apellido": "Perez"
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-99"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"unidad_de_cantidad": "94",
"valor_unitario": "15000.00",
"descripcion": "Materiales de excavacion",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "30000.00",
"valor_impuesto": "5700.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "30000.00",
"valor_total_detalle": "30000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "30000.00",
"valor_total_impuesto": "5700.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "Prueba de recargo",
"porcentaje_recargo": "2.00",
"valor_base_calculo_recargo": "30000.00",
"valor_total_recargo": "600.00"
},
{
"nombre_recargo": "Envio de mercancia",
"porcentaje_recargo": "5.00",
"valor_base_calculo_recargo": "30000.00",
"valor_total_recargo": "1500.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "30000.00",
"valor_base_calculo_impuestos": "30000.00",
"valor_base_mas_impuestos": "35700.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "2100.00",
"valor_total_impuesto_1": "5700.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "37800.00",
"valor_total_a_pagar": "37800.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 16.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000576",
"fecha": "2019-08-21",
"hora": "21:34:55",
"moneda": "USD",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 42,
"identificador_de_pago": "PRUEBA",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-08-16",
"numero_orden": "documento origen",
"prefijo": "SETP",
"nota": [
"{ 'Son':'' }"
]
},
"cambio_de_moneda": {
"fecha_cambio": "2019-08-21",
"codigo": "COP",
"valor_base_trm": "3500.00"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "901219999",
"correo_electronico": "wmg@oxsoft.com.co",
"numero_movil": "",
"nombre": {
"razon_social": "ACME",
"primer_nombre": "ACME",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Cra 10 85 via caracas",
"RUT": {
"resp_calidades_atributos": [
"O-99"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 100,
"unidad_de_cantidad": "94",
"valor_unitario": "13400.00",
"descripcion": "Producto",
"valor_total_detalle_con_cargo_descuento": "1340000.00",
"valor_total_detalle": "1340000.00",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1340000.00",
"valor_impuesto": "254600.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valores_unitarios": {
"valor_descuento": "0.00",
"valor_con_descuento": "0.00",
"valor_impuesto_1": "0.00",
"valor_impuesto_2": "0.00",
"valor_impuesto_3": "0.00",
"valor_impuesto_4": "0.00",
"valor_reteiva": "0.00",
"valor_retefuente": "0.00",
"valor_reteica": "0.00",
"valor_a_pagar": "1340000.00"
}
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1340000.00",
"valor_total_impuesto": "254600.00"
}
],
"retenciones": [
{
"codigo": 6,
"porcentaje": "15.000",
"valor_base": "254600.00",
"valor_retenido": "38190.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "1340000.00",
"valor_base_calculo_impuestos": "1340000.00",
"valor_base_mas_impuestos": "1594600.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "254600.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "38190.00",
"valor_total_reteica": "0.00",
"total_factura": "1594600.00",
"valor_total_a_pagar": "1556410.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validacion previa",
"integrador": {
"nombre": "OxSoft",
"tipo": "WEB"
}
}
}
Ejemplo 17.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000577",
"fecha": "2019-08-21",
"hora": "21:34:55",
"moneda": "USD",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 42,
"identificador_de_pago": "PRUEBA",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-08-16",
"numero_orden": "documento origen",
"prefijo": "SETP",
"nota": [
"{ 'Son':'' }"
]
},
"cambio_de_moneda": {
"fecha_cambio": "2019-08-21",
"codigo": "COP",
"valor_base_trm": "3500.00"
},
"informacion_adquiriente": {
"tipo_contribuyente": 2,
"tipo_regimen": 0,
"tipo_identificacion": 22,
"identificacion": "392546",
"correo_electronico": "wmg@oxsoft.com.co",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "Andres",
"segundo_nombre": "Perez",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "",
"RUT": {
"resp_calidades_atributos": [
"O-99"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 100,
"unidad_de_cantidad": "94",
"valor_unitario": "13400.00",
"descripcion": "Producto",
"valor_total_detalle_con_cargo_descuento": "1340000.00",
"valor_total_detalle": "1340000.00",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1340000.00",
"valor_impuesto": "254600.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valores_unitarios": {
"valor_descuento": "0.00",
"valor_con_descuento": "0.00",
"valor_impuesto_1": "0.00",
"valor_impuesto_2": "0.00",
"valor_impuesto_3": "0.00",
"valor_impuesto_4": "0.00",
"valor_reteiva": "0.00",
"valor_retefuente": "0.00",
"valor_reteica": "0.00",
"valor_a_pagar": "1340000.00"
}
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1340000.00",
"valor_total_impuesto": "254600.00"
}
],
"retenciones": [
{
"codigo": 6,
"porcentaje": "15.000",
"valor_base": "254600.00",
"valor_retenido": "38190.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "1340000.00",
"valor_base_calculo_impuestos": "1340000.00",
"valor_base_mas_impuestos": "1594600.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "254600.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "38190.00",
"valor_total_reteica": "0.00",
"total_factura": "1594600.00",
"valor_total_a_pagar": "1556410.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validacion previa",
"integrador": {
"nombre": "OxSoft",
"tipo": "WEB"
}
}
}
Ejemplo 18.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000659",
"fecha": "2019-08-26",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-07-03",
"numero_orden": "",
"prefijo": "SETP"
},
"periodo_facturacion": {
"fecha_inicio":"2019-08-01",
"fecha_fin":"2019-08-30"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "600000.00",
"valor_base_mas_impuestos": "714000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "114000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "714000.00",
"valor_total_a_pagar": "714000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 19.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001204",
"fecha": "2020-01-07",
"hora": "10:37:32",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 10,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "3015223786",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 4,
"valor_unitario": "36000.00",
"unidad_de_cantidad": "94",
"descripcion": "Servicio Excluido de impuesto",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "144000.00",
"valor_total_detalle": "144000.00"
},
{
"numero_linea": 2,
"cantidad": 2,
"valor_unitario": "50000.00",
"unidad_de_cantidad": "94",
"descripcion": "Elemento con IVA",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "100000.00",
"valor_impuesto": "19000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "100000.00",
"valor_total_detalle": "100000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "0.00",
"valor_total_impuesto": "0.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "100000.00",
"valor_total_impuesto": "19000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "244000.00",
"valor_base_calculo_impuestos": "100000.00",
"valor_base_mas_impuestos": "263000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "19000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "263000.00",
"valor_total_a_pagar": "263000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "Factura excluido de IVA",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Salida Exitosa
Salida con errores de semantica
Salida con errores de datos
Salida con errores HTTP
Salida con error de datos en la DIAN
{
"codigo_error": 0,
"descripcion_error": "OK",
"tiempo_ejecucion": 2.8475100994110109,
"transaccion": "5e5e5e5e5e55e",
"resultado": {
"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"id_factura": "SETP990001502",
"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
"url_application_response": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ar083002047005520SETP990001502.xml",
"url_attached_document_url": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ad083002047005520SETP990001502.xml",
"url_representacion_grafica": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.pdf",
"url_notificacion_aceptacion_rechazo": "http://app.afacturar.com/consulta_documento/?uid=5e5e5e5e5e55e"
},
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": ""
}
Salida con errores de semantica
{
"codigo_error": 400,
"descripcion_error": "Hay un problema con la informacion entregada",
"tiempo_ejecucion": 0.01330113410949707,
"transaccion": "5e74ce82707f6",
"resultado": [
{
"propiedad": "facturas[0].encabezado.tipo_factura",
"descripcion": "The property tipo_factura is required"
},
{
"propiedad": "facturas[0].encabezado.tipo_factura",
"descripcion": "Does not have a value in the enumeration [1,2,3,5,6,7,8,9,10]"
},
{
"propiedad": "facturas[0].encabezado",
"descripcion": "The property tipo_factur is not defined and the definition does not allow additional properties"
}
],
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": ""
}
Salida con errores de datos
{
"codigo_error": 400,
"descripcion_error": "Hay problema(s) con la información entregada",
"resultado": [
[
{
"propiedad": "facturas->encabezado-> numero_resolucion_facturacion y facturas->encabezado-> prefijo",
"descripcion": "No exiten rangos de facturación para la resolución SET + 18760000001 "
},
{
"propiedad": "facturas->fecha_vencimiento",
"descripcion": "Si el metodo de pago es contado, la fecha de vencimiento debe ir vacia"
}
]
]
}
Salida con errores HTTP
{
"codigo_error": 500,
"descripcion_error": "Unauthenticated."
}
Salida con error de datos en la DIAN
{
"codigo_error": 15,
"descripcion_error": "La validación en la DIAN devuelve error(es)",
"tiempo_ejecucion": 1.9776690006256104,
"transaccion": "5e74d144dd565",
"resultado": {
"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"id_factura": "SETP990001504",
"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
},
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": "Regla: FAU06, Rechazo: 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.Regla: FAU02, Rechazo: 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"
}
CURL
curl -X POST \
https://servicios-pruebas.afacturar.com/api/vp/factura_nacional \
-H 'accept: application/json' \
-H 'authorization: Bearer token_obligado' \
-H 'cache-control: no-cache' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-H 'postman-token: 7d6d9f51-7372-30a6-4f37-fa651f384b75' \
-F 'data={
"facturas": [
{
"encabezado": {
"id_factura": "990001502",
"fecha": "2020-03-19",
"hora": "05:36:10",
"nota": [
"{'\''SON'\'':'\''XXX XXX XXX'\''",
"'\''VARIABLE'\'':'\''VALOR'\''}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 2,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2020-03-19",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "830020470",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "ABC S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "600000.00",
"valor_base_mas_impuestos": "714000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "114000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "714000.00",
"valor_total_a_pagar": "714000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}' \
-F documento_obligado=830020470
C#
var client = new RestClient("https://servicios-pruebas.afacturar.com/api/vp/factura_nacional");
var request = new RestRequest(Method.POST);
request.AddHeader("postman-token", "df0e4129-6a74-7660-dad1-9133d9429be2");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("authorization", "Bearer token_obligado");
request.AddHeader("accept", "application/json");
request.AddHeader("content-type", "multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW");
request.AddParameter("multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW", "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"data\"\r\n\r\n{\n\t\"facturas\": [\n\t\t{\n\t\t\t\"encabezado\": {\n\t\t\t\t\"id_factura\": \"990001678\",\n\t\t\t\t\"fecha\": \"2020-06-25\",\n\t\t\t\t\"hora\": \"12:37:32\",\n\t\t\t\t\"nota\": [\n\t\t\t\t\t\"{'SON':'XXX XXX XXX'\",\n\t\t\t\t\t\"'VARIABLE':'VALOR'}\"\n\t\t\t\t],\n\t\t\t\t\"moneda\": \"COP\",\n\t\t\t\t\"tipo_factura\": 1,\n\t\t\t\t\"metodo_de_pago\": 1,\n\t\t\t\t\"tipo_de_pago\": 10,\n\t\t\t\t\"identificador_de_pago\": \"ABC1234\",\n\t\t\t\t\"numero_resolucion_facturacion\": \"18760000001\",\n\t\t\t\t\"fecha_vencimiento\": \"\",\n\t\t\t\t\"numero_orden\": \"\",\n\t\t\t\t\"prefijo\": \"SETP\"\n\t\t\t},\n\t\t\t\"informacion_adquiriente\": {\n\t\t\t\t\"tipo_contribuyente\": 1,\n\t\t\t\t\"tipo_regimen\": 2,\n\t\t\t\t\"tipo_identificacion\": 31,\n\t\t\t\t\"identificacion\": \"900730299\",\n\t\t\t\t\"correo_electronico\": \"info@teleinte.com\",\n\t\t\t\t\"numero_movil\": \"3015223786\",\n\t\t\t\t\"nombre\": {\n\t\t\t\t\t\"razon_social\": \"PIXELPRO S.A.S.\",\n\t\t\t\t\t\"primer_nombre\": \"\",\n\t\t\t\t\t\"segundo_nombre\": \"\",\n\t\t\t\t\t\"apellido\": \"\"\n\t\t\t\t},\n\t\t\t\t\"pais\": \"CO\",\n\t\t\t\t\"departamento\": \"11\",\n\t\t\t\t\"ciudad\": \"11001\",\n\t\t\t\t\"zona\": \"\",\n\t\t\t\t\"direccion\": \"Carrera 10\",\n\t\t\t\t\"RUT\": {\n\t\t\t\t\t\"resp_calidades_atributos\": [\n\t\t\t\t\t\t\"O-07\",\n\t\t\t\t\t\t\"O-08\"\n\t\t\t\t\t],\n\t\t\t\t\t\"usuario_aduanero\": [\n\t\t\t\t\t\t\"\"\n\t\t\t\t\t]\n\t\t\t\t}\n\t\t\t},\n\t\t\t\"detalle_factura\": [\n\t\t\t\t{\n\t\t\t\t\t\"numero_linea\": 1,\n\t\t\t\t\t\"cantidad\": 1.0,\n\t\t\t\t\t\"unidad_de_cantidad\": \"94\",\n\t\t\t\t\t\"valor_unitario\": \"337000.00\",\n\t\t\t\t\t\"descripcion\": \"descripcion\",\n\t\t\t\t\t\"regalo\": {\n\t\t\t\t\t\t\"es_regalo\": false,\n\t\t\t\t\t\t\"cod_precio_referencia\": 0,\n\t\t\t\t\t\t\"precio_referencia\": \"0.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"cargo_descuento\": {\n\t\t\t\t\t\t\"es_descuento\": false,\n\t\t\t\t\t\t\"porcentaje_cargo_descuento\": \"0.00\",\n\t\t\t\t\t\t\"valor_base_cargo_descuento\": \"337000.00\",\n\t\t\t\t\t\t\"valor_cargo_descuento\": \"0.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"impuestos_detalle\": {\n\t\t\t\t\t\t\"codigo_impuesto\": 1,\n\t\t\t\t\t\t\"porcentaje_impuesto\": \"0.00\",\n\t\t\t\t\t\t\"valor_base_impuesto\": \"337000.00\",\n\t\t\t\t\t\t\"valor_impuesto\": \"0.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"retenciones_detalle\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"codigo\": 0,\n\t\t\t\t\t\t\t\"porcentaje\": \"0.00\",\n\t\t\t\t\t\t\t\"valor_base\": \"0.00\",\n\t\t\t\t\t\t\t\"valor_retenido\": \"0.00\"\n\t\t\t\t\t\t}\n\t\t\t\t\t],\n\t\t\t\t\t\"valores_unitarios\": {\n\t\t\t\t\t\t\"valor_descuento\": \"0.00\",\n\t\t\t\t\t\t\"valor_con_descuento\": \"0.00\",\n\t\t\t\t\t\t\"valor_impuesto_1\": \"0.00\",\n\t\t\t\t\t\t\"valor_impuesto_2\": \"0.00\",\n\t\t\t\t\t\t\"valor_impuesto_3\": \"0.00\",\n\t\t\t\t\t\t\"valor_impuesto_4\": \"0.00\",\n\t\t\t\t\t\t\"valor_reteiva\": \"0.00\",\n\t\t\t\t\t\t\"valor_retefuente\": \"0.00\",\n\t\t\t\t\t\t\"valor_reteica\": \"0.00\",\n\t\t\t\t\t\t\"valor_a_pagar\": \"0.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"valor_total_detalle_con_cargo_descuento\": \"337000.00\",\n\t\t\t\t\t\"valor_total_detalle\": \"337000.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"impuestos\": [\n\t\t\t\t{\n\t\t\t\t\t\"codigo_impuesto\": 1,\n\t\t\t\t\t\"porcentaje_impuesto\": \"0.00\",\n\t\t\t\t\t\"valor_base_calculo_impuesto\": \"337000.00\",\n\t\t\t\t\t\"valor_total_impuesto\": \"0.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"retenciones\": [\n\t\t\t\t{\n\t\t\t\t\t\"codigo\": 5,\n\t\t\t\t\t\"porcentaje\": \"0.00\",\n\t\t\t\t\t\"valor_base\": \"337000.00\",\n\t\t\t\t\t\"valor_retenido\": \"0.00\"\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"codigo\": 6,\n\t\t\t\t\t\"porcentaje\": \"0.00\",\n\t\t\t\t\t\"valor_base\": \"337000.00\",\n\t\t\t\t\t\"valor_retenido\": \"0.00\"\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"codigo\": 7,\n\t\t\t\t\t\"porcentaje\": \"0.00\",\n\t\t\t\t\t\"valor_base\": \"337000.00\",\n\t\t\t\t\t\"valor_retenido\": \"0.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"recargos\": [\n\t\t\t\t{\n\t\t\t\t\t\"nombre_recargo\": \"\",\n\t\t\t\t\t\"porcentaje_recargo\": \"0.00\",\n\t\t\t\t\t\"valor_base_calculo_recargo\": \"0.00\",\n\t\t\t\t\t\"valor_total_recargo\": \"0.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"descuentos\": [\n\t\t\t\t{\n\t\t\t\t\t\"codigo_descuento\": 99,\n\t\t\t\t\t\"porcentaje_descuento\": \"0.00\",\n\t\t\t\t\t\"valor_base_calculo_descuento\": \"0.00\",\n\t\t\t\t\t\"valor_total_descuento\": \"0.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"valor_factura\": {\n\t\t\t\t\"valor_base\": \"337000.00\",\n\t\t\t\t\"valor_base_calculo_impuestos\": \"337000.00\",\n\t\t\t\t\"valor_base_mas_impuestos\": \"337000.00\",\n\t\t\t\t\"valor_anticipo\": \"0.00\",\n\t\t\t\t\"valor_descuento_total\": \"0.00\",\n\t\t\t\t\"valor_total_recargos\": \"0.00\",\n\t\t\t\t\"valor_total_impuesto_1\": \"0.00\",\n\t\t\t\t\"valor_total_impuesto_2\": \"0.00\",\n\t\t\t\t\"valor_total_impuesto_3\": \"0.00\",\n\t\t\t\t\"valor_total_impuesto_4\": \"0.00\",\n\t\t\t\t\"valor_total_reteiva\": \"0.00\",\n\t\t\t\t\"valor_total_retefuente\": \"0.00\",\n\t\t\t\t\"valor_total_reteica\": \"0.00\",\n\t\t\t\t\"total_factura\": \"337000.00\",\n\t\t\t\t\"valor_total_a_pagar\": \"337000.00\"\n\t\t\t}\n\t\t}\n\t],\n\t\"generalidades\": {\n\t\t\"tipo_ambiente_dian\": 2,\n\t\t\"version\": 2,\n\t\t\"identificador_transmision\": \"Prueba_xwsr1234\",\n\t\t\"rg_tipo\": \"\",\n\t\t\"rg_base_64\": \"\",\n\t\t\"rg_px_qr\": {\n\t\t\t\"x\": \"\",\n\t\t\t\"y\": \"\",\n\t\t\t\"size\": \"\"\n\t\t},\n\t\t\"rg_px_cufe\": {\n\t\t\t\"x\": \"\",\n\t\t\t\"y\": \"\",\n\t\t\t\"size\": \"\"\n\t\t},\n\t\t\"notificacion\":\t{\n\t\t\t\"es_automatico\":\"S\",\n\t\t\t\"correo_obligado\":\"acanon@eleinte.com\",\n\t\t\t\"asunto\":\"\",\n\t\t\t\"con_copia\":\"\"\n\t\t},\n\t\t\"integrador\": {\n\t\t\t\"nombre\": \"POSTMAN\",\n\t\t\t\"tipo\": \"POSTMAN\"\n\t\t}\n\t}\n}\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"documento_obligado\"\r\n\r\n830020470\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Factura de contingencia
Especificación detallada para recibir información de factura para ser procesadas en la plataforma
Histórico de cambios
| Versión | Cambios | Fecha de liberación |
|---|---|---|
| 2.2 | En la variable detalle_factura se adiciono las variables marca, modelo y codificacion_estandar. Estas variables se utilizan para tener más información de los productos y/o servicios, permitiendo a los clientes codificar productos y servicios de forma clara, basandose en estándares acordados por la industria los cuales facilitan el comercio entre empresas y gobierno | 08 de junio de 2020 |
| 2.1 | En la variable informacion_adquiriente -> correo_electronico permitir varias direcciones de correo. Se debe tener en cuenta que la primera dirección de correo es la utilizada para el envio de la notificación al adquiriente. | 08 de mayo de 2020 |
| 2 | Validación previa. | 07 de Mayo de 2020 |
POST
/factura_contingencia
documento_obligado:
000000000
data:
{
"facturas": [{
"encabezado": {
"id_factura": "",
"fecha": "",
"hora": "",
"nota": ["{'':'','':'','':'','':'','':'','':''}"],
"moneda": "",
"tipo_factura": #,
"metodo_de_pago": ##,
"tipo_de_pago": ##,
"identificador_de_pago": "",
"numero_resolucion_facturacion": "",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": ""
},
"informacion_factura_contingencia":{
"id_factura_contingencia":"",
"copia_factura":"",
"fecha_contingencia":"",
"tipo_contingencia":"",
"codigo_tipo_documento":"",
},
"periodo_facturacion":{
"fecha_inicio":"",
"fecha_fin":"",
},
"cambio_de_moneda":{
"fecha_cambio":"",
"codigo":"",
"valor_base_trm":"0.00"
},
"informacion_adquiriente": {
"tipo_contribuyente": #,
"tipo_regimen": #,
"tipo_identificacion":#,
"identificacion": ""
"correo_electronico": "",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "",
"nombre_pais": "",
"departamento": "",
"nombre_departamento": "",
"zona": "",
"ciudad": "",
"nombre_ciudad": "",
"direccion": "",
"RUT": {
"resp_calidades_atributos": ["",""],
"usuario_aduanero": [""]
}
},
"detalle_factura": [{
"numero_linea": #,
"cantidad": #,
"unidad_de_cantidad":"" ,
"valor_unitario": "0.00",
"descripcion": "",
"nota_detalle": "",
"marca": "",
"modelo": "",
"codificacion_estandar": {
"cod_grupo_bien_servicio": "",
"nombre_grupo_bien_servicio": "",
"cod_segmento_bien_servicio": "",
"cod_bien_servicio": ""
},
"regalo": {
"es_regalo": "",
"cod_precio_referencia": #,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": "",
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": #,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [{
"codigo": #,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}],
"valores_unitarios":{
"valor_descuento":"0.00",
"valor_con_descuento":"0.00",
"valor_impuesto_1":"0.00",
"valor_impuesto_2":"0.00",
"valor_impuesto_3":"0.00",
"valor_impuesto_4":"0.00",
"valor_reteiva":"0.00",
"valor_retefuente":"0.00",
"valor_reteica":"0.00",
"valor_a_pagar":"0.00"
},
"valor_total_detalle_con_cargo_descuento": "0.00",
"valor_total_detalle": "0.00"
}],
"impuestos": [{
"codigo_impuesto": #,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "0.00",
"valor_total_impuesto": "0.00"
}],
"retenciones":[{
"codigo": #,
"porcentaje":"0.00",
"valor_base":"0.00",
"valor_retenido":"0.00"
}],
"recargos": [{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}],
"descuentos": [{
"codigo_descuento": #,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}],
"valor_factura": {
"valor_base": "0.00",
"valor_base_calculo_impuestos": "0.00",
"valor_base_mas_impuestos": "0.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "0.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "0.00",
"valor_total_a_pagar": "0.00"
}
}],
"generalidades": {
"tipo_ambiente_dian": #,
"version": #,
"identificador_transmision": "",
"rg_tipo":"",
"rg_base_64":"",
"rg_px_qr": {
"x":"",
"y":"",
"size":"",
"mostrar_en":""
},
"rg_px_cufe": {
"x":"",
"y":"",
"size":"",
"mostrar_en":""
},
"integrador": {
"nombre":"",
"tipo":"",
"webhook": ""
}
}
}
encabezado
id_factura
Descripción:
Número de documento: Número de factura o factura cambiaria. Consecutivo de factura autorizados por la DIAN
Tipo de dato:
String
Especificaciones:
No se permiten caracteres adicionales como espacios o guiones.
Obligatorio:
Si
fecha
Descripción:
Fecha de emisión de la factura a efectos fiscales.
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Si
hora
Descripción:
Hora de emisión de la factura
Tipo de dato:
Time
Especificaciones:
HH24:MM:SS
Obligatorio:
Si
nota
Descripción:
Las notas se van a distribuir en un formato similar a JSON, en el cual se cambia la comilla doble por sencilla, tanto en el nombre de la variable, como en su valor, esto debido a la restricción de algunos caracteres especiales que no son soportados en este campo.
Este JSON termina siendo un STRING que se debe enviar dividido en las posiciones del array de nota, de acuerdo con las restricciones que defina la DIAN:
A la fecha (2019-01-11) existe una restricción de enviar como mínimo 15 caracteres(*)
La estructura a utilizar es:
{'variable_1': 'valor_1', 'variable_2':'valor_2'}Ejemplos:
Enviar valores nulos o vacíos
nota[0] = "{‘variable_1': 'null', 'variable_2':'valor_2', 'variable_3':''}"
División del STRING en varias posiciones del array
nota[0] = "{‘variable_1': 'null', 'variab"
nota[1] = "le_2':'valor_2', 'variable_3':''}"
El API genera la concatenación del STRING y lo convierte a formato JSON y realiza la respectiva validación.
Hay que tener en cuenta que los caracteres (comilla sencilla, backslash, backslash comilla sencilla ) no se deben enviar, porque no son soportados en el API.
Si alguna variable es diferente a las del listado de especificaciones, se debe consultar con el personal de operación de Teleinte S.A.S, para realizar la respectiva validación, y en caso que no exista una variable, se estudiará el caso para determinar la adición o no de la variable que cumpla con la descripción requerida.
(*) Estas restricciones pueden cambiar en cualquier momento por parte de la DIAN, de acuerdo al nuevo proceso que estandarización y validación que están estableciendo.
Tipo de dato:
Array
Especificaciones:
El listado de la estandarización de las variables se puede ver aqui
Obligatorio:
Si
moneda
Descripción:
Divisa aplicable a toda la factura
Tipo de dato:
Parametrizado
Especificaciones:
COP- Colombia, USD - dolares. Inf adicional Ver
Obligatorio:
Si
tipo_factura
Descripción:
Tipo de Factura
Tipo de dato:
Parametrizado
Especificaciones:
10= Estandar
Obligatorio:
Si
metodo_de_pago
Descripción:
Método de pago
Tipo de dato:
Parametrizado
Especificaciones:
1 = Contado
2 = Crédito
Obligatorio:
Si
tipo_de_pago
Descripción:
Código correspondiente al medio de pago
Tipo de dato:
Parametrizado
Obligatorio:
Si
identificador_de_pago
Descripción:
Identificador de pago o número de referencia de pago
Tipo de dato:
String
Especificaciones:
Obligatorio:
No
numero_resolucion_facturacion
Descripción:
Número del código de la resolución otorgada para la numeración. Debe corresponder a un número de autorización del contribuyente emisor
Tipo de dato:
String
Especificaciones:
18 caracteres
Obligatorio:
Si
fecha_vencimiento
Descripción:
Fecha de vencimiento. Obligatorio si el método de pago es crédito
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
No
numero_orden
Descripción:
Número de orden
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
prefijo
Descripción:
Prefijo de la resolución registrado para la numeración.
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si
informacion_adquiriente
tipo_contribuyente
Descripción:
Tipo de identificación Tributaria o similar de la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
1= Persona juridica
2= Persona natural
Obligatorio:
Si
tipo_regimen
Descripción:
Régimen al que pertenece la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
0= Simplificado
2= Común
Obligatorio:
Si
tipo_identificacion
Descripción:
Tipo de documento de identificación de la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
11= Registro civil
12= Tarjeta de identidad
13= Cedula ciudadania
21= Tarjeta de extranjería
22= Cedula de extranjería
31= NIT
41= Pasaporte
42= Documento de identificación extranjero
Obligatorio:
Si
identificacion
Descripción:
Número completo de la identificación de la empresa o persona
Tipo de dato:
String
Especificaciones:
Alfanumérico
Obligatorio:
Si
correo_electronico
Descripción:
Lista de direcciones de correo electronico, separadas por punto y coma ';'. Para el envio de las notificaciones al adquiriente se va tomar la primera dirección de correo.
Tipo de dato:
Especificaciones:
xxxx@xx.xx;yyyy@yy.yy
Obligatorio:
Si
numero_movil
Descripción:
Número de móvil para el envio de notificaciones
Tipo de dato:
String
Especificaciones:
3111111111
Obligatorio:
No
nombre
Descripción:
Nombre comercial del emisor
Tipo de dato:
array
Especificaciones:
Depende del tipo de contribuyente.
Persona juridica {razon_social}.
Persona natural {primer_nombre, segundo_nombre, apellidos}
Obligatorio:
Si
razon_social
Descripción:
Nombre comercial
Tipo de dato:
Alfanumérico
Especificaciones:
Opcional dependiendo el tipo de contribuyente. Si es NIT es obligatorio
Obligatorio:
Si es persona juridica
primer_nombre
Descripción:
Primer nombre
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si es persona natural
segundo_nombre
Descripción:
Segundo nombre
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
apellido
Descripción:
Apellidos
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si es persona natural
pais
Descripción:
Código dentificador del país. Código alfa-2 asignado al pais
Tipo de dato:
Parametrizado
Especificaciones:
Estandar ISO 3166-1. Inf adicional Ver
Obligatorio:
Si
nombre_pais
Descripción:
Nombre del país.
Tipo de dato:
String
Especificaciones:
Estandar ISO 3166-1. Inf adicional Ver
Obligatorio:
No
departamento
Descripción:
Codigo del departamento, son las subdivisiones administrativas del país (CO). Fue publicada en 1998 y actualizada por última vez en el sexto boletín de la primera edición en 2004.
Si no corresponde a Colombia debe ir el nombre de la ciudad o estado
Tipo de dato:
Parametrizado
Especificaciones:
ISO 3166-2:CO. Inf adicional Ver
Obligatorio:
Si
nombre_departamento
Descripción:
Nombre del departamento
Tipo de dato:
String
Especificaciones:
ISO 3166-2:CO. Inf adicional Ver
Obligatorio:
No
ciudad
Descripción:
Código del municipio ó ciudad ó subdivisión de tercer nivel.
Tipo de dato:
Parametrizado
Especificaciones:
Inf adicional Ver
Obligatorio:
Si
nombre_ciudad
Descripción:
Nombre del municipio ó ciudad ó subdivisión de tercer nivel.
Tipo de dato:
String
Especificaciones:
Inf adicional Ver
Obligatorio:
No
zona
Descripción:
Nombre de la subdivisión de la ciudad
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
direccion
Descripción:
Elemento de texto libre, que el emisor puede elegir utilizar para poner toda la información de la dirección
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 10 caracteres
Obligatorio:
Si
RUT
Descripción:
Información del RUT - Registro Unico Tributario. Responsabilidades, Calidades y Atributos, numeral 53 y Usuarios aduaneros, numeral 54.
Tipo de dato:
array
Especificaciones:
Parametrizable
Obligatorio:
Si
resp_calidades_atributos
Descripción:
Lista de codigos de las responsabilidades, calidades y atributos registrados en el RUT, numeral 53
Tipo de dato:
Array
Especificaciones:
Parametrizado.Inf adicional Ver
Obligatorio:
Si
usuario_aduanero
Descripción:
Lista de codigos usuarios aduaneros registrados en el RUT, numeral 54
Tipo de dato:
Array
Especificaciones:
Vacio
Obligatorio:
No
detalle_factura
numero_linea
Descripción:
Número de Línea
Tipo de dato:
Numerico
Especificaciones:
1...n
Obligatorio:
Si
cantidad
Descripción:
(Cant) Cantidad de productos o servicios solicitados. Número de unidades servidas/prestadas.
Tipo de dato:
Numerico
Especificaciones:
...n
Obligatorio:
Si
unidad_de_cantidad
Descripción:
Unidad de la cantidad del artículo solicitiado
Tipo de dato:
Parametrizado
Obligatorio:
Si
valor_unitario
Descripción:
(VU) Es el precio por unidad de cada bien o servicio antes de aplicar los impuestos o descuento. El valor base es el precio de un activo fijo a efectos impositivos. El valor base es el precio base de un activo sobre el cual se calcula la depreciación y la amortización
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
descripcion
Descripción:
Descripción del artículo o servicio a que se refiere esta línea de la factura
Tipo de dato:
Alfanumérico
Especificaciones:
Mínimo de 2 caracteres
Obligatorio:
Si
nota_detalle
Descripción:
Información adicional: Texto libre, relativo al documento. Para el caso de facturas por contratos de servicio tipo AIU, se debe enviar incluir el objeto del contrato facturado
Tipo de dato:
Alfanumérico
Especificaciones:
Mínimo de 2 caracteres
Obligatorio:
Si
marca
Descripción:
Marca: Marca del artículo
Tipo de dato:
String
Especificaciones:
Obligatorio:
Si
modelo
Descripción:
Modelo: Modelo del artículo
Tipo de dato:
String
Especificaciones:
Obligatorio:
Si
codificacion_estandar
Descripción:
Identificación del producto o servicio de acuerdo con un estandar acordado por la industria, los cuales facilitan el comercio entre empresas y gobierno.
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
cod_grupo_bien_servicio
Descripción:
Tipo de estandar de codificación utilizado para la clasificación de los productos o servicios.
UNSPSC - United Nations Standard Products and Services Code® - Código Estándar de Productos y Servicios de Naciones Unidas. Ver documentación
GTIN - Números Globales de Identificación de Productos.Estructura de los códigos GTIN:
999 - Códigos libres o autónomosCorresponden a la codificación que las empresas cuentan en sus sistemas para la identificación inequívoca de los bienes o servicios que prestan.
Tipo de dato:
Parametrizado
Especificaciones:
1 -> UNSPSC
10 -> GTIN
20 -> Partida Arancelarias
999 -> Estándar de adopción del contribuyente
Obligatorio:
Si
nombre_grupo_bien_servicio
Descripción:
Nombre de la codificación utilizada para la clasificación de los productos o servicios
Tipo de dato:
Parametrizado
Especificaciones:
UNSPSC -> 1
GTIN -> 10
Partida Arancelarias -> 20
Estándar de adopción del contribuyente -> 999
Obligatorio:
Si
cod_segmento_bien_servicio
Descripción:
Codigo del segmento.
Tipo de dato:
String
Especificaciones:
Dependen del grupo del bien o servicio. Información adicional Ver
Obligatorio:
Si
cod_bien_servicio
Descripción:
Codigo del bien o servicio
Tipo de dato:
String
Especificaciones:
Dependen del segmento del bien o servicio. Información adicional Ver
Obligatorio:
Si
regalo
Descripción:
Indicador de si el ítem es gratuito o no
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
es_regalo
Descripción:
Describe si el articulo es un regalo o muestra comercial
Tipo de dato:
Boolean
Especificaciones:
true o false
Obligatorio:
Si
cod_precio_referencia
Descripción:
Código del tipo de precio informado
Tipo de dato:
Parametrizado
Especificaciones:
1 = Valor comercial
2 = Valor en inventarios
3 = Otro valor
0 = En el caso que no sea regalo
Obligatorio:
Si
precio_referencia
Descripción:
Precio de referencia para línea que no contienen valor comercial.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
cargo_descuento
Descripción:
Información relacionada con un cargo o un descuento
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
es_descuento
Descripción:
Indica que el elemento es un Cargo y no un descuento
Descuento es true cuando es un descuento, un Crédito descuenta el valor del ítem
Cargo es false cuando es un recargo, es un Débito aumenta el valor del item.
Tipo de dato:
Boolean
Especificaciones:
True o false
Obligatorio:
Si
porcentaje_cargo_descuento
Descripción:
Porcentaje de descuento o cargo a la linea de la factura
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_cargo_descuento
Descripción:
Valor Base para calcular el descuento o el cargo
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_cargo_descuento
Descripción:
Valor del descuento o el cargo
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
impuestos_detalle
Descripción:
Información relacionada con el impuesto aplicado a la linea de detalle
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
codigo_impuesto
Descripción:
Identificador del tributo
Tipo de dato:
Parametrizado
Especificaciones:
1= IVA
2= Impuesto al consumo
3= ICA
4= Impuesto nacional al consumo
0= Excluido de IVA
Obligatorio:
Si
porcentaje_impuesto
Descripción:
Tarifa del tributo. Porcentaje del valor tributable a ser aplicada a la base imponible de la linea de detalle. Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base_impuesto
Descripción:
(VU-VD)*Cant). Base Imponible sobre la que se calcula el valor del tributo. Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_impuesto
Descripción:
(((VU-VD)*Cant) * %Imp). Valor del tributo: producto del porcentaje aplicado sobre la base imponible.Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
retenciones_detalle
Descripción:
Información relacionada con los tributos retenidos en la linea de detalle
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
codigo
Descripción:
Identificador de las retenciónes
Tipo de dato:
Parametrizado
Especificaciones:
5= ReteIVA
6= ReteFuente
7= ReteICA
0= No tiene retenciónes
Obligatorio:
Si
porcentaje
Descripción:
Tarifa del tributo retenido. Porcentaje del valor tributable retenido a ser aplicada a la base imponible de la linea de detalle.
Tipo de dato:
Parametrizado ReteFuente - ReteIVA
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base
Descripción:
La base gravable es el valor sobre el cual se aplica la tarifa de la retención
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_retenido
Descripción:
Valor del tributo: producto del porcentaje aplicado sobre la base imponible
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valores_unitarios
Descripción:
Información relacionada con el valor por producto de la linea de detalle, los datos recibidos son utilizados para la representación grafica cuando sea necesario
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
valor_descuento
Descripción:
Valor del descuento aplicado a un producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_con_descuento
Descripción:
Valor del producto aplicando el descuento de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_1
Descripción:
Valor de la base imponible (IVA) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_2
Descripción:
Valor de la base imponible (Impuesto al consumo) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_3
Descripción:
Valor de la base imponible (ICA) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_4
Descripción:
Valor de la base imponible (Impuesto nacional al consumo) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_reteiva
Descripción:
Valor retenido de Reteiva del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_retefuente
Descripción:
Valor retenido de Retefuente del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_reteica
Descripción:
Valor retenido de Reteica del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_a_pagar
Descripción:
Valor total del producto de la linea de detalle, incluyendo descuentos, retenciónes e impuestos
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_total_detalle_con_cargo_descuento
Descripción:
(((VU * Cant)- VD)+VR). Valor total de la linea de detalle incluyendo el descuento y el recargo si aplica
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_detalle
Descripción:
(VU*Cant). Valor total de la linea de detalle sin incluir descuentos, retenciónes o impuestos.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
impuestos
codigo_impuesto
Descripción:
Es la clase que se utiliza para describir el esquema del impuesto
Tipo de dato:
Parametrizado
Especificaciones:
01= IVA
02= Impuesto al consumo
03= ICA
04= Impuesto nacional al consumo
0= Excluido de IVA
Obligatorio:
Si
porcentaje_impuesto
Descripción:
Número de importe del impuesto retenido. Si hay algun item excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base_calculo_impuesto
Descripción:
Base Imponible sobre la que se calcula la retención de impuesto. Si hay algun item excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto
Descripción:
Importe del impuesto retenido. Si hay algun item excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
retenciones
codigo
Descripción:
Identificador de las retenciónes
Tipo de dato:
Parametrizado
Especificaciones:
5= ReteIVA
6= ReteFuente
7= ReteICA
0= No tiene retenciónes
Obligatorio:
No
porcentaje
Descripción:
Importe del impuesto retenido al total de la factura
Tipo de dato:
Parametrizado ReteFuente - ReteIVA
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
No
valor_base
Descripción:
La base gravable es el valor sobre el cual se aplica la tarifa de la retención
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_retenido
Descripción:
Valor total de la retención por factura
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
recargos
nombre_recargo
Descripción:
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
porcentaje_recargo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_base_calculo_recargo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_total_recargo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
descuentos
codigo_descuento
Descripción:
Numero utilizado para categorizar el tipo de descuento otorgado
Tipo de dato:
Parametrizado
Especificaciones:
00= Descuento por impuesto asumido
01= Pague uno lleve otro02= Descuentos contractulales
03= Descuento por pronto pago
04= Envío gratis
05= Descuentos escpecíficos por inventarios
06= Descuento por monto de compras
07= Descuento de temporada
08= Descuento por acturalización de productos / servicios
09= Descuento general
10= Descuento por volumen
11= Otro descuento
99= No aplica descuento
Obligatorio:
Si
porcentaje_descuento
Descripción:
Número del descuento
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_calculo_descuento
Descripción:
Valor Base para calcular el descuento
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_descuento
Descripción:
Valor total del descuento
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_factura
valor_base
Descripción:
Total Valor Bruto antes de tributos: Total valor bruto, suma de los valores brutos de las líneas de la factura incluyendo descuentos mas recargos, es decir la suma de todas las lineas de detalle de los valor_total_detalle_con_cargo_descuento.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_calculo_impuestos
Descripción:
Total Valor Base Imponible : Base imponible para el cálculo de los tributos
tiene que ser la suma de los valores de las bases imponibles de todas líneas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_mas_impuestos
Descripción:
Total de Valor Bruto más tributos
El Valor Bruto más tributos tiene que ser igual 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.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_anticipo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_descuento_total
Descripción:
Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
El Valor del Descuento Total es igual a la Suma de todos los descuentos globales aplicados al total de la factura.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_1
Descripción:
Suma de todos los impuestos 1 aplicados a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_2
Descripción:
Suma de todos los impuestos 2 aplicados a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_3
Descripción:
Tipo de dato:
Suma de todos los impuestos 3 aplicados a nivel de las lineas de detalle
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_4
Descripción:
Tipo de dato:
Suma de todos los impuestos 4 aplicados a nivel de las lineas de detalle
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_reteiva
Descripción:
Suma de todos los reteiva a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_retefuente
Descripción:
Suma de todos los retefuente a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_reteica
Descripción:
Suma de todos los reteica a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_factura
Descripción:
Valor Total de factura: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems)+valor de impuestos + valor cargos – valor descuentos – valor anticipos
El Valor a total de Factura es igual a la Suma de Valor Bruto más tributos - Valor del Descuento Total + Valor del Cargo Total - Valor del Anticipo Total
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_a_pagar
Descripción:
Valor total a pagar: El valor a total de factura es igual a la suma de valor bruto + impuestos - retenciónes - valor del descuento total + valor del cargo total - valor del anticipo total
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
generalidades
tipo_ambiente_dian
Descripción:
Ambiente de la DIAN al que se destina el documento enviado.
Tipo de dato:
Parametrizable
Especificaciones:
1= Producción
2= Pruebas
Obligatorio:
Si
version
Descripción:
Identificación consecutiva de la especificación
Tipo de dato:
Decimal
Especificaciones:
Obligatorio:
Si
identificador_transmision
Descripción:
Código único para identificar el paquete transmitido
Tipo de dato:
Alfanumérico
Especificaciones:
Obligatorio:
Mínimo 5 caracteres
rg_base_64
Descripción:
Pdf del documento elecronico en base 64
Tipo de dato:
Alfanumérico
Especificaciones:
Obligatorio:
Mínimo 5 caracteres
rg_tipo
Descripción:
Si se envia rg_base_64 identificar que tipo de archivo es HTML o PDF
Tipo de dato:
Parametrizable
Especificaciones:
HTML O PDF
Obligatorio:
Si hay información en rg_base_64
rg_px_qr
Descripción:
Información para ubicar el QR dentro del documento envido en base 64
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si se envia el rg_base_64
x
Descripción:
Posicionamiento en x dentro de la representación grafica
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en x desde la posición (0,0)
Obligatorio:
No
y
Descripción:
Posicionamiento en y dentro de la representación grafica
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en y desde la posición (0,0)
Obligatorio:
No
size
Descripción:
Tamaño del qr
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
mostrar_en
Descripción:
Identificador de si el QR en el PDF se pinta en la primera pagina o en todas
Tipo de dato:
Parametrizable
Especificaciones:
PRIMERA_PAGINA,TODAS
Obligatorio:
No
rg_px_cufe
Descripción:
Información de configuración de CUFE en la representación grafica
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si se envia el rg_base_64
x
Descripción:
Posicionamiento en x(abscisas) en el plano cartesiano en el cuarto cuadrante, es decir las columnas empezando de 0.
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en x desde la posición (0,0)
Obligatorio:
No
y
Descripción:
Posicionamiento en y(ordenadas) en el plano cartesiano en el cuarto cuadrante, es decir las filas empezando de 0.
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en y desde la posición (0,0)
Obligatorio:
No
size
Descripción:
Tamaño de la letra
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
mostrar_en
Descripción:
Identificador de si el QR en el PDF se pinta en la primera pagina o en todas
Tipo de dato:
Parametrizable
Especificaciones:
PRIMERA_PAGINA,TODAS
Obligatorio:
No
notificacion
Descripción:
Información de configuración de envio de notificaciones. Los campos de notificación son obligatorios en caso que sea de forma automatica.
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
es_automatico
Descripción:
Indicar si la notificación es enviada de forma automatica
Tipo de dato:
Parametrizado
Especificaciones:
S o N
Obligatorio:
No
correo_obligado
Descripción:
Dirección de correo del obligado
Tipo de dato:
Especificaciones:
xxx@xx.xxx
Obligatorio:
No
asunto
Descripción:
Texto para el envio de las notificaciones
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
con_copia
Descripción:
Tamaño de la letra
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
integrador
Descripción:
Información de quien envia la información
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
nombre
Descripción:
Nombre de quien realiza la integración
Tipo de dato:
Parametrizado
Especificaciones:
S o N
Obligatorio:
Si
tipo
Descripción:
Codigo del medio usado para realizar la integración
Tipo de dato:
Parametrizado
Especificaciones:
MOVIL
WEB
DLL
EXCEL
ERP-XXXXXXXXX
Obligatorio:
Si
webhook
Descripción:
URL para notificar cuando ha ocurrido un evento. Esta se utiliza cuando los codigos de error del retorno del API son 28,20.
Tipo de dato:
String
Especificaciones:
URL con portocolo de seguridad - HTTPS
Obligatorio:
No
cambio_de_moneda
fecha_cambio
Descripción:
Fecha del cambio de la moneda.
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Si la moneda de origen es diferente de COP
codigo
Descripción:
La moneda de referencia para el tipo de cambio; La moneda a partir de la cual se realiza el cambio.
Tipo de dato:
Parametrizado
Especificaciones:
COP- Colombia, USD - dolares. Inf adicional Ver
Obligatorio:
Si la moneda de origen es diferente de COP
valor_base_trm
Descripción:
Tasa de cambio del día de emisión o expedición del documento.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si la moneda de origen es diferente de COP
informacion_factura_contingencia
id_factura_contingencia
Descripción:
Identificación del documento referenciado en esta factura. Prefijo y Número del documento referenciado
Tipo de dato:
String
Especificaciones:
Minimo de 2 caracteres
Obligatorio:
Si
copia_factura
Descripción:
Indicar si la factura ha sido transcrita de manera manual
Tipo de dato:
String
Especificaciones:
true, false
Obligatorio:
Si
fecha_contingencia
Descripción:
Fecha de emisión del documento referenciado.
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Si
tipo_contingencia
Descripción:
Tipo de factura de contingencia.
Tipo de dato:
Parametrizado
Especificaciones:
3 => Factura por Contingencia Facturador
Obligatorio:
Si
codigo_tipo_documento
Descripción:
Identificador del tipo de documento de referencia .
Tipo de dato:
Parametrizado
Especificaciones:
El codigo depende del tipo de factura de contingencia. Inf adicional Ver
Obligatorio:
Si
periodo_facturacion
fecha_inicio
Descripción:
Periodo de Facturación: Intervalo de fechas a las que referencia la factura, por ejemplo servicios públicos, contratos de arrendamiento, matriculas en educación, etc. Fecha de inicio del periodo de facturación
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Opcional, si se utiliza es obligatorio
fecha_fin
Descripción:
Periodo de Facturación: Intervalo de fechas a las que referencia la factura, por ejemplo servicios públicos, contratos de arrendamiento, matriculas en educación, etc. Fecha de fin del periodo de facturación
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Opcional, si se utiliza es obligatorio
- Ejemplo 1. Factura con un detalle de cantidad un e impuesto del 19%
- Ejemplo 2. Factura con varios detalles de cantidad uno y con diferentes impuestos de IVA e impuesto nacional al consumo
- Ejemplo 3. Factura con varios detalles con cantidad mayor que uno y con diferentes impuestos de IVA, ICA, impuesto nacional al consumo
- Ejemplo 4. Factura con un detalle exento de IVA y otros detalles con impuestos
- Ejemplo 5. Factura con adquiriente persona natural
- Ejemplo 6. Factura con descuento a nivel de detalles
- Ejemplo 7. Factura con descuento a nivel de la factura
- Ejemplo 8. Factura con retenciones a nivel de la factura - RETEIVA
- Ejemplo 9. Factura con retenciones a nivel de detalle de la factura - RETEIVA, RETEFUENTE
- Ejemplo 10. Factura con un detalle como regalo
- Ejemplo 11. Factura AIU
- Ejemplo 12. Factura AIU con retenciones
- Ejemplo 13. Factura con recargos a nivel de factura
- Ejemplo 14. Factura con recargos a nivel de detalle de factura
- Ejemplo 15. Factura con varios recargos
- Ejemplo 16. Factura con moneda diferente de COP
- Ejemplo 17. Factura con moneda diferente de COP y persona natural con cedula de extranjeria y residencia en Colombia
- Ejemplo 18. Factura con periodo de facturación
Ejemplo 1.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001557",
"fecha": "2020-05-07",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-07-03",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "600000.00",
"valor_base_mas_impuestos": "714000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "114000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "714000.00",
"valor_total_a_pagar": "714000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 2.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001561",
"fecha": "2020-05-07",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "60000.00",
"descripcion": "Provisión ",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "60000.00",
"valor_impuesto": "9600.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "60000.00",
"valor_total_detalle": "60000.00"
},
{
"numero_linea": 3,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "50000.00",
"descripcion": "Provisión ",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_impuesto": "50000.00",
"valor_impuesto": "4000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "50000.00",
"valor_total_detalle": "50000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "60000.00",
"valor_total_impuesto": "9600.00"
},
{
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_calculo_impuesto": "50000.00",
"valor_total_impuesto": "4000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "710000.00",
"valor_base_calculo_impuestos": "710000.00",
"valor_base_mas_impuestos": "837600.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "123600.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "4000.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "837600.00",
"valor_total_a_pagar": "837600.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 3.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001563",
"fecha": "2020-05-07",
"hora": "12:25:30",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 10,
"identificador_de_pago": "",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "3005211254",
"nombre": {
"razon_social": "PIXELPRO S.A.S.\t",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 4,
"valor_unitario": "480000.00",
"unidad_de_cantidad": "94",
"descripcion": "Configuración inicial afacturar ",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1920000.00",
"valor_impuesto": "364800.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1920000.00",
"valor_total_detalle": "1920000.00"
},
{
"numero_linea": 2,
"cantidad": 168,
"unidad_de_cantidad": "94",
"valor_unitario": "10000.00",
"descripcion": "Servicio2",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "1680000.00",
"valor_impuesto": "268800.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1680000.00",
"valor_total_detalle": "1680000.00"
},
{
"numero_linea": 3,
"cantidad": 23,
"unidad_de_cantidad": "94",
"valor_unitario": "5000.00",
"descripcion": "Servicio1",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "5.00",
"valor_base_impuesto": "115000.00",
"valor_impuesto": "5750.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "115000.00",
"valor_total_detalle": "115000.00"
},
{
"numero_linea": 4,
"cantidad": 3,
"unidad_de_cantidad": "94",
"valor_unitario": "52000.00",
"descripcion": "Servicio4",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_impuesto": "156000.00",
"valor_impuesto": "12480.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "156000.00",
"valor_total_detalle": "156000.00"
},
{
"numero_linea": 5,
"cantidad": 12,
"unidad_de_cantidad": "94",
"valor_unitario": "58000.00",
"descripcion": "Servicio 4 - 16",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 4,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "696000.00",
"valor_impuesto": "111360.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "696000.00",
"valor_total_detalle": "696000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1920000.00",
"valor_total_impuesto": "364800.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "1680000.00",
"valor_total_impuesto": "268800.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "5.00",
"valor_base_calculo_impuesto": "115000.00",
"valor_total_impuesto": "5750.00"
},
{
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_calculo_impuesto": "156000.00",
"valor_total_impuesto": "12480.00"
},
{
"codigo_impuesto": 4,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "696000.00",
"valor_total_impuesto": "111360.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "4567000.00",
"valor_base_calculo_impuestos": "4567000.00",
"valor_base_mas_impuestos": "5330190.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "639350.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "123840.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "5330190.00",
"valor_total_a_pagar": "5330190.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 4.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001564",
"fecha": "2020-05-07",
"hora": "12:37:32",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 10,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "3015223786",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 4,
"valor_unitario": "36000.00",
"unidad_de_cantidad": "94",
"descripcion": "Servicio Exento",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "144000.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "144000.00",
"valor_total_detalle": "144000.00"
},
{
"numero_linea": 2,
"cantidad": 3,
"valor_unitario": "480000.00",
"unidad_de_cantidad": "94",
"descripcion": "Configuración inicial afacturar ",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1440000.00",
"valor_impuesto": "273600.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1440000.00",
"valor_total_detalle": "1440000.00"
},
{
"numero_linea": 3,
"cantidad": 23,
"valor_unitario": "3500.00",
"unidad_de_cantidad": "94",
"descripcion": "R-PI34-SW-K9",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "80500.00",
"valor_impuesto": "15295.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "80500.00",
"valor_total_detalle": "80500.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "144000.00",
"valor_total_impuesto": "0.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1520500.00",
"valor_total_impuesto": "288895.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "1664500.00",
"valor_base_calculo_impuestos": "1664500.00",
"valor_base_mas_impuestos": "1953395.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "288895.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "1953395.00",
"valor_total_a_pagar": "1953395.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 5.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001566",
"fecha": "2020-05-07",
"hora": "15:01:50",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 10,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 2,
"tipo_regimen": 0,
"tipo_identificacion": 13,
"identificacion": "52984786",
"correo_electronico": "info@teleinte.com",
"numero_movil": "3103103100",
"nombre": {
"razon_social": "",
"primer_nombre": "Maria",
"segundo_nombre": "Liliana",
"apellido": "Perez"
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"valor_unitario": "750000.00",
"unidad_de_cantidad": "94",
"descripcion": "SRV-ITL-PSSAV Servicios",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "750000.00",
"valor_impuesto": "142500.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "750000.00",
"valor_total_detalle": "750000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "750000.00",
"valor_total_impuesto": "142500.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "750000.00",
"valor_base_calculo_impuestos": "750000.00",
"valor_base_mas_impuestos": "892500.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "142500.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "892500.00",
"valor_total_a_pagar": "892500.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 6.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001567",
"fecha": "2020-05-07",
"hora": "08:37:32",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 10,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "31031031031",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "36000.00",
"descripcion": "Servicio Exento",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": true,
"porcentaje_cargo_descuento": "10.00",
"valor_base_cargo_descuento": "36000.00",
"valor_cargo_descuento": "3600.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "32400.00",
"valor_impuesto": "6156.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "32400.00",
"valor_total_detalle": "36000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "75000.00",
"descripcion": "Servicio descuento",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": true,
"porcentaje_cargo_descuento": "20.00",
"valor_base_cargo_descuento": "75000.00",
"valor_cargo_descuento": "15000.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "60000.00",
"valor_impuesto": "9600.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "60000.00",
"valor_total_detalle": "75000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "32400.00",
"valor_total_impuesto": "6156.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "60000.00",
"valor_total_impuesto": "9600.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "92400.00",
"valor_base_calculo_impuestos": "92400.00",
"valor_base_mas_impuestos": "108156.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "15756.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "108156.00",
"valor_total_a_pagar": "108156.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 7.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001568",
"fecha": "2020-05-07",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 11,
"porcentaje_descuento": "10.00",
"valor_base_calculo_descuento": "600000.00",
"valor_total_descuento": "60000.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "600000.00",
"valor_base_mas_impuestos": "714000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "60000.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "114000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "654000.00",
"valor_total_a_pagar": "654000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 8.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001569",
"fecha": "2020-05-07",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
}
],
"retenciones": [
{
"codigo": 5,
"porcentaje": "15.00",
"valor_base": "600000.00",
"valor_retenido": "90000.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "600000.00",
"valor_base_mas_impuestos": "714000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "114000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "90000.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "714000.00",
"valor_total_a_pagar": "624000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 9.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001570",
"fecha": "2020-05-07",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "187000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "187000.00",
"valor_impuesto": "35530.00"
},
"retenciones_detalle": [
{
"codigo": 5,
"porcentaje": "15.00",
"valor_base": "35530.00",
"valor_retenido": "5329.50"
},
{
"codigo": 6,
"porcentaje": "10.00",
"valor_base": "187000.00",
"valor_retenido": "18700.00"
}
],
"valor_total_detalle_con_cargo_descuento": "187000.00",
"valor_total_detalle": "187000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "1000000.00",
"descripcion": "Servicio de provisión inicial",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "1000000.00",
"valor_impuesto": "160000.00"
},
"retenciones_detalle": [
{
"codigo": 5,
"porcentaje": "15.00",
"valor_base": "160000.00",
"valor_retenido": "24000.00"
},
{
"codigo": 6,
"porcentaje": "4.00",
"valor_base": "1000000.00",
"valor_retenido": "40000.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1000000.00",
"valor_total_detalle": "1000000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "187000.00",
"valor_total_impuesto": "35530.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "1000000.00",
"valor_total_impuesto": "160000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "1187000.00",
"valor_base_calculo_impuestos": "1187000.00",
"valor_base_mas_impuestos": "1382530.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "195530.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "29329.50",
"valor_total_retefuente": "58700.00",
"valor_total_reteica": "0.00",
"total_factura": "1382530.00",
"valor_total_a_pagar": "1382530.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 10.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001571",
"fecha": "2019-08-25",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": "",
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"valor_unitario": "0.00",
"unidad_de_cantidad": "94",
"descripcion": "Servicio de provisión inicial",
"regalo": {
"es_regalo": true,
"cod_precio_referencia": 3,
"precio_referencia": "1000000.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "1000000.00",
"valor_impuesto": "160000.00"
},
"retenciones_detalle": [
{
"codigo": "",
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "0.00",
"valor_total_detalle": "0.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "1000000.00",
"valor_total_impuesto": "160000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "1600000.00",
"valor_base_mas_impuestos": "874000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "274000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "874000.00",
"valor_total_a_pagar": "874000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 11.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001572",
"fecha": "2020-05-07",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Administración: Contrato de AIU por concepto de : xxxxxxxxx",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "60000.00",
"descripcion": "Regalo",
"regalo": {
"es_regalo": true,
"cod_precio_referencia": 1,
"precio_referencia": "60000.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "0.00",
"valor_total_detalle": "0.00"
},
{
"numero_linea": 3,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "60000.00",
"descripcion": "Utilidad",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "60000.00",
"valor_impuesto": "11400.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "60000.00",
"valor_total_detalle": "60000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "60000.00",
"valor_total_impuesto": "11400.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "660000.00",
"valor_base_calculo_impuestos": "60000.00",
"valor_base_mas_impuestos": "671400.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "11400.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "671400.00",
"valor_total_a_pagar": "671400.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 12.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000628",
"fecha": "2019-08-25",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia":{
"tipo_contingencia":3,
"cod_documento_contingencia":"FTC",
"id_factura_contingencia":"SETP990000100",
"fecha_contingencia":"2019-08-01"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10 ",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2985,
"unidad_de_cantidad": "94",
"valor_unitario": "1682.00",
"descripcion": "Materiales de excavacion",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "5020770.00",
"valor_total_detalle": "5020770.00"
},
{
"numero_linea": 2,
"cantidad": 795,
"unidad_de_cantidad": "94",
"valor_unitario": "2045.00",
"descripcion": "Excavacion",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1625775.00",
"valor_total_detalle": "1625775.00"
},
{
"numero_linea": 3,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "332327.25",
"descripcion": "Administración",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "332327.25",
"valor_total_detalle": "332327.25"
},
{
"numero_linea": 4,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "66465.45",
"descripcion": "Imprevisto",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "66465.45",
"valor_total_detalle": "66465.45"
},
{
"numero_linea": 5,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "332327.25",
"descripcion": "Utilidad",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "332327.25",
"valor_impuesto": "63142.18"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "332327.25",
"valor_total_detalle": "332327.25"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "332327.25",
"valor_total_impuesto": "63142.18"
}
],
"descuentos": [
{
"codigo_descuento": 0,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"retenciones": [
{
"codigo": 6,
"porcentaje": "2.00",
"valor_base": "7377664.95",
"valor_retenido": "147553.30"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "7377664.95",
"valor_base_calculo_impuestos": "332327.25",
"valor_base_mas_impuestos": "7440807.13",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "63142.18",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "147553.30",
"valor_total_reteica": "0.00",
"total_factura": "7440807.13",
"valor_total_a_pagar": "7440807.13"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 13.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001574",
"fecha": "2020-05-07",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 2,
"tipo_regimen": 0,
"tipo_identificacion": 22,
"identificacion": "392546",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "Andres ",
"segundo_nombre": "",
"apellido": "Perez"
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10 ",
"RUT": {
"resp_calidades_atributos": [
"O-99"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"unidad_de_cantidad": "94",
"valor_unitario": "15000.00",
"descripcion": "Materiales de excavacion",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "30000.00",
"valor_impuesto": "5700.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "30000.00",
"valor_total_detalle": "30000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "30000.00",
"valor_total_impuesto": "5700.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "Prueba de recargo",
"porcentaje_recargo": "2.00",
"valor_base_calculo_recargo": "30000.00",
"valor_total_recargo": "600.00"
}
],
"descuentos": [
{
"codigo_descuento": 0,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "30000.00",
"valor_base_calculo_impuestos": "30000.00",
"valor_base_mas_impuestos": "35700.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "600.00",
"valor_total_impuesto_1": "5700.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "36300.00",
"valor_total_a_pagar": "36300.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 14.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001575",
"fecha": "2020-05-07",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 2,
"tipo_regimen": 0,
"tipo_identificacion": 22,
"identificacion": "392546",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "Andres ",
"segundo_nombre": "",
"apellido": "Perez"
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "10000.00",
"descripcion": "Materiales de excavacion",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "2.00",
"valor_base_cargo_descuento": "10000.00",
"valor_cargo_descuento": "200.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "10200.00",
"valor_impuesto": "1938.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "10200.00",
"valor_total_detalle": "10200.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "10200.00",
"valor_total_impuesto": "1938.00"
}
],
"descuentos": [
{
"codigo_descuento": 0,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "10200.00",
"valor_base_calculo_impuestos": "10200.00",
"valor_base_mas_impuestos": "12138.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "1938.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "12138.00",
"valor_total_a_pagar": "12138.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 15.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001575",
"fecha": "2020-05-07",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 2,
"tipo_regimen": 0,
"tipo_identificacion": 22,
"identificacion": "392546",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "Andres ",
"segundo_nombre": "",
"apellido": "Perez"
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-99"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"unidad_de_cantidad": "94",
"valor_unitario": "15000.00",
"descripcion": "Materiales de excavacion",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "30000.00",
"valor_impuesto": "5700.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "30000.00",
"valor_total_detalle": "30000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "30000.00",
"valor_total_impuesto": "5700.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "Prueba de recargo",
"porcentaje_recargo": "2.00",
"valor_base_calculo_recargo": "30000.00",
"valor_total_recargo": "600.00"
},
{
"nombre_recargo": "Envio de mercancia",
"porcentaje_recargo": "5.00",
"valor_base_calculo_recargo": "30000.00",
"valor_total_recargo": "1500.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "30000.00",
"valor_base_calculo_impuestos": "30000.00",
"valor_base_mas_impuestos": "35700.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "2100.00",
"valor_total_impuesto_1": "5700.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "37800.00",
"valor_total_a_pagar": "37800.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 16.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001577",
"fecha": "2020-05-07",
"hora": "21:34:55",
"moneda": "USD",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 42,
"identificador_de_pago": "PRUEBA",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "documento origen",
"prefijo": "SETP",
"nota": [
"{ 'Son':'' }"
]
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"cambio_de_moneda": {
"fecha_cambio": "2019-08-21",
"codigo": "COP",
"valor_base_trm": "3500.00"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "901219999",
"correo_electronico": "wmg@oxsoft.com.co",
"numero_movil": "",
"nombre": {
"razon_social": "ACME",
"primer_nombre": "ACME",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Cra 10 85 via caracas",
"RUT": {
"resp_calidades_atributos": [
"O-99"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 100,
"unidad_de_cantidad": "94",
"valor_unitario": "13400.00",
"descripcion": "Producto",
"valor_total_detalle_con_cargo_descuento": "1340000.00",
"valor_total_detalle": "1340000.00",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1340000.00",
"valor_impuesto": "254600.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valores_unitarios": {
"valor_descuento": "0.00",
"valor_con_descuento": "0.00",
"valor_impuesto_1": "0.00",
"valor_impuesto_2": "0.00",
"valor_impuesto_3": "0.00",
"valor_impuesto_4": "0.00",
"valor_reteiva": "0.00",
"valor_retefuente": "0.00",
"valor_reteica": "0.00",
"valor_a_pagar": "1340000.00"
}
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1340000.00",
"valor_total_impuesto": "254600.00"
}
],
"retenciones": [
{
"codigo": 6,
"porcentaje": "15.000",
"valor_base": "254600.00",
"valor_retenido": "38190.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "1340000.00",
"valor_base_calculo_impuestos": "1340000.00",
"valor_base_mas_impuestos": "1594600.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "254600.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "38190.00",
"valor_total_reteica": "0.00",
"total_factura": "1594600.00",
"valor_total_a_pagar": "1556410.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validacion previa",
"integrador": {
"nombre": "OxSoft",
"tipo": "WEB"
}
}
}
Ejemplo 17.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001578",
"fecha": "2020-05-07",
"hora": "21:34:55",
"moneda": "USD",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 42,
"identificador_de_pago": "PRUEBA",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "documento origen",
"prefijo": "SETP",
"nota": [
"{ 'Son':'' }"
]
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"cambio_de_moneda": {
"fecha_cambio": "2019-08-21",
"codigo": "COP",
"valor_base_trm": "3500.00"
},
"informacion_adquiriente": {
"tipo_contribuyente": 2,
"tipo_regimen": 0,
"tipo_identificacion": 22,
"identificacion": "392546",
"correo_electronico": "wmg@oxsoft.com.co",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "Andres",
"segundo_nombre": "",
"apellido": "Perez"
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "",
"RUT": {
"resp_calidades_atributos": [
"O-99"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 100,
"unidad_de_cantidad": "94",
"valor_unitario": "13400.00",
"descripcion": "Producto",
"valor_total_detalle_con_cargo_descuento": "1340000.00",
"valor_total_detalle": "1340000.00",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1340000.00",
"valor_impuesto": "254600.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valores_unitarios": {
"valor_descuento": "0.00",
"valor_con_descuento": "0.00",
"valor_impuesto_1": "0.00",
"valor_impuesto_2": "0.00",
"valor_impuesto_3": "0.00",
"valor_impuesto_4": "0.00",
"valor_reteiva": "0.00",
"valor_retefuente": "0.00",
"valor_reteica": "0.00",
"valor_a_pagar": "1340000.00"
}
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1340000.00",
"valor_total_impuesto": "254600.00"
}
],
"retenciones": [
{
"codigo": 6,
"porcentaje": "15.000",
"valor_base": "254600.00",
"valor_retenido": "38190.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "1340000.00",
"valor_base_calculo_impuestos": "1340000.00",
"valor_base_mas_impuestos": "1594600.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "254600.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "38190.00",
"valor_total_reteica": "0.00",
"total_factura": "1594600.00",
"valor_total_a_pagar": "1556410.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validacion previa",
"integrador": {
"nombre": "OxSoft",
"tipo": "WEB"
}
}
}
Ejemplo 18.
{
"facturas": [
{
"encabezado": {
"id_factura": "990001579",
"fecha": "2020-05-07",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "SETP990000100",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"periodo_facturacion": {
"fecha_inicio":"2019-08-01",
"fecha_fin":"2019-08-30"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "600000.00",
"valor_base_mas_impuestos": "714000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "114000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "714000.00",
"valor_total_a_pagar": "714000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Salida Exitosa
Salida con errores de semantica
Salida con errores de datos
Salida con errores HTTP
Salida con error de datos en la DIAN
{
"codigo_error": 0,
"descripcion_error": "OK",
"tiempo_ejecucion": 2.8475100994110109,
"transaccion": "5e5e5e5e5e55e",
"resultado": {
"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"id_factura": "SETP990001502",
"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
"url_application_response": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ar083002047005520SETP990001502.xml",
"url_attached_document_url": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ad083002047005520SETP990001502.xml",
"url_representacion_grafica": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.pdf",
"url_notificacion_aceptacion_rechazo": "http://app.afacturar.com/consulta_documento/?uid=5e5e5e5e5e55e"
},
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": ""
}
Salida con errores de semantica
{
"codigo_error": 400,
"descripcion_error": "Hay un problema con la informacion entregada",
"tiempo_ejecucion": 0.01330113410949707,
"transaccion": "5e74ce82707f6",
"resultado": [
{
"propiedad": "facturas[0].encabezado.tipo_factura",
"descripcion": "The property tipo_factura is required"
},
{
"propiedad": "facturas[0].encabezado.tipo_factura",
"descripcion": "Does not have a value in the enumeration [1,2,3,5,6,7,8,9,10]"
},
{
"propiedad": "facturas[0].encabezado",
"descripcion": "The property tipo_factur is not defined and the definition does not allow additional properties"
}
],
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": ""
}
Salida con errores de datos
{
"codigo_error": 400,
"descripcion_error": "Hay problema(s) con la información entregada",
"resultado": [
[
{
"propiedad": "facturas->encabezado-> numero_resolucion_facturacion y facturas->encabezado-> prefijo",
"descripcion": "No exiten rangos de facturación para la resolución SET + 18760000001 "
},
{
"propiedad": "facturas->fecha_vencimiento",
"descripcion": "Si el metodo de pago es contado, la fecha de vencimiento debe ir vacia"
}
]
]
}
Salida con errores HTTP
{
"codigo_error": 500,
"descripcion_error": "Unauthenticated."
}
Salida con error de datos en la DIAN
{
"codigo_error": 15,
"descripcion_error": "La validación en la DIAN devuelve error(es)",
"tiempo_ejecucion": 1.9776690006256104,
"transaccion": "5e74d144dd565",
"resultado": {
"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"id_factura": "SETP990001504",
"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
},
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": "Regla: FAU06, Rechazo: 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.Regla: FAU02, Rechazo: 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"
}
CURL
curl -X POST \
https://servicios-pruebas.afacturar.com/api/vp/factura_contingencia \
-H 'accept: application/json' \
-H 'authorization: Bearer token_obligado' \
-H 'cache-control: no-cache' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-H 'postman-token: 7d6d9f51-7372-30a6-4f37-fa651f384b75' \
-F 'data={
"facturas": [
{
"encabezado": {
"id_factura": "990001502",
"fecha": "2020-03-19",
"hora": "05:36:10",
"nota": [
"{'\''SON'\'':'\''XXX XXX XXX'\''",
"'\''VARIABLE'\'':'\''VALOR'\''}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 2,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2020-03-19",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_factura_contingencia": {
"id_factura_contingencia": "xxxxxxxxxxxxx",
"copia_factura": "true",
"fecha_contingencia": "2019-08-01",
"tipo_contingencia": 3,
"codigo_tipo_documento": "03-A"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "830020470",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "ABC S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "600000.00",
"valor_base_mas_impuestos": "714000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "114000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "714000.00",
"valor_total_a_pagar": "714000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}' \
-F documento_obligado=830020470
C#
var client = new RestClient("https://servicios-pruebas.afacturar.com/api/vp_des/factura_contingencia");
var request = new RestRequest(Method.POST);
request.AddHeader("postman-token", "f4d9caa5-eb61-9985-6ea0-e9df18b4c8f1");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("authorization", "Bearer token_obligado");
request.AddHeader("accept", "application/json");
request.AddHeader("content-type", "multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW");
request.AddParameter("multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW", "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"data\"\r\n\r\n{\n\t\"facturas\": [\n\t\t{\n\t\t\t\"encabezado\": {\n\t\t\t\t\"id_factura\": \"990001675\",\n\t\t\t\t\"fecha\": \"2020-06-25\",\n\t\t\t\t\"hora\": \"05:36:10\",\n\t\t\t\t\"nota\": [\n\t\t\t\t\t\"{'SON':'XXX XXX XXX'\",\n\t\t\t\t\t\"'VARIABLE':'VALOR'}\"\n\t\t\t\t],\n\t\t\t\t\"moneda\": \"COP\",\n\t\t\t\t\"tipo_factura\": 10,\n\t\t\t\t\"metodo_de_pago\": 1,\n\t\t\t\t\"tipo_de_pago\": 41,\n\t\t\t\t\"identificador_de_pago\": \"ABC1234\",\n\t\t\t\t\"numero_resolucion_facturacion\": \"18760000001\",\n\t\t\t\t\"fecha_vencimiento\": \"\",\n\t\t\t\t\"numero_orden\": \"\",\n\t\t\t\t\"prefijo\": \"SETP\"\n\t\t\t},\n\t\t\t\"informacion_factura_contingencia\": {\n\t\t\t\t\"id_factura_contingencia\": \"SETP990000100\",\n\t\t\t\t\"copia_factura\": \"true\",\n\t\t\t\t\"fecha_contingencia\": \"2019-08-01\",\n\t\t\t\t\"tipo_contingencia\": 3,\n\t\t\t\t\"codigo_tipo_documento\": \"03-A\"\n\t\t\t},\n\t\t\t\"periodo_facturacion\": {\n\t\t\t\t\"fecha_inicio\":\"2019-08-01\",\n\t\t\t\t\"fecha_fin\":\"2019-08-30\"\n\t\t\t},\n\t\t\t\"informacion_adquiriente\": {\n\t\t\t\t\"tipo_contribuyente\": 2,\n\t\t\t\t\"tipo_regimen\": 2,\n\t\t\t\t\"tipo_identificacion\": 31,\n\t\t\t\t\"identificacion\": \"33700230\",\n\t\t\t\t\"correo_electronico\": \"info@teleinte.com\",\n\t\t\t\t\"numero_movil\": \"\",\n\t\t\t\t\"nombre\": {\n\t\t\t\t\t\"razon_social\": \"\",\n\t\t\t\t\t\"primer_nombre\": \"Andrea\",\n\t\t\t\t\t\"segundo_nombre\": \"\",\n\t\t\t\t\t\"apellido\": \"Cañón\"\n\t\t\t\t},\n\t\t\t\t\"pais\": \"CO\",\n\t\t\t\t\"departamento\": \"11\",\n\t\t\t\t\"ciudad\": \"11001\",\n\t\t\t\t\"zona\": \"\",\n\t\t\t\t\"direccion\": \"Carrera 10\",\n\t\t\t\t\"RUT\": {\n\t\t\t\t\t\"resp_calidades_atributos\": [\n\t\t\t\t\t\t\"O-07\",\n\t\t\t\t\t\t\"O-08\"\n\t\t\t\t\t],\n\t\t\t\t\t\"usuario_aduanero\": [\n\t\t\t\t\t\t\"\"\n\t\t\t\t\t]\n\t\t\t\t}\n\t\t\t},\n\t\t\t\"detalle_factura\": [\n\t\t\t\t{\n\t\t\t\t\t\"numero_linea\": 1,\n\t\t\t\t\t\"cantidad\": 1,\n\t\t\t\t\t\"unidad_de_cantidad\": \"94\",\n\t\t\t\t\t\"valor_unitario\": \"600000.00\",\n\t\t\t\t\t\"descripcion\": \"Provisión inicial afacturar\",\n\t\t\t\t\t\"nota_detalle\": \"Nota de detalle\",\n\t\t\t\t\t\"regalo\": {\n\t\t\t\t\t\t\"es_regalo\": false,\n\t\t\t\t\t\t\"cod_precio_referencia\": 0,\n\t\t\t\t\t\t\"precio_referencia\": \"0.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"cargo_descuento\": {\n\t\t\t\t\t\t\"es_descuento\": false,\n\t\t\t\t\t\t\"porcentaje_cargo_descuento\": \"0.00\",\n\t\t\t\t\t\t\"valor_base_cargo_descuento\": \"0.00\",\n\t\t\t\t\t\t\"valor_cargo_descuento\": \"0.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"impuestos_detalle\": {\n\t\t\t\t\t\t\"codigo_impuesto\": 1,\n\t\t\t\t\t\t\"porcentaje_impuesto\": \"19.00\",\n\t\t\t\t\t\t\"valor_base_impuesto\": \"600000.00\",\n\t\t\t\t\t\t\"valor_impuesto\": \"114000.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"retenciones_detalle\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"codigo\": 0,\n\t\t\t\t\t\t\t\"porcentaje\": \"0.00\",\n\t\t\t\t\t\t\t\"valor_base\": \"0.00\",\n\t\t\t\t\t\t\t\"valor_retenido\": \"0.00\"\n\t\t\t\t\t\t}\n\t\t\t\t\t],\n\t\t\t\t\t\"valor_total_detalle_con_cargo_descuento\": \"600000.00\",\n\t\t\t\t\t\"valor_total_detalle\": \"600000.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"impuestos\": [\n\t\t\t\t{\n\t\t\t\t\t\"codigo_impuesto\": 1,\n\t\t\t\t\t\"porcentaje_impuesto\": \"19.00\",\n\t\t\t\t\t\"valor_base_calculo_impuesto\": \"600000.00\",\n\t\t\t\t\t\"valor_total_impuesto\": \"114000.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"retenciones\": [\n\t\t\t\t{\n\t\t\t\t\t\"codigo\": 5,\n\t\t\t\t\t\"porcentaje\": \"0.00\",\n\t\t\t\t\t\"valor_base\": \"337000.00\",\n\t\t\t\t\t\"valor_retenido\": \"0.00\"\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"codigo\": 6,\n\t\t\t\t\t\"porcentaje\": \"0.00\",\n\t\t\t\t\t\"valor_base\": \"337000.00\",\n\t\t\t\t\t\"valor_retenido\": \"0.00\"\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"codigo\": 7,\n\t\t\t\t\t\"porcentaje\": \"0.00\",\n\t\t\t\t\t\"valor_base\": \"337000.00\",\n\t\t\t\t\t\"valor_retenido\": \"0.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"recargos\": [\n\t\t\t\t{\n\t\t\t\t\t\"nombre_recargo\": \"Flete\",\n\t\t\t\t\t\"porcentaje_recargo\": \"100.00\",\n\t\t\t\t\t\"valor_base_calculo_recargo\": \"0.00\",\n\t\t\t\t\t\"valor_total_recargo\": \"0.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"descuentos\": [\n\t\t\t\t{\n\t\t\t\t\t\"codigo_descuento\": 99,\n\t\t\t\t\t\"porcentaje_descuento\": \"0.00\",\n\t\t\t\t\t\"valor_base_calculo_descuento\": \"0.00\",\n\t\t\t\t\t\"valor_total_descuento\": \"0.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"valor_factura\": {\n\t\t\t\t\"valor_base\": \"600000.00\",\n\t\t\t\t\"valor_base_calculo_impuestos\": \"600000.00\",\n\t\t\t\t\"valor_base_mas_impuestos\": \"714000.00\",\n\t\t\t\t\"valor_anticipo\": \"0.00\",\n\t\t\t\t\"valor_descuento_total\": \"0.00\",\n\t\t\t\t\"valor_total_recargos\": \"0.00\",\n\t\t\t\t\"valor_total_impuesto_1\": \"114000.00\",\n\t\t\t\t\"valor_total_impuesto_2\": \"0.00\",\n\t\t\t\t\"valor_total_impuesto_3\": \"0.00\",\n\t\t\t\t\"valor_total_impuesto_4\": \"0.00\",\n\t\t\t\t\"valor_total_reteiva\": \"0.00\",\n\t\t\t\t\"valor_total_retefuente\": \"0.00\",\n\t\t\t\t\"valor_total_reteica\": \"0.00\",\n\t\t\t\t\"total_factura\": \"714000.00\",\n\t\t\t\t\"valor_total_a_pagar\": \"714000.00\"\n\t\t\t}\n\t\t}\n\t],\n\t\"generalidades\": {\n\t\t\"tipo_ambiente_dian\": 2,\n\t\t\"version\": 2,\n\t\t\"identificador_transmision\": \"2019 validación previa\",\n\t\t\"integrador\": {\n\t\t\t\"nombre\": \"Afacturar.com\",\n\t\t\t\"tipo\": \"WEB\"\n\t\t}\n\t}\n}\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"documento_obligado\"\r\n\r\n830020470\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Nota crédito
Especificación detallada para recibir información de la nota crédito para ser procesadas en la plataforma
Histórico de cambios
| Versión | Cambios | Fecha |
|---|---|---|
| 2.8 | En la variable detalle_factura se adiciono las variables marca, modelo y codificacion_estandar. Estas variables se utilizan para tener mas información de los productos y/o servicios, permitiendo a los clientes codificar productos y servicios de forma clara, basandose en estándares acordados por la industria los cuales facilitan el comercio entre empresas y gobierno | 08 de junio de 2020 |
| 2.7 | En la variable informacion_adquiriente -> correo_electronico permitir varias direcciones de correo. Se debe tener en cuenta que la primera dirección de correo es la utilizada para el envio de la notificación al adquiriente. | 08 de mayo de 2020 |
| 2.6 | Se adiciono en nota_credito -> encabezado la variable "numero_orden", para los documentos que tienen el numero de la orden y asi visualizar en el xml el grupo OrderReference | 07 de Abril de 2020 |
| 2.5 | Los PDFs que se reciben en base64 se adiciono en generalidades -> rg_px_cufe y rg_px_qr, la opción de mostrar_en, para indicar si el QR y el CUFE/CUDE debe pintarse en la primera pagina o en todas. | 05 de Marzo de 2020 |
| 2.4 |
Se adiciono en informacion_factura las variables "tipo_documento" y "codigo_tipo_documento", para identificar el tipo de documento al que se va a realizar la nota credito, ademas se adiciono en el detalle_factura el objeto "regalo" y la variable "nota_detalle".
Para realizar notas credito de facturas tipo AIU se debe enviar el tipo_documento, codigo_tipo_documento y en los detalles en el item de Admistración en la descripción la paralabra clave ADMINISTRACION y en la variable nota_detalle el objeto del contrato. Ejemplo: |
27 de febrero de 2020 |
| 2.3 |
Se adiciono las retenciones por detalle y por documento. Para hacer notas credito de documentos que contengan retenciones, es necesario que envien en encabezado -> nota, las siguientes variables con el valor retenido encada una de ellas.
Ejemplo: "nota": ["{'variable_uno':'valor_uno','variable_dos':'valor_dos','vr_rte_iva':'0.00','vr_rte_fte':'0.00','vr_rte_ica':'0.00'}"] |
24 de febrero de 2020 |
| 2.2 |
Se agregó el nombre del país, departamento y ciudad para mostrar en la representación gráfica.
El tipo de pago ZZZ se cambio por -999 para validar datos tipo numérico como dato de entrada. |
16 de Octubre de 2019 |
| 2.1 | Adición de variables. Cambio de nombre de variables que sean legibles. | 27 de Agosto de 2019 |
| 2 | Ajustes de validación previa | 09 de Agosto de 2019 |
POST
/nota_credito
documento_obligado:
000000000
data:
{
"nota_credito": [{
"encabezado": {
"id_nota_credito": "",
"fecha": "",
"hora": "",
"nota": ["{'':'','':'','':'','':'','':'','':''}"],
"moneda": "",
"tipo_nota_credito": ##,
"numero_orden": ""
},
"informacion_factura": {
"id_factura": "",
"codigo_unico_factura": "",
"fecha": "",
"hora": "",
"tipo_documento": "",
"codigo_tipo_documento": "",
},
"cambio_de_moneda":{
"fecha_cambio":"",
"codigo":"",
"valor_base_trm":"0.00"
},
"informacion_adquiriente": {
"tipo_contribuyente": #,
"tipo_regimen": #,
"tipo_identificacion":#,
"identificacion": ""
"correo_electronico": "",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "",
"nombre_pais": "",
"departamento": "",
"nombre_departamento": "",
"zona": "",
"ciudad": "",
"nombre_ciudad": "",
"direccion": "",
"RUT": {
"resp_calidades_atributos": ["",""],
"usuario_aduanero": [""]
}
},
"detalle_factura": [{
"numero_linea": #,
"cantidad": #,
"unidad_de_cantidad":"" ,
"valor_unitario": "0.00",
"descripcion": "",
"nota_detalle": "",
"marca": "",
"modelo": "",
"codificacion_estandar": {
"cod_grupo_bien_servicio": "",
"nombre_grupo_bien_servicio": "",
"cod_segmento_bien_servicio": "",
"cod_bien_servicio": ""
},
"regalo": {
"es_regalo": "",
"cod_precio_referencia": #,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": "",
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": #,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [{
"codigo": #,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}],
"valores_unitarios":{
"valor_impuesto_1":"0.00",
"valor_impuesto_2":"0.00",
"valor_impuesto_3":"0.00",
"valor_impuesto_4":"0.00",
"valor_a_pagar":"0.00"
},
"valor_total_detalle_con_cargo_descuento": "0.00",
"valor_total_detalle": "0.00"
}],
"impuestos": [{
"codigo_impuesto": #,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "0.00",
"valor_total_impuesto": "0.00"
}],
"retenciones":[{
"codigo": #,
"porcentaje":"0.00",
"valor_base":"0.00",
"valor_retenido":"0.00"
}],
"recargos": [{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}],
"descuentos": [{
"codigo_descuento": #,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}],
"valor_nota_credito": {
"valor_base": "0.00",
"valor_base_calculo_impuestos": "0.00",
"valor_base_mas_impuestos": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "0.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_nota_credito": "0.00",
"valor_total_a_pagar": "0.00"
}
}],
"generalidades": {
"tipo_ambiente_dian": #,
"version": #,
"identificador_transmision": "",
"rg_tipo":"",
"rg_base_64":"",
"rg_px_qr": {
"x":"",
"y":"",
"size":"",
"mostrar_en":""
},
"rg_px_cufe": {
"x":"",
"y":"",
"size":"",
"mostrar_en":""
},
"integrador": {
"nombre":"",
"tipo":"",
"webhook": ""
}
}
}
encabezado
id_nota_credito
Descripción:
Identificador del documento: Número de la nota crédito. Incluye prefijo (NC) + consecutivo.
Tipo de dato:
String
Especificaciones:
No se permiten caracteres adicionales como espacios o guiones.
Obligatorio:
Si
fecha
Descripción:
Fecha de emisión de la nota credito.
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Si
hora
Descripción:
Hora de emisión de la nota credito
Tipo de dato:
Time
Especificaciones:
HH24:MM:SS
Obligatorio:
Si
nota
Descripción:
Las notas se van a distribuir en un formato similar a JSON, en el cual se cambia la comilla doble por sencilla, tanto en el nombre de la variable, como en su valor, esto debido a la restricción de algunos caracteres especiales que no son soportados en este campo.
Este JSON termina siendo un STRING que se debe enviar dividido en las posiciones del array de nota, de acuerdo con las restricciones que defina la DIAN:
A la fecha (2019-01-11) existe una restricción de enviar como mínimo 15 caracteres(*)
La estructura a utilizar es:
{'variable_1': 'valor_1', 'variable_2':'valor_2'}Ejemplos:
Enviar valores nulos o vacíos
nota[0] = "{‘variable_1': 'null', 'variable_2':'valor_2', 'variable_3':''}"
División del STRING en varias posiciones del array
nota[0] = "{‘variable_1': 'null', 'variab"
nota[1] = "le_2':'valor_2', 'variable_3':''}"
El API genera la concatenación del STRING y lo convierte a formato JSON y realiza la respectiva validación.
Hay que tener en cuenta que los caracteres (comilla sencilla, backslash, backslash comilla sencilla ) no se deben enviar, porque no son soportados en el API.
Si alguna variable es diferente a las del listado de especificaciones, se debe consultar con el personal de operación de Teleinte S.A.S, para realizar la respectiva validación, y en caso que no exista una variable, se estudiará el caso para determinar la adición o no de la variable que cumpla con la descripción requerida.
(*) Estas restricciones pueden cambiar en cualquier momento por parte de la DIAN, de acuerdo al nuevo proceso que estandarización y validación que están estableciendo.
Tipo de dato:
Array
Especificaciones:
El listado de la estandarización de las variables se puede ver aqui
Obligatorio:
Si
moneda
Descripción:
Divisa aplicable a toda la factura
Tipo de dato:
Parametrizado
Especificaciones:
COP- Colombia, USD - dolares. Inf adicional Ver
Obligatorio:
Si
tipo_nota_credito
Descripción:
Código de tipo de nota de crédito
Tipo de dato:
Parametrizado
Especificaciones:
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
Obligatorio:
Si
numero_orden
Descripción:
Número de orden
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
informacion_factura
id_factura
Descripción:
Identificador del documento: Número de la factura.
Tipo de dato:
Parametrizado
Especificaciones:
Mínimo 1 caracteres
Obligatorio:
Si
fecha
Descripción:
Fecha de emisión del documento que se va a realizar la nota crédito.
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Si
hora
Descripción:
Hora de emisión del documento que se va a realizar la nota crédito.
Tipo de dato:
Time
Especificaciones:
HH24:MM:SS
Obligatorio:
Si
codigo_unico_factura
Descripción:
CUFE- Codigo unico del documento electronico que se va a realizar la nota crédito
Tipo de dato:
String
Especificaciones:
Minimo de 18 caracteres
Obligatorio:
Si
tipo_documento
Descripción:
Tipo de documento al que se va a realizar la nota credito
Tipo de dato:
Parametrizado
Especificaciones:
FACTURA, NOTA_DEBITO
Obligatorio:
No
codigo_tipo_documento
Descripción:
Código de tipo de documento al que se le va a realizar la nota credito
Tipo de dato:
Parametrizado
Especificaciones:
Si es factura debe ir tipo de factura y si es nota debito el tipo de nota debito
Obligatorio:
No
informacion_adquiriente
tipo_contribuyente
Descripción:
Tipo de identificación Tributaria o similar de la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
1= Persona juridica
2= Persona natural
Obligatorio:
Si
tipo_regimen
Descripción:
Régimen al que pertenece la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
0= Simplificado
2= Común
Obligatorio:
Si
tipo_identificacion
Descripción:
Tipo de documento de identificación de la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
11= Registro civil
12= Tarjeta de identidad
13= Cedula ciudadania
21= Tarjeta de extranjería
22= Cedula de extranjería
31= NIT
41= Pasaporte
42= Documento de identificación extranjero
Obligatorio:
Si
identificacion
Descripción:
Número completo de la identificación de la empresa o persona
Tipo de dato:
String
Especificaciones:
Alfanumérico
Obligatorio:
Si
correo_electronico
Descripción:
Lista de direcciones de correo electronico, separadas por punto y coma ';'. Para el envio de las notificaciones al adquiriente se va tomar la primera dirección de correo.
Tipo de dato:
Especificaciones:
xxxx@xx.xx;yyyy@yy.yy
Obligatorio:
Si
numero_movil
Descripción:
Número de móvil para el envio de notificaciones
Tipo de dato:
String
Especificaciones:
3111111111
Obligatorio:
No
nombre
Descripción:
Nombre comercial del emisor
Tipo de dato:
array
Especificaciones:
Depende del tipo de contribuyente.
Persona juridica {razon_social}.
Persona natural {primer_nombre, segundo_nombre, apellidos}
Obligatorio:
Si
razon_social
Descripción:
Nombre comercial
Tipo de dato:
Alfanumérico
Especificaciones:
Opcional dependiendo el tipo de contribuyente. Si es NIT es obligatorio
Obligatorio:
Si es persona juridica
primer_nombre
Descripción:
Primer nombre
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si es persona natural
segundo_nombre
Descripción:
Segundo nombre
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
apellido
Descripción:
Apellidos
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si es persona natural
pais
Descripción:
Código dentificador del país. Código alfa-2 asignado al pais
Tipo de dato:
Parametrizado
Especificaciones:
Estandar ISO 3166-1. Inf adicional Ver
Obligatorio:
Si
nombre_pais
Descripción:
Nombre del país.
Tipo de dato:
String
Especificaciones:
Estandar ISO 3166-1. Inf adicional Ver
Obligatorio:
No
departamento
Descripción:
Codigo del departamento, son las subdivisiones administrativas del país (CO). Fue publicada en 1998 y actualizada por última vez en el sexto boletín de la primera edición en 2004.
Si no corresponde a Colombia debe ir el nombre de la ciudad o estado
Tipo de dato:
Parametrizado
Especificaciones:
ISO 3166-2:CO. Inf adicional Ver
Obligatorio:
Si
nombre_departamento
Descripción:
Nombre del departamento
Tipo de dato:
String
Especificaciones:
ISO 3166-2:CO. Inf adicional Ver
Obligatorio:
No
ciudad
Descripción:
Código del municipio ó ciudad ó subdivisión de tercer nivel.
Tipo de dato:
Parametrizado
Especificaciones:
Inf adicional Ver
Obligatorio:
Si
nombre_ciudad
Descripción:
Nombre del municipio ó ciudad ó subdivisión de tercer nivel.
Tipo de dato:
String
Especificaciones:
Inf adicional Ver
Obligatorio:
No
zona
Descripción:
Nombre de la subdivisión de la ciudad
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
direccion
Descripción:
Elemento de texto libre, que el emisor puede elegir utilizar para poner toda la información de la dirección
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 10 caracteres
Obligatorio:
Si
RUT
Descripción:
Información del RUT - Registro Unico Tributario. Responsabilidades, Calidades y Atributos, numeral 53 y Usuarios aduaneros, numeral 54.
Tipo de dato:
array
Especificaciones:
Parametrizable
Obligatorio:
Si
resp_calidades_atributos
Descripción:
Lista de codigos de las responsabilidades, calidades y atributos registrados en el RUT, numeral 53
Tipo de dato:
Array
Especificaciones:
Parametrizado.Inf adicional Ver
Obligatorio:
Si
usuario_aduanero
Descripción:
Lista de codigos usuarios aduaneros registrados en el RUT, numeral 54
Tipo de dato:
Array
Especificaciones:
Vacio
Obligatorio:
No
detalle_factura
numero_linea
Descripción:
Número de Línea
Tipo de dato:
Numerico
Especificaciones:
1...n
Obligatorio:
Si
cantidad
Descripción:
(Cant) Cantidad de productos o servicios solicitados. Número de unidades servidas/prestadas.
Tipo de dato:
Numerico
Especificaciones:
...n
Obligatorio:
Si
unidad_de_cantidad
Descripción:
Unidad de la cantidad del artículo solicitiado
Tipo de dato:
Parametrizado
Obligatorio:
Si
valor_unitario
Descripción:
(VU) Es el precio por unidad de cada bien o servicio antes de aplicar los impuestos o descuento. El valor base es el precio de un activo fijo a efectos impositivos. El valor base es el precio base de un activo sobre el cual se calcula la depreciación y la amortización
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
descripcion
Descripción:
Descripción del artículo o servicio a que se refiere esta línea de la factura. Para el caso de facturas por contratos de servicio tipo AIU en el item de administración se debe enviar la palabra clave 'ADMINISTRACION'
Tipo de dato:
Alfanumérico
Especificaciones:
Mínimo de 2 caracteres
Obligatorio:
Si
nota_detalle
Descripción:
Información adicional: Texto libre, relativo al documento. Para el caso de facturas por contratos de servicio tipo AIU, se debe enviar incluir el objeto del contrato facturado
Tipo de dato:
Alfanumérico
Especificaciones:
Mínimo de 2 caracteres
Obligatorio:
Si
marca
Descripción:
Marca: Marca del artículo
Tipo de dato:
String
Especificaciones:
Obligatorio:
Si
modelo
Descripción:
Modelo: Modelo del artículo
Tipo de dato:
String
Especificaciones:
Obligatorio:
Si
codificacion_estandar
Descripción:
Identificación del producto o servicio de acuerdo con un estandar acordado por la industria, los cuales facilitan el comercio entre empresas y gobierno.
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
cod_grupo_bien_servicio
Descripción:
Tipo de estandar de codificación utilizado para la clasificación de los productos o servicios.
UNSPSC - United Nations Standard Products and Services Code® - Código Estándar de Productos y Servicios de Naciones Unidas. Ver documentación
GTIN - Números Globales de Identificación de Productos.Estructura de los códigos GTIN:
999 - Códigos libres o autónomosCorresponden a la codificación que las empresas cuentan en sus sistemas para la identificación inequívoca de los bienes o servicios que prestan.
Tipo de dato:
Parametrizado
Especificaciones:
1 -> UNSPSC
10 -> GTIN
20 -> Partida Arancelarias
999 -> Estándar de adopción del contribuyente
Obligatorio:
Si
nombre_grupo_bien_servicio
Descripción:
Nombre de la codificación utilizada para la clasificación de los productos o servicios
Tipo de dato:
Parametrizado
Especificaciones:
UNSPSC -> 1
GTIN -> 10
Partida Arancelarias -> 20
Estándar de adopción del contribuyente -> 999
Obligatorio:
Si
cod_segmento_bien_servicio
Descripción:
Codigo del segmento.
Tipo de dato:
String
Especificaciones:
Dependen del grupo del bien o servicio. Información adicional Ver
Obligatorio:
Si
cod_bien_servicio
Descripción:
Codigo del bien o servicio
Tipo de dato:
String
Especificaciones:
Dependen del segmento del bien o servicio. Información adicional Ver
Obligatorio:
Si
regalo
Descripción:
Indicador de si el ítem es gratuito o no
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
es_regalo
Descripción:
Describe si el articulo es un regalo o muestra comercial
Tipo de dato:
Boolean
Especificaciones:
true o false
Obligatorio:
Si
cod_precio_referencia
Descripción:
Código del tipo de precio informado
Tipo de dato:
Parametrizado
Especificaciones:
1 = Valor comercial
2 = Valor en inventarios
3 = Otro valor
0 = En el caso que no sea regalo
Obligatorio:
Si
precio_referencia
Descripción:
Precio de referencia para línea que no contienen valor comercial.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
cargo_descuento
Descripción:
Información relacionada con un cargo o un descuento
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
es_descuento
Descripción:
Indica que el elemento es un Cargo y no un descuento
Descuento es true cuando es un descuento, un Crédito descuenta el valor del ítem
Cargo es false cuando es un recargo, es un Débito aumenta el valor del item.
Tipo de dato:
Boolean
Especificaciones:
True o false
Obligatorio:
Si
porcentaje_cargo_descuento
Descripción:
Porcentaje de descuento o cargo a la linea de la factura
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_cargo_descuento
Descripción:
Valor Base para calcular el descuento o el cargo
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_cargo_descuento
Descripción:
Valor del descuento o el cargo
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
impuestos_detalle
Descripción:
Información relacionada con el impuesto aplicado a la linea de detalle
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
codigo_impuesto
Descripción:
Identificador del tributo
Tipo de dato:
Parametrizado
Especificaciones:
1= IVA
2= Impuesto al consumo
3= ICA
4= Impuesto nacional al consumo
0= Excluido de IVA
Obligatorio:
Si
porcentaje_impuesto
Descripción:
Tarifa del tributo. Porcentaje del valor tributable a ser aplicada a la base imponible de la linea de detalle. Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base_impuesto
Descripción:
(VU-VD)*Cant). Base Imponible sobre la que se calcula el valor del tributo. Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_impuesto
Descripción:
(((VU-VD)*Cant) * %Imp). Valor del tributo: producto del porcentaje aplicado sobre la base imponible. Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
retenciones_detalle
Descripción:
Información relacionada con los tributos retenidos en la linea de detalle
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
codigo
Descripción:
Identificador de las retenciónes
Tipo de dato:
Parametrizado
Especificaciones:
5= ReteIVA
6= ReteFuente
7= ReteICA
0= No tiene retenciónes
Obligatorio:
Si
porcentaje
Descripción:
Tarifa del tributo retenido. Porcentaje del valor tributable retenido a ser aplicada a la base imponible de la linea de detalle.
Tipo de dato:
Parametrizado ReteFuente - ReteIVA
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base
Descripción:
La base gravable es el valor sobre el cual se aplica la tarifa de la retención
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_retenido
Descripción:
Valor del tributo: producto del porcentaje aplicado sobre la base imponible
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valores_unitarios
Descripción:
Información relacionada con el valor por producto de la linea de detalle, los datos recibidos son utilizados para la representación grafica cuando sea necesario
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
valor_impuesto_1
Descripción:
Valor de la base imponible (IVA) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_2
Descripción:
Valor de la base imponible (Impuesto al consumo) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_3
Descripción:
Valor de la base imponible (ICA) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_4
Descripción:
Valor de la base imponible (Impuesto nacional al consumo) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_a_pagar
Descripción:
Valor total del producto de la linea de detalle, incluyendo descuentos, retenciónes e impuestos
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_total_detalle_con_cargo_descuento
Descripción:
(((VU * Cant)- VD)+ VR ). Valor total de la linea de detalle incluyendo el descuento y el recargo si aplica
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_detalle
Descripción:
(VU*Cant). Valor total de la linea de detalle sin incluir descuentos, retenciónes o impuestos.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
impuestos
codigo_impuesto
Descripción:
Es la clase que se utiliza para describir el esquema del impuesto
Tipo de dato:
Parametrizado
Especificaciones:
01= IVA
02= Impuesto al consumo
03= ICA
04= Impuesto nacional al consumo
0= Excluido de IVA
Obligatorio:
Si
porcentaje_impuesto
Descripción:
Número de importe del impuesto retenido. Si algun item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base_calculo_impuesto
Descripción:
Base Imponible sobre la que se calcula la retención de impuesto. Si algun item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto
Descripción:
Importe del impuesto retenido. Si algun item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_nota_credito
valor_base
Descripción:
Total Valor Bruto antes de tributos: Total valor bruto, suma de los valores brutos de las líneas de la factura incluyendo descuentos mas recargos, es decir la suma de todas las lineas de detalle de los valor_total_detalle_con_cargo_descuento.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_calculo_impuestos
Descripción:
Total Valor Base Imponible : Base imponible para el cálculo de los tributos
tiene que ser la suma de los valores de las bases imponibles de todas líneas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_mas_impuestos
Descripción:
Total de Valor Bruto más tributos
El Valor Bruto más tributos tiene que ser igual 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.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_descuento_total
Descripción:
Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
El Valor del Descuento Total es igual a la Suma de todos los descuentos globales aplicados al total de la factura.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_1
Descripción:
Suma de todos los impuestos 1 aplicados a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_2
Descripción:
Suma de todos los impuestos 2 aplicados a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_3
Descripción:
Suma de todos los impuestos 3 aplicados a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_4
Descripción:
Suma de todos los impuestos 4 aplicados a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_reteiva
Descripción:
Suma de todos los reteiva a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_total_retefuente
Descripción:
Suma de todos los retefuente a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_total_reteica
Descripción:
Suma de todos los reteica a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
total_nota_credito
Descripción:
Total importe bruto +Total valor_impuestos
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_a_pagar
Descripción:
Valor total a pagar: El valor a total del documento es igual a la suma de valor bruto + impuestos - retenciónes - valor del descuento total + valor del cargo total - valor del anticipo total
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
generalidades
tipo_ambiente_dian
Descripción:
Ambiente de la DIAN al que se destina el documento enviado.
Tipo de dato:
Parametrizable
Especificaciones:
1= Producción
2= Pruebas
Obligatorio:
Si
version
Descripción:
Identificación consecutiva de la especificación
Tipo de dato:
Decimal
Especificaciones:
Obligatorio:
Si
identificador_transmision
Descripción:
Código único para identificar el paquete transmitido
Tipo de dato:
Alfanumérico
Especificaciones:
Obligatorio:
Mínimo 5 caracteres
rg_base_64
Descripción:
Pdf del documento elecronico en base 64
Tipo de dato:
Alfanumérico
Especificaciones:
Obligatorio:
Mínimo 5 caracteres
rg_tipo
Descripción:
Si se envia rg_base_64 identificar que tipo de archivo es HTML o PDF
Tipo de dato:
Parametrizable
Especificaciones:
HTML O PDF
Obligatorio:
Si hay información en rg_base_64
rg_px_qr
Descripción:
Información para ubicar el QR dentro del documento envido en base 64
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si se envia el rg_base_64
x
Descripción:
Posicionamiento en x dentro de la representación grafica
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en x desde la posición (0,0)
Obligatorio:
No
y
Descripción:
Posicionamiento en y dentro de la representación grafica
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en y desde la posición (0,0)
Obligatorio:
No
size
Descripción:
Tamaño del qr
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
mostrar_en
Descripción:
Identificador de si el QR en el PDF se pinta en la primera pagina o en todas
Tipo de dato:
Parametrizable
Especificaciones:
PRIMERA_PAGINA,TODAS
Obligatorio:
No
rg_px_cufe
Descripción:
Información de configuración de CUFE en la representación grafica
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si se envia el rg_base_64
x
Descripción:
Posicionamiento en x(abscisas) en el plano cartesiano en el cuarto cuadrante, es decir las columnas empezando de 0.
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en x desde la posición (0,0)
Obligatorio:
No
y
Descripción:
Posicionamiento en y(ordenadas) en el plano cartesiano en el cuarto cuadrante, es decir las filas empezando de 0.
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en y desde la posición (0,0)
Obligatorio:
No
size
Descripción:
Tamaño de la letra
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
mostrar_en
Descripción:
Identificador de si el CUFE/CUDE en el PDF se pinta en la primera pagina o en todas
Tipo de dato:
Parametrizable
Especificaciones:
PRIMERA_PAGINA,TODAS
Obligatorio:
No
notificacion
Descripción:
Información de configuración de envio de notificaciones. Los campos de notificación son obligatorios en caso que sea de forma automatica.
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
es_automatico
Descripción:
Indicar si la notificación es enviada de forma automatica
Tipo de dato:
Parametrizado
Especificaciones:
S o N
Obligatorio:
No
correo_obligado
Descripción:
Dirección de correo del obligado
Tipo de dato:
Especificaciones:
xxx@xx.xxx
Obligatorio:
No
asunto
Descripción:
Texto para el envio de las notificaciones
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
con_copia
Descripción:
Tamaño de la letra
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
integrador
Descripción:
Información de quien envia la información
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
nombre
Descripción:
Nombre de quien realiza la integración
Tipo de dato:
Parametrizado
Especificaciones:
S o N
Obligatorio:
Si
tipo
Descripción:
Codigo del medio usado para realizar la integración
Tipo de dato:
Parametrizado
Especificaciones:
MOVIL
WEB
DLL
EXCEL
ERP-XXXXXXXXX
Obligatorio:
Si
webhook
Descripción:
URL para notificar cuando ha ocurrido un evento. Esta se utiliza cuando los codigos de error del retorno del API son 28,20.
Tipo de dato:
String
Especificaciones:
URL con portocolo de seguridad - HTTPS
Obligatorio:
No
cambio_de_moneda
fecha_cambio
Descripción:
Fecha del cambio de la moneda.
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Si la moneda de origen es diferente de COP
codigo
Descripción:
La moneda de referencia para el tipo de cambio; La moneda a partir de la cual se realiza el cambio.
Tipo de dato:
Parametrizado
Especificaciones:
COP- Colombia, USD - dolares. Inf adicional Ver
Obligatorio:
Si la moneda de origen es diferente de COP
valor_base_trm
Descripción:
Tasa de cambio del día de emisión o expedición del documento.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si la moneda de origen es diferente de COP
retenciones
codigo
Descripción:
Identificador de las retenciónes
Tipo de dato:
Parametrizado
Especificaciones:
5= ReteIVA
6= ReteFuente
7= ReteICA
0= No tiene retenciónes
Obligatorio:
No
porcentaje
Descripción:
Importe del impuesto retenido al total de la factura
Tipo de dato:
Parametrizado ReteFuente - ReteIVA
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
No
valor_base
Descripción:
La base gravable es el valor sobre el cual se aplica la tarifa de la retención
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_retenido
Descripción:
Valor total de la retención por factura
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
cambio_de_moneda
informacion_factura_contingencia
periodo_facturacion
- Ejemplo 1. Nota credito con un detalle de cantidad uno e impuesto del 19%
- Ejemplo 2. Nota credito con varios detalles de cantidad uno y con diferentes impuestos de IVA e impuesto nacional al consumo
- Ejemplo 3. Nota credito con varios detalles con cantidad mayor que uno y con diferentes impuestos de IVA, impuesto nacional al consumo
- Ejemplo 4. Nota credito con un detalle exento de IVA y otros detalles con impuestos
- Ejemplo 5. Nota credito con adquiriente persona natural
- Ejemplo 6. Nota credito con descuento a nivel de detalles
- Ejemplo 7. Nota credito con descuento a nivel de la nota
- Ejemplo 8. Nota credito con recargos a nivel de nota
- Ejemplo 9. Nota credito con recargos a nivel de detalle de nota
- Ejemplo 10. Nota credito con moneda diferente de COP
- Ejemplo 11. Nota credito con un detalle excluido de IVA y otros detalles con impuestos
- Ejemplo 12. Nota credito de documento con retenciones
- Ejemplo 13. Nota credito de factura AIU
- Ejemplo 14. Nota credito de factura con un detalle con regalo
Ejemplo 1.
{
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC122",
"fecha": "2019-08-22",
"hora": "08:53:03",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_credito": 2
},
"informacion_factura": {
"id_factura": "990000575",
"codigo_unico_factura": "48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989",
"fecha": "2019-08-22",
"hora": "14:06:08"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "552000.00",
"descripcion": "Provision inicial afacturar",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "10.00",
"valor_base_cargo_descuento": "1104000.00",
"valor_cargo_descuento": "110400.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "552000.00",
"valor_impuesto": "104880.00"
},
"valor_total_detalle_con_cargo_descuento": "552000.00",
"valor_total_detalle": "552000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "552000.00",
"valor_total_impuesto": "104880.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"valor_nota_credito": {
"valor_base": "552000.00",
"valor_base_calculo_impuestos": "552000.00",
"valor_base_mas_impuestos": "656880.00",
"valor_total_recargos": "0.00",
"valor_descuento_total": "0.00",
"valor_total_impuesto_1": "104880.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_credito": "656880.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "20181106125307",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 2.
{
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC124",
"fecha": "2019-08-22",
"hora": "08:53:03",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_credito": 2
},
"informacion_factura": {
"id_factura": "990000575",
"codigo_unico_factura": "48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989",
"fecha": "2019-08-22",
"hora": "14:06:08"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "552000.00",
"descripcion": "Provision inicial afacturar",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "552000.00",
"valor_impuesto": "104880.00"
},
"valor_total_detalle_con_cargo_descuento": "552000.00",
"valor_total_detalle": "552000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "55000.00",
"descripcion": "Detalle dos",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "55000.00",
"valor_impuesto": "8800.00"
},
"valor_total_detalle_con_cargo_descuento": "55000.00",
"valor_total_detalle": "55000.00"
},
{
"numero_linea": 3,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "75000.00",
"descripcion": "Detalle tres",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 4,
"porcentaje_impuesto": "4.00",
"valor_base_impuesto": "75000.00",
"valor_impuesto": "3000.00"
},
"valor_total_detalle_con_cargo_descuento": "75000.00",
"valor_total_detalle": "75000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "552000.00",
"valor_total_impuesto": "104880.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "55000.00",
"valor_total_impuesto": "8800.00"
},
{
"codigo_impuesto": 4,
"porcentaje_impuesto": "4.00",
"valor_base_calculo_impuesto": "75000.00",
"valor_total_impuesto": "3000.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"valor_nota_credito": {
"valor_base": "682000.00",
"valor_base_calculo_impuestos": "682000.00",
"valor_base_mas_impuestos": "798680.00",
"valor_total_recargos": "0.00",
"valor_descuento_total": "0.00",
"valor_total_impuesto_1": "113680.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "3000.00",
"total_nota_credito": "798680.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "20181106125307",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 3.
{
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC126",
"fecha": "2019-08-22",
"hora": "08:53:03",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_credito": 2
},
"informacion_factura": {
"id_factura": "990000575",
"codigo_unico_factura": "48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989",
"fecha": "2019-08-22",
"hora": "14:06:08"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"unidad_de_cantidad": "94",
"valor_unitario": "552000.00",
"descripcion": "Provision inicial afacturar",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1104000.00",
"valor_impuesto": "209760.00"
},
"valor_total_detalle_con_cargo_descuento": "1104000.00",
"valor_total_detalle": "1104000.00"
},
{
"numero_linea": 2,
"cantidad": 8,
"unidad_de_cantidad": "94",
"valor_unitario": "55000.00",
"descripcion": "Detalle dos",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "440000.00",
"valor_impuesto": "70400.00"
},
"valor_total_detalle_con_cargo_descuento": "440000.00",
"valor_total_detalle": "440000.00"
},
{
"numero_linea": 3,
"cantidad": 3,
"unidad_de_cantidad": "94",
"valor_unitario": "75000.00",
"descripcion": "Detalle tres",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 4,
"porcentaje_impuesto": "4.00",
"valor_base_impuesto": "225000.00",
"valor_impuesto": "9000.00"
},
"valor_total_detalle_con_cargo_descuento": "225000.00",
"valor_total_detalle": "225000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1104000.00",
"valor_total_impuesto": "209760.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "440000.00",
"valor_total_impuesto": "70400.00"
},
{
"codigo_impuesto": 4,
"porcentaje_impuesto": "4.00",
"valor_base_calculo_impuesto": "225000.00",
"valor_total_impuesto": "9000.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"valor_nota_credito": {
"valor_base": "1769000.00",
"valor_base_calculo_impuestos": "1769000.00",
"valor_base_mas_impuestos": "2058160.00",
"valor_total_recargos": "0.00",
"valor_descuento_total": "0.00",
"valor_total_impuesto_1": "280160.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "9000.00",
"total_nota_credito": "2058160.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "20181106125307",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 4.
{
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC127",
"fecha": "2019-08-22",
"hora": "08:53:03",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_credito": 2
},
"informacion_factura": {
"id_factura": "990000575",
"codigo_unico_factura": "48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989",
"fecha": "2019-08-22",
"hora": "14:06:08"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 4,
"valor_unitario": "36000.00",
"unidad_de_cantidad": "94",
"descripcion": "Servicio Exento",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "144000.00",
"valor_impuesto": "0.00"
},
"valor_total_detalle_con_cargo_descuento": "144000.00",
"valor_total_detalle": "144000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "55000.00",
"descripcion": "Detalle dos",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "55000.00",
"valor_impuesto": "8800.00"
},
"valor_total_detalle_con_cargo_descuento": "55000.00",
"valor_total_detalle": "55000.00"
},
{
"numero_linea": 3,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "75000.00",
"descripcion": "Detalle tres",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 4,
"porcentaje_impuesto": "4.00",
"valor_base_impuesto": "75000.00",
"valor_impuesto": "3000.00"
},
"valor_total_detalle_con_cargo_descuento": "75000.00",
"valor_total_detalle": "75000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "144000.00",
"valor_total_impuesto": "0.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "55000.00",
"valor_total_impuesto": "8800.00"
},
{
"codigo_impuesto": 4,
"porcentaje_impuesto": "4.00",
"valor_base_calculo_impuesto": "75000.00",
"valor_total_impuesto": "3000.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"valor_nota_credito": {
"valor_base": "274000.00",
"valor_base_calculo_impuestos": "274000.00",
"valor_base_mas_impuestos": "285800.00",
"valor_total_recargos": "0.00",
"valor_descuento_total": "0.00",
"valor_total_impuesto_1": "8800.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "3000.00",
"total_nota_credito": "285800.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "20181106125307",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 5.
{
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC128",
"fecha": "2019-08-22",
"hora": "08:53:03",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_credito": 2
},
"informacion_factura": {
"id_factura": "990000575",
"codigo_unico_factura": "48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989",
"fecha": "2019-08-22",
"hora": "14:06:08"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-03",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "552000.00",
"descripcion": "Provision inicial afacturar",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "552000.00",
"valor_impuesto": "104880.00"
},
"valor_total_detalle_con_cargo_descuento": "552000.00",
"valor_total_detalle": "552000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "552000.00",
"valor_total_impuesto": "104880.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}],
"valor_nota_credito": {
"valor_base": "552000.00",
"valor_base_calculo_impuestos": "552000.00",
"valor_base_mas_impuestos": "656880.00",
"valor_total_recargos": "0.00",
"valor_descuento_total": "0.00",
"valor_total_impuesto_1": "104880.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_credito": "656880.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "20181106125307",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 6.
{
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC129",
"fecha": "2019-08-22",
"hora": "08:53:03",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_credito": 2
},
"informacion_factura": {
"id_factura": "990000575",
"codigo_unico_factura": "48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989",
"fecha": "2019-08-22",
"hora": "14:06:08"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"unidad_de_cantidad": "94",
"valor_unitario": "552000.00",
"descripcion": "Provision inicial afacturar",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "993600.00",
"valor_impuesto": "188784.00"
},
"valor_total_detalle_con_cargo_descuento": "993600.00",
"valor_total_detalle": "1104000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "993600.00",
"valor_total_impuesto": "188784.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}],
"valor_nota_credito": {
"valor_base": "993600.00",
"valor_base_calculo_impuestos": "993600.00",
"valor_base_mas_impuestos": "1182384.00",
"valor_total_recargos": "0.00",
"valor_descuento_total": "0.00",
"valor_total_impuesto_1": "188784.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_credito": "1182384.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "20181106125307",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 7.
{
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC131",
"fecha": "2019-08-22",
"hora": "08:53:03",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_credito": 2
},
"informacion_factura": {
"id_factura": "990000575",
"codigo_unico_factura": "48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989",
"fecha": "2019-08-22",
"hora": "14:06:08"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"unidad_de_cantidad": "94",
"valor_unitario": "552000.00",
"descripcion": "Provision inicial afacturar",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1104000.00",
"valor_impuesto": "209760.00"
},
"valor_total_detalle_con_cargo_descuento": "1104000.00",
"valor_total_detalle": "1104000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1104000.00",
"valor_total_impuesto": "209760.00"
}
],
"descuentos": [
{
"codigo_descuento": 11,
"porcentaje_descuento": "10.00",
"valor_base_calculo_descuento": "1104000.00",
"valor_total_descuento": "110400.00"
}
],
"recargos": [{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}],
"valor_nota_credito": {
"valor_base": "1104000.00",
"valor_base_calculo_impuestos": "1104000.00",
"valor_base_mas_impuestos": "1313760.00",
"valor_total_recargos": "0.00",
"valor_descuento_total": "110400.00",
"valor_total_impuesto_1": "209760.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_credito": "1203360.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "20181106125307",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 8.
{
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC132",
"fecha": "2019-08-22",
"hora": "08:53:03",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_credito": 2
},
"informacion_factura": {
"id_factura": "990000575",
"codigo_unico_factura": "48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989",
"fecha": "2019-08-22",
"hora": "14:06:08"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"unidad_de_cantidad": "94",
"valor_unitario": "552000.00",
"descripcion": "Provision inicial afacturar",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1104000.00",
"valor_impuesto": "209760.00"
},
"valor_total_detalle_con_cargo_descuento": "1104000.00",
"valor_total_detalle": "1104000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1104000.00",
"valor_total_impuesto": "209760.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [{
"nombre_recargo": " Envio de detalles",
"porcentaje_recargo": "10.00",
"valor_base_calculo_recargo": "1104000.00",
"valor_total_recargo": "110400.00"
}],
"valor_nota_credito": {
"valor_base": "1104000.00",
"valor_base_calculo_impuestos": "1104000.00",
"valor_base_mas_impuestos": "1313760.00",
"valor_total_recargos": "110400.00",
"valor_descuento_total": "0.00",
"valor_total_impuesto_1": "209760.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_credito": "1424160.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "20181106125307",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 9.
{
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC133",
"fecha": "2019-08-22",
"hora": "08:53:03",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_credito": 2
},
"informacion_factura": {
"id_factura": "990000575",
"codigo_unico_factura": "48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989",
"fecha": "2019-08-22",
"hora": "14:06:08"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"unidad_de_cantidad": "94",
"valor_unitario": "552000.00",
"descripcion": "Provision inicial afacturar",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "10.00",
"valor_base_cargo_descuento": "1104000.00",
"valor_cargo_descuento": "110400.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1214400.00",
"valor_impuesto": "230736.00"
},
"valor_total_detalle_con_cargo_descuento": "1214400.00",
"valor_total_detalle": "1104000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1214400.00",
"valor_total_impuesto": "230736.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}],
"valor_nota_credito": {
"valor_base": "1214400.00",
"valor_base_calculo_impuestos": "1214400.00",
"valor_base_mas_impuestos": "1445136.00",
"valor_total_recargos": "0.00",
"valor_descuento_total": "0.00",
"valor_total_impuesto_1": "230736.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_credito": "1445136.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "20181106125307",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 10.
{
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC135",
"fecha": "2019-08-22",
"hora": "08:53:03",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "USD",
"tipo_nota_credito": 2
},
"informacion_factura": {
"id_factura": "990000575",
"codigo_unico_factura": "48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989",
"fecha": "2019-08-22",
"hora": "14:06:08"
},
"cambio_de_moneda":{
"fecha_cambio":"2019-08-22",
"codigo":"COP",
"valor_base_trm":"3500.00"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "552000.00",
"descripcion": "Provision inicial afacturar",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "10.00",
"valor_base_cargo_descuento": "1104000.00",
"valor_cargo_descuento": "110400.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "552000.00",
"valor_impuesto": "104880.00"
},
"valor_total_detalle_con_cargo_descuento": "552000.00",
"valor_total_detalle": "552000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "552000.00",
"valor_total_impuesto": "104880.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}],
"valor_nota_credito": {
"valor_base": "552000.00",
"valor_base_calculo_impuestos": "552000.00",
"valor_base_mas_impuestos": "656880.00",
"valor_total_recargos": "0.00",
"valor_descuento_total": "0.00",
"valor_total_impuesto_1": "104880.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_credito": "656880.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "20181106125307",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 11.
{
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC200",
"fecha": "2020-01-07",
"hora": "08:53:03",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_credito": 2
},
"informacion_factura": {
"id_factura": "990000575",
"codigo_unico_factura": "48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989",
"fecha": "2019-08-22",
"hora": "14:06:08"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 4,
"valor_unitario": "36000.00",
"unidad_de_cantidad": "94",
"descripcion": "Servicio Exento",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"valor_total_detalle_con_cargo_descuento": "144000.00",
"valor_total_detalle": "144000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "55000.00",
"descripcion": "Detalle dos",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "55000.00",
"valor_impuesto": "8800.00"
},
"valor_total_detalle_con_cargo_descuento": "55000.00",
"valor_total_detalle": "55000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "0.00",
"valor_total_impuesto": "0.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "55000.00",
"valor_total_impuesto": "8800.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"valor_nota_credito": {
"valor_base": "199000.00",
"valor_base_calculo_impuestos": "55000.00",
"valor_base_mas_impuestos": "207800.00",
"valor_total_recargos": "0.00",
"valor_descuento_total": "0.00",
"valor_total_impuesto_1": "8800.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_credito": "207800.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "20181106125307",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 12.
{
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC215",
"fecha": "2020-01-23",
"hora": "09:59:18",
"nota": [
"{'SON':'Dos millones seiscientas noventa mil ciento cuarenta y cinco coma cinco cuatro cuatro tres cinco'",
"'vr_rte_ica':'0.00'",
"'vr_rte_iva':'72227.18'",
"'vr_rte_fte':'253428.69'"}"
],
"moneda": "COP",
"tipo_nota_credito": 1
},
"informacion_factura": {
"id_factura": "SETP990001042",
"fecha": "2020-01-07",
"hora": "08:47:00",
"codigo_unico_factura": "3a7087097447c8a350aeae9d71536d7fec934823e000378742d074227381f3c7f3369c300ea43b1b323a508e81e16f8e"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 10,
"unidad_de_cantidad": "94",
"valor_unitario": "253428.69",
"descripcion": "PROTECSIL SN GRIS",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "2534286.90",
"valor_impuesto": "481514.51"
},
"retenciones_detalle": [
{
"codigo": 6,
"porcentaje": "10.00",
"valor_base": "2534286.90",
"valor_retenido": "253428.69"
},
{
"codigo": 5,
"porcentaje": "15.00",
"valor_base": "481514.51",
"valor_retenido": "72227.18"
}
],
"valor_total_detalle_con_cargo_descuento": "2534286.90",
"valor_total_detalle": "2534286.90"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "2534286.90",
"valor_total_impuesto": "481514.51"
}
],
"retenciones": [
{
"codigo": 5,
"porcentaje": "15.00",
"valor_base": "481514.51",
"valor_retenido": "72227.18"
},
{
"codigo": 6,
"porcentaje": "10.00",
"valor_base": "2534286.90",
"valor_retenido": "253428.69"
}
],
"recargos": [
{
"nombre_recargo": "0.00",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_credito": {
"valor_base": "2534286.90",
"valor_base_calculo_impuestos": "2534286.90",
"valor_base_mas_impuestos": "3015801.41",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "481514.51",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "72227.18",
"valor_total_retefuente": "253428.69",
"valor_total_reteica": "0.00",
"total_nota_credito": "3015801.41",
"valor_total_a_pagar": "2690145.54"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "c9f0f895fb98ab9159f51fd0297e236d",
"integrador": {
"nombre": "WEB",
"tipo": "WEB"
}
}
}
Ejemplo 13.
{
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC219",
"fecha": "2020-02-26",
"hora": "09:59:18",
"nota": [
"{'SON':'Dos millones seiscientas noventa mil ciento cuarenta y cinco coma cinco cuatro cuatro tres cinco','vr_rte_ica':'0.00','vr_rte_iva':'72227.18','vr_rte_fte':'253428.69'}"
],
"moneda": "COP",
"tipo_nota_credito": 1
},
"informacion_factura": {
"id_factura": "SETP990001042",
"fecha": "2020-01-07",
"hora": "08:47:00",
"codigo_unico_factura": "3a7087097447c8a350aeae9d71536d7fec934823e000378742d074227381f3c7f3369c300ea43b1b323a508e81e16f8e",
"tipo_documento": "FACTURA",
"codigo_tipo_documento": 9
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "16061759.00",
"descripcion": "Detalle 1",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"valor_total_detalle_con_cargo_descuento": "16061759.00",
"valor_total_detalle": "16061759.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "6283630.00",
"descripcion": "003-PRIMA SERV",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"valor_total_detalle_con_cargo_descuento": "6283630.00",
"valor_total_detalle": "6283630.00"
},
{
"numero_linea": 3,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "0.00",
"descripcion": "ADMINISTRACION - Contrato de servicios AIU",
"nota_detalle": "Prestación de servicios",
"regalo": {
"es_regalo": true,
"cod_precio_referencia": 3,
"precio_referencia": "2234539.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "2234539.00",
"valor_impuesto": "424562.00"
},
"valor_total_detalle_con_cargo_descuento": "0.00",
"valor_total_detalle": "0.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "2234539.00",
"valor_total_impuesto": "424562.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_credito": {
"valor_base": "22345389.00",
"valor_base_calculo_impuestos": "2234539.00",
"valor_base_mas_impuestos": "22769951.00",
"valor_total_recargos": "0.00",
"valor_descuento_total": "0.00",
"valor_total_impuesto_1": "424562.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_nota_credito": "22769951.00",
"valor_total_a_pagar": "22769951.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "Prueba",
"integrador": {
"nombre": "WEB",
"tipo": "WEB"
}
}
}
Ejemplo 14.
{
"nota_credito": [
{
"encabezado": {
"fecha": "2020-09-16",
"hora": "16:38:46",
"nota": [
" "
],
"moneda": "COP",
"id_nota_credito": "NC290",
"tipo_nota_credito": 1
},
"informacion_factura": {
"id_factura": "990000575",
"codigo_unico_factura": "48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989",
"fecha": "2020-09-16",
"hora": "21:37:55"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "8308308308",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "TELEINTE",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Dirección",
"RUT": {
"resp_calidades_atributos": [
"O-13"
],
"usuario_aduanero": []
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "100000.00",
"descripcion": "Producto",
"valor_total_detalle_con_cargo_descuento": "100000.00",
"valor_total_detalle": "100000.00",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "100000.00",
"valor_impuesto": "19000.00"
},
"valores_unitarios": {
"valor_descuento": "0.00",
"valor_con_descuento": "0.00",
"valor_impuesto_1": "0.00",
"valor_impuesto_2": "0.00",
"valor_impuesto_3": "0.00",
"valor_impuesto_4": "0.00",
"valor_reteiva": "0.00",
"valor_retefuente": "0.00",
"valor_reteica": "0.00",
"valor_a_pagar": "100000.00"
}
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "100000.00",
"descripcion": "Producto",
"valor_total_detalle_con_cargo_descuento": "100000.00",
"valor_total_detalle": "100000.00",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "100000.00",
"valor_impuesto": "19000.00"
},
"valores_unitarios": {
"valor_descuento": "0.00",
"valor_con_descuento": "0.00",
"valor_impuesto_1": "0.00",
"valor_impuesto_2": "0.00",
"valor_impuesto_3": "0.00",
"valor_impuesto_4": "0.00",
"valor_reteiva": "0.00",
"valor_retefuente": "0.00",
"valor_reteica": "0.00",
"valor_a_pagar": "100000.00"
}
},
{
"numero_linea": 3,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "100000.00",
"descripcion": "Producto",
"valor_total_detalle_con_cargo_descuento": "50000.00",
"valor_total_detalle": "100000.00",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": true,
"porcentaje_cargo_descuento": "50.00",
"valor_base_cargo_descuento": "100000.00",
"valor_cargo_descuento": "50000.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "50000.00",
"valor_impuesto": "9500.00"
},
"valores_unitarios": {
"valor_descuento": "0.00",
"valor_con_descuento": "0.00",
"valor_impuesto_1": "0.00",
"valor_impuesto_2": "0.00",
"valor_impuesto_3": "0.00",
"valor_impuesto_4": "0.00",
"valor_reteiva": "0.00",
"valor_retefuente": "0.00",
"valor_reteica": "0.00",
"valor_a_pagar": "50000.00"
}
},
{
"numero_linea": 4,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "100000.00",
"descripcion": "Producto",
"valor_total_detalle_con_cargo_descuento": "0.00",
"valor_total_detalle": "0.00",
"regalo": {
"es_regalo": true,
"cod_precio_referencia": 3,
"precio_referencia": "100000.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "100000.00",
"valor_impuesto": "19000.00"
},
"valores_unitarios": {
"valor_descuento": "0.00",
"valor_con_descuento": "0.00",
"valor_impuesto_1": "0.00",
"valor_impuesto_2": "0.00",
"valor_impuesto_3": "0.00",
"valor_impuesto_4": "0.00",
"valor_reteiva": "0.00",
"valor_retefuente": "0.00",
"valor_reteica": "0.00",
"valor_a_pagar": "100000.00"
}
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "350000.00",
"valor_total_impuesto": "66500.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_credito": {
"valor_base": "250000.00",
"valor_base_calculo_impuestos": "350000.00",
"valor_base_mas_impuestos": "316500.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "66500.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_credito": "316500.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validacion previa",
"rg_tipo": "PDF_PROPIO",
"rg_url_pdf_propio": "",
"integrador": {
"nombre": "SINFO",
"tipo": "WEB"
}
}
}
Salida Exitosa
Salida con errores de semantica
Salida con errores de datos
Salida con errores HTTP
Salida con error de datos en la DIAN
{
"codigo_error": 0,
"descripcion_error": "OK",
"tiempo_ejecucion": 2.8475100994110109,
"transaccion": "5e5e5e5e5e55e",
"resultado": {
"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"id_nota_credito": "SETP990001502",
"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
"url_application_response": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ar083002047005520SETP990001502.xml",
"url_attached_document_url": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ad083002047005520SETP990001502.xml",
"url_representacion_grafica": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.pdf",
"url_notificacion_aceptacion_rechazo": "http://app.afacturar.com/consulta_documento/?uid=5e5e5e5e5e55e"
},
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": ""
}
Salida con errores de semantica
{
"codigo_error": 400,
"descripcion_error": "Hay un problema con la informacion entregada",
"tiempo_ejecucion": 0.01330113410949707,
"transaccion": "5e74ce82707f6",
"resultado": [
{
"propiedad": "nota_credito[0].encabezado.tipo_nota_credito",
"descripcion": "The property tipo_nota_credito is required"
},
{
"propiedad": "nota_credito[0].encabezado.tipo_nota_credito",
"descripcion": "Does not have a value in the enumeration [1,2,3,4,5,6]"
},
{
"propiedad": "nota_credito[0].encabezado",
"descripcion": "The property tipo_nota_credit is not defined and the definition does not allow additional properties"
}
],
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": ""
}
Salida con errores de datos
{
"codigo_error": 400,
"descripcion_error": "Hay problema(s) con la información entregada",
"resultado": [
[
{
"propiedad": "nota_credito->encabezado->fecha",
"descripcion": "Fecha invalida"
}
]
]
}
Salida con errores HTTP
{
"codigo_error": 500,
"descripcion_error": "Unauthenticated."
}
Salida con error de datos en la DIAN
{
"codigo_error": 15,
"descripcion_error": "La validación en la DIAN devuelve error(es)",
"tiempo_ejecucion": 1.9776690006256104,
"transaccion": "5e74d144dd565",
"resultado": {
"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"id_nota_credito": "SETP990001504",
"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
},
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": "Regla: FAU06, Rechazo: 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.Regla: FAU02, Rechazo: 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"
}
CURL
curl -X POST \
https://servicios-pruebas.afacturar.com/api/vp/nota_credito \
-H 'accept: application/json' \
-H 'authorization: Bearer token_obligado' \
-H 'cache-control: no-cache' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-H 'postman-token: 7d6d9f51-7372-30a6-4f37-fa651f384b75' \
-F 'data={
"nota_credito": [
{
"encabezado": {
"id_nota_credito": "NC122",
"fecha": "2019-08-22",
"hora": "08:53:03",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_credito": 2
},
"informacion_factura": {
"id_factura": "990000575",
"codigo_unico_factura": "48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989",
"fecha": "2019-08-22",
"hora": "14:06:08"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "552000.00",
"descripcion": "Provision inicial afacturar",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "10.00",
"valor_base_cargo_descuento": "1104000.00",
"valor_cargo_descuento": "110400.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "552000.00",
"valor_impuesto": "104880.00"
},
"valor_total_detalle_con_cargo_descuento": "552000.00",
"valor_total_detalle": "552000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "552000.00",
"valor_total_impuesto": "104880.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"valor_nota_credito": {
"valor_base": "552000.00",
"valor_base_calculo_impuestos": "552000.00",
"valor_base_mas_impuestos": "656880.00",
"valor_total_recargos": "0.00",
"valor_descuento_total": "0.00",
"valor_total_impuesto_1": "104880.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_credito": "656880.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "20181106125307",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}' \
-F documento_obligado=830020470
C#
var client = new RestClient("https://servicios-pruebas.afacturar.com/api/vp/nota_credito");
var request = new RestRequest(Method.POST);
request.AddHeader("postman-token", "2ba7519d-3eaa-eb4c-16b7-353b2c8e032b");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("authorization", "Bearer token_cliente");
request.AddHeader("accept", "application/json");
request.AddHeader("content-type", "multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW");
request.AddParameter("multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW", "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"data\"\r\n\r\n{\n\t\"nota_credito\": [\n\t\t{\n\t\t\t\"encabezado\": {\n\t\t\t\t\"id_nota_credito\": \"NC259\",\n\t\t\t\t\"fecha\": \"2020-06-25\",\n\t\t\t\t\"hora\": \"09:05:04\",\n\t\t\t\t\"nota\": [\n\t\t\t\t\t\"{'son_total_a_pagar':'SON: Seis millones doscientas setenta y ocho mil cuatrocientas','nota_factura':'Proyecto: MFP S.A.S. / Tipo de pago: Credito.'}\"\n\t\t\t\t],\n\t\t\t\t\"moneda\": \"COP\",\n\t\t\t\t\"tipo_nota_credito\": 1\n\t\t\t},\n\t\t\t\"informacion_factura\": {\n\t\t\t\t\"id_factura\": \"990000575\",\n\t\t\t\t\"codigo_unico_factura\": \"48aff6ec3c84a09cfccb2dc508ade66b9ff4c53b8402253bafab6f4e8e48fdbf1347ea25f7c3fe2e303f83a87817a989\",\n\t\t\t\t\"fecha\": \"2019-08-22\",\n\t\t\t\t\"hora\": \"14:06:08\"\n\t\t\t},\n\t\t\t\"informacion_adquiriente\": {\n\t\t\t\t\"tipo_contribuyente\": 1,\n\t\t\t\t\"tipo_regimen\": 2,\n\t\t\t\t\"tipo_identificacion\": 31,\n\t\t\t\t\"identificacion\": \"811023263\",\n\t\t\t\t\"correo_electronico\": \"secretaria2@mantenimientodefachadasypisos.com\",\n\t\t\t\t\"numero_movil\": \"\",\n\t\t\t\t\"nombre\": {\n\t\t\t\t\t\"razon_social\": \"MANTENIMIENTO DE FACHADAS Y PISOS S.A.S\",\n\t\t\t\t\t\"primer_nombre\": \"\",\n\t\t\t\t\t\"segundo_nombre\": \"\",\n\t\t\t\t\t\"apellido\": \"\"\n\t\t\t\t},\n\t\t\t\t\"pais\": \"CO\",\n\t\t\t\t\"nombre_pais\": \"Colombia\",\n\t\t\t\t\"departamento\": \"5\",\n\t\t\t\t\"nombre_departamento\": \"ANTIOQUIA\",\n\t\t\t\t\"zona\": \"ITAGÜÍ\",\n\t\t\t\t\"ciudad\": \"5360\",\n\t\t\t\t\"nombre_ciudad\": \"ITAGÜÍ\",\n\t\t\t\t\"direccion\": \"CALLE 78 No 52 D - 120 \",\n\t\t\t\t\"RUT\": {\n\t\t\t\t\t\"resp_calidades_atributos\": [\n\t\t\t\t\t\t\"O-07\",\n\t\t\t\t\t\t\"O-09\",\n\t\t\t\t\t\t\"O-14\"\n\t\t\t\t\t],\n\t\t\t\t\t\"usuario_aduanero\": [\n\t\t\t\t\t\t\"A-23\"\n\t\t\t\t\t]\n\t\t\t\t}\n\t\t\t},\n\t\t\t\"detalle_factura\": [\n\t\t\t\t{\n\t\t\t\t\t\"numero_linea\": 1,\n\t\t\t\t\t\"cantidad\": 2,\n\t\t\t\t\t\"unidad_de_cantidad\": \"94\",\n\t\t\t\t\t\"valor_unitario\": \"442000.00\",\n\t\t\t\t\t\"descripcion\": \"12\",\n\t\t\t\t\t\"cargo_descuento\": {\n\t\t\t\t\t\t\"es_descuento\": true,\n\t\t\t\t\t\t\"porcentaje_cargo_descuento\": \"0.00\",\n\t\t\t\t\t\t\"valor_base_cargo_descuento\": \"0.00\",\n\t\t\t\t\t\t\"valor_cargo_descuento\": \"0.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"impuestos_detalle\": {\n\t\t\t\t\t\t\"codigo_impuesto\": 1,\n\t\t\t\t\t\t\"porcentaje_impuesto\": \"19.00\",\n\t\t\t\t\t\t\"valor_base_impuesto\": \"884000.00\",\n\t\t\t\t\t\t\"valor_impuesto\": \"167960.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"valores_unitarios\": {\n\t\t\t\t\t\t\"valor_impuesto_1\": \"167960.00\",\n\t\t\t\t\t\t\"valor_impuesto_2\": \"0.00\",\n\t\t\t\t\t\t\"valor_impuesto_3\": \"0.00\",\n\t\t\t\t\t\t\"valor_impuesto_4\": \"0.00\",\n\t\t\t\t\t\t\"valor_a_pagar\": \"1051960.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"valor_total_detalle_con_cargo_descuento\": \"884000.00\",\n\t\t\t\t\t\"valor_total_detalle\": \"884000.00\"\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"numero_linea\": 2,\n\t\t\t\t\t\"cantidad\": 1,\n\t\t\t\t\t\"unidad_de_cantidad\": \"94\",\n\t\t\t\t\t\"valor_unitario\": \"498000.00\",\n\t\t\t\t\t\"descripcion\": \"12345\",\n\t\t\t\t\t\"cargo_descuento\": {\n\t\t\t\t\t\t\"es_descuento\": true,\n\t\t\t\t\t\t\"porcentaje_cargo_descuento\": \"0.00\",\n\t\t\t\t\t\t\"valor_base_cargo_descuento\": \"0.00\",\n\t\t\t\t\t\t\"valor_cargo_descuento\": \"0.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"impuestos_detalle\": {\n\t\t\t\t\t\t\"codigo_impuesto\": 1,\n\t\t\t\t\t\t\"porcentaje_impuesto\": \"19.00\",\n\t\t\t\t\t\t\"valor_base_impuesto\": \"498000.00\",\n\t\t\t\t\t\t\"valor_impuesto\": \"94620.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"valores_unitarios\": {\n\t\t\t\t\t\t\"valor_impuesto_1\": \"94620.00\",\n\t\t\t\t\t\t\"valor_impuesto_2\": \"0.00\",\n\t\t\t\t\t\t\"valor_impuesto_3\": \"0.00\",\n\t\t\t\t\t\t\"valor_impuesto_4\": \"0.00\",\n\t\t\t\t\t\t\"valor_a_pagar\": \"592620.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"valor_total_detalle_con_cargo_descuento\": \"498000.00\",\n\t\t\t\t\t\"valor_total_detalle\": \"498000.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"impuestos\": [\n\t\t\t\t{\n\t\t\t\t\t\"codigo_impuesto\": 1,\n\t\t\t\t\t\"porcentaje_impuesto\": \"19.00\",\n\t\t\t\t\t\"valor_base_calculo_impuesto\": \"1382000.00\",\n\t\t\t\t\t\"valor_total_impuesto\": \"262580.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"recargos\": [\n\t\t\t\t{\n\t\t\t\t\t\"nombre_recargo\": \"Flete\",\n\t\t\t\t\t\"porcentaje_recargo\": \"100.00\",\n\t\t\t\t\t\"valor_base_calculo_recargo\": \"0.00\",\n\t\t\t\t\t\"valor_total_recargo\": \"0.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"descuentos\": [],\n\t\t\t\"valor_nota_credito\": {\n\t\t\t\t\"valor_base\": \"1382000.00\",\n\t\t\t\t\"valor_base_calculo_impuestos\": \"1382000.00\",\n\t\t\t\t\"valor_base_mas_impuestos\": \"1644580.00\",\n\t\t\t\t\"valor_descuento_total\": \"0.00\",\n\t\t\t\t\"valor_total_recargos\": \"0.00\",\n\t\t\t\t\"valor_total_impuesto_1\": \"262580.00\",\n\t\t\t\t\"valor_total_impuesto_2\": \"0.00\",\n\t\t\t\t\"valor_total_impuesto_3\": \"0.00\",\n\t\t\t\t\"valor_total_impuesto_4\": \"0.00\",\n\t\t\t\t\"total_nota_credito\": \"1644580.00\"\n\t\t\t}\n\t\t}\n\t],\n\t\"generalidades\": {\n\t\t\"tipo_ambiente_dian\": 2,\n\t\t\"version\": 2,\n\t\t\"identificador_transmision\": \"900279558\",\n\t\t\"rg_base_64\": \"\",\n\t\t\"rg_tipo\": \"\",\n\t\t\"rg_px_qr\": {\n\t\t\t\"x\": \"\",\n\t\t\t\"y\": \"\",\n\t\t\t\"size\": \"\"\n\t\t},\n\t\t\"rg_px_cufe\": {\n\t\t\t\"x\": \"\",\n\t\t\t\"y\": \"\",\n\t\t\t\"size\": \"\"\n\t\t},\n\t\t\"integrador\": {\n\t\t\t\"nombre\": \"Margen Cero\",\n\t\t\t\"tipo\": \"ERP-Conector\"\n\t\t}\n\t}\n}\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"documento_obligado\"\r\n\r\n830020470\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Nota debito
Especificación detallada para recibir información de la nota debito para ser procesadas en la plataforma
Histórico de cambios
| Versión | Cambios | Fecha |
|---|---|---|
| 2.8 | En la variable detalle_factura se adiciono las variables marca, modelo y codificacion_estandar. Estas variables se utilizan para tener mas información de los productos y/o servicios, permitiendo a los clientes codificar productos y servicios de forma clara, basandose en estándares acordados por la industria los cuales facilitan el comercio entre empresas y gobierno | 08 de junio de 2020 |
| 2.7 | En la variable informacion_adquiriente -> correo_electronico permitir varias direcciones de correo. Se debe tener en cuenta que la primera dirección de correo es la utilizada para el envio de la notificación al adquiriente. | 08 de mayo de 2020 |
| 2.6 | Se adiciono en nota_credito -> encabezado la variable "numero_orden", para los documentos que tienen el numero de la orden y asi visualizar en el xml el grupo OrderReference | 07 de Abril de 2020 |
| 2.5 | Los PDFs que se reciben en base64 se adiciono en generalidades -> rg_px_cufe y rg_px_qr, la opción de mostrar_en, para indicar si el QR y el CUFE/CUDE debe pintarse en la primera pagina o en todas. | 05 de Marzo de 2020 |
| 2.4 |
Se adiciono en informacion_factura las variables "tipo_documento" y "codigo_tipo_documento", para identificar el tipo de documento al que se va a realizar la nota credito, ademas se adiciono en el detalle_factura el objeto "regalo" y la variable "nota_detalle".
Para realizar notas debito de facturas tipo AIU se debe enviar el tipo_documento, codigo_tipo_documento y en los detalles en el item de Admistración en la descripción la paralabra clave ADMINISTRACION y en la variable nota_detalle el objeto del contrato. Ejemplo: |
27 de febrero de 2020 |
| 2.3 |
Se adiciono las retenciones por detalle y por documento. Para hacer notas credito de documentos que contengan retenciones, es necesario que envien en encabezado -> nota, las siguientes variables con el valor retenido encada una de ellas.
Ejemplo: "nota": ["{'variable_uno':'valor_uno','variable_dos':'valor_dos','vr_rte_iva':'0.00','vr_rte_fte':'0.00','vr_rte_ica':'0.00'}"] |
24 de febrero de 2020 |
| 2.2 |
Se agregó el nombre del país, departamento y ciudad para mostrar en la representación gráfica.
El tipo de pago ZZZ se cambio por -999 para validar datos tipo numérico como dato de entrada. |
16 de Octubre de 2019 |
| 2.1 | Adición de variables. Cambio de nombre de variables que sean legibles. | 27 de Agosto de 2019 |
| 2 | Ajustes de validación previa | 09 de Agosto de 2019 |
POST
/nota_debito
documento_obligado:
000000000
data:
{
"nota_debito": [{
"encabezado": {
"id_nota_debito": "",
"fecha": "",
"hora": "",
"nota": ["{'':'','':'','':'','':'','':'','':''}"],
"moneda": "",
"tipo_nota_debito": ##,
"metodo_de_pago": ##,
"tipo_de_pago": ##,
"identificador_de_pago": "",
"numero_orden": ""
},
"informacion_factura": {
"id_factura": "",
"codigo_unico_factura": "",
"fecha": "",
"hora": "",
"tipo_documento": "",
"codigo_tipo_documento": "",
},
"cambio_de_moneda":{
"fecha_cambio":"",
"codigo":"",
"valor_base_trm":"0.00"
},
"informacion_adquiriente": {
"tipo_contribuyente": #,
"tipo_regimen": #,
"tipo_identificacion":#,
"identificacion": ""
"correo_electronico": "",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "",
"nombre_pais": "",
"departamento": "",
"nombre_departamento": "",
"zona": "",
"ciudad": "",
"nombre_ciudad": "",
"direccion": "",
"RUT": {
"resp_calidades_atributos": ["",""],
"usuario_aduanero": [""]
}
},
"detalle_factura": [{
"numero_linea": #,
"cantidad": #,
"unidad_de_cantidad":"" ,
"valor_unitario": "0.00",
"descripcion": "",
"nota_detalle": "",
"marca": "",
"modelo": "",
"codificacion_estandar": {
"cod_grupo_bien_servicio": "",
"nombre_grupo_bien_servicio": "",
"cod_segmento_bien_servicio": "",
"cod_bien_servicio": ""
},
"regalo": {
"es_regalo": "",
"cod_precio_referencia": #,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": "",
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": #,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [{
"codigo": #,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}],
"valores_unitarios":{
"valor_descuento":"0.00",
"valor_con_descuento":"0.00",
"valor_impuesto_1":"0.00",
"valor_impuesto_2":"0.00",
"valor_impuesto_3":"0.00",
"valor_impuesto_4":"0.00",
"valor_reteiva":"0.00",
"valor_retefuente":"0.00",
"valor_reteica":"0.00",
"valor_a_pagar":"0.00"
},
"valor_total_detalle_con_cargo_descuento": "0.00",
"valor_total_detalle": "0.00"
}],
"impuestos": [{
"codigo_impuesto": #,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "0.00",
"valor_total_impuesto": "0.00"
}],
"retenciones":[{
"codigo": #,
"porcentaje":"0.00",
"valor_base":"0.00",
"valor_retenido":"0.00"
}],
"recargos": [{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}],
"descuentos": [{
"codigo_descuento": #,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}],
"valor_nota_debito": {
"valor_base": "0.00",
"valor_base_calculo_impuestos": "0.00",
"valor_base_mas_impuestos": "0.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "0.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_nota_debito": "0.00"
"valor_total_a_pagar": "0.00"
}
}],
"generalidades": {
"tipo_ambiente_dian": #,
"version": #,
"identificador_transmision": "",
"rg_tipo":"",
"rg_base_64":"",
"rg_px_qr": {
"x":"",
"y":"",
"size":"",
"mostrar_en":""
},
"rg_px_cufe": {
"x":"",
"y":"",
"size":"",
"mostrar_en":""
},
"integrador": {
"nombre":"",
"tipo":"",
"webhook": ""
}
}
}
encabezado
id_nota_debito
Descripción:
Identificador del documento: Número de la nota debito. Incluye prefijo (ND) + consecutivo.
Tipo de dato:
String
Especificaciones:
No se permiten caracteres adicionales como espacios o guiones.
Obligatorio:
Si
fecha
Descripción:
Fecha de emisión de la factura a efectos fiscales.
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Si
hora
Descripción:
Hora de emisión de la factura
Tipo de dato:
Time
Especificaciones:
HH24:MM:SS
Obligatorio:
Si
nota
Descripción:
Las notas se van a distribuir en un formato similar a JSON, en el cual se cambia la comilla doble por sencilla, tanto en el nombre de la variable, como en su valor, esto debido a la restricción de algunos caracteres especiales que no son soportados en este campo.
Este JSON termina siendo un STRING que se debe enviar dividido en las posiciones del array de nota, de acuerdo con las restricciones que defina la DIAN:
A la fecha (2019-01-11) existe una restricción de enviar como mínimo 15 caracteres(*)
La estructura a utilizar es:
{'variable_1': 'valor_1', 'variable_2':'valor_2'}Ejemplos:
Enviar valores nulos o vacíos
nota[0] = "{‘variable_1': 'null', 'variable_2':'valor_2', 'variable_3':''}"
División del STRING en varias posiciones del array
nota[0] = "{‘variable_1': 'null', 'variab"
nota[1] = "le_2':'valor_2', 'variable_3':''}"
El API genera la concatenación del STRING y lo convierte a formato JSON y realiza la respectiva validación.
Hay que tener en cuenta que los caracteres (comilla sencilla, backslash, backslash comilla sencilla ) no se deben enviar, porque no son soportados en el API.
Si alguna variable es diferente a las del listado de especificaciones, se debe consultar con el personal de operación de Teleinte S.A.S, para realizar la respectiva validación, y en caso que no exista una variable, se estudiará el caso para determinar la adición o no de la variable que cumpla con la descripción requerida.
(*) Estas restricciones pueden cambiar en cualquier momento por parte de la DIAN, de acuerdo al nuevo proceso que estandarización y validación que están estableciendo.
Tipo de dato:
Array
Especificaciones:
El listado de la estandarización de las variables se puede ver aqui
Obligatorio:
Si
moneda
Descripción:
Divisa aplicable a toda la factura
Tipo de dato:
Parametrizado
Especificaciones:
COP- Colombia, USD - dolares. Inf adicional Ver
Obligatorio:
Si
tipo_nota_debito
Descripción:
Código de tipo de nota de debito
Tipo de dato:
Parametrizado
Especificaciones:
1= Intereses
2= Gastos por cobrar
3= Cambio del valor
4= Otro
Obligatorio:
Si
metodo_de_pago
Descripción:
Método de pago
Tipo de dato:
Parametrizado
Especificaciones:
1 = Contado
2 = Crédito
Obligatorio:
Si
tipo_de_pago
Descripción:
Código correspondiente al medio de pago
Tipo de dato:
Parametrizado
Obligatorio:
Si
identificador_de_pago
Descripción:
Identificador de pago o número de referencia de pago
Tipo de dato:
String
Especificaciones:
Obligatorio:
No
numero_orden
Descripción:
Número de orden
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
informacion_factura
id_factura
Descripción:
Identificador del documento: Número de la factura.
Tipo de dato:
Parametrizado
Especificaciones:
Mínimo 1 caracteres
Obligatorio:
Si
fecha
Descripción:
Fecha de emisión del documento que se va a realizar la nota debito.
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Si
hora
Descripción:
Hora de emisión del documento que se va a realizar la nota debito.
Tipo de dato:
Time
Especificaciones:
HH24:MM:SS
Obligatorio:
Si
codigo_unico_factura
Descripción:
CUFE- Codigo unico del documento electronico que se va a realizar la nota debito
Tipo de dato:
String
Especificaciones:
Minimo de 18 caracteres
Obligatorio:
Si
tipo_documento
Descripción:
Tipo de documento al que se va a realizar la nota debito
Tipo de dato:
Parametrizado
Especificaciones:
FACTURA, NOTA_CREDITO
Obligatorio:
No
codigo_tipo_documento
Descripción:
Código de tipo de documento al que se le va a realizar la nota debito
Tipo de dato:
Parametrizado
Especificaciones:
Si es factura debe ir tipo de factura y si es nota credito el tipo de nota credito
Obligatorio:
No
informacion_adquiriente
tipo_contribuyente
Descripción:
Tipo de identificación Tributaria o similar de la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
1= Persona juridica
2= Persona natural
Obligatorio:
Si
tipo_regimen
Descripción:
Régimen al que pertenece la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
0= Simplificado
2= Común
Obligatorio:
Si
tipo_identificacion
Descripción:
Tipo de documento de identificación de la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
11= Registro civil
12= Tarjeta de identidad
13= Cedula ciudadania
21= Tarjeta de extranjería
22= Cedula de extranjería
31= NIT
41= Pasaporte
42= Documento de identificación extranjero
Obligatorio:
Si
identificacion
Descripción:
Número completo de la identificación de la empresa o persona
Tipo de dato:
String
Especificaciones:
Alfanumérico
Obligatorio:
Si
correo_electronico
Descripción:
Lista de direcciones de correo electronico, separadas por punto y coma ';'. Para el envio de las notificaciones al adquiriente se va tomar la primera dirección de correo.
Tipo de dato:
Especificaciones:
xxxx@xx.xx;yyyy@yy.yy
Obligatorio:
Si
numero_movil
Descripción:
Número de móvil para el envio de notificaciones
Tipo de dato:
String
Especificaciones:
3111111111
Obligatorio:
No
nombre
Descripción:
Nombre comercial del emisor
Tipo de dato:
array
Especificaciones:
Depende del tipo de contribuyente.
Persona juridica {razon_social}.
Persona natural {primer_nombre, segundo_nombre, apellidos}
Obligatorio:
Si
razon_social
Descripción:
Nombre comercial
Tipo de dato:
Alfanumérico
Especificaciones:
Opcional dependiendo el tipo de contribuyente. Si es NIT es obligatorio
Obligatorio:
Si es persona juridica
primer_nombre
Descripción:
Primer nombre
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si es persona natural
segundo_nombre
Descripción:
Segundo nombre
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
apellido
Descripción:
Apellidos
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si es persona natural
pais
Descripción:
Código dentificador del país. Código alfa-2 asignado al pais
Tipo de dato:
Parametrizado
Especificaciones:
Estandar ISO 3166-1. Inf adicional Ver
Obligatorio:
Si
nombre_pais
Descripción:
Nombre del país.
Tipo de dato:
String
Especificaciones:
Estandar ISO 3166-1. Inf adicional Ver
Obligatorio:
No
departamento
Descripción:
Codigo del departamento, son las subdivisiones administrativas del país (CO). Fue publicada en 1998 y actualizada por última vez en el sexto boletín de la primera edición en 2004.
Si no corresponde a Colombia debe ir el nombre de la ciudad o estado
Tipo de dato:
Parametrizado
Especificaciones:
ISO 3166-2:CO. Inf adicional Ver
Obligatorio:
Si
nombre_departamento
Descripción:
Nombre del departamento
Tipo de dato:
String
Especificaciones:
ISO 3166-2:CO. Inf adicional Ver
Obligatorio:
No
ciudad
Descripción:
Código del municipio ó ciudad ó subdivisión de tercer nivel.
Tipo de dato:
Parametrizado
Especificaciones:
Inf adicional Ver
Obligatorio:
Si
nombre_ciudad
Descripción:
Nombre del municipio ó ciudad ó subdivisión de tercer nivel.
Tipo de dato:
String
Especificaciones:
Inf adicional Ver
Obligatorio:
No
zona
Descripción:
Nombre de la subdivisión de la ciudad
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
direccion
Descripción:
Elemento de texto libre, que el emisor puede elegir utilizar para poner toda la información de la dirección
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 10 caracteres
Obligatorio:
Si
RUT
Descripción:
Información del RUT - Registro Unico Tributario. Responsabilidades, Calidades y Atributos, numeral 53 y Usuarios aduaneros, numeral 54.
Tipo de dato:
array
Especificaciones:
Parametrizable
Obligatorio:
Si
resp_calidades_atributos
Descripción:
Lista de codigos de las responsabilidades, calidades y atributos registrados en el RUT, numeral 53
Tipo de dato:
Array
Especificaciones:
Parametrizado.Inf adicional Ver
Obligatorio:
Si
usuario_aduanero
Descripción:
Lista de codigos usuarios aduaneros registrados en el RUT, numeral 54
Tipo de dato:
Array
Especificaciones:
Vacio
Obligatorio:
No
detalle_factura
numero_linea
Descripción:
Número de Línea
Tipo de dato:
Numerico
Especificaciones:
1...n
Obligatorio:
Si
cantidad
Descripción:
(Cant) Cantidad de productos o servicios solicitados. Número de unidades servidas/prestadas.
Tipo de dato:
Numerico
Especificaciones:
...n
Obligatorio:
Si
unidad_de_cantidad
Descripción:
Unidad de la cantidad del artículo solicitiado
Tipo de dato:
Parametrizado
Obligatorio:
Si
valor_unitario
Descripción:
(VU) Es el precio por unidad de cada bien o servicio antes de aplicar los impuestos o descuento. El valor base es el precio de un activo fijo a efectos impositivos. El valor base es el precio base de un activo sobre el cual se calcula la depreciación y la amortización
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
descripcion
Descripción:
Descripción del artículo o servicio a que se refiere esta línea de la factura. Para el caso de facturas por contratos de servicio tipo AIU en el item de administración se debe enviar la palabra clave 'ADMINISTRACION'
Tipo de dato:
Alfanumérico
Especificaciones:
Mínimo de 2 caracteres
Obligatorio:
Si
nota_detalle
Descripción:
Información adicional: Texto libre, relativo al documento. Para el caso de facturas por contratos de servicio tipo AIU, se debe enviar incluir el objeto del contrato facturado
Tipo de dato:
Alfanumérico
Especificaciones:
Mínimo de 2 caracteres
Obligatorio:
Si
marca
Descripción:
Marca: Marca del artículo
Tipo de dato:
String
Especificaciones:
Obligatorio:
Si
modelo
Descripción:
Modelo: Modelo del artículo
Tipo de dato:
String
Especificaciones:
Obligatorio:
Si
codificacion_estandar
Descripción:
Identificación del producto o servicio de acuerdo con un estandar acordado por la industria, los cuales facilitan el comercio entre empresas y gobierno.
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
cod_grupo_bien_servicio
Descripción:
Tipo de estandar de codificación utilizado para la clasificación de los productos o servicios.
UNSPSC - United Nations Standard Products and Services Code® - Código Estándar de Productos y Servicios de Naciones Unidas. Ver documentación
GTIN - Números Globales de Identificación de Productos.Estructura de los códigos GTIN:
999 - Códigos libres o autónomosCorresponden a la codificación que las empresas cuentan en sus sistemas para la identificación inequívoca de los bienes o servicios que prestan.
Tipo de dato:
Parametrizado
Especificaciones:
1 -> UNSPSC
10 -> GTIN
20 -> Partida Arancelarias
999 -> Estándar de adopción del contribuyente
Obligatorio:
Si
nombre_grupo_bien_servicio
Descripción:
Nombre de la codificación utilizada para la clasificación de los productos o servicios
Tipo de dato:
Parametrizado
Especificaciones:
UNSPSC -> 1
GTIN -> 10
Partida Arancelarias -> 20
Estándar de adopción del contribuyente -> 999
Obligatorio:
Si
cod_segmento_bien_servicio
Descripción:
Codigo del segmento.
Tipo de dato:
String
Especificaciones:
Dependen del grupo del bien o servicio. Información adicional Ver
Obligatorio:
Si
cod_bien_servicio
Descripción:
Codigo del bien o servicio
Tipo de dato:
String
Especificaciones:
Dependen del segmento del bien o servicio. Información adicional Ver
Obligatorio:
Si
regalo
Descripción:
Indicador de si el ítem es gratuito o no
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
es_regalo
Descripción:
Describe si el articulo es un regalo o muestra comercial
Tipo de dato:
Boolean
Especificaciones:
true o false
Obligatorio:
Si
cod_precio_referencia
Descripción:
Código del tipo de precio informado
Tipo de dato:
Parametrizado
Especificaciones:
1 = Valor comercial
2 = Valor en inventarios
3 = Otro valor
0 = En el caso que no sea regalo
Obligatorio:
Si
precio_referencia
Descripción:
Precio de referencia para línea que no contienen valor comercial.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
cargo_descuento
Descripción:
Información relacionada con un cargo o un descuento
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
es_descuento
Descripción:
Indica que el elemento es un Cargo y no un descuento
Descuento es true cuando es un descuento, un Crédito descuenta el valor del ítem
Cargo es false cuando es un recargo, es un Débito aumenta el valor del item.
Tipo de dato:
Boolean
Especificaciones:
True o false
Obligatorio:
Si
porcentaje_cargo_descuento
Descripción:
Porcentaje de descuento o cargo a la linea de la factura
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_cargo_descuento
Descripción:
Valor Base para calcular el descuento o el cargo
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_cargo_descuento
Descripción:
Valor del descuento o el cargo
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
impuestos_detalle
Descripción:
Información relacionada con el impuesto aplicado a la linea de detalle
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
codigo_impuesto
Descripción:
Identificador del tributo
Tipo de dato:
Parametrizado
Especificaciones:
1= IVA
2= Impuesto al consumo
3= ICA
4= Impuesto nacional al consumo
0= Excluido de IVA
Obligatorio:
Si
porcentaje_impuesto
Descripción:
Tarifa del tributo. Porcentaje del valor tributable a ser aplicada a la base imponible de la linea de detalle. Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_impuesto
Descripción:
(VU-VD)*Cant). Base Imponible sobre la que se calcula el valor del tributo. Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_impuesto
Descripción:
(((VU-VD)*Cant) * %Imp). Valor del tributo: producto del porcentaje aplicado sobre la base imponible. Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
retenciones_detalle
Descripción:
Información relacionada con los tributos retenidos en la linea de detalle
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
codigo
Descripción:
Identificador de las retenciónes
Tipo de dato:
Parametrizado
Especificaciones:
5= ReteIVA
6= ReteFuente
7= ReteICA
0= No tiene retenciónes
Obligatorio:
Si
porcentaje
Descripción:
Tarifa del tributo retenido. Porcentaje del valor tributable retenido a ser aplicada a la base imponible de la linea de detalle.
Tipo de dato:
Parametrizado ReteFuente - ReteIVA
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base
Descripción:
La base gravable es el valor sobre el cual se aplica la tarifa de la retención
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_retenido
Descripción:
Valor del tributo: producto del porcentaje aplicado sobre la base imponible
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valores_unitarios
Descripción:
Información relacionada con el valor por producto de la linea de detalle, los datos recibidos son utilizados para la representación grafica cuando sea necesario
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
valor_descuento
Descripción:
Valor del descuento aplicado a un producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_con_descuento
Descripción:
Valor del producto aplicando el descuento de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_1
Descripción:
Valor de la base imponible (IVA) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_2
Descripción:
Valor de la base imponible (Impuesto al consumo) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_3
Descripción:
Valor de la base imponible (ICA) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_4
Descripción:
Valor de la base imponible (Impuesto nacional al consumo) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_reteiva
Descripción:
Valor retenido de Reteiva del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_retefuente
Descripción:
Valor retenido de Retefuente del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_reteica
Descripción:
Valor retenido de Reteica del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_a_pagar
Descripción:
Valor total del producto de la linea de detalle, incluyendo descuentos, retenciónes e impuestos
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_total_detalle_con_cargo_descuento
Descripción:
(((VU * Cant)- VD)+VR). Valor total de la linea de detalle incluyendo el descuento y el recargo si aplica
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_detalle
Descripción:
(VU*Cant). Valor total de la linea de detalle sin incluir descuentos, retenciónes o impuestos.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
impuestos
codigo_impuesto
Descripción:
Es la clase que se utiliza para describir el esquema del impuesto
Tipo de dato:
Parametrizado
Especificaciones:
01= IVA
02= Impuesto al consumo
03= ICA
04= Impuesto nacional al consumo
0= Excluido de IVA
Obligatorio:
Si
porcentaje_impuesto
Descripción:
Número de importe del impuesto retenido. Si hay algun item excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base_calculo_impuesto
Descripción:
Base Imponible sobre la que se calcula la retención de impuesto. Si hay algun item excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto
Descripción:
Importe del impuesto retenido. Si hay algun item excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
cambio_de_moneda
fecha_cambio
Descripción:
Fecha del cambio de la moneda.
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Si la moneda de origen es diferente de COP
codigo
Descripción:
La moneda de referencia para el tipo de cambio; La moneda a partir de la cual se realiza el cambio.
Tipo de dato:
Parametrizado
Especificaciones:
COP- Colombia, USD - dolares. Inf adicional Ver
Obligatorio:
Si la moneda de origen es diferente de COP
valor_base_trm
Descripción:
Tasa de cambio del día de emisión o expedición del documento.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si la moneda de origen es diferente de COP
recargos
nombre_recargo
Descripción:
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
porcentaje_recargo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_base_calculo_recargo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_total_recargo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
descuentos
codigo_descuento
Descripción:
Numero utilizado para categorizar el tipo de descuento otorgado
Tipo de dato:
Parametrizado
Especificaciones:
00= Descuento por impuesto asumido
01= Pague uno lleve otro02= Descuentos contractulales
03= Descuento por pronto pago
04= Envío gratis
05= Descuentos escpecíficos por inventarios
06= Descuento por monto de compras
07= Descuento de temporada
08= Descuento por acturalización de productos / servicios
09= Descuento general
10= Descuento por volumen
11= Otro descuento
99= No aplica descuento
Obligatorio:
Si
porcentaje_descuento
Descripción:
Número del descuento
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_calculo_descuento
Descripción:
Valor Base para calcular el descuento
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_descuento
Descripción:
Valor total del descuento
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_nota_debito
valor_base
Descripción:
Total Valor Bruto antes de tributos: Total valor bruto, suma de los valores brutos de las líneas de la factura incluyendo descuentos mas recargos, es decir la suma de todas las lineas de detalle de los valor_total_detalle_con_cargo_descuento.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_calculo_impuestos
Descripción:
Total Valor Base Imponible : Base imponible para el cálculo de los tributos
tiene que ser la suma de los valores de las bases imponibles de todas líneas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_mas_impuestos
Descripción:
Total de Valor Bruto más tributos
El Valor Bruto más tributos tiene que ser igual 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.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_anticipo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_descuento_total
Descripción:
Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
El Valor del Descuento Total es igual a la Suma de todos los descuentos globales aplicados al total de la factura.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_1
Descripción:
Suma de todos los impuestos 1 aplicados a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_2
Descripción:
Suma de todos los impuestos 2 aplicados a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_3
Descripción:
Tipo de dato:
Suma de todos los impuestos 3 aplicados a nivel de las lineas de detalle
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_4
Descripción:
Tipo de dato:
Suma de todos los impuestos 4 aplicados a nivel de las lineas de detalle
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_reteiva
Descripción:
Suma de todos los reteiva a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_total_retefuente
Descripción:
Suma de todos los retefuente a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_total_reteica
Descripción:
Suma de todos los reteica a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
total_nota_debito
Descripción:
Total importe bruto +Total valor_impuestos
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_a_pagar
Descripción:
Valor total a pagar: El valor a total de factura es igual a la suma de valor bruto + impuestos - retenciónes - valor del descuento total + valor del cargo total - valor del anticipo total
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
generalidades
tipo_ambiente_dian
Descripción:
Ambiente de la DIAN al que se destina el documento enviado.
Tipo de dato:
Parametrizable
Especificaciones:
1= Producción
2= Pruebas
Obligatorio:
Si
version
Descripción:
Identificación consecutiva de la especificación
Tipo de dato:
Decimal
Especificaciones:
Obligatorio:
Si
identificador_transmision
Descripción:
Código único para identificar el paquete transmitido
Tipo de dato:
Alfanumérico
Especificaciones:
Obligatorio:
Mínimo 5 caracteres
rg_base_64
Descripción:
Pdf del documento elecronico en base 64
Tipo de dato:
Alfanumérico
Especificaciones:
Obligatorio:
Mínimo 5 caracteres
rg_tipo
Descripción:
Si se envia rg_base_64 identificar que tipo de archivo es HTML o PDF
Tipo de dato:
Parametrizable
Especificaciones:
HTML O PDF
Obligatorio:
Si hay información en rg_base_64
rg_px_qr
Descripción:
Información para ubicar el QR dentro del documento envido en base 64
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si se envia el rg_base_64
x
Descripción:
Posicionamiento en x dentro de la representación grafica
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en x desde la posición (0,0)
Obligatorio:
No
y
Descripción:
Posicionamiento en y dentro de la representación grafica
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en y desde la posición (0,0)
Obligatorio:
No
size
Descripción:
Tamaño del qr
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
mostrar_en
Descripción:
Identificador de si el QR en el PDF se pinta en la primera pagina o en todas
Tipo de dato:
Parametrizable
Especificaciones:
PRIMERA_PAGINA,TODAS
Obligatorio:
No
rg_px_cufe
Descripción:
Información de configuración de CUFE en la representación grafica
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si se envia el rg_base_64
x
Descripción:
Posicionamiento en x(abscisas) en el plano cartesiano en el cuarto cuadrante, es decir las columnas empezando de 0.
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en x desde la posición (0,0)
Obligatorio:
No
y
Descripción:
Posicionamiento en y(ordenadas) en el plano cartesiano en el cuarto cuadrante, es decir las filas empezando de 0.
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en y desde la posición (0,0)
Obligatorio:
No
size
Descripción:
Tamaño de la letra
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
mostrar_en
Descripción:
Identificador de si el CUFE/CUDE en el PDF se pinta en la primera pagina o en todas
Tipo de dato:
Parametrizable
Especificaciones:
PRIMERA_PAGINA,TODAS
Obligatorio:
No
notificacion
Descripción:
Información de configuración de envio de notificaciones. Los campos de notificación son obligatorios en caso que sea de forma automatica.
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
es_automatico
Descripción:
Indicar si la notificación es enviada de forma automatica
Tipo de dato:
Parametrizado
Especificaciones:
S o N
Obligatorio:
No
correo_obligado
Descripción:
Dirección de correo del obligado
Tipo de dato:
Especificaciones:
xxx@xx.xxx
Obligatorio:
No
asunto
Descripción:
Texto para el envio de las notificaciones
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
con_copia
Descripción:
Tamaño de la letra
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
integrador
Descripción:
Información de quien envia la información
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
nombre
Descripción:
Nombre de quien realiza la integración
Tipo de dato:
Parametrizado
Especificaciones:
S o N
Obligatorio:
Si
tipo
Descripción:
Codigo del medio usado para realizar la integración
Tipo de dato:
Parametrizado
Especificaciones:
MOVIL
WEB
DLL
EXCEL
ERP-XXXXXXXXX
Obligatorio:
Si
webhook
Descripción:
URL para notificar cuando ha ocurrido un evento. Esta se utiliza cuando los codigos de error del retorno del API son 28,20.
Tipo de dato:
String
Especificaciones:
URL con portocolo de seguridad - HTTPS
Obligatorio:
No
retenciones
codigo
Descripción:
Identificador de las retenciónes
Tipo de dato:
Parametrizado
Especificaciones:
5= ReteIVA
6= ReteFuente
7= ReteICA
0= No tiene retenciónes
Obligatorio:
No
porcentaje
Descripción:
Importe del impuesto retenido al total de la factura
Tipo de dato:
Parametrizado ReteFuente - ReteIVA
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
No
valor_base
Descripción:
La base gravable es el valor sobre el cual se aplica la tarifa de la retención
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_retenido
Descripción:
Valor total de la retención por factura
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
periodo_facturacion
- Ejemplo 1. Nota debito con un detalle de cantidad e impuesto del 19%
- Ejemplo 2. Nota debito con varios detalles de cantidad uno y con diferentes impuestos de IVA
- Ejemplo 3. Nota debito con varios detalles con cantidad mayor que uno y con diferentes impuestos de IVA, impuesto nacional al consumo
- Ejemplo 4. Nota debito con un detalle exento de IVA y otros detalles con impuestos
- Ejemplo 5. Nota debito con adquiriente persona natural
- Ejemplo 6. Nota debito con descuento a nivel de detalles
- Ejemplo 7. Nota debito con descuento a nivel de la nota debito
- Ejemplo 8. Nota debito con recargos a nivel de nota debito
- Ejemplo 9. Nota debito con recargos a nivel de detalle de nota debito
- Ejemplo 10. Nota debito con varios recargos a nivel de la nota debito
- Ejemplo 11. Nota debito con moneda diferente de COP
- Ejemplo 12. Nota debito con un detalle excluido de IVA y otros detalles con impuestos
- Ejemplo 13. Nota debito de documento con retenciones
- Ejemplo 14. Nota debito de factura AIU
Ejemplo 1.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND103",
"fecha": "2019-08-05",
"hora": "10:49:00",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-07-05",
"hora": "16:11:03"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-03",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"valor_unitario": "10972561.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~balon~|~",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "10972561.00",
"valor_impuesto": "2084786.59"
},
"valor_total_detalle_con_cargo_descuento": "10972561.00",
"valor_total_detalle": "10972561.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "10972561.00",
"valor_total_impuesto": "2084786.59"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "10972561.00",
"valor_base_calculo_impuestos": "10972561.00",
"valor_base_mas_impuestos": "13057347.59",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "2084786.59",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_debito": "13057347.59",
"valor_total_a_pagar": "13057347.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 2.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND131",
"fecha": "2019-08-21",
"hora": "10:49:00",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-07-05",
"hora": "16:11:03"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-03",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"valor_unitario": "600000.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~balon~|~",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"valor_unitario": "60000.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~pesas~|~",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "60000.00",
"valor_impuesto": "9600.00"
},
"valor_total_detalle_con_cargo_descuento": "60000.00",
"valor_total_detalle": "60000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "60000.00",
"valor_total_impuesto": "9600.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "660000.00",
"valor_base_calculo_impuestos": "660000.00",
"valor_base_mas_impuestos": "783600.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "123600.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_debito": "783600.00",
"valor_total_a_pagar": "783600.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 3.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND132",
"fecha": "2019-08-21",
"hora": "10:49:00",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-07-05",
"hora": "16:11:03"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-03",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"valor_unitario": "300000.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~balon~|~",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
},
{
"numero_linea": 2,
"cantidad": 3,
"valor_unitario": "50000.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~pesas~|~",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_impuesto": "150000.00",
"valor_impuesto": "12000.00"
},
"valor_total_detalle_con_cargo_descuento": "150000.00",
"valor_total_detalle": "150000.00"
},
{
"numero_linea": 3,
"cantidad": 5,
"valor_unitario": "25000.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~Bandas~|~",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "125000.00",
"valor_impuesto": "20000.00"
},
"valor_total_detalle_con_cargo_descuento": "125000.00",
"valor_total_detalle": "125000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "125000.00",
"valor_total_impuesto": "20000.00"
},
{
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_calculo_impuesto": "150000.00",
"valor_total_impuesto": "12000.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "875000.00",
"valor_base_calculo_impuestos": "875000.00",
"valor_base_mas_impuestos": "1021000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "134000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "12000.00",
"total_nota_debito": "1021000.00",
"valor_total_a_pagar": "1021000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 4.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND134",
"fecha": "2019-08-21",
"hora": "10:49:00",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-07-05",
"hora": "16:11:03"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "830020470",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "TELEINTE S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10 96-25",
"RUT": {
"resp_calidades_atributos": [
"O-03",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 4,
"valor_unitario": "36000.00",
"unidad_de_cantidad": "94",
"descripcion": "Servicio Exento",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "144000.00",
"valor_impuesto": "0.00"
},
"valor_total_detalle_con_cargo_descuento": "144000.00",
"valor_total_detalle": "144000.00"
},
{
"numero_linea": 2,
"cantidad": 3,
"valor_unitario": "480000.00",
"unidad_de_cantidad": "94",
"descripcion": "Configuración inicial afacturar ",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1440000.00",
"valor_impuesto": "273600.00"
},
"valor_total_detalle_con_cargo_descuento": "1440000.00",
"valor_total_detalle": "1440000.00"
},
{
"numero_linea": 3,
"cantidad": 23,
"valor_unitario": "3500.00",
"unidad_de_cantidad": "94",
"descripcion": "R-PI34-SW-K9",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "80500.00",
"valor_impuesto": "15295.00"
},
"valor_total_detalle_con_cargo_descuento": "80500.00",
"valor_total_detalle": "80500.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "144000.00",
"valor_total_impuesto": "0.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1520500.00",
"valor_total_impuesto": "288895.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "1664500.00",
"valor_base_calculo_impuestos": "1664500.00",
"valor_base_mas_impuestos": "1953395.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "288895.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_debito": "1953395.00",
"valor_total_a_pagar": "1953395.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 5.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND135",
"fecha": "2019-08-21",
"hora": "10:49:00",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-07-05",
"hora": "16:11:03"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "830020470",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "TELEINTE S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10 96-29",
"RUT": {
"resp_calidades_atributos": [
"O-03",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"valor_unitario": "10972561.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~balon~|~",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "10972561.00",
"valor_impuesto": "2084786.59"
},
"valor_total_detalle_con_cargo_descuento": "10972561.00",
"valor_total_detalle": "10972561.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "10972561.00",
"valor_total_impuesto": "2084786.59"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "10972561.00",
"valor_base_calculo_impuestos": "10972561.00",
"valor_base_mas_impuestos": "13057347.59",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "2084786.59",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_debito": "13057347.59",
"valor_total_a_pagar": "13057347.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 6.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND126",
"fecha": "2019-08-20",
"hora": "10:49:00",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-08-20",
"hora": "10:11:03"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "830020470",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "TELEINTE S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10 96-29",
"RUT": {
"resp_calidades_atributos": [
"O-03",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"valor_unitario": "100000.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~balon~|~",
"cargo_descuento": {
"es_descuento": true,
"porcentaje_cargo_descuento": "10.00",
"valor_base_cargo_descuento": "100000.00",
"valor_cargo_descuento": "10000.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "90000.00",
"valor_impuesto": "17100.00"
},
"valor_total_detalle_con_cargo_descuento": "90000.00",
"valor_total_detalle": "100000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "90000.00",
"valor_total_impuesto": "17100.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "90000.00",
"valor_base_calculo_impuestos": "90000.00",
"valor_base_mas_impuestos": "107100.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "17100.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_debito": "107100.00",
"valor_total_a_pagar": "107100.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 7.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND137",
"fecha": "2019-08-20",
"hora": "10:49:00",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-08-20",
"hora": "10:11:03"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "830020470",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "TELEINTE S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10 96-29",
"RUT": {
"resp_calidades_atributos": [
"O-03",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"valor_unitario": "100000.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~balon~|~",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "200000.00",
"valor_impuesto": "38000.00"
},
"valor_total_detalle_con_cargo_descuento": "200000.00",
"valor_total_detalle": "200000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "200000.00",
"valor_total_impuesto": "38000.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 11,
"porcentaje_descuento": "10.00",
"valor_base_calculo_descuento": "200000.00",
"valor_total_descuento": "20000.00"
}
],
"valor_nota_debito": {
"valor_base": "200000.00",
"valor_base_calculo_impuestos": "200000.00",
"valor_base_mas_impuestos": "238000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "20000.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "38000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_debito": "218000.00",
"valor_total_a_pagar": "218000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 8.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND142",
"fecha": "2019-08-20",
"hora": "10:49:00",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-08-20",
"hora": "10:11:03"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "830020470",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "TELEINTE S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10 96-25",
"RUT": {
"resp_calidades_atributos": [
"O-03",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"valor_unitario": "100000.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~balon~|~",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "200000.00",
"valor_impuesto": "38000.00"
},
"valor_total_detalle_con_cargo_descuento": "200000.00",
"valor_total_detalle": "200000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "200000.00",
"valor_total_impuesto": "38000.00"
}
],
"recargos": [
{
"nombre_recargo": "Envio de mercancia",
"porcentaje_recargo": "5.00",
"valor_base_calculo_recargo": "200000.00",
"valor_total_recargo": "10000.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "200000.00",
"valor_base_calculo_impuestos": "200000.00",
"valor_base_mas_impuestos": "238000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "10000.00",
"valor_total_impuesto_1": "38000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_debito": "248000.00",
"valor_total_a_pagar": "248000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 9.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND145",
"fecha": "2019-08-22",
"hora": "10:49:00",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-08-20",
"hora": "10:11:03"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "830020470",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "TELEINTE S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10 96-29",
"RUT": {
"resp_calidades_atributos": [
"O-03",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"valor_unitario": "100000.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~balon~|~",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "5.00",
"valor_base_cargo_descuento": "200000.00",
"valor_cargo_descuento": "10000.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "210000.00",
"valor_impuesto": "39900.00"
},
"valor_total_detalle_con_cargo_descuento": "210000.00",
"valor_total_detalle": "210000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "210000.00",
"valor_total_impuesto": "39900.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "210000.00",
"valor_base_calculo_impuestos": "210000.00",
"valor_base_mas_impuestos": "249900.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "39900.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_debito": "249900.00",
"valor_total_a_pagar": "249900.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 10.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND146",
"fecha": "2019-08-22",
"hora": "10:49:00",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-08-20",
"hora": "10:11:03"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "830020470",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "TELEINTE S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10 96-25",
"RUT": {
"resp_calidades_atributos": [
"O-03",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2,
"valor_unitario": "100000.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~balon~|~",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "200000.00",
"valor_impuesto": "38000.00"
},
"valor_total_detalle_con_cargo_descuento": "200000.00",
"valor_total_detalle": "200000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "200000.00",
"valor_total_impuesto": "38000.00"
}
],
"recargos": [
{
"nombre_recargo": "Prueba de recargo",
"porcentaje_recargo": "2.00",
"valor_base_calculo_recargo": "200000.00",
"valor_total_recargo": "4000.00"
},
{
"nombre_recargo": "Envio de mercancia",
"porcentaje_recargo": "5.00",
"valor_base_calculo_recargo": "200000.00",
"valor_total_recargo": "10000.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "200000.00",
"valor_base_calculo_impuestos": "200000.00",
"valor_base_mas_impuestos": "238000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "14000.00",
"valor_total_impuesto_1": "38000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_debito": "252000.00",
"valor_total_a_pagar": "252000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 11.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND148",
"fecha": "2019-08-22",
"hora": "10:49:00",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-07-05",
"hora": "16:11:03"
},
"cambio_de_moneda":{
"fecha_cambio":"2019-08-22",
"codigo":"USD",
"valor_base_trm":"3500.00"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "830020470",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "TELEINTE S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10 96-25",
"RUT": {
"resp_calidades_atributos": [
"O-03",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"valor_unitario": "10972561.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~balon~|~",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "10972561.00",
"valor_impuesto": "2084786.59"
},
"valor_total_detalle_con_cargo_descuento": "10972561.00",
"valor_total_detalle": "10972561.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "10972561.00",
"valor_total_impuesto": "2084786.59"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "10972561.00",
"valor_base_calculo_impuestos": "10972561.00",
"valor_base_mas_impuestos": "13057347.59",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "2084786.59",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_debito": "13057347.59",
"valor_total_a_pagar": "13057347.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 12.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND200",
"fecha": "2020-01-07",
"hora": "10:49:00",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-07-05",
"hora": "16:11:03"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "830020470",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "TELEINTE S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10 96-25",
"RUT": {
"resp_calidades_atributos": [
"O-03",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 4,
"valor_unitario": "36000.00",
"unidad_de_cantidad": "94",
"descripcion": "Servicio Exento",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"valor_total_detalle_con_cargo_descuento": "144000.00",
"valor_total_detalle": "144000.00"
},
{
"numero_linea": 2,
"cantidad": 3,
"valor_unitario": "480000.00",
"unidad_de_cantidad": "94",
"descripcion": "Configuración inicial afacturar ",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1440000.00",
"valor_impuesto": "273600.00"
},
"valor_total_detalle_con_cargo_descuento": "1440000.00",
"valor_total_detalle": "1440000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "0.00",
"valor_total_impuesto": "0.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1440000.00",
"valor_total_impuesto": "273600.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "1584000.00",
"valor_base_calculo_impuestos": "1440000.00",
"valor_base_mas_impuestos": "1857600.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "273600.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_debito": "1857600.00",
"valor_total_a_pagar": "1857600.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 13.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND100",
"fecha": "2020-02-06",
"hora": "00:59:18",
"nota": [
"{'SON':'Seis millones novecientas setenta y una mil trescientas sesenta y una coma seis cinco cuatro una cinco'",
"'vr_rte_ica':'0.00'",
"'pct_rte_ica':'0.00'",
"'vr_rte_iva':'72227.18'",
"'pct_rte_iva':'15.00'",
"'vr_rte_fte':'253428.69'",
"'pct_rte_fte':'10.00'",
"'vr_total_factura':'2690145.54'",
"'vr_total_a_pagar':'2690145.54'}"
],
"metodo_de_pago": 1,
"tipo_de_pago": 1,
"moneda": "COP",
"tipo_nota_debito": 1
},
"informacion_factura": {
"id_factura": "SETP990001102",
"fecha": "2020-01-20",
"hora": "07:33:21",
"codigo_unico_factura": "e3d2703015ea19fc50a86a038a2af958aeade93508daa56d41b0287b639a43089449f1dde072c4558d3e6618aab27c39"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "811023263",
"correo_electronico": "proyectos@netfiners.com",
"numero_movil": "",
"nombre": {
"razon_social": "MANTENIMIENTO DE FACHADAS Y PISOS S.A.S",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"nombre_pais": "Colombia",
"departamento": "5",
"nombre_departamento": "ANTIOQUIA",
"zona": "ITAGÜÍ",
"ciudad": "5360",
"nombre_ciudad": "ITAGÜÍ",
"direccion": "CALLE 78 No 52 D - 120 ",
"RUT": {
"resp_calidades_atributos": [
"O-99"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 2985,
"unidad_de_cantidad": "KGM",
"valor_unitario": "1682.00",
"descripcion": "PROTECSIL H290",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "5020770.00",
"valor_total_detalle": "5020770.00"
},
{
"numero_linea": 2,
"cantidad": 795,
"unidad_de_cantidad": "94",
"valor_unitario": "2045.00",
"descripcion": "PROTECSIL SN GRIS",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1625775.00",
"valor_total_detalle": "1625775.00"
},
{
"numero_linea": 3,
"cantidad": 1,
"unidad_de_cantidad": "KGM",
"valor_unitario": "332327.25",
"descripcion": "PROTECSIL OLEOFUGO 380",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "332327.25",
"valor_total_detalle": "332327.25"
},
{
"numero_linea": 4,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "66465.45",
"descripcion": "PROTECSIL SN GRIS",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "66465.45",
"valor_total_detalle": "66465.45"
},
{
"numero_linea": 5,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "0.00",
"descripcion": "Utilidad",
"regalo": {
"es_regalo": true,
"cod_precio_referencia": 3,
"precio_referencia": "352266.89"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "352266.89",
"valor_impuesto": "66930.71"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "0.00",
"valor_total_detalle": "0.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "352266.89",
"valor_total_impuesto": "66930.71"
}
],
"retenciones": [
{
"codigo": 6,
"porcentaje": "2.00",
"valor_base": "7045337.70",
"valor_retenido": "140906.75"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "7045337.70",
"valor_base_calculo_impuestos": "352266.89",
"valor_base_mas_impuestos": "7112268.41",
"valor_anticipo": "0.00",
"valor_total_impuesto_1": "66930.71",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "140906.75",
"valor_total_reteica": "0.00",
"valor_total_recargos": "0.00",
"valor_descuento_total": "0.00",
"total_nota_debito": "7112268.41",
"valor_total_a_pagar": "6971361.65"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "c0c7c76d30bd3dcaefc96f40275bdc0a",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 14.
{
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND112",
"fecha": "2019-08-05",
"hora": "10:49:00",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-07-05",
"hora": "16:11:03"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-09",
"O-07"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"valor_unitario": "10972561.00",
"unidad_de_cantidad": "94",
"descripcion": "~|~~|~balon~|~",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "10972561.00",
"valor_impuesto": "2084786.59"
},
"valor_total_detalle_con_cargo_descuento": "10972561.00",
"valor_total_detalle": "10972561.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "10972561.00",
"valor_total_impuesto": "2084786.59"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "10972561.00",
"valor_base_calculo_impuestos": "10972561.00",
"valor_base_mas_impuestos": "13057347.59",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "2084786.59",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_debito": "13057347.59",
"valor_total_a_pagar": "13057347.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Salida Exitosa
Salida con errores de semantica
Salida con errores de datos
Salida con errores HTTP
Salida con error de datos en la DIAN
{
"codigo_error": 0,
"descripcion_error": "OK",
"tiempo_ejecucion": 2.8475100994110109,
"transaccion": "5e5e5e5e5e55e",
"resultado": {
"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"id_nota_debito": "SETP990001502",
"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
"url_application_response": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ar083002047005520SETP990001502.xml",
"url_attached_document_url": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ad083002047005520SETP990001502.xml",
"url_representacion_grafica": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.pdf",
"url_notificacion_aceptacion_rechazo": "http://app.afacturar.com/consulta_documento/?uid=5e5e5e5e5e55e"
},
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": ""
}
Salida con errores de semantica
{
"codigo_error": 400,
"descripcion_error": "Hay un problema con la informacion entregada",
"tiempo_ejecucion": 0.01330113410949707,
"transaccion": "5e74ce82707f6",
"resultado": [
{
"propiedad": "nota_debito[0].encabezado.tipo_nota_debito",
"descripcion": "The property tipo_nota_debito is required"
},
{
"propiedad": "nota_debito[0].encabezado.tipo_nota_debito",
"descripcion": "Does not have a value in the enumeration [1,2,3,5,6,7,8,9,10]"
},
{
"propiedad": "nota_debito[0].encabezado",
"descripcion": "The property tipo_nota_debit is not defined and the definition does not allow additional properties"
}
],
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": ""
}
Salida con errores de datos
{
"codigo_error": 400,
"descripcion_error": "Hay problema(s) con la información entregada",
"resultado": [
[
{
"propiedad": "nota_debito->fecha",
"descripcion": "fecha invalida"
}
]
]
}
Salida con errores HTTP
{
"codigo_error": 500,
"descripcion_error": "Unauthenticated."
}
Salida con error de datos en la DIAN
{
"codigo_error": 15,
"descripcion_error": "La validación en la DIAN devuelve error(es)",
"tiempo_ejecucion": 1.9776690006256104,
"transaccion": "5e74d144dd565",
"resultado": {
"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"id_nota_debito": "SETP990001504",
"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
},
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": "Regla: FAU06, Rechazo: 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.Regla: FAU02, Rechazo: 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"
}
CURL
curl -X POST \
https://servicios-pruebas.afacturar.com/api/vp/nota_debito \
-H 'accept: application/json' \
-H 'authorization: Bearer token_cliente' \
-H 'cache-control: no-cache' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-F 'data={
"nota_debito": [
{
"encabezado": {
"id_nota_debito": "ND195",
"fecha": "2020-06-25",
"hora": "10:49:00",
"nota": [
"{'\''SON'\'':'\''XXX XXX XXX'\''",
"'\''VARIABLE'\'':'\''VALOR'\''}"
],
"moneda": "COP",
"tipo_nota_debito": 3,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABC1234",
"fecha_vencimiento": ""
},
"informacion_factura": {
"id_factura": "990000181",
"codigo_unico_factura": "c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71",
"fecha": "2019-07-05",
"hora": "16:11:03"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 0,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-15",
"O-16"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"valor_unitario": "10972561.00",
"unidad_de_cantidad": "94",
"descripcion": "",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "10972561.00",
"valor_impuesto": "2084786.59"
},
"valor_total_detalle_con_cargo_descuento": "10972561.00",
"valor_total_detalle": "10972561.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "10972561.00",
"valor_total_impuesto": "2084786.59"
}
],
"recargos": [
{
"nombre_recargo": "Flete",
"porcentaje_recargo": "100.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_nota_debito": {
"valor_base": "10972561.00",
"valor_base_calculo_impuestos": "10972561.00",
"valor_base_mas_impuestos": "13057347.59",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "2084786.59",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"total_nota_debito": "13057347.59",
"valor_total_a_pagar": "13057347.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "10031420072_20190531104920",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
} ' \
-F documento_obligado=830020470
C#
var client = new RestClient("https://servicios-pruebas.afacturar.com/api/vp/nota_debito");
var request = new RestRequest(Method.POST);
request.AddHeader("postman-token", "41b1de00-0819-be86-245d-a58233cedb69");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("authorization", "Bearer token_cliente");
request.AddHeader("accept", "application/json");
request.AddHeader("content-type", "multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW");
request.AddParameter("multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW", "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"data\"\r\n\r\n{\n\t\"nota_debito\": [\n\t\t{\n\t\t\t\"encabezado\": {\n\t\t\t\t\"id_nota_debito\": \"ND195\",\n\t\t\t\t\"fecha\": \"2020-06-25\",\n\t\t\t\t\"hora\": \"10:49:00\",\n\t\t\t\t\"nota\": [\n\t\t\t\t\t\"{'SON':'XXX XXX XXX'\",\n\t\t\t\t\t\"'VARIABLE':'VALOR'}\"\n\t\t\t\t],\n\t\t\t\t\"moneda\": \"COP\",\n\t\t\t\t\"tipo_nota_debito\": 3,\n\t\t\t\t\"metodo_de_pago\": 1,\n\t\t\t\t\"tipo_de_pago\": 41,\n\t\t\t\t\"identificador_de_pago\": \"ABC1234\",\n\t\t\t\t\"fecha_vencimiento\": \"\"\n\t\t\t},\n\t\t\t\"informacion_factura\": {\n\t\t\t\t\"id_factura\": \"990000181\",\n\t\t\t\t\"codigo_unico_factura\": \"c605391a9d0ab5539524e089cca1dd69305629f3cf5a61f9c1565b1a2f6d551bb7e9fb80cd4efc478f3d6012aff46c71\",\n\t\t\t\t\"fecha\": \"2019-07-05\",\n\t\t\t\t\"hora\": \"16:11:03\"\n\t\t\t},\n\t\t\t\"informacion_adquiriente\": {\n\t\t\t\t\"tipo_contribuyente\": 1,\n\t\t\t\t\"tipo_regimen\": 0,\n\t\t\t\t\"tipo_identificacion\": 31,\n\t\t\t\t\"identificacion\": \"900730299\",\n\t\t\t\t\"correo_electronico\": \"info@teleinte.com\",\n\t\t\t\t\"numero_movil\": \"\",\n\t\t\t\t\"nombre\": {\n\t\t\t\t\t\"razon_social\": \"PIXELPRO S.A.S.\",\n\t\t\t\t\t\"primer_nombre\": \"\",\n\t\t\t\t\t\"segundo_nombre\": \"\",\n\t\t\t\t\t\"apellido\": \"\"\n\t\t\t\t},\n\t\t\t\t\"pais\": \"CO\",\n\t\t\t\t\"departamento\": \"11\",\n\t\t\t\t\"ciudad\": \"11001\",\n\t\t\t\t\"zona\": \"\",\n\t\t\t\t\"direccion\": \"Carrera 10\",\n\t\t\t\t\"RUT\": {\n\t\t\t\t\t\"resp_calidades_atributos\": [\n\t\t\t\t\t\t\"O-15\",\n\t\t\t\t\t\t\"O-16\"\n\t\t\t\t\t],\n\t\t\t\t\t\"usuario_aduanero\": [\n\t\t\t\t\t\t\"\"\n\t\t\t\t\t]\n\t\t\t\t}\n\t\t\t},\n\t\t\t\"detalle_factura\": [\n\t\t\t\t{\n\t\t\t\t\t\"numero_linea\": 1,\n\t\t\t\t\t\"cantidad\": 1,\n\t\t\t\t\t\"valor_unitario\": \"10972561.00\",\n\t\t\t\t\t\"unidad_de_cantidad\": \"94\",\n\t\t\t\t\t\"descripcion\": \"\",\n\t\t\t\t\t\"cargo_descuento\": {\n\t\t\t\t\t\t\"es_descuento\": false,\n\t\t\t\t\t\t\"porcentaje_cargo_descuento\": \"0.00\",\n\t\t\t\t\t\t\"valor_base_cargo_descuento\": \"0.00\",\n\t\t\t\t\t\t\"valor_cargo_descuento\": \"0.00\"\n\t\t\t\t\t},\n\t\t\t\t\t\"impuestos_detalle\": {\n\t\t\t\t\t\t\"codigo_impuesto\": 1,\n\t\t\t\t\t\t\"porcentaje_impuesto\": \"19.00\",\n\t\t\t\t\t\t\"valor_base_impuesto\": \"10972561.00\",\n\t\t\t\t\t\t\"valor_impuesto\": \"2084786.59\"\n\t\t\t\t\t},\n\t\t\t\t\t\"valor_total_detalle_con_cargo_descuento\": \"10972561.00\",\n\t\t\t\t\t\"valor_total_detalle\": \"10972561.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"impuestos\": [\n\t\t\t\t{\n\t\t\t\t\t\"codigo_impuesto\": 1,\n\t\t\t\t\t\"porcentaje_impuesto\": \"19.00\",\n\t\t\t\t\t\"valor_base_calculo_impuesto\": \"10972561.00\",\n\t\t\t\t\t\"valor_total_impuesto\": \"2084786.59\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"recargos\": [\n\t\t\t\t{\n\t\t\t\t\t\"nombre_recargo\": \"Flete\",\n\t\t\t\t\t\"porcentaje_recargo\": \"100.00\",\n\t\t\t\t\t\"valor_base_calculo_recargo\": \"0.00\",\n\t\t\t\t\t\"valor_total_recargo\": \"0.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"descuentos\": [\n\t\t\t\t{\n\t\t\t\t\t\"codigo_descuento\": 99,\n\t\t\t\t\t\"porcentaje_descuento\": \"0.00\",\n\t\t\t\t\t\"valor_base_calculo_descuento\": \"0.00\",\n\t\t\t\t\t\"valor_total_descuento\": \"0.00\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"valor_nota_debito\": {\n\t\t\t\t\"valor_base\": \"10972561.00\",\n\t\t\t\t\"valor_base_calculo_impuestos\": \"10972561.00\",\n\t\t\t\t\"valor_base_mas_impuestos\": \"13057347.59\",\n\t\t\t\t\"valor_anticipo\": \"0.00\",\n\t\t\t\t\"valor_descuento_total\": \"0.00\",\n\t\t\t\t\"valor_total_recargos\": \"0.00\",\n\t\t\t\t\"valor_total_impuesto_1\": \"2084786.59\",\n\t\t\t\t\"valor_total_impuesto_2\": \"0.00\",\n\t\t\t\t\"valor_total_impuesto_3\": \"0.00\",\n\t\t\t\t\"valor_total_impuesto_4\": \"0.00\",\n\t\t\t\t\"total_nota_debito\": \"13057347.59\",\n\t\t\t\t\"valor_total_a_pagar\": \"13057347.00\"\n\t\t\t}\n\t\t}\n\t],\n\t\"generalidades\": {\n\t\t\"tipo_ambiente_dian\": 2,\n\t\t\"version\": 2,\n\t\t\"identificador_transmision\": \"10031420072_20190531104920\",\n\t\t\"integrador\": {\n\t\t\t\"nombre\": \"Afacturar.com\",\n\t\t\t\"tipo\": \"WEB\"\n\t\t}\n\t}\n}\t\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"documento_obligado\"\r\n\r\n830020470\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Errores
Cuando usted hace un llamado a la API, puede recibir los siguientes mensajes de error en la respuesta. Puede que haya algo mal con su solicitud o puede que algo esté mal de nuestra parte. Los errores responden con un código de error y JSON que contiene un mensaje, una descripción y un código API más preciso.
Códigos de ERROR
Tabla de Errores
| Código | Estado | Descripción | Acción sugerida |
|---|---|---|---|
| 400 | Solicitud incorrecta | Hay un problema con su solicitud | Compruebe que su solicitud sigue la documentación de la API y utiliza la sintaxis correcta. |
| 401 | No autorizado | No tiene la autorización necesaria para realizar la solicitud. | Asegúrese de estar utilizando una clave API válida con los permisos necesarios para su solicitud. |
| 403 | Prohibido | El servidor entendió la solicitud, pero se negó a cumplirla. | Vea si su plan en Afacturar.com incluye el recurso que está solicitando y su clave API tiene las autorizaciones necesarias. |
| 404 | No encontrado | El servidor no pudo encontrar el recurso solicitado. | Cambie su URL de solicitud para que coincida con un punto final API válido. |
| 405 | Método no permitido | El recurso no tiene el método especificado. (por ejemplo, PUT en las transmisiones) | Cambie el método para seguir la documentación del recurso. |
| 409 | Conflicto | Un conflicto surgió de su solicitud. (por ejemplo, el OFE no esta asociado al código de autorización) | Modificar la carga útil para eliminar el conflicto.. |
| 415 | Tipo de medio no admitido | La solicitud no está en un formato compatible. | Verifique que su encabezado Content-Type sea compatible y que su solicitud cumpla con la documentación. |
| 422 | Entidad no procesable | La solicitud fue sintácticamente correcta pero falló debido a errores semánticos. | Asegúrese de que su solicitud incluya todos los campos obligatorios y que sus datos sean válidos. |
| 429 | Exceder el límite de envío | Se excede el numero de transacciones permitido (120 por minuto). | Verifique que se encuentra dentro de los límites acordados con Afacturar. |
| 500 | Error de servidor interno | Algo salió mal de nuestro lado. | Pruebe la solicitud nuevamente más tarde. Si el error no se resuelve, póngase en contacto con el soporte técnico soporte@afacturar.com. |
| 503 | Servicio no disponible | Estamos experimentando niveles de tráfico más altos de lo normal. | Prueba la solicitud nuevamente, ya estamos enterado del problema para aumentar la capacidad. |
Integración con DLL Afacturar
Que es?
Un archivo DLL es una biblioteca que contiene código y datos que pueden utilizarse por varios programas al mismo tiempo.
El archivo Afacturar.DLL procesa los datos enviados desde cualquier aplicativo que pueda invocar una dll, como Visual Basic 6.0, .NET, java, entre otros. El cual los transmite al proveedor tecnologico - TELEINTE S.A.S. para Factura electronica.
Este archivo funciona en ambiente Windows y necesitan el .Net Framework desde 4.5 para operar.
Como funciona?
Para realizar la integración del DLL se necesitan los siguientes programas:
Pasos para la integración con Componentes COM
Histórico de cambios
| Versión | Cambios | Fecha de liberación |
|---|---|---|
| 2.7 |
Nueva versión del archivo de descarga. Ir a descargar Afacturar.dll Adición el parametro cambio_de_moneda en el metodo factura_nacionalvp . Factura nacional => Se adicionaron nuevas variables en la cadena de datos de detalle_factura (nota_detalle, marca, modelo, cod_grupo_bien_servicio, nombre_grupo_bien_servicio, cod_segmento_bien_servicio, cod_bien_servicio), tambien se adiciono el cambio_de_moneda. Adición el parametro cambio_de_moneda en el metodo nota_creditovp . Nota credito => Se adicionaron nuevas variables en la cadena de datos de detalle_factura (nota_detalle, marca, modelo, cod_grupo_bien_servicio, nombre_grupo_bien_servicio, cod_segmento_bien_servicio, cod_bien_servicio), tambien se adiciono el cambio_de_moneda, retenciones_detalle y retenciones. Adición el parametro cambio_de_moneda en el metodo nota_debitovp . Nota debito => Se adicionaron nuevas variables en la cadena de datos de detalle_factura (nota_detalle, marca, modelo, cod_grupo_bien_servicio, nombre_grupo_bien_servicio, cod_segmento_bien_servicio, cod_bien_servicio), tambien se adiciono el cambio_de_moneda, retenciones_detalle y retenciones. |
26 de Junio de 2020 |
| 2.6 |
Nueva versión del archivo de descarga. Ir a descargar Afacturar.dll Adición de nota_detalle. marca, modelo, codificacion_estandar en los detalles de los diferentes documentos, factura_nacionalvp, factura_exportacionvp, nota_creditovp y nota_debitovp. Adición del metodo factura_contingencia. En la nota_creditovp y nota_debitovp se agrego las retenciones_detalle, retenciones y cambio_de_moneda. |
16 de Junio de 2020 |
| 2.5 | Adición de variables. Cambio de nombre de variables que sean legibles. | 27 de Agosto de 2019 |
| 2 | Ajustes de validación previa | 09 de Agosto de 2019 |
Descarga de archivos del DLL
| Versión | Archivo | Fecha de liberación |
|---|---|---|
| 2.7 | Afacturar_27.zip | 26 de Junio de 2020 |
| 2.6 | Afacturar_26.zip | 16 de Junio de 2020 |
| 2.5 | Afacturar_25.dll | 27 de Agosto de 2019 |
Datos comunes en la configuración de Afacturar.dll en los diferentes metodos
La cadena tiene la siguiente estructura:
variable_cadena = "variable_campo_1=valor_1 | variable_campo_2=valor_2"
- | -> Separa los campos
- ; -> Indica un arrray
- = -> Define los pares valores
- ! -> Indica que un mismo detalle tiene diferentes impuestos o retenciones, esto se aplica en impuesto_detalle y retenciones_detalle
Los nombre de las variables de campo no se pueden cambiar y deben seguir la estructura indicada
Configuración de Afacturar.dll para factura nacional
El dll tiene como parametro de entrada una cadena de datos con la siguiente estructura:
doc = "Identificación del Obligado"
encabezado = "id_factura=|fecha=|hora=|moneda=|tipo_factura=1|metodo_de_pago=|tipo_de_pago= |identificador_de_pago=|numero_resolucion_facturacion=|fecha_vencimiento=|numero_orden=|prefijo=|"
notas = "variable:valor°"
informacion_adquiriente = "tipo_contribuyente=|tipo_regimen=|tipo_identificacion=|identificacion=|correo_electronico= |numero_movil=|direccion=|departamento=|zona=|ciudad=|pais=|"
nombre = "razon_social=|primer_nombre=|segundo_nombre=|apellido=|"
resp_calidades_atributos = "Codigo de responsabilidades según documentación | "
usuario_aduanero = "Codigo de usuario aduanero según documentación | "
detalle_factura = "nota_detalle=|marca=|modelo=|cod_grupo_bien_servicio=|nombre_grupo_bien_servicio=|cod_segmento_bien_servicio=|cod_bien_servicio=|numero_linea=|cantidad=|unidad_de_cantidad=|valor_unitario=|descripcion=|regalo_es_regalo= |regalo_cod_precio_referencia=|regalo_precio_referencia=|cargo_descuento_es_descuento=|cargo_descuento_porcentaje_cargo_descuento= |cargo_descuento_valor_base_cargo_descuento=|cargo_descuento_valor_cargo_descuento=|impuestos_detalle_codigo_impuesto= |impuestos_detalle_porcentaje_impuesto=|impuestos_detalle_valor_base_impuesto=|impuestos_detalle_valor_impuesto= |valores_unitarios_valor_descuento=|valores_unitarios_valor_con_descuento=|valores_unitarios_valor_impuesto_1=|valores_unitarios_valor_impuesto_2= |valores_unitarios_valor_impuesto_3=|valores_unitarios_valor_impuesto_4=|valores_unitarios_valor_reteiva=|valores_unitarios_valor_retefuente= |valores_unitarios_valor_reteica=|valores_unitarios_valor_a_pagar=|valor_total_detalle_con_cargo_descuento=|valor_total_detalle=|;"
retenciones_detalle = "codigo=|porcentaje=|valor_base=|valor_retenido=!;"
impuestos = "codigo_impuesto=|porcentaje_impuesto=|valor_base_calculo_impuesto=|valor_total_impuesto=;"
retenciones = "codigo=|porcentaje=|valor_base=|valor_retenido=;"
recargos = "nombre_recargo=|porcentaje_recargo=|valor_base_calculo_recargo=|valor_total_recargo=;"
descuentos = "codigo_descuento=|porcentaje_descuento=|valor_base_calculo_descuento=|valor_total_descuento=;"
valor_factura = "valor_base=|valor_base_calculo_impuestos=|valor_base_mas_impuestos=|valor_anticipo=|valor_descuento_total=|valor_total_recargos= |valor_total_impuesto_1=|valor_total_impuesto_2=|valor_total_impuesto_3=|valor_total_impuesto_4=|valor_total_reteiva=|valor_total_retefuente= |valor_total_reteica=|total_factura=|valor_total_a_pagar=|;"
generalidades = "tipo_ambiente_dian=|version=|identificador_transmision=|rg_tipo=|rg_base_64=|rg_px_qr_x=|rg_px_qr_y=|rg_px_qr_size=|rg_px_cufe_x= |rg_px_cufe_y=|rg_px_cufe_size=|notificacion_correo_obligado=|notificacion_es_automatico=|con_copia=|asunto=|integrador_tipo=DLL |integrador_nombre=afacturar.dll|;
testsetid = "|;"
cambio_de_moneda = "codigo=|fecha_cambio=|valor_base_trm=|;"
Nota: En caso de no utilizar el cambio de moneda, enviar la palabra clave N/A.
Método
factura_nacionalvp(urlp, token, documento_obligado, encabezado, notas, informacion_adquiriente, nombre, detalle_factura, descuentos,retenciones, recargos, retenciones_detalle, impuestos, valor_factura, generalidades, resp_calidades_atributos, usuario_aduanero, testsetid,cambio_de_moneda)
Configuración de Afacturar.dll para nota credito
El dll tiene como parametro de entrada una cadena de datos con la siguiente estructura:
encabezado = "id_nota_credito=|fecha=|hora=|moneda=|tipo_nota_credito=|"
informacion_factura = "id_factura=|codigo_unico_factura=|fecha=|hora=|"
informacion_adquiriente = "tipo_contribuyente=|tipo_regimen=|tipo_identificacion=|identificacion=|correo_electronico=|numero_movil=|departamento=|zona=|ciudad=|direccion=|pais=|"
nombre = "razon_social=|primer_nombre=|segundo_nombre=|apellido=|"
resp_calidades_atributos = "|"
usuario_aduanero = "O-07|"
notas = "variable:valor|"
detalle_factura = "nota_detalle=|marca=|modelo=|cod_grupo_bien_servicio=|nombre_grupo_bien_servicio=|cod_segmento_bien_servicio=|cod_bien_servicio=numero_linea=|cantidad=|unidad_de_cantidad=|valor_unitario=|descripcion=|valor_total_detalle_con_cargo_descuento=|valor_total_detalle=|cargo_es_descuento=|cargo_porcentaje_cargo_descuento=|cargo_valor_base_cargo_descuento=|cargo_valor_cargo_descuento=|valores_unitarios_valor_impuesto_1=|valores_unitarios_valor_impuesto_2=|valores_unitarios_valor_impuesto_3=|valores_unitarios_valor_impuesto_4=|valor_a_pagar=|;"
impuestos_detalle = "codigo_impuesto=|porcentaje_impuesto=|valor_base_impuesto=|valor_impuesto=|;"
impuestos = "codigo_impuesto=|porcentaje_impuesto=|valor_base_calculo_impuesto=|valor_total_impuesto=|;"
recargos = "nombre_recargo=|porcentaje_recargo=|valor_base_calculo_recargo=|valor_total_recargo=|;"
descuentos="codigo_descuento=|porcentaje_descuento=|valor_base_calculo_descuento=|valor_total_descuento=|;"
generalidades = "integrador_nombre=|integrador_tipo=|tipo_ambiente_dian=|version=|identificador_transmision=|rg_tipo=|rg_base_64=|rg_px_qr_x=|rg_px_qr_y=|rg_px_qr_size=|rg_px_cufe_x=|rg_px_cufe_y=|rg_px_cufe_size=|notificacion_es_automatico=|notificacion_correo_obligado=|asunto=|con_copia=|"
valor_nota_credito = "valor_base=|valor_base_calculo_impuestos=|valor_base_mas_impuestos=|valor_descuento_total=|valor_total_recargos=|valor_total_impuesto_1=|valor_total_impuesto_2=|valor_total_impuesto_3=|valor_total_impuesto_4=|total_nota_credito=|"
testsetid = "|;"
retenciones_detalle = "codigo=|porcentaje=|valor_base=|valor_retenido=!;"
retenciones = "codigo=|porcentaje=|valor_base=|valor_retenido=;"
cambio_de_moneda = "codigo=|fecha_cambio=|valor_base_trm=|;"
Nota: En caso de no utilizar el cambio de moneda, enviar la palabra clave N/A.
Método
nota_creditovp(urlp,token,documento_obligado,encabezado,notas,informacion_adquiriente,nombre,detalle_factura,impuestos_detalle,impuestos,valor_nota_credito,generalidades,informacion_factura,resp_calidades_atributos,usuario_aduanero,recargos,descuentos, testsetid,retenciones,retenciones_detalle,cambio_de_moneda)
Configuración de Afacturar.dll para nota debito
El dll tiene como parametro de entrada una cadena de datos con la siguiente estructura:
encabezado = "id_nota_debito=|fecha=|hora=|moneda=|tipo_nota_debito=|metodo_de_pago=|tipo_de_pago=|identificador_de_pago=|"
informacion_factura = "id_factura=|codigo_unico_factura=|fecha=|hora=|"
informacion_adquiriente = "tipo_contribuyente=|tipo_regimen=|tipo_identificacion=|identificacion=|correo_electronico=|numero_movil=|departamento=|zona=|ciudad=|direccion=|pais=|"
nombre = "razon_social=|primer_nombre=|segundo_nombre=|apellido=|"
resp_calidades_atributos = "|"
usuario_aduanero = "O-07|"
notas = "variable:valor|"
detalle_factura = ""nota_detalle=|marca=|modelo=|cod_grupo_bien_servicio=|nombre_grupo_bien_servicio=|cod_segmento_bien_servicio=|cod_bien_servicio=valor_total_detalle_con_cargo_descuento=|valores_unitarios_valor_a_pagar=|valores_unitarios_valor_reteica=|valores_unitarios_valor_retefuente=|valores_unitarios_valor_reteiva=|valores_unitarios_valor_impuesto_4=|valores_unitarios_valor_impuesto_3=|valores_unitarios_valor_impuesto_2=|valores_unitarios_valor_impuesto_1=|valores_unitarios_valor_con_descuento=|valores_unitarios_valor_descuento=|impuestos_detalle_valor_impuesto=|impuestos_detalle_valor_base_impuesto=|impuestos_detalle_porcentaje_impuesto=|impuestos_detalle_codigo_impuesto=|cargo_descuento_valor_cargo_descuento=|cargo_descuento_valor_base_cargo_descuento=|cargo_descuento_porcentaje_cargo_descuento=|cargo_descuento_es_descuento=|numero_linea=|cantidad=|unidad_de_cantidad=|valor_unitario=|descripcion=|valor_total_detalle=|;"
impuestos = "codigo_impuesto=|porcentaje_impuesto=|valor_base_calculo_impuesto=|valor_total_impuesto=|;"
recargos = "nombre_recargo=|porcentaje_recargo=|valor_base_calculo_recargo=|valor_total_recargo=|;"
descuentos="codigo_descuento=|porcentaje_descuento=|valor_base_calculo_descuento=|valor_total_descuento=|;"
generalidades = "integrador_nombre=|integrador_tipo=|tipo_ambiente_dian=|version=|identificador_transmision=|rg_tipo=|rg_base_64=|rg_px_qr_x=|rg_px_qr_y=|rg_px_qr_size=|rg_px_cufe_x=|rg_px_cufe_y=|rg_px_cufe_size=|notificacion_es_automatico=|notificacion_correo_obligado=|asunto=|con_copia=|"
valor_nota_debito = "valor_base=|valor_base_calculo_impuestos=|valor_base_mas_impuestos=|valor_anticipo=|valor_descuento_total=|valor_total_recargos=|valor_total_impuesto_1=|valor_total_impuesto_2=|valor_total_impuesto_3=|valor_total_impuesto_4=|total_nota_debito=|valor_total_a_pagar=|"
retenciones_detalle = "codigo=|porcentaje=|valor_base=|valor_retenido=!;"
retenciones = "codigo=|porcentaje=|valor_base=|valor_retenido=;"
cambio_de_moneda = "codigo=|fecha_cambio=|valor_base_trm=|;"
Nota: En caso de no utilizar el cambio de moneda, enviar la palabra clave N/A.
Método
nota_debitovp(urlp, token, documento_obligado, encabezado, notas, informacion_adquiriente, nombre,detalle_factura, descuentos, recargos, impuestos, valor_nota_debito, generalidades, informacion_factura, resp_calidades_atributos, usuario_aduanero,retenciones, retenciones_detalle,cambio_de_moneda)
Configuración de Afacturar.dll para factura mandato
El dll tiene como parametro de entrada una cadena de datos con la siguiente estructura:
encabezado = "id_factura=|fecha=|hora=|moneda=|tipo_factura=|metodo_de_pago=|tipo_de_pago=|identificador_de_pago=|numero_resolucion_facturacion=|fecha_vencimiento=|numero_orden=|prefijo=|"
notas = "variable:valor|"
informacion_mandante = "tipo_contribuyente=|tipo_regimen=|tipo_identificacion=|identificacion=|correo_electronico=|numero_movil=|nombre_razon_social=|nombre_primer_nombre=|nombre_segundo_nombre=|nombre_apellido=|departamento=|zona=|ciudad=|direccion=|pais=|rut_resp=|rut_adua=|;"
contratos = "numero=|fecha=|tipo=|!;"
informacion_adquiriente = "tipo_contribuyente=|tipo_regimen=|tipo_identificacion=|identificacion=|correo_electronico=|numero_movil=|departamento=|zona=|ciudad=|direccion=|pais=|razon_social=|primer_nombre=|segundo_nombre=|apellido=|"
usuario_aduanero = "|"
resp_calidades_atributos = "O-07|"
detalle_factura = "datos_mandante_numero_contrato=|datos_mandante_tipo_identificacion_mandante=|datos_mandante_nombre_mandante=|valor_total_detalle_con_cargo_descuento=|valores_unitarios_valor_a_pagar=|valores_unitarios_valor_reteica=|valores_unitarios_valor_retefuente=|valores_unitarios_valor_reteiva=|valores_unitarios_valor_impuesto_4=|valores_unitarios_valor_impuesto_3=|valores_unitarios_valor_impuesto_2=|valores_unitarios_valor_impuesto_1=|valores_unitarios_valor_con_descuento=|valores_unitarios_valor_descuento=|impuestos_detalle_valor_impuesto=|impuestos_detalle_valor_base_impuesto=|impuestos_detalle_porcentaje_impuesto=|impuestos_detalle_codigo_impuesto=|cargo_descuento_valor_cargo_descuento=|cargo_descuento_valor_base_cargo_descuento=|cargo_descuento_porcentaje_cargo_descuento=|cargo_descuento_es_descuento=|regalo_precio_referencia=|regalo_cod_precio_referencia=|regalo_es_regalo=|numero_linea=|cantidad=|unidad_de_cantidad=|valor_unitario=|descripcion=|valor_total_detalle=|;"
retenciones_detalles = "codigo=|porcentaje=|valor_base=|valor_retenido=|!;"
impuestos = "codigo_impuesto=|porcentaje_impuesto=|valor_base_calculo_impuesto=|valor_total_impuesto=|;"
retenciones = "codigo=|porcentaje=|valor_base=|valor_retenido=|;"
recargos = "nombre_recargo=|porcentaje_recargo=|valor_base_calculo_recargo=|valor_total_recargo=|;"
descuentos = "codigo_descuento=|porcentaje_descuento=|valor_base_calculo_descuento=|valor_total_descuento=|;"
valor_factura = "valor_total_a_pagar=|valor_total_reteica=|valor_total_retefuente=|valor_total_reteiva=|valor_base_mas_impuestos=|valor_base= |valor_base_calculo_impuestos=|valor_anticipo=|valor_descuento_total=|valor_total_recargos=|valor_total_impuesto_1= |valor_total_impuesto_2=|valor_total_impuesto_3=|valor_total_impuesto_4=|total_factura=|"
generalidades = "tipo_ambiente_dian=|version=|identificador_transmision=|rg_tipo=|rg_base_64=|rg_px_qr_x=|rg_px_qr_y=|rg_px_qr_size=|rg_px_cufe_x=|rg_px_cufe_y=|rg_px_cufe_size=|notificacion_es_automatico=|notificacion_correo_obligado=|asunto=|con_copia=|integrador_nombre=|integrador_tipo=|"
Método
factura_mandatovp(urlp,token,documento_obligado,encabezado,notas,informacion_adquiriente,detalle_factura,descuentos,retenciones,recargos,retenciones_detalle,impuestos_detalle,impuestos,Valor_factura,generalidades,resp_calidades_atributos,usuario_aduanero,informacion_mandante,contratos)
Ejemplo
doc = "XXXXXXXXXX"
encabezado = "id_factura=990000470|fecha=2019-07-23|hora=05:36:10|moneda=COP|tipo_factura=1|metodo_de_pago=1|tipo_de_pago=10
|identificador_de_pago=|numero_resolucion_facturacion=18760000001|fecha_vencimiento=|numero_orden=|prefijo=SETP|"
informacion_adquiriente = "tipo_contribuyente=1|tipo_regimen=2|tipo_identificacion=31|identificacion=9999999|correo_electronico=info@teleinte.com
|numero_movil=|departamento=11|zona=11001|ciudad=11001|direccion=Cra 10|pais=CO|";
nombre = "razon_social=PIXELPRO S.A.S.|primer_nombre=|segundo_nombre=|apellido="
resp_calidades_atributos = "O-07|o-08|"
usuario_aduanero = "|"
detalle_factura = "numero_linea=1|cantidad=1|unidad_de_cantidad=94|valor_unitario=600000.00
|descripcion=Prueba de detalle|regalo_es_regalo=false|regalo_cod_precio_referencia=0|regalo_precio_referencia=0.00|cargo_descuento_es_descuento=false
|cargo_descuento_porcentaje_cargo_descuento=0.00|cargo_descuento_valor_base_cargo_descuento=0.00|cargo_descuento_valor_cargo_descuento=0.00
|impuestos_detalle_codigo_impuesto=1|impuestos_detalle_porcentaje_impuesto=19.00|impuestos_detalle_valor_base_impuesto=600000.00
|impuestos_detalle_valor_impuesto=114000.00|valores_unitarios_valor_descuento=0.00|valores_unitarios_valor_con_descuento=0.00
|valores_unitarios_valor_impuesto_1=0.00|valores_unitarios_valor_impuesto_2=0.00|valores_unitarios_valor_impuesto_3=0.00
|valores_unitarios_valor_impuesto_4=0.00|valores_unitarios_valor_reteiva=0.00|valores_unitarios_valor_retefuente=0.00|valores_unitarios_valor_reteica=0.00
|valores_unitarios_valor_a_pagar=0.00|valor_total_detalle_con_cargo_descuento=600000.00|valor_total_detalle=600000.00|;"
retenciones_detalle = "codigo=0|porcentaje=0.00|valor_base=0.00|valor_retenido=0.00!;"
impuestos = "codigo_impuesto=1|porcentaje_impuesto=19.00|valor_base_calculo_impuesto=600000.00|valor_total_impuesto=114000.00;"
retenciones = "codigo=0|porcentaje=0.00|valor_base=0.00|valor_retenido=0.00;"
recargos = "nombre_recargo=|porcentaje_recargo=0.00|valor_base_calculo_recargo=0.00|valor_total_recargo=0.00;"
descuentos = "codigo_descuento=0|porcentaje_descuento=0.00|valor_base_calculo_descuento=0.00|valor_total_descuento=0.00;"
valor_factura = "valor_base=600000.00|valor_base_calculo_impuestos=600000.00|valor_base_mas_impuestos=714000.00|valor_anticipo=0.00
|valor_descuento_total=0.00|valor_total_recargos=0.00|valor_total_impuesto_1=114000.00|valor_total_impuesto_2=0.00
|valor_total_impuesto_3=0.00|valor_total_impuesto_4=0.00|valor_total_reteiva=0.00|valor_total_retefuente=0.00|valor_total_reteica=0.00
|total_factura=714000.00|valor_total_a_pagar=714000.00|"
generalidades = "tipo_ambiente_dian=2|version=2|identificador_transmision=22_20181102155632|rg_tipo=PDF
|rg_base_64=C:\\xxxxx\\FE1.pdf|rg_px_qr_x=180|rg_px_qr_y=240|rg_px_qr_size=20|rg_px_cufe_x=125|rg_px_cufe_y=235|rg_px_cufe_size=10
|notificacion_correo_obligado=adonofrio@sistemaspentagonosas.com|notificacion_es_automatico=S|con_copia=adonofrio@sistemaspentagonosas.com|asunto=demostracion comparativo|integrador_tipo=DLL|integrador_nombre=afacturar.dll|"
Factura de mandato
Especificación detallada para recibir información de factura para ser procesadas en la plataforma
Histórico de cambios
| Versión | Cambios | Fecha de liberación |
|---|---|---|
| 2.4 | En la variable detalle_factura se adiciono las variables marca, modelo y codificacion_estandar. Estas variables se utilizan para tener mas información de los productos y/o servicios, permitiendo a los clientes codificar productos y servicios de forma clara, basandose en estándares acordados por la industria los cuales facilitan el comercio entre empresas y gobierno | 08 de junio de 2020 |
| 2.4 | En la variable detalle_factura se adiciono las variables marca, modelo y codificacion_estandar. Estas variables se utilizan para tener mas información de los productos y/o servicios, permitiendo a los clientes codificar productos y servicios de forma clara, basandose en estándares acordados por la industria los cuales facilitan el comercio entre empresas y gobierno | 08 de junio de 2020 |
| 2.3 | En la variable informacion_adquiriente -> correo_electronico permitir varias direcciones de correo. Se debe tener en cuenta que la primera dirección de correo es la utilizada para el envio de la notificación al adquiriente. | 08 de mayo de 2020 |
| 2.2 | Los PDFs que se reciben en base64 se adiciono en generalidades -> rg_px_cufe y rg_px_qr, la opción de mostrar_en, para indicar si el QR y el CUFE/CUDE debe pintarse en la primera pagina o en todas. | 05 de Marzo de 2020 |
| 2.1 |
Se agregó el nombre del país, departamento y ciudad para mostrar en la representación gráfica.
El tipo de pago ZZZ se cambio por -999 para validar datos tipo numérico como dato de entrada. |
16 de Octubre de 2019 |
| 2 | Ajustes de validación previa | 27 de Agosto de 2019 |
POST
/factura_mandato
documento_obligado:
000000000
data:
{
"facturas": [{
"encabezado": {
"id_factura": "",
"fecha": "",
"hora": "",
"nota": ["{'':'','':'','':'','':'','':'','':''}"],
"moneda": "",
"tipo_factura": #,
"metodo_de_pago": ##,
"tipo_de_pago": ##,
"identificador_de_pago": "",
"numero_resolucion_facturacion": "",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": ""
},
"periodo_facturacion":{
"fecha_inicio":"",
"fecha_fin":"",
},
"cambio_de_moneda":{
"fecha_cambio":"",
"codigo":"",
"valor_base_trm":"0.00"
},
"informacion_mandantes":[{
"tipo_contribuyente":"",
"tipo_regimen":"",
"tipo_identificacion":"",
"identificacion":"",
"correo_electronico":"",
"numero_movil":"",
"nombre":{
"razon_social":"",
"primer_nombre":"",
"segundo_nombre":"",
"apellido":""
},
"pais":"",
"departamento":"",
"ciudad":"",
"zona":"",
"direccion":"",
"RUT":{
"resp_calidades_atributos":["",""],
"usuario_aduanero":[""]
},
"contratos":[{
"numero":"",
"fecha":"",
"tipo":""
}],
}],
"informacion_adquiriente": {
"tipo_contribuyente": #,
"tipo_regimen": #,
"tipo_identificacion":#,
"identificacion": ""
"correo_electronico": "",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "",
"nombre_pais": "",
"departamento": "",
"nombre_departamento": "",
"zona": "",
"ciudad": "",
"nombre_ciudad": "",
"direccion": "",
"RUT": {
"resp_calidades_atributos": ["",""],
"usuario_aduanero": [""]
}
},
"detalle_factura": [{
"numero_linea": #,
"cantidad": #,
"unidad_de_cantidad":"" ,
"valor_unitario": "0.00",
"descripcion": "",
"marca": "",
"modelo": "",
"codificacion_estandar": {
"cod_grupo_bien_servicio": "",
"nombre_grupo_bien_servicio": "",
"cod_segmento_bien_servicio": "",
"cod_bien_servicio": ""
},
"regalo": {
"es_regalo": "",
"cod_precio_referencia": #,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": "",
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": #,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"datos_mandante":{
"numero_contrato":"",
"tipo_identificacion_mandante":"",
"identificacion_mandante":"",
"nombre_mandante":""
},
"retenciones_detalle": [{
"codigo": #,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}],
"valores_unitarios":{
"valor_descuento":"0.00",
"valor_con_descuento":"0.00",
"valor_impuesto_1":"0.00",
"valor_impuesto_2":"0.00",
"valor_impuesto_3":"0.00",
"valor_impuesto_4":"0.00",
"valor_reteiva":"0.00",
"valor_retefuente":"0.00",
"valor_reteica":"0.00",
"valor_a_pagar":"0.00"
},
"valor_total_detalle_con_cargo_descuento": "0.00",
"valor_total_detalle": "0.00"
}],
"impuestos": [{
"codigo_impuesto": #,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "0.00",
"valor_total_impuesto": "0.00"
}],
"retenciones":[{
"codigo": #,
"porcentaje":"0.00",
"valor_base":"0.00",
"valor_retenido":"0.00"
}],
"recargos": [{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}],
"descuentos": [{
"codigo_descuento": #,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}],
"valor_factura": {
"valor_base": "0.00",
"valor_base_calculo_impuestos": "0.00",
"valor_base_mas_impuestos": "0.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "0.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "0.00",
"valor_total_a_pagar": "0.00"
}
}],
"generalidades": {
"tipo_ambiente_dian": #,
"version": #,
"identificador_transmision": "",
"rg_tipo":"",
"rg_base_64":"",
"rg_px_qr": {
"x":"",
"y":"",
"size":"",
"mostrar_en":""
},
"rg_px_cufe": {
"x":"",
"y":"",
"size":"",
"mostrar_en":""
},
"integrador": {
"nombre":"",
"tipo":"",
"webhook": ""
}
}
}
encabezado
id_factura
Descripción:
Número de documento: Número de factura o factura cambiaria. Consecutivo de factura autorizados por la DIAN
Tipo de dato:
String
Especificaciones:
No se permiten caracteres adicionales como espacios o guiones.
Obligatorio:
Si
fecha
Descripción:
Fecha de emisión de la factura a efectos fiscales.
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Si
hora
Descripción:
Hora de emisión de la factura
Tipo de dato:
Time
Especificaciones:
HH24:MM:SS
Obligatorio:
Si
nota
Descripción:
Las notas se van a distribuir en un formato similar a JSON, en el cual se cambia la comilla doble por sencilla, tanto en el nombre de la variable, como en su valor, esto debido a la restricción de algunos caracteres especiales que no son soportados en este campo.
Este JSON termina siendo un STRING que se debe enviar dividido en las posiciones del array de nota, de acuerdo con las restricciones que defina la DIAN:
A la fecha (2019-01-11) existe una restricción de enviar como mínimo 15 caracteres(*)
La estructura a utilizar es:
{'variable_1': 'valor_1', 'variable_2':'valor_2'}Ejemplos:
Enviar valores nulos o vacíos
nota[0] = "{‘variable_1': 'null', 'variable_2':'valor_2', 'variable_3':''}"
División del STRING en varias posiciones del array
nota[0] = "{‘variable_1': 'null', 'variab"
nota[1] = "le_2':'valor_2', 'variable_3':''}"
El API genera la concatenación del STRING y lo convierte a formato JSON y realiza la respectiva validación.
Hay que tener en cuenta que los caracteres (comilla sencilla, backslash, backslash comilla sencilla ) no se deben enviar, porque no son soportados en el API.
Si alguna variable es diferente a las del listado de especificaciones, se debe consultar con el personal de operación de Teleinte S.A.S, para realizar la respectiva validación, y en caso que no exista una variable, se estudiará el caso para determinar la adición o no de la variable que cumpla con la descripción requerida.
(*) Estas restricciones pueden cambiar en cualquier momento por parte de la DIAN, de acuerdo al nuevo proceso que estandarización y validación que están estableciendo.
Tipo de dato:
Array
Especificaciones:
El listado de la estandarización de las variables se puede ver aqui
Obligatorio:
Si
moneda
Descripción:
Divisa aplicable a toda la factura
Tipo de dato:
Parametrizado
Especificaciones:
COP- Colombia, USD - dolares. Inf adicional Ver
Obligatorio:
Si
tipo_factura
Descripción:
Tipo de Factura
Tipo de dato:
Parametrizado
Especificaciones:
11= Mandatos
Obligatorio:
Si
metodo_de_pago
Descripción:
Método de pago
Tipo de dato:
Parametrizado
Especificaciones:
1 = Contado
2 = Crédito
Obligatorio:
Si
tipo_de_pago
Descripción:
Código correspondiente al medio de pago
Tipo de dato:
Parametrizado
Obligatorio:
Si
identificador_de_pago
Descripción:
Identificador de pago o número de referencia de pago
Tipo de dato:
String
Especificaciones:
Obligatorio:
No
numero_resolucion_facturacion
Descripción:
Número del código de la resolución otorgada para la numeración. Debe corresponder a un número de autorización del contribuyente emisor
Tipo de dato:
String
Especificaciones:
18 caracteres
Obligatorio:
Si
fecha_vencimiento
Descripción:
Fecha de vencimiento. Obligatorio si el método de pago es crédito
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
No
numero_orden
Descripción:
Número de orden
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
prefijo
Descripción:
Prefijo de la resolución registrado para la numeración.
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si
informacion_adquiriente
tipo_contribuyente
Descripción:
Tipo de identificación Tributaria o similar de la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
1= Persona juridica
2= Persona natural
Obligatorio:
Si
tipo_regimen
Descripción:
Régimen al que pertenece la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
0= Simplificado
2= Común
Obligatorio:
Si
tipo_identificacion
Descripción:
Tipo de documento de identificación de la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
11= Registro civil
12= Tarjeta de identidad
13= Cedula ciudadania
21= Tarjeta de extranjería
22= Cedula de extranjería
31= NIT
41= Pasaporte
42= Documento de identificación extranjero
Obligatorio:
Si
identificacion
Descripción:
Número completo de la identificación de la empresa o persona
Tipo de dato:
String
Especificaciones:
Alfanumérico
Obligatorio:
Si
correo_electronico
Descripción:
Dirección de correo electronico del contacto, uilizado para el envio de notificaciones
Tipo de dato:
Especificaciones:
xxxx@xx.xx
Obligatorio:
Si
numero_movil
Descripción:
Número de móvil para el envio de notificaciones
Tipo de dato:
String
Especificaciones:
3111111111
Obligatorio:
No
nombre
Descripción:
Nombre comercial del emisor
Tipo de dato:
array
Especificaciones:
Depende del tipo de contribuyente.
Persona juridica {razon_social}.
Persona natural {primer_nombre, segundo_nombre, apellidos}
Obligatorio:
Si
razon_social
Descripción:
Nombre comercial
Tipo de dato:
Alfanumérico
Especificaciones:
Opcional dependiendo el tipo de contribuyente. Si es NIT es obligatorio
Obligatorio:
Si es persona juridica
primer_nombre
Descripción:
Primer nombre
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si es persona natural
segundo_nombre
Descripción:
Segundo nombre
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
apellido
Descripción:
Apellidos
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si es persona natural
pais
Descripción:
Código dentificador del país. Código alfa-2 asignado al pais
Tipo de dato:
Parametrizado
Especificaciones:
Estandar ISO 3166-1. Inf adicional Ver
Obligatorio:
Si
departamento
Descripción:
Codigo del departamento, son las subdivisiones administrativas del país (CO). Fue publicada en 1998 y actualizada por última vez en el sexto boletín de la primera edición en 2004.
Si no corresponde a Colombia debe ir el nombre de la ciudad o estado
Tipo de dato:
Parametrizado
Especificaciones:
ISO 3166-2:CO. Inf adicional Ver
Obligatorio:
Si
ciudad
Descripción:
Código del municipio ó ciudad ó subdivisión de tercer nivel.
Tipo de dato:
Parametrizado
Especificaciones:
Inf adicional Ver
Obligatorio:
Si
zona
Descripción:
Nombre de la subdivisión de la ciudad
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
direccion
Descripción:
Elemento de texto libre, que el emisor puede elegir utilizar para poner toda la información de la dirección
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 10 caracteres
Obligatorio:
Si
RUT
Descripción:
Información del RUT - Registro Unico Tributario. Responsabilidades, Calidades y Atributos, numeral 53 y Usuarios aduaneros, numeral 54.
Tipo de dato:
array
Especificaciones:
Parametrizable
Obligatorio:
Si
resp_calidades_atributos
Descripción:
Lista de codigos de las responsabilidades, calidades y atributos registrados en el RUT, numeral 53
Tipo de dato:
Array
Especificaciones:
Parametrizado.Inf adicional Ver
Obligatorio:
Si
usuario_aduanero
Descripción:
Lista de codigos usuarios aduaneros registrados en el RUT, numeral 54
Tipo de dato:
Array
Especificaciones:
Parametrizado.Inf adicional Ver
Obligatorio:
No
detalle_factura
numero_linea
Descripción:
Número de Línea
Tipo de dato:
Numerico
Especificaciones:
1...n
Obligatorio:
Si
cantidad
Descripción:
(Cant) Cantidad de productos o servicios solicitados. Número de unidades servidas/prestadas.
Tipo de dato:
Numerico
Especificaciones:
...n
Obligatorio:
Si
unidad_de_cantidad
Descripción:
Unidad de la cantidad del artículo solicitiado
Tipo de dato:
Parametrizado
Obligatorio:
Si
valor_unitario
Descripción:
(VU) Es el precio por unidad de cada bien o servicio antes de aplicar los impuestos o descuento. El valor base es el precio de un activo fijo a efectos impositivos. El valor base es el precio base de un activo sobre el cual se calcula la depreciación y la amortización
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
descripcion
Descripción:
Descripción del artículo o servicio a que se refiere esta línea de la factura
Tipo de dato:
Alfanumérico
Especificaciones:
Mínimo de 2 caracteres
Obligatorio:
Si
nota_detalle
Descripción:
Información adicional: Texto libre, relativo al documento. Para el caso de facturas por contratos de servicio tipo AIU, se debe enviar incluir el objeto del contrato facturado
Tipo de dato:
Alfanumérico
Especificaciones:
Mínimo de 2 caracteres
Obligatorio:
Si
marca
Descripción:
Marca: Marca del artículo
Tipo de dato:
String
Especificaciones:
Obligatorio:
Si
modelo
Descripción:
Modelo: Modelo del artículo
Tipo de dato:
String
Especificaciones:
Obligatorio:
Si
codificacion_estandar
Descripción:
Identificación del producto o servicio de acuerdo con un estandar acordado por la industria, los cuales facilitan el comercio entre empresas y gobierno.
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
cod_grupo_bien_servicio
Descripción:
Tipo de estandar de codificación utilizado para la clasificación de los productos o servicios.
UNSPSC - United Nations Standard Products and Services Code® - Código Estándar de Productos y Servicios de Naciones Unidas. Ver documentación
GTIN - Números Globales de Identificación de Productos.Estructura de los códigos GTIN:
999 - Códigos libres o autónomosCorresponden a la codificación que las empresas cuentan en sus sistemas para la identificación inequívoca de los bienes o servicios que prestan.
Tipo de dato:
Parametrizado
Especificaciones:
1 -> UNSPSC
10 -> GTIN
20 -> Partida Arancelarias
999 -> Estándar de adopción del contribuyente
Obligatorio:
Si
nombre_grupo_bien_servicio
Descripción:
Nombre de la codificación utilizada para la clasificación de los productos o servicios
Tipo de dato:
Parametrizado
Especificaciones:
UNSPSC -> 1
GTIN -> 10
Partida Arancelarias -> 20
Estándar de adopción del contribuyente -> 999
Obligatorio:
Si
cod_segmento_bien_servicio
Descripción:
Codigo del segmento.
Tipo de dato:
String
Especificaciones:
Dependen del grupo del bien o servicio. Información adicional Ver
Obligatorio:
Si
cod_bien_servicio
Descripción:
Codigo del bien o servicio
Tipo de dato:
String
Especificaciones:
Dependen del segmento del bien o servicio. Información adicional Ver
Obligatorio:
Si
regalo
Descripción:
Indicador de si el ítem es gratuito o no
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
es_regalo
Descripción:
Describe si el articulo es un regalo o muestra comercial
Tipo de dato:
Boolean
Especificaciones:
true o false
Obligatorio:
Si
cod_precio_referencia
Descripción:
Código del tipo de precio informado
Tipo de dato:
Parametrizado
Especificaciones:
1 = Valor comercial
2 = Valor en inventarios
3 = Otro valor
0 = En el caso que no sea regalo
Obligatorio:
Si
precio_referencia
Descripción:
Precio de referencia para línea que no contienen valor comercial.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
cargo_descuento
Descripción:
Información relacionada con un cargo o un descuento
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
es_descuento
Descripción:
Indica que el elemento es un Cargo y no un descuento
Descuento es true cuando es un descuento, un Crédito descuenta el valor del ítem
Cargo es false cuando es un recargo, es un Débito aumenta el valor del item.
Tipo de dato:
Boolean
Especificaciones:
True o false
Obligatorio:
Si
porcentaje_cargo_descuento
Descripción:
Porcentaje de descuento o cargo a la linea de la factura
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_cargo_descuento
Descripción:
Valor Base para calcular el descuento o el cargo
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_cargo_descuento
Descripción:
Valor del descuento o el cargo
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
impuestos_detalle
Descripción:
Información relacionada con el impuesto aplicado a la linea de detalle
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
codigo_impuesto
Descripción:
Identificador del tributo
Tipo de dato:
Parametrizado
Especificaciones:
1= IVA
2= Impuesto al consumo
3= ICA
4= Impuesto nacional al consumo
0= Excluido de IVA
Obligatorio:
Si
porcentaje_impuesto
Descripción:
Tarifa del tributo. Porcentaje del valor tributable a ser aplicada a la base imponible de la linea de detalle. Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base_impuesto
Descripción:
(VU-VD)*Cant). Base Imponible sobre la que se calcula el valor del tributo. Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_impuesto
Descripción:
(((VU-VD)*Cant) * %Imp). Valor del tributo: producto del porcentaje aplicado sobre la base imponible. Si el item es excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
datos_mandante
Descripción:
Información del mandante
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
numero_contrato
Descripción:
Información del identificador del contrato
Tipo de dato:
String
Especificaciones:
Mínimo 2 caracteres
Obligatorio:
Si
tipo_identificacion_mandante
Descripción:
Tipo de identificación Tributaria o similar del mandante
Tipo de dato:
Parametrizado
Especificaciones:
11= Registro civil
12= Tarjeta de identidad
13= Cedula ciudadania
21= Tarjeta de extranjería
22= Cedula de extranjería
31= NIT
41= Pasaporte
42= Documento de identificación extranjero
Obligatorio:
Si
identificacion_mandante
Descripción:
Identificación del mandante
Tipo de dato:
String
Especificaciones:
Mínimo 2 caracteres
Obligatorio:
Si
nombre_mandante
Descripción:
Nombre del mandante
Tipo de dato:
String
Especificaciones:
Mínimo 2 caracteres
Obligatorio:
Si
retenciones_detalle
Descripción:
Información relacionada con los tributos retenidos en la linea de detalle
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
codigo
Descripción:
Identificador de las retenciónes
Tipo de dato:
Parametrizado
Especificaciones:
5= ReteIVA
6= ReteFuente
7= ReteICA
0= No tiene retenciónes
Obligatorio:
Si
porcentaje
Descripción:
Tarifa del tributo retenido. Porcentaje del valor tributable retenido a ser aplicada a la base imponible de la linea de detalle.
Tipo de dato:
Parametrizado ReteFuente - ReteIVA
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base
Descripción:
La base gravable es el valor sobre el cual se aplica la tarifa de la retención
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_retenido
Descripción:
Valor del tributo: producto del porcentaje aplicado sobre la base imponible
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valores_unitarios
Descripción:
Información relacionada con el valor por producto de la linea de detalle, los datos recibidos son utilizados para la representación grafica cuando sea necesario
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
valor_descuento
Descripción:
Valor del descuento aplicado a un producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_con_descuento
Descripción:
Valor del producto aplicando el descuento de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_1
Descripción:
Valor de la base imponible (IVA) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_2
Descripción:
Valor de la base imponible (Impuesto al consumo) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_3
Descripción:
Valor de la base imponible (ICA) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_impuesto_4
Descripción:
Valor de la base imponible (Impuesto nacional al consumo) del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_reteiva
Descripción:
Valor retenido de Reteiva del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_retefuente
Descripción:
Valor retenido de Retefuente del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_reteica
Descripción:
Valor retenido de Reteica del producto de la linea de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_a_pagar
Descripción:
Valor total del producto de la linea de detalle, incluyendo descuentos, retenciónes e impuestos
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_total_detalle_con_cargo_descuento
Descripción:
(((VU * Cant)- VD)+VR). Valor total de la linea de detalle incluyendo el descuento y el recargo si aplica
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_detalle
Descripción:
(VU*Cant). Valor total de la linea de detalle sin incluir descuentos, retenciónes o impuestos.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
impuestos
codigo_impuesto
Descripción:
Es la clase que se utiliza para describir el esquema del impuesto
Tipo de dato:
Parametrizado
Especificaciones:
01= IVA
02= Impuesto al consumo
03= ICA
04= Impuesto nacional al consumo
0= Excluido de IVA
Obligatorio:
Si
porcentaje_impuesto
Descripción:
Número de importe del impuesto retenido. Si hay algun item excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
Si
valor_base_calculo_impuesto
Descripción:
Base Imponible sobre la que se calcula la retención de impuesto. Si hay algun item excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto
Descripción:
Importe del impuesto retenido. Si hay algun item excluido de IVA debe ir en 0.00.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
retenciones
codigo
Descripción:
Identificador de las retenciónes
Tipo de dato:
Parametrizado
Especificaciones:
5= ReteIVA
6= ReteFuente
7= ReteICA
0= No tiene retenciónes
Obligatorio:
No
porcentaje
Descripción:
Importe del impuesto retenido al total de la factura
Tipo de dato:
Parametrizado ReteFuente - ReteIVA
String patron decimal
Especificaciones:
Separador con punto, dos decimales. Información adicional Ver
Obligatorio:
No
valor_base
Descripción:
La base gravable es el valor sobre el cual se aplica la tarifa de la retención
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_retenido
Descripción:
Valor total de la retención por factura
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
recargos
nombre_recargo
Descripción:
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
porcentaje_recargo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_base_calculo_recargo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
valor_total_recargo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
No
descuentos
codigo_descuento
Descripción:
Numero utilizado para categorizar el tipo de descuento otorgado
Tipo de dato:
Parametrizado
Especificaciones:
00= Descuento por impuesto asumido
01= Pague uno lleve otro02= Descuentos contractulales
03= Descuento por pronto pago
04= Envío gratis
05= Descuentos escpecíficos por inventarios
06= Descuento por monto de compras
07= Descuento de temporada
08= Descuento por acturalización de productos / servicios
09= Descuento general
10= Descuento por volumen
11= Otro descuento
99= No aplica descuento
Obligatorio:
Si
porcentaje_descuento
Descripción:
Número del descuento
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_calculo_descuento
Descripción:
Valor Base para calcular el descuento
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_descuento
Descripción:
Valor total del descuento
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_factura
valor_base
Descripción:
Total Valor Bruto antes de tributos: Total valor bruto, suma de los valores brutos de las líneas de la factura incluyendo descuentos mas recargos, es decir la suma de todas las lineas de detalle de los valor_total_detalle_con_cargo_descuento.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_calculo_impuestos
Descripción:
Total Valor Base Imponible : Base imponible para el cálculo de los tributos
tiene que ser la suma de los valores de las bases imponibles de todas líneas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_base_mas_impuestos
Descripción:
Total de Valor Bruto más tributos
El Valor Bruto más tributos tiene que ser igual 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.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_anticipo
Descripción:
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_descuento_total
Descripción:
Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
El Valor del Descuento Total es igual a la Suma de todos los descuentos globales aplicados al total de la factura.
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_1
Descripción:
Suma de todos los impuestos 1 aplicados a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_2
Descripción:
Suma de todos los impuestos 2 aplicados a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_3
Descripción:
Tipo de dato:
Suma de todos los impuestos 3 aplicados a nivel de las lineas de detalle
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_impuesto_4
Descripción:
Tipo de dato:
Suma de todos los impuestos 4 aplicados a nivel de las lineas de detalle
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_reteiva
Descripción:
Suma de todos los reteiva a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_retefuente
Descripción:
Suma de todos los retefuente a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_reteica
Descripción:
Suma de todos los reteica a nivel de las lineas de detalle
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_factura
Descripción:
Valor Total de factura: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems)+valor de impuestos + valor cargos – valor descuentos – valor anticipos
El Valor a total de Factura es igual a la Suma de Valor Bruto más tributos - Valor del Descuento Total + Valor del Cargo Total - Valor del Anticipo Total
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
valor_total_a_pagar
Descripción:
Valor total a pagar: El valor a total de factura es igual a la suma de valor bruto + impuestos - retenciónes - valor del descuento total + valor del cargo total - valor del anticipo total
Tipo de dato:
String patron decimal
Especificaciones:
Separador con punto, dos decimales
Obligatorio:
Si
generalidades
tipo_ambiente_dian
Descripción:
Ambiente de la DIAN al que se destina el documento enviado.
Tipo de dato:
Parametrizable
Especificaciones:
1= Producción
2= Pruebas
Obligatorio:
Si
version
Descripción:
Identificación consecutiva de la especificación
Tipo de dato:
Decimal
Especificaciones:
Obligatorio:
Si
identificador_transmision
Descripción:
Código único para identificar el paquete transmitido
Tipo de dato:
Alfanumérico
Especificaciones:
Obligatorio:
Mínimo 5 caracteres
rg_base_64
Descripción:
Pdf del documento elecronico en base 64
Tipo de dato:
Alfanumérico
Especificaciones:
Obligatorio:
Mínimo 5 caracteres
rg_tipo
Descripción:
Si se envia rg_base_64 identificar que tipo de archivo es HTML o PDF
Tipo de dato:
Parametrizable
Especificaciones:
HTML O PDF
Obligatorio:
Si hay información en rg_base_64
rg_px_qr
Descripción:
Información para ubicar el QR dentro del documento envido en base 64
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si se envia el rg_base_64
x
Descripción:
Posicionamiento en x dentro de la representación grafica
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en x desde la posición (0,0)
Obligatorio:
No
y
Descripción:
Posicionamiento en y dentro de la representación grafica
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en y desde la posición (0,0)
Obligatorio:
No
size
Descripción:
Tamaño del qr
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
mostrar_en
Descripción:
Identificador de si el QR en el PDF se pinta en la primera pagina o en todas
Tipo de dato:
Parametrizable
Especificaciones:
PRIMERA_PAGINA,TODAS
Obligatorio:
No
rg_px_cufe
Descripción:
Información de configuración de CUFE en la representación grafica
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si se envia el rg_base_64
x
Descripción:
Posicionamiento en x(abscisas) en el plano cartesiano en el cuarto cuadrante, es decir las columnas empezando de 0.
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en x desde la posición (0,0)
Obligatorio:
No
y
Descripción:
Posicionamiento en y(ordenadas) en el plano cartesiano en el cuarto cuadrante, es decir las filas empezando de 0.
Tipo de dato:
numerico
Especificaciones:
Coordenada en pixeles en y desde la posición (0,0)
Obligatorio:
No
size
Descripción:
Tamaño de la letra
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
mostrar_en
Descripción:
Identificador de si el CUFE/CUDE en el PDF se pinta en la primera pagina o en todas
Tipo de dato:
Parametrizable
Especificaciones:
PRIMERA_PAGINA,TODAS
Obligatorio:
No
notificacion
Descripción:
Información de configuración de envio de notificaciones. Los campos de notificación son obligatorios en caso que sea de forma automatica.
Tipo de dato:
Object
Especificaciones:
Obligatorio:
No
es_automatico
Descripción:
Indicar si la notificación es enviada de forma automatica
Tipo de dato:
Parametrizado
Especificaciones:
S o N
Obligatorio:
No
correo_obligado
Descripción:
Dirección de correo del obligado
Tipo de dato:
Especificaciones:
xxx@xx.xxx
Obligatorio:
No
asunto
Descripción:
Texto para el envio de las notificaciones
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
con_copia
Descripción:
Tamaño de la letra
Tipo de dato:
numerico
Especificaciones:
El tamaño Mínimo es 10 el máximo 12
Obligatorio:
No
integrador
Descripción:
Información de quien envia la información
Tipo de dato:
Object
Especificaciones:
Obligatorio:
Si
nombre
Descripción:
Nombre de quien realiza la integración
Tipo de dato:
Parametrizado
Especificaciones:
S o N
Obligatorio:
Si
tipo
Descripción:
Codigo del medio usado para realizar la integración
Tipo de dato:
Parametrizado
Especificaciones:
MOVIL
WEB
DLL
EXCEL
ERP-XXXXXXXXX
Obligatorio:
Si
webhook
Descripción:
URL para notificar cuando ha ocurrido un evento. Esta se utiliza cuando los codigos de error del retorno del API son 28,20.
Tipo de dato:
String
Especificaciones:
URL con portocolo de seguridad - HTTPS
Obligatorio:
No
informacion_mandantes
tipo_contribuyente
Descripción:
Tipo de identificación Tributaria o similar de la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
1= Persona juridica
2= Persona natural
Obligatorio:
Si
tipo_regimen
Descripción:
Régimen al que pertenece la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
0= Simplificado
2= Común
Obligatorio:
Si
tipo_identificacion
Descripción:
Tipo de documento de identificación de la empresa o persona
Tipo de dato:
Parametrizado
Especificaciones:
11= Registro civil
12= Tarjeta de identidad
13= Cedula ciudadania
21= Tarjeta de extranjería
22= Cedula de extranjería
31= NIT
41= Pasaporte
42= Documento de identificación extranjero
Obligatorio:
Si
identificacion
Descripción:
Número completo de la identificación de la empresa o persona
Tipo de dato:
String
Especificaciones:
Alfanumérico
Obligatorio:
Si
correo_electronico
Descripción:
Lista de direcciones de correo electronico, separadas por punto y coma ';'. Para el envio de las notificaciones al adquiriente se va tomar la primera dirección de correo.
Tipo de dato:
Especificaciones:
xxxx@xx.xx;yyyy@yy.yy
Obligatorio:
Si
numero_movil
Descripción:
Número de móvil para el envio de notificaciones
Tipo de dato:
String
Especificaciones:
3111111111
Obligatorio:
No
nombre
Descripción:
Nombre comercial del emisor
Tipo de dato:
array
Especificaciones:
Depende del tipo de contribuyente.
Persona juridica {razon_social}.
Persona natural {primer_nombre, segundo_nombre, apellidos}
Obligatorio:
Si
razon_social
Descripción:
Nombre comercial
Tipo de dato:
Alfanumérico
Especificaciones:
Opcional dependiendo el tipo de contribuyente. Si es NIT es obligatorio
Obligatorio:
Si es persona juridica
primer_nombre
Descripción:
Primer nombre
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si es persona natural
segundo_nombre
Descripción:
Segundo nombre
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
apellido
Descripción:
Apellidos
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
Si es persona natural
pais
Descripción:
Código dentificador del país. Código alfa-2 asignado al pais
Tipo de dato:
Parametrizado
Especificaciones:
Estandar ISO 3166-1. Inf adicional Ver
Obligatorio:
Si
nombre_pais
Descripción:
Nombre del país.
Tipo de dato:
String
Especificaciones:
Estandar ISO 3166-1. Inf adicional Ver
Obligatorio:
No
departamento
Descripción:
Codigo del departamento, son las subdivisiones administrativas del país (CO). Fue publicada en 1998 y actualizada por última vez en el sexto boletín de la primera edición en 2004.
Si no corresponde a Colombia debe ir el nombre de la ciudad o estado
Tipo de dato:
Parametrizado
Especificaciones:
ISO 3166-2:CO. Inf adicional Ver
Obligatorio:
Si
nombre_departamento
Descripción:
Nombre del departamento
Tipo de dato:
String
Especificaciones:
ISO 3166-2:CO. Inf adicional Ver
Obligatorio:
No
ciudad
Descripción:
Código del municipio ó ciudad ó subdivisión de tercer nivel.
Tipo de dato:
Parametrizado
Especificaciones:
Inf adicional Ver
Obligatorio:
Si
nombre_ciudad
Descripción:
Nombre del municipio ó ciudad ó subdivisión de tercer nivel.
Tipo de dato:
String
Especificaciones:
Inf adicional Ver
Obligatorio:
No
zona
Descripción:
Nombre de la subdivisión de la ciudad
Tipo de dato:
String
Especificaciones:
Mínimo 3 caracteres
Obligatorio:
No
direccion
Descripción:
Elemento de texto libre, que el emisor puede elegir utilizar para poner toda la información de la dirección
Tipo de dato:
Alfabético
Especificaciones:
Mínimo 10 caracteres
Obligatorio:
Si
RUT
Descripción:
Información del RUT - Registro Unico Tributario. Responsabilidades, Calidades y Atributos, numeral 53 y Usuarios aduaneros, numeral 54.
Tipo de dato:
array
Especificaciones:
Parametrizable
Obligatorio:
Si
resp_calidades_atributos
Descripción:
Lista de codigos de las responsabilidades, calidades y atributos registrados en el RUT, numeral 53
Tipo de dato:
Array
Especificaciones:
Parametrizado.Inf adicional Ver
Obligatorio:
Si
usuario_aduanero
Descripción:
Lista de codigos usuarios aduaneros registrados en el RUT, numeral 54
Tipo de dato:
Array
Especificaciones:
Vacio
Obligatorio:
No
periodo_facturacion
fecha_inicio
Descripción:
Periodo de Facturación: Intervalo de fechas a las que referencia la factura, por ejemplo servicios públicos, contratos de arrendamiento, matriculas en educación, etc. Fecha de inicio del periodo de facturación
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Opcional, si se utiliza es obligatorio
fecha_fin
Descripción:
Periodo de Facturación: Intervalo de fechas a las que referencia la factura, por ejemplo servicios públicos, contratos de arrendamiento, matriculas en educación, etc. Fecha de fin del periodo de facturación
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Opcional, si se utiliza es obligatorio
periodo_facturacion
fecha_inicio
Descripción:
Periodo de Facturación: Intervalo de fechas a las que referencia la factura, por ejemplo servicios públicos, contratos de arrendamiento, matriculas en educación, etc. Fecha de inicio del periodo de facturación
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Opcional, si se utiliza es obligatorio
fecha_fin
Descripción:
Periodo de Facturación: Intervalo de fechas a las que referencia la factura, por ejemplo servicios públicos, contratos de arrendamiento, matriculas en educación, etc. Fecha de fin del periodo de facturación
Tipo de dato:
Date
Especificaciones:
AAAA-MM-DD
Obligatorio:
Opcional, si se utiliza es obligatorio
- Ejemplo 1. Factura con un detalle de cantidad un e impuesto del 19%
- Ejemplo 2. Factura con varios detalles de cantidad uno y con diferentes impuestos de IVA e impuesto nacional al consumo
- Ejemplo 3. Factura con varios detalles con cantidad mayor que uno y con diferentes impuestos de IVA, ICA, impuesto nacional al consumo
- Ejemplo 4. Factura con un detalle exento de IVA y otros detalles con impuestos
- Ejemplo 5. Factura con adquiriente persona natural
- Ejemplo 6. Factura con descuento a nivel de detalles
- Ejemplo 7. Factura con descuento a nivel de la factura
- Ejemplo 8. Factura con retenciones a nivel de la factura - RETEIVA
- Ejemplo 9. Factura con retenciones a nivel de detalle de la factura - RETEIVA, RETEFUENTE
- Ejemplo 10. Factura con un detalle como regalo
- Ejemplo 11. Factura con recargos a nivel de factura
- Ejemplo 12. Factura con recargos a nivel de detalle de factura
- Ejemplo 13. Factura con varios recargos
- Ejemplo 14. Factura con moneda diferente de COP
- Ejemplo 15. Factura con periodo de facturación
- Ejemplo 16. Factura con un detalle excluido de IVA y otros detalles con impuestos
Ejemplo 1.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000602",
"fecha": "2019-08-23",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 11,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_mandantes": [
{
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900084341",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "DIGITAL BUSINESS DBX LTDA",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
},
"contratos": [
{
"numero": "123456789",
"fecha": "2019-08-15",
"tipo": "Mandato"
}
]
}
],
"informacion_adquiriente": {
"tipo_contribuyente": 2,
"tipo_regimen": 0,
"tipo_identificacion": 22,
"identificacion": "392546",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "Andres ",
"segundo_nombre": "",
"apellido": "Perez"
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-99"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "15000.00",
"descripcion": "Materiales de excavacion",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "15000.00",
"valor_impuesto": "2850.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "15000.00",
"valor_total_detalle": "15000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "15000.00",
"valor_total_impuesto": "2850.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "15000.00",
"valor_base_calculo_impuestos": "15000.00",
"valor_base_mas_impuestos": "17850.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "2850.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "17850.00",
"valor_total_a_pagar": "17850.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 2.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000606",
"fecha": "2019-08-23",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 11,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-07-03",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_mandantes": [
{
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900084341",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "DIGITAL BUSINESS DBX LTDA",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
},
"contratos": [
{
"numero": "123456789",
"fecha": "2019-08-15",
"tipo": "Mandato"
}
]
}
],
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "60000.00",
"descripcion": "Provisión ",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "60000.00",
"valor_impuesto": "9600.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "60000.00",
"valor_total_detalle": "60000.00"
},
{
"numero_linea": 3,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "50000.00",
"descripcion": "Provisión ",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_impuesto": "50000.00",
"valor_impuesto": "4000.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "50000.00",
"valor_total_detalle": "50000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "60000.00",
"valor_total_impuesto": "9600.00"
},
{
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_calculo_impuesto": "50000.00",
"valor_total_impuesto": "4000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "710000.00",
"valor_base_calculo_impuestos": "710000.00",
"valor_base_mas_impuestos": "837600.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "123600.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "4000.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "837600.00",
"valor_total_a_pagar": "837600.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 3.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000604",
"fecha": "2019-08-01",
"hora": "12:25:30",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 10,
"identificador_de_pago": "",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_mandantes": [
{
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900084341",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "DIGITAL BUSINESS DBX LTDA",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
},
"contratos": [
{
"numero": "123456789",
"fecha": "2019-08-15",
"tipo": "Mandato"
}
]
}
],
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "3005211254",
"nombre": {
"razon_social": "PIXELPRO S.A.S.\t",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 4,
"valor_unitario": "480000.00",
"unidad_de_cantidad": "94",
"descripcion": "Configuración inicial afacturar ",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1920000.00",
"valor_impuesto": "364800.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1920000.00",
"valor_total_detalle": "1920000.00"
},
{
"numero_linea": 2,
"cantidad": 168,
"unidad_de_cantidad": "94",
"valor_unitario": "10000.00",
"descripcion": "Servicio2",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "1680000.00",
"valor_impuesto": "268800.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1680000.00",
"valor_total_detalle": "1680000.00"
},
{
"numero_linea": 3,
"cantidad": 23,
"unidad_de_cantidad": "94",
"valor_unitario": "5000.00",
"descripcion": "Servicio1",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "5.00",
"valor_base_impuesto": "115000.00",
"valor_impuesto": "5750.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "115000.00",
"valor_total_detalle": "115000.00"
},
{
"numero_linea": 4,
"cantidad": 3,
"unidad_de_cantidad": "94",
"valor_unitario": "52000.00",
"descripcion": "Servicio4",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_impuesto": "156000.00",
"valor_impuesto": "12480.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "156000.00",
"valor_total_detalle": "156000.00"
},
{
"numero_linea": 5,
"cantidad": 12,
"unidad_de_cantidad": "94",
"valor_unitario": "58000.00",
"descripcion": "Servicio 4 - 16",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 4,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "696000.00",
"valor_impuesto": "111360.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "696000.00",
"valor_total_detalle": "696000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1920000.00",
"valor_total_impuesto": "364800.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "1680000.00",
"valor_total_impuesto": "268800.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "5.00",
"valor_base_calculo_impuesto": "115000.00",
"valor_total_impuesto": "5750.00"
},
{
"codigo_impuesto": 4,
"porcentaje_impuesto": "8.00",
"valor_base_calculo_impuesto": "156000.00",
"valor_total_impuesto": "12480.00"
},
{
"codigo_impuesto": 4,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "696000.00",
"valor_total_impuesto": "111360.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "4567000.00",
"valor_base_calculo_impuestos": "4567000.00",
"valor_base_mas_impuestos": "5330190.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "639350.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "123840.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "5330190.00",
"valor_total_a_pagar": "5330190.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 4.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000605",
"fecha": "2019-08-23",
"hora": "12:37:32",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 11,
"metodo_de_pago": 1,
"tipo_de_pago": 10,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_mandantes": [
{
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900084341",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "DIGITAL BUSINESS DBX LTDA",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
},
"contratos": [
{
"numero": "123456789",
"fecha": "2019-08-15",
"tipo": "Mandato"
}
]
}
],
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "3015223786",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 4,
"valor_unitario": "36000.00",
"unidad_de_cantidad": "94",
"descripcion": "Servicio Exento",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "144000.00",
"valor_impuesto": "0.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "144000.00",
"valor_total_detalle": "144000.00"
},
{
"numero_linea": 2,
"cantidad": 3,
"valor_unitario": "480000.00",
"unidad_de_cantidad": "94",
"descripcion": "Configuración inicial afacturar ",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "1440000.00",
"valor_impuesto": "273600.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1440000.00",
"valor_total_detalle": "1440000.00"
},
{
"numero_linea": 3,
"cantidad": 23,
"valor_unitario": "3500.00",
"unidad_de_cantidad": "94",
"descripcion": "R-PI34-SW-K9",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "80500.00",
"valor_impuesto": "15295.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "80500.00",
"valor_total_detalle": "80500.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "144000.00",
"valor_total_impuesto": "0.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "1520500.00",
"valor_total_impuesto": "288895.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "1664500.00",
"valor_base_calculo_impuestos": "1664500.00",
"valor_base_mas_impuestos": "1953395.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "288895.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "1953395.00",
"valor_total_a_pagar": "1953395.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 5.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000480",
"fecha": "2019-08-01",
"hora": "15:01:50",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 1,
"metodo_de_pago": 1,
"tipo_de_pago": 10,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_mandantes": [
{
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900084341",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "DIGITAL BUSINESS DBX LTDA",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
},
"contratos": [
{
"numero": "123456789",
"fecha": "2019-08-15",
"tipo": "Mandato"
}
]
}
],
"informacion_adquiriente": {
"tipo_contribuyente": 2,
"tipo_regimen": 0,
"tipo_identificacion": 13,
"identificacion": "52984786",
"correo_electronico": "info@teleinte.com",
"numero_movil": "3103103100",
"nombre": {
"razon_social": "",
"primer_nombre": "Maria",
"segundo_nombre": "Liliana",
"apellido": "Perez"
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"valor_unitario": "750000.00",
"unidad_de_cantidad": "94",
"descripcion": "SRV-ITL-PSSAV Servicios",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "750000.00",
"valor_impuesto": "142500.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "750000.00",
"valor_total_detalle": "750000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "750000.00",
"valor_total_impuesto": "142500.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "750000.00",
"valor_base_calculo_impuestos": "750000.00",
"valor_base_mas_impuestos": "892500.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "142500.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "892500.00",
"valor_total_a_pagar": "892500.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 6.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000607",
"fecha": "2019-08-01",
"hora": "08:37:32",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 11,
"metodo_de_pago": 1,
"tipo_de_pago": 10,
"identificador_de_pago": "ABC1234",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_mandantes": [
{
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900084341",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "DIGITAL BUSINESS DBX LTDA",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
},
"contratos": [
{
"numero": "123456789",
"fecha": "2019-08-15",
"tipo": "Mandato"
}
]
}
],
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "31031031031",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "36000.00",
"descripcion": "Servicio Exento",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": true,
"porcentaje_cargo_descuento": "10.00",
"valor_base_cargo_descuento": "36000.00",
"valor_cargo_descuento": "3600.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "32400.00",
"valor_impuesto": "6156.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "32400.00",
"valor_total_detalle": "36000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "75000.00",
"descripcion": "Servicio descuento",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": true,
"porcentaje_cargo_descuento": "20.00",
"valor_base_cargo_descuento": "75000.00",
"valor_cargo_descuento": "15000.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "60000.00",
"valor_impuesto": "9600.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "60000.00",
"valor_total_detalle": "75000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "32400.00",
"valor_total_impuesto": "6156.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "60000.00",
"valor_total_impuesto": "9600.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "92400.00",
"valor_base_calculo_impuestos": "92400.00",
"valor_base_mas_impuestos": "108156.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "15756.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "108156.00",
"valor_total_a_pagar": "108156.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 7.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000608",
"fecha": "2019-08-23",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 11,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-07-03",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_mandantes": [
{
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900084341",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "DIGITAL BUSINESS DBX LTDA",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
},
"contratos": [
{
"numero": "123456789",
"fecha": "2019-08-15",
"tipo": "Mandato"
}
]
}
],
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 11,
"porcentaje_descuento": "10.00",
"valor_base_calculo_descuento": "600000.00",
"valor_total_descuento": "60000.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "600000.00",
"valor_base_mas_impuestos": "714000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "60000.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "114000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "654000.00",
"valor_total_a_pagar": "654000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 8.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000609",
"fecha": "2019-08-24",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 11,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-07-03",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_mandantes": [
{
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "1020470585",
"correo_electronico": "juan@11111.com",
"numero_movil": "3102556326",
"nombre": {
"razon_social": "Juan Carlos Pinzon",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"departamento": "11",
"zona": "chapinero",
"ciudad": "11001",
"direccion": "cll 20",
"pais": "CO",
"RUT": {
"resp_calidades_atributos": [
"O-11"
],
"usuario_aduanero": [
""
]
},
"contratos": [
{
"numero": "102033",
"fecha": "2019-08-01",
"tipo": "mandato"
}
]
}
],
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "600000.00",
"valor_impuesto": "114000.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "600000.00",
"valor_total_detalle": "600000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "600000.00",
"valor_total_impuesto": "114000.00"
}
],
"retenciones": [
{
"codigo": 5,
"porcentaje": "15.00",
"valor_base": "600000.00",
"valor_retenido": "90000.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "600000.00",
"valor_base_calculo_impuestos": "600000.00",
"valor_base_mas_impuestos": "714000.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "114000.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "90000.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "714000.00",
"valor_total_a_pagar": "624000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 9.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000610",
"fecha": "2019-08-25",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 11,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-07-03",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_mandantes": [
{
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900084341",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "DIGITAL BUSINESS DBX LTDA",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
},
"contratos": [
{
"numero": "123456789",
"fecha": "2019-08-15",
"tipo": "Mandato"
}
]
}
],
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "187000.00",
"descripcion": "Provisión inicial afacturar",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_impuesto": "187000.00",
"valor_impuesto": "35530.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 5,
"porcentaje": "15.00",
"valor_base": "35530.00",
"valor_retenido": "5329.50"
},
{
"codigo": 6,
"porcentaje": "10.00",
"valor_base": "187000.00",
"valor_retenido": "18700.00"
}
],
"valor_total_detalle_con_cargo_descuento": "187000.00",
"valor_total_detalle": "187000.00"
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "1000000.00",
"descripcion": "Servicio de provisión inicial",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_impuesto": "1000000.00",
"valor_impuesto": "160000.00"
},
"datos_mandante": {
"numero_contrato": "123456789",
"tipo_identificacion_mandante": 31,
"identificacion_mandante": "900084341",
"nombre_mandante": "DIGITAL BUSINESS DBX LTDA"
},
"retenciones_detalle": [
{
"codigo": 5,
"porcentaje": "15.00",
"valor_base": "160000.00",
"valor_retenido": "24000.00"
},
{
"codigo": 6,
"porcentaje": "4.00",
"valor_base": "1000000.00",
"valor_retenido": "40000.00"
}
],
"valor_total_detalle_con_cargo_descuento": "1000000.00",
"valor_total_detalle": "1000000.00"
}
],
"impuestos": [
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "19.00",
"valor_base_calculo_impuesto": "187000.00",
"valor_total_impuesto": "35530.00"
},
{
"codigo_impuesto": 1,
"porcentaje_impuesto": "16.00",
"valor_base_calculo_impuesto": "1000000.00",
"valor_total_impuesto": "160000.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "1187000.00",
"valor_base_calculo_impuestos": "1187000.00",
"valor_base_mas_impuestos": "1382530.00",
"valor_anticipo": "0.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "195530.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "29329.50",
"valor_total_retefuente": "58700.00",
"valor_total_reteica": "0.00",
"total_factura": "1382530.00",
"valor_total_a_pagar": "1382530.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
}
}
}
Ejemplo 10.
{
"facturas": [
{
"encabezado": {
"id_factura": "990000611",
"fecha": "2019-08-25",
"hora": "05:36:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 11,
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "No disponible",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2019-07-03",
"numero_orden": "",
"prefijo": "SETP"
},
"informacion_mandantes": [
{
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900084341",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "DIGITAL BUSINESS DBX LTDA",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
},
"contratos": [
{
"numero": "123456789",
"fecha": "2019-08-15",
"tipo": "Mandato"
}
]
}
],
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "PIXELPRO S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"RUT": {
"resp_calidades_atributos": [
"O-07",
"O-08"
],
"usuario_aduanero": [
""
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "600000.00",
"descripcion"