Observación: Información sujeta a cambios

EndPoint

Método: POST

EndPoint:


						Pruebas 

						https://servicios-pruebas.afacturar.com/api/vp/doc_sop_adq_nota_ajuste


						Producción 

						https://servicios.afacturar.com/api/vp/doc_sop_adq_nota_ajuste

Seguridad SSL: Afacturar cuenta en sus endpoint con certificados de seguridad (DigiCert SHA2 Extended Validation Server CA), su aplicación debe ser capaz de negociar y validar dicho certificado.

Parámetros de entrada

HEADERS

Accept: application/json

Authorization: Bearer Token asignado a cada cliente

BODY

documento_obligado: Número de identificación del cliente

data: JSON

Estructura de JSON de entrada

Notas de ajuste de documento soporte adquisición

nota_credito Objeto Requerido

Información de la nota credito

Especificación:

encabezado Objeto Requerido

Encabezado

Especificación:

id_nota_credito

String

Requerido

Identificador del documento: Número de la nota crédito. Incluye prefijo (NC) + consecutivo.

Especificación: No se permiten caracteres adicionales como espacios o guiones.

fecha

Date

Requerido

Fecha de emisión de la nota credito.

Especificación: AAAA-MM-DD

hora

Time

Requerido

Hora de emisión de la nota credito

Especificación: HH24:MM:SS

nota Array Requerido

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

Especificación: El listado de la estandarización de las variables se puede ver aqui

moneda

Parametrizado

Requerido

Divisa aplicable a toda la factura

Especificación: COP- Colombia, USD - dolares. Inf adicional Ver

tipo_nota_credito

Parametrizado

Requerido

Código de descripción de la corrección

Especificación:

1= Devolución parcial de los bienes y/o no aceptación parcial del servicio

2= Anulación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente

3= Rebaja o descuento parcial o total

4= Ajuste de precio

5= Otros

numero_orden

String

No_requerido

Número de orden

Especificación: Mínimo 3 caracteres

metodo_de_pago

Parametrizado

No_Requerido

Método de pago

Especificación:

1 = Contado

2 = Crédito

tipo_de_pago

Parametrizado

No_Requerido

Código correspondiente al medio de pago

Especificación:

10 = Efectivo

42 = Consignación bancaria

20 = Cheque

Inf adicional Ver

identificador_de_pago

String

No_requerido

Identificador de pago o número de referencia de pago

Especificación:

fecha_vencimiento

Date

No_requerido

Fecha de vencimiento. Obligatorio si el método de pago es crédito

Especificación: AAAA-MM-DD

informacion_factura

Objeto

Requerido

Información de la factura

Especificación:

id_factura

Parametrizado

Requerido

Identificador del documento: Número de la factura.

Especificación: Mínimo 1 caracteres

fecha

Date

Requerido

Fecha de emisión del documento que se va a realizar la nota crédito.

Especificación: AAAA-MM-DD

hora

Time

Requerido

Hora de emisión del documento que se va a realizar la nota crédito.

Especificación: HH24:MM:SS

codigo_unico_factura

String

Requerido

CUFE- Codigo unico del documento electronico que se va a realizar la nota crédito

Especificación: Minimo de 18 caracteres

cambio_de_moneda

Objeto

No_requerido

Datos del cambio de moneda

Especificación:

fecha_cambio

Date

Requerido

Fecha del cambio de la moneda.

Especificación: Formato: AAAA-MM-DD. Si la moneda de origen es diferente de COP

codigo

Parametrizado

Requerido

La moneda de referencia para el tipo de cambio; La moneda a partir de la cual se realiza el cambio.

Especificación: COP- Colombia, USD - dolares. Inf adicional Ver. Si la moneda de origen es diferente de COP

valor_base_trm

String-patron

Requerido

Tasa de cambio del día de emisión o expedición del documento.

Especificación: Separador con punto, dos decimales. Si la moneda de origen es diferente de COP

informacion_adquiriente

Objeto

Requerido

Información del proveedor (vendedor)

Especificación:

tipo_contribuyente

Parametrizado

Requerido

Tipo de identificación Tributaria o similar de la empresa o persona

Especificación:

1= Persona juridica

2= Persona natural

tipo_regimen

Parametrizado

Requerido

Régimen al que pertenece la empresa o persona

Especificación:

0= Simplificado

2= Común

tipo_identificacion

Parametrizado

Requerido

Tipo de documento de identificación de la empresa o persona

Especificación:

21= Tarjeta de extranjería

22= Cedula de extranjería

31= NIT

41= Pasaporte

42= Documento de identificación extranjero

47= PEP

50= NIT de otro país

Nota: Se debe enviar el tipo 31 cuando la procedencia es igual a 10

identificacion

String

Requerido

Número completo de la identificación de la empresa o persona

Especificación: String

procedencia

Parametrizado

Requerido

Indicador de procedencia de vendedor

Especificación:

10= Residente

11= No residente

correo_electronico

Requerido

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.

Especificación: xxxx@xx.xx;yyyy@yy.yy

numero_movil

String

No_requerido

Número de móvil para el envio de notificaciones

Especificación: 3111111111

nombre

Array

Requerido

Razon social de acuerdo con lo que está en el RUT

Especificación: Depende del tipo de contribuyente.

Persona juridica {razon_social}.

Persona natural {primer_nombre, segundo_nombre, apellidos}

razon_social

String

Requerido

Nombre comercial

Especificación: Opcional dependiendo el tipo de contribuyente. Si es NIT es obligatorio

primer_nombre

String

Requerido

Primer nombre

Especificación: Mínimo 3 caracteres. Es requerido si el tipo de contribuyente es persona natutal

segundo_nombre

String

No_requerido

Segundo nombre

Especificación: Mínimo 3 caracteres. Es requerido si el tipo de contribuyente es persona natutal

apellido

String

Requerido

Apellidos

Especificación: Mínimo 3 caracteres. Es requerido si el tipo de contribuyente es persona natutal

pais

Parametrizado

Requerido

Código dentificador del país. Código alfa-2 asignado al pais

Especificación: Estandar ISO 3166-1. Inf adicional Ver

nombre_pais

String

No_requerido

Nombre del país.

Especificación: Estandar ISO 3166-1. Inf adicional Ver

departamento

Parametrizado

Requerido

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

Especificación: ISO 3166-2:CO. Inf adicional Ver

nombre_departamento

String

No_requerido

Nombre del departamento

Especificación: ISO 3166-2:CO. Inf adicional Ver

ciudad

Parametrizado

Requerido

Código del municipio ó ciudad ó subdivisión de tercer nivel.

Especificación: Inf adicional Ver

nombre_ciudad

String

No_requerido

Nombre del municipio ó ciudad ó subdivisión de tercer nivel.

Especificación: Inf adicional Ver

zona

String

No_requerido

Nombre de la subdivisión de la ciudad

Especificación: Mínimo 3 caracteres

direccion

String

Requerido

Elemento de texto libre, que el emisor puede elegir utilizar para poner toda la información de la dirección

Especificación: Mínimo 10 caracteres

codigo_postal

String

Requerido

El código postal es una estructura numérica o alfanumérica que se asigna a un área geográfica de un país y facilita la entrega de correspondencia, porque identifica cada destino con un único número. No reemplaza la dirección, sino que la complementa para facilitar la entrega de un envío.
En Colombia el código postal consta de 6 dígitos (ejemplo: 578986) que señalan inicialmente la posición geográfica, seguida por la de encaminamiento y finalmente la que nos ubica dentro del área postal. Se puede consultar en www.codigopostal.gov.co

Especificación: Mínimo 5 caracteres

detalles_tributarios

Parametrizado

Requerido

Detalles tributarios de persona natural o juridica

Especificación:

01= IVA

ZZ= No aplica

RUT

Array

Requerido

Información del RUT - Registro Unico Tributario. Responsabilidades, Calidades y Atributos, numeral 53 y Usuarios aduaneros, numeral 54.

Especificación: Parametrizado

resp_calidades_atributos

Array

Requerido

Lista de codigos de las responsabilidades, calidades y atributos registrados en el RUT, numeral 53

Especificación: Parametrizado.Inf adicional Ver

usuario_aduanero

Array

No_requerido

Lista de codigos usuarios aduaneros registrados en el RUT, numeral 54

Especificación: Vacio

detalle_factura

Objeto

Requerido

Información de la nota credito

Especificación:

numero_linea

Numerico

Requerido

Número de Línea

Especificación: 1...n

cantidad

Numerico

Requerido

(Cant) Cantidad de productos o servicios solicitados. Número de unidades servidas/prestadas.

Especificación: ...n

unidad_de_cantidad

Parametrizado

Requerido

Unidad de la cantidad del artículo solicitiado

Especificación:

94 => Unidad

LBR => Libra

LTR => Litro

MIN => Minuto

Inf adicional Ver

valor_unitario

String-patron

Requerido

(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

Especificación: Separador con punto, dos decimales

descripcion

String

Requerido

Descripcion del artículo o servicio a que se refiere esta línea de la factura

Especificación: Mínimo de 2 caracteres

nota_detalle

String

Requerido

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

Especificación: Mínimo de 2 caracteres

marca

String

Requerido

Marca: Marca del artículo

Especificación:

modelo

String

Requerido

Modelo: Modelo del artículo

Especificación:

codificacion_estandar

Objeto

No_requerido

Identificación del producto o servicio de acuerdo con un estandar acordado por la industria, los cuales facilitan el comercio entre empresas y gobierno.

Especificación:

cod_grupo_bien_servicio

Parametrizado

Requerido

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:

GS1 - Guía de Identificación. Ver documentación

GTIN 14 - Identificación Unidades Logísticas. Ver documentación

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.

Especificación:

1 -> UNSPSC

10 -> GTIN

20 -> Partida Arancelarias

999 -> Estándar de adopción del contribuyente

nombre_grupo_bien_servicio

Parametrizado

Requerido

Nombre de la codificación utilizada para la clasificación de los productos o servicios

Especificación:

UNSPSC -> 1

GTIN -> 10

Partida Arancelarias -> 20

Estándar de adopción del contribuyente -> 999

cod_segmento_bien_servicio

String

Requerido

Codigo del segmento.

Especificación: Dependen del grupo del bien o servicio. Información adicional Ver

cod_bien_servicio

String

Requerido

Codigo del bien o servicio

Especificación: Dependen del segmento del bien o servicio. Información adicional Ver

regalo

Objeto

No_Requerido

Indicador de si el ítem es gratuito o no

Especificación:

es_regalo

Boolean

Requerido

Describe si el articulo es un regalo o muestra comercial

Especificación: true o false

cod_precio_referencia

Parametrizado

Requerido

Código del tipo de precio informado

Especificación:

1 = Valor comercial

0 = En el caso que no sea regalo

precio_referencia

String-patron

Requerido

Precio de referencia para línea que no contienen valor comercial.

Especificación: Separador con punto, dos decimales

cargo_descuento

Objeto

Requerido

Información relacionada con un cargo o un descuento

Especificación:

es_descuento

Boolean

Requerido

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.

Especificación: True o false

porcentaje_cargo_descuento

String-patron

Requerido

Porcentaje de descuento o cargo a la linea de la factura

Especificación: Separador con punto, dos decimales

valor_base_cargo_descuento

String-patron

Requerido

Valor Base para calcular el descuento o el cargo

Especificación: Separador con punto, dos decimales

valor_cargo_descuento

String-patron

Requerido

Valor del descuento o el cargo

Especificación: Separador con punto, dos decimales

impuestos_detalle

Objeto

Requerido

Información relacionada con el impuesto aplicado a la linea de detalle

Especificación:

codigo_impuesto

Parametrizado

Requerido

Identificador del tributo

Especificación:

1= IVA

0= Excluido de IVA

porcentaje_impuesto

String-patron

Requerido

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.

Especificación: Separador con punto, dos decimales. Información adicional Ver

valor_base_impuesto

String-patron

Requerido

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

Especificación: Separador con punto, dos decimales

valor_impuesto

String-patron

Requerido

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

Especificación: Separador con punto, dos decimales

valor_total_detalle_con_cargo_descuento

String-patron

Requerido

(((VU * Cant)- VD)+ VR ). Valor total de la linea de detalle incluyendo el descuento y el recargo si aplica

Especificación: Separador con punto, dos decimales

valor_total_detalle

String-patron

Requerido

(VU*Cant). Valor total de la linea de detalle sin incluir descuentos, retenciónes o impuestos.

Especificación: Separador con punto, dos decimales

impuestos

Objeto

Requerido

Impuestos

Especificación:

codigo_impuesto

Parametrizado

Requerido

Es la clase que se utiliza para describir el esquema del impuesto

Especificación:

01= IVA

05= ReteIVA

06= ReteRenta

porcentaje_impuesto

String-patron

Requerido

Número de importe del impuesto retenido. Si algun item es excluido de IVA debe ir en 0.00.

Especificación: Separador con punto, dos decimales. Información adicional Ver

valor_base_calculo_impuesto

String-patron

Requerido

Base Imponible sobre la que se calcula la retención de impuesto. Si algun item es excluido de IVA debe ir en 0.00.

Especificación: Separador con punto, dos decimales

valor_total_impuesto

String-patron

Requerido

Importe del impuesto retenido. Si algun item es excluido de IVA debe ir en 0.00.

Especificación: Separador con punto, dos decimales

descuentos

Objeto

Requerido

Descuentos

Especificación:

codigo_descuento

Parametrizado

Requerido

Numero utilizado para categorizar el tipo de descuento otorgado

Especificación:

01= Descuento condicionado

99= No aplica descuento

porcentaje_descuento

String-patron

Requerido

Número del descuento

Especificación: Separador con punto, dos decimales

valor_base_calculo_descuento

String-patron

Requerido

Valor Base para calcular el descuento

Especificación: Separador con punto, dos decimales

valor_total_descuento

String-patron

Requerido

Valor total del descuento

Especificación: Separador con punto, dos decimales

valor_nota_credito

Objeto

Requerido

Información de la nota credito

Especificación:

valor_base

String-patron

Requerido

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.

Especificación: Separador con punto, dos decimales

valor_base_calculo_impuestos

String-patron

Requerido

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

Especificación: Separador con punto, dos decimales

valor_base_mas_impuestos

String-patron

Requerido

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.

Especificación: Separador con punto, dos decimales

valor_anticipo

String-patron

No_requerido

Valor que el cliente pago por adelantado a cuenta de una futura compra

Especificación: Separador con punto, dos decimales

valor_descuento_total

String-patron

Requerido

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.

Especificación: Separador con punto, dos decimales

valor_total_impuesto_1

String-patron

Requerido

Suma de todos los impuestos 1 aplicados a nivel de las lineas de detalle

Especificación: Separador con punto, dos decimales

valor_total_reteiva

String-patron

No_requerido

Suma de todos los reteiva a nivel de las lineas de detalle

Especificación: Separador con punto, dos decimales

valor_total_reterenta

String-patron

No_requerido

Suma de todos los retefuente a nivel de las lineas de detalle

Especificación: Separador con punto, dos decimales

total_nota_credito

String-patron

Requerido

Total importe bruto +Total valor_impuestos

Especificación: Separador con punto, dos decimales

valor_total_a_pagar

String-patron

Requerido

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

Especificación: Separador con punto, dos decimales

generalidades

Objeto

Requerido

Generalidades

Especificación:

tipo_ambiente_dian

Parametrizado

Requerido

Ambiente de la DIAN al que se destina el documento enviado.

Especificación:

1= Producción

2= Pruebas

version

Numerico

Requerido

Identificación consecutiva de la especificación

Especificación:

identificador_transmision

String

Mínimo 5 caracteres

Código único para identificar el paquete transmitido

Especificación:

rg_base_64

String

Requerido

Pdf del documento elecronico en base 64

Especificación: Mínimo 5 caracteres

rg_tipo

Parametrizado

Requerido

Si se envia rg_base_64 identificar que tipo de archivo es HTML o PDF

Especificación: HTML O PDF. Si hay información en rg_base_64

rg_px_qr

Objeto

No_requerido

Información para ubicar el QR dentro del documento envido en base 64

Especificación: Si hay información en rg_base_64

Numerico

Requerido

Posicionamiento en x dentro de la representación grafica

Especificación: Coordenada en pixeles en x desde la posición (0,0)

Numerico

Requerido

Posicionamiento en y dentro de la representación grafica

Especificación: Coordenada en pixeles en y desde la posición (0,0)

size

Numerico

Requerido

Tamaño del qr

Especificación: El tamaño Mínimo es 10 el máximo 12

mostrar_en

Parametrizado

Requerido

Identificador de si el QR en el PDF se pinta en la primera pagina o en todas

Especificación: PRIMERA_PAGINA,TODAS

rg_px_cufe

Objeto

No_requerido

Información de configuración de CUFE en la representación grafica

Especificación: Si se envia el rg_base_64

Numerico

Requerido

Posicionamiento en x(abscisas) en el plano cartesiano en el cuarto cuadrante, es decir las columnas empezando de 0.

Especificación: Coordenada en pixeles en x desde la posición (0,0)

Numerico

Requerido

Posicionamiento en y(ordenadas) en el plano cartesiano en el cuarto cuadrante, es decir las filas empezando de 0.

Especificación: Coordenada en pixeles en y desde la posición (0,0)

size

Numerico

Requerido

Tamaño de la letra

Especificación: El tamaño Mínimo es 10 el máximo 12

mostrar_en

Parametrizado

Requerido

Identificador de si el CUFE/CUDE en el PDF se pinta en la primera pagina o en todas

Especificación: PRIMERA_PAGINA,TODAS

notificacion

Objeto

No_requerido

Información de configuración de envio de notificaciones. Los campos de notificación son obligatorios en caso que sea de forma automatica.

Especificación:

es_automatico

Parametrizado

Requerido

Indicar si la notificación es enviada de forma automatica

Especificación: S o N

correo_obligado

Requerido

Dirección de correo del obligado

Especificación: xxx@xx.xxx

asunto

String

Requerido

Texto para el envio de las notificaciones

Especificación: Mínimo 3 caracteres

con_copia

Numerico

Requerido

Tamaño de la letra

Especificación: El tamaño Mínimo es 10 el máximo 12

integrador

Objeto

Requerido

Información de quien envia la información

Especificación:

nombre

Parametrizado

Requerido

Nombre de quien realiza la integración

Especificación: S o N

tipo

Parametrizado

Requerido

Codigo del medio usado para realizar la integración

Especificación:

MOVIL

WEB

DLL

EXCEL

ERP-XXXXXXXXX

webhook

String

No_requerido

URL para notificar cuando ha ocurrido un evento. Esta se utiliza cuando los codigos de error del retorno del API son 28,20.

Especificación: URL con portocolo de seguridad - HTTPS

Estructura json


														{
	"nota_credito": [
		{
			"encabezado": {
				"id_nota_credito": "",
				"fecha": "",
				"hora": "",
				"nota": [
					"{'':'','':'','':'','':'','':'','':''}"
				],
				"moneda": "",
				"tipo_nota_credito": "",
				"numero_orden": ""
			},
			"informacion_factura": {
				"id_factura": "",
				"codigo_unico_factura": "",
				"fecha": "",
				"hora": ""
			},
			"cambio_de_moneda": {
				"fecha_cambio": "",
				"codigo": "",
				"valor_base_trm": ""
			},
			"informacion_adquiriente": {
				"tipo_contribuyente": "",
				"tipo_regimen": "",
				"tipo_identificacion": "",
				"identificacion": "",
				"procedencia": "",
				"correo_electronico": "",
				"numero_movil": "",
				"nombre": {
					"razon_social": "",
					"primer_nombre": "",
					"segundo_nombre": "",
					"apellido": ""
				},
				"pais": "",
				"departamento": "",
				"zona": "",
				"ciudad": "",
				"direccion": "",
				"codigo_postal": "",
				"RUT": {
					"resp_calidades_atributos": [
						""
					],
					"usuario_aduanero": [
						""
					]
				},
				"detalles_tributarios": ""
			},
			"detalle_factura": [
				{
					"numero_linea": "",
					"cantidad": "",
					"unidad_de_cantidad": "",
					"valor_unitario": "",
					"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": ""
					},
					"cargo_descuento": {
						"es_descuento": "",
						"porcentaje_cargo_descuento": "",
						"valor_base_cargo_descuento": "",
						"valor_cargo_descuento": ""
					},
					"impuestos_detalle": {
						"codigo_impuesto": "",
						"porcentaje_impuesto": "",
						"valor_base_impuesto": "",
						"valor_impuesto": ""
					},
					"retenciones_detalle": [
						{
							"codigo": "",
							"porcentaje": "",
							"valor_base": "",
							"valor_retenido": ""
						}
					],
					
					"valor_total_detalle_con_cargo_descuento": "",
					"valor_total_detalle": ""
				}
			],
			"impuestos": [
				{
					"codigo_impuesto": "",
					"porcentaje_impuesto": "",
					"valor_base_calculo_impuesto": "",
					"valor_total_impuesto": ""
				}
			],
			"retenciones": [
				{
					"codigo": 0,
					"porcentaje": "0.00",
					"valor_base": "0.00",
					"valor_retenido": "0.00"
				}
			],
			"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_nota_credito": {
				"valor_base": "",
				"valor_base_calculo_impuestos": "",
				"valor_base_mas_impuestos": "",
				"valor_anticipo": "",
				"valor_descuento_total": "",
				"valor_total_recargos": "",
				"valor_total_impuesto_1": "",
				"valor_total_reteiva": "",
				"valor_total_reterenta": "",
				"total_nota_credito": "",
				"valor_total_a_pagar": ""
			}
		}
	],
	"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": ""
		}
	}
}

Estructura JSON de respuesta

Salida Exitosa


{
	"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 [10,11]"
        },
        {
            "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: DSAB36, Rechazo: Código QR no es informado o no es correcto"
}

Codigo de respuesta

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
28	Timeout	La operación duro más de 60 seg
15	Error retornado por la DIAN	La información enviada no cumple con el estandar del XML o los valores no estan bien calculados
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.

Documento soporte adquisición de factura ejemplos

Ejemplo 1. DSA de factura con un detalle de cantidad un e impuesto del 19%

Ejemplo 1.


									{
	"nota_credito": [
		{
			"encabezado": {
				"id_nota_credito": "NCDS9",
				"fecha": "2022-08-17",
				"hora": "00:00:00",
				"nota": [
					""
				],
				"moneda": "COP",
				"tipo_nota_credito": 2
			},
			"informacion_factura": {
				"id_factura": "SEDS984005009",
				"codigo_unico_factura": "c74435edb66020720ab5879ee17af7ac6861997a57cb2fd43569902ec697af282183f2f2f3edfbddd6318a3c8a94f150",
				"fecha": "2022-08-17",
				"hora": "00:00:00"
			},
			"informacion_adquiriente": {
				"tipo_contribuyente": 2,
				"tipo_regimen": 0,
				"tipo_identificacion": 31,
				"identificacion": "33700230",
				"procedencia": 10,
				"correo_electronico": "consumidor_final@prueba.com",
				"numero_movil": "",
				"nombre": {
					"razon_social": "",
					"primer_nombre": "Andrea",
					"segundo_nombre": "",
					"apellido": "final"
				},
				"lenguaje": "es",
				"pais": "CO",
				"departamento": "11",
				"ciudad": "11001",
				"zona": "",
				"direccion": "Carrera 12 ",
				"codigo_postal": "111161",
				"RUT": {
					"resp_calidades_atributos": [
						"R-99-PN"
					],
					"usuario_aduanero": [
						""
					]
				},
				"detalles_tributarios": "ZZ"
			},
			"detalle_factura": [
				{
					"numero_linea": 1,
					"cantidad": 1.0,
					"unidad_de_cantidad": "94",
					"valor_unitario": "38500.00",
					"descripcion": "CRA 49 C No 80-245 LOCAL 6 Mandante : 22353399",
					"nota_detalle": "",
					"marca": "",
					"modelo": "",
					"cargo_descuento": {
						"es_descuento": false,
						"porcentaje_cargo_descuento": "0.00",
						"valor_base_cargo_descuento": "38500.00",
						"valor_cargo_descuento": "0.00"
					},
					"impuestos_detalle": {
						"codigo_impuesto": 1,
						"porcentaje_impuesto": "0.00",
						"valor_base_impuesto": "38500.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": "38500.00",
					"valor_total_detalle": "38500.00"
				}
			],
			"impuestos": [
				{
					"codigo_impuesto": 1,
					"porcentaje_impuesto": "0.00",
					"valor_base_calculo_impuesto": "38500.00",
					"valor_total_impuesto": "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_nota_credito": {
				"valor_base": "38500.00",
				"valor_base_calculo_impuestos": "38500.00",
				"valor_base_mas_impuestos": "38500.00",
				"valor_descuento_total": "0.00",
				"valor_total_recargos": "0.00",
				"valor_total_impuesto_1": "0.00",
				"valor_total_reteiva": "0.00",
				"valor_total_reterenta": "0.00",
				"total_nota_credito": "38500.00",
				"valor_total_a_pagar": "38500.00"
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 2,
		"version": 2,
		"identificador_transmision": "Prueba_xwsr1234",
		"rg_tipo": "",
		"rg_base_64": "",
		"integrador": {
			"nombre": "afacturar.dll",
			"tipo": "DLL"
		}
	}
}

Consumo del API

CURL


																curl -X POST \
								https://servicios-pruebas.afacturar.com/api/vp/documento_soporte_adquisicion \
								-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": "",
											"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/documento_soporte_adquisicion");
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);

Historico de cambios

Versión	Cambios	Fecha de liberación
3	Ajustes según Resolución No. 000167 (30 DIC 2021)	17 de Agosto de 2022
2	Creación del API	28 de Mayo de 2021

Factura nacional

Factura de mandato

Factura de exportación

Factura de contingencia

Nota credito

Nota debito

Documento soporte en adquisición

Notas de ajuste Doc soporte en adquisición

Nómina-Enviar

Nómina-Reemplazar

Nómina-Eliminar

Historico de eventos

Lector CUFE

Acuse de recibo FEV

Recibo del B/S

Aceptación expresa

Aceptación tácita

Reclamo FEV

Token de acceso

Transacciones emitidas

Integración

Notas de ajuste de documento soporte adquisición

EndPoint

Parámetros de entrada

HEADERS

BODY

Estructura de JSON de entrada

Notas de ajuste de documento soporte adquisición

Estructura json

Estructura JSON de respuesta

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 de respuesta

Códigos de ERROR

Documento soporte adquisición de factura ejemplos

Ejemplo 1.

Consumo del API

CURL

C#

Historico de cambios