Copyright Teleinte SAS 2021
Para mayor información en operaciones@teleinte.com

DEE-TTP ( DOCUMENTO EQUIVALENTE ELECTRÓNICO TRANSPORTE AEREO DE PASAJEROS)

EndPoint


Método: POST

EndPoint:

Pruebas
https://servicios-pruebas.afacturar.com/api/doc_equivalente/TAP/factura
Habilitación
https://servicios-habilitacion.afacturar.com/api/doc_equivalente/TAP/factura
Producción
https://servicios.afacturar.com/api/doc_equivalente/TAP/factura

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

testSetId: Número entregado en la DIAN para la Habilitación. Este parametro es soló para habilitación


Estructura de JSON de entrada


DE - Transporte aéreo de pasajeros

facturas Objeto Requerido

Información de la factura

Especificación:

encabezado Objeto Requerido

Encabezado

Especificación:

id_factura String Requerido

Número de documento: Número de factura o factura cambiaria. Consecutivo de factura autorizados por la DIAN

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

Fecha de emisión de la factura a efectos fiscales.Validar que la fecha del documento no sea inferior a 5 días calendario y no superior a 10 días calendario.

Especificación: AAAA-MM-DD
hora Time Requerido

Hora de emisión de la factura

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_factura Parametrizado Requerido

Tipo de Factura

Especificación:

10= Estandar
numero_orden String No_requerido

Número de orden

Especificación: Mínimo 3 caracteres
servicio Array Requerido

Datos del servicio de transporte

Especificación:

pasaje_aereo Objeto Requerido

Datos de quien presta el servicio

Especificación:

aerolinea String Requerido

Nombre de la aerolinea

Especificación: Minimo 2 caracteres
operado_por String Requerido

Nombre del operador

Especificación: Mínimo 2 caracteres.
localizador_reserva String Requerido

Número de reserva

Especificación: Mínimo 2 caracteres.
itinerario Array Requerido

Datos del itenerario del vuelo

Especificación: Se pueden enviar varios en caso que hayan escalas
numero_vuelo String Requerido

Número de vuelo

Especificación: Minimo 2 caracteres
origen String Requerido

Lugar de origen

Especificación: Mínimo 2 caracteres.
destino String Requerido

Lugar de destino

Especificación: Mínimo 2 caracteres.
fecha_salida Date No_Requerido

Fecha salida

Especificación: AAAA-MM-DD
hora_salida Time No_Requerido

Hora de salida

Especificación: HH24:00:00
fecha_llegada Date No_Requerido

Fecha de llegada

Especificación: AAAA-MM-DD
hora_llegada Time No_Requerido

Hora de llegada

Especificación: HH24:00:00
duracion String No_Requerido

Duración del vuelo

Especificación: Mínimo 2 caracteres, con la estructura HH24:00
otros_datos Array No_requerido

Otros datos adicionales a incluir en el documento

Especificación: Se pueden enviar varios en caso que hayan escalas
variable String Requerido

Nombre del elemento a informar

Especificación: Mínimo 2 caracteres
valor String Requerido

Valor del elemento a informar

Especificación:

pasajeros Array Requerido

Información de los pasajeros

Especificación:

tipo_identificacion Parametrizado Requerido

Tipo de documento de identificación de la persona.

Especificación:

11= Registro civil

12= Tarjeta de identidad

13= Cedula ciudadania

21= Tarjeta de extranjería

22= Cedula de extranjería

41= Pasaporte

42= Documento de identificación extranjero

47=PEP

91=NUIP
identificacion String Requerido

Número completo de la identificación de la persona.

Especificación: String
nombre Objeto Requerido

Nombre del pasajero

Especificación:

tipo_identificacion Parametrizado Requerido

Tipo de documento de identificación de la persona.

Especificación:

11= Registro civil

12= Tarjeta de identidad

13= Cedula ciudadania

21= Tarjeta de extranjería

22= Cedula de extranjería

41= Pasaporte

42= Documento de identificación extranjero

47=PEP

91=NUIP
identificacion String Requerido

Número completo de la identificación de la persona.

Especificación: String
nombre Objeto Requerido

Nombre del pasajero

Especificación:

primer_nombre String Requerido

Primer nombre.

Especificación: Mínimo 3 caracteres.
otros_nombres String Requerido

Otros nombres

Especificación:

primer_apellido String Requerido

Primer apellido.

Especificación: Mínimo 3 caracteres.

otros_apellidos String Requerido

Otros apellidos

Especificación:

numero_tiquete String Requerido

Número de tiquete

Especificación:

correo_electronico No_Requerido

Direccion de correo electronico

Especificación: xxxx@xx.xx;yyyy@yy.yy
numero_movil String No_Requerido

Número de móvil

Especificación: 3111111111
equipaje String No_Requerido

Tipo de equipaje

Especificación:

cabina String Requerido

Cabita en el vuelo

Especificación:

tarifa String No_Requerido

Tarifa

Especificación:

Silla String No_Requerido

Numero de silla a ocupar en el avion

Especificación:

informacion_adicional Array No_Requerido

Caracteristicas adicionales al detalle

Especificación:

variable String Requerido

Nombre del elemento a informar

Especificación:

DESCRIPCION => Otra descripción del item
valor String Requerido

Valor del elemento a informar

Especificación:

numero_tiquete String Requerido

Número de tiquete

Especificación:

correo_electronico No_Requerido

Direccion de correo electronico

Especificación: xxxx@xx.xx;yyyy@yy.yy
numero_movil String No_Requerido

Número de móvil

Especificación: 3111111111
equipaje String No_Requerido

Tipo de equipaje

Especificación:

cabina String Requerido

Cabita en el vuelo

Especificación:

tarifa String No_Requerido

Tarifa

Especificación:

Silla String No_Requerido

Numero de silla a ocupar en el avion

Especificación:

informacion_adicional Array No_Requerido

Caracteristicas adicionales al detalle

Especificación:

tipo_identificacion Parametrizado Requerido

Tipo de documento de identificación de la persona.

Especificación:

11= Registro civil

12= Tarjeta de identidad

13= Cedula ciudadania

21= Tarjeta de extranjería

22= Cedula de extranjería

41= Pasaporte

42= Documento de identificación extranjero

47=PEP

91=NUIP
identificacion String Requerido

Número completo de la identificación de la persona.

Especificación: String
nombre Objeto Requerido

Nombre del pasajero

Especificación:

primer_nombre String Requerido

Primer nombre.

Especificación: Mínimo 3 caracteres.
otros_nombres String Requerido

Otros nombres

Especificación:

primer_apellido String Requerido

Primer apellido.

Especificación: Mínimo 3 caracteres.

otros_apellidos String Requerido

Otros apellidos

Especificación:

numero_tiquete String Requerido

Número de tiquete

Especificación:

correo_electronico No_Requerido

Direccion de correo electronico

Especificación: xxxx@xx.xx;yyyy@yy.yy
numero_movil String No_Requerido

Número de móvil

Especificación: 3111111111
equipaje String No_Requerido

Tipo de equipaje

Especificación:

cabina String Requerido

Cabita en el vuelo

Especificación:

tarifa String No_Requerido

Tarifa

Especificación:

Silla String No_Requerido

Numero de silla a ocupar en el avion

Especificación:

informacion_adicional Array No_Requerido

Caracteristicas adicionales al detalle

Especificación:

variable String Requerido

Nombre del elemento a informar

Especificación:

DESCRIPCION => Otra descripción del item
valor String Requerido

Valor del elemento a informar

Especificación:

informacion_adquiriente Objeto Requerido

Información del adquiriente

Especificación:

tipo_contribuyente Parametrizado Requerido

Tipo de identificación Tributaria o similar de la empresa o persona
Consumidor final se debe enviar 2.

Especificación:

1= Persona juridica

2= Persona natural
tipo_regimen Parametrizado Requerido

Régimen al que pertenece la empresa o persona.
Consumidor final se debe enviar 0.

Especificación:

0= Simplificado

2= Común

99= otro
tipo_identificacion Parametrizado Requerido

Tipo de documento de identificación de la empresa o persona.
Consumidor final se debe enviar 13.

Especificación:

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

47=PEP

50= NIT de otro país

91=NUIP
identificacion String Requerido

Número completo de la identificación de la empresa o persona.
Consumidor final se debe enviar 222222222222.

Especificación: String
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. Se adiciono el api consulta_correo_electronico (Inf. Otros), para consultar el correo electronico del adquiriente y poder enviar esté correo en la información del adquiriente, dicho correo es el registrado en el portal de la DIAN.

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_comercial String No_requerido

Nombre Comercial de acuerdo con lo que está en el RUT

Especificación:

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.
Consumidor final se debe enviar 'consumidor'.

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

Segundo nombre.
Consumidor final se debe enviar vacio.

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

Apellidos.
Consumidor final se debe enviar 'final'.

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.
Consumidor final se debe enviar X.

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.
Consumidor final se debe enviar XXX.

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.
Consumidor final se debe enviar XXXX.

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
detalles_tributarios Parametrizado Requerido

Codigo del detalles tributario de la empresa.
Consumidor final se debe enviar ZZ.

Especificación:

01 = IVA

04 = INC

ZA = IVA E INC

ZZ = No aplica

RUT Array Requerido

Información del RUT - Registro Unico Tributario. Responsabilidades, Calidades y Atributos, numeral 53 y Usuarios aduaneros, numeral 54.
Consumidor final se debe enviar R-99-PN.

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
porcentaje_participacion String-patron Requerido

Porcentaje de participación del bien / servicio del adquiriente. Nota: Se utiliza en caso que haya más de un adquiriente. La sumatoria del porcentaje del adquiriente y otros debe sumar 100

Especificación: Separador con punto, hasta seis decimales.
formas_de_pago Array No_Requerido

Formas de pago

Especificación:

metodo_de_pago Parametrizado Requerido

Método de pago

Especificación:

1 = Contado

2 = Crédito
tipo_de_pago Parametrizado Requerido

Código correspondiente al medio de pago

Especificación:

10 = Efectivo

42 = Consignación bancaria

20 = Cheque

Inf adicional Ver
Se elimino el codigo (8) Mantener, se adicionaron los codigos (71) Bonos y (72) Vales.
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
detalle_factura Objeto Requerido

Detalles de la factura

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, hasta seis 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 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

    Se eliminaron los codigos (2) Valor en inventarios y (3) Otro valor

    precio_referencia String-patron Requerido

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

    Especificación: Separador con punto, hasta seis 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, hasta seis decimales
    valor_base_cargo_descuento String-patron Requerido

    Valor Base para calcular el descuento o el cargo

    Especificación: Separador con punto, hasta seis decimales
    valor_cargo_descuento String-patron Requerido

    Valor del descuento o el cargo

    Especificación: Separador con punto, hasta seis 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

    2= Impuesto al consumo

    3= ICA

    4= Impuesto nacional al consumo

    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, hasta seis 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, hasta seis 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, hasta seis decimales
    retenciones_detalle Objeto Requerido

    Información relacionada con los tributos retenidos en la linea de detalle

    Especificación:

    codigo Parametrizado Requerido

    Identificador de las retenciónes

    Especificación:

    5= ReteIVA

    6= ReteFuente

    7= ReteICA

    0= No tiene retenciónes

    porcentaje Parametrizado ReteFuente - ReteIVA

    String patron decimal

    		 Requerido

    Tarifa del tributo retenido. Porcentaje del valor tributable retenido a ser aplicada a la base imponible de la linea de detalle.

    Especificación: Separador con punto, hasta seis decimales. Información adicional Ver
    valor_base String-patron Requerido

    La base gravable es el valor sobre el cual se aplica la tarifa de la retención

    Especificación: Separador con punto, hasta seis decimales
    valor_retenido String-patron Requerido

    Valor del tributo: producto del porcentaje aplicado sobre la base imponible

    Especificación: Separador con punto, hasta seis 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, hasta seis 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, hasta seis decimales
    informacion_adicional Array No_Requerido

    Caracteristicas adicionales al detalle

    Especificación:

    variable String Requerido

    Nombre del elemento a informar

    Especificación:

    DESCRIPCION => Otra descripción del item
    valor String Requerido

    Valor del elemento a informar

    Especificación:

    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

    02= Impuesto al consumo

    03= ICA

    04= Impuesto nacional al consumo

    0= Excluido de IVA
    porcentaje_impuesto String-patron Requerido

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

    Especificación: Separador con punto, hasta seis 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 hay algun item excluido de IVA debe ir en 0.00.

    Especificación: Separador con punto, hasta seis decimales
    valor_total_impuesto String-patron Requerido

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

    Especificación: Separador con punto, hasta seis decimales
    retenciones Objeto Requerido

    Retenciones

    Especificación:

    codigo Parametrizado Requerido

    Identificador de las retenciónes

    Especificación:

    5= ReteIVA

    6= ReteFuente

    7= ReteICA

    0= No tiene retenciónes
    porcentaje Parametrizado Requerido

    Importe del impuesto retenido al total de la factura

    Especificación: Separador con punto, hasta seis decimales. Información adicional Ver
    valor_base String-patron Requerido

    La base gravable es el valor sobre el cual se aplica la tarifa de la retención

    Especificación: Separador con punto, hasta seis decimales
    valor_retenido String-patron Requerido

    Valor total de la retención por factura

    Especificación: Separador con punto, hasta seis decimales
    recargos Objeto Requerido

    Recargos

    Especificación:

    nombre_recargo String Requerido

    Especificación: Mínimo 3 caracteres
    porcentaje_recargo String-patron Requerido

    Especificación: Separador con punto, hasta seis decimales
    valor_base_calculo_recargo String-patron Requerido

    Especificación: Separador con punto, hasta seis decimales
    valor_total_recargo String-patron Requerido

    Especificación: Separador con punto, hasta seis 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

    Se eliminaron los codigos: (00) Descuento por impuesto asumido. (02) 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.
    porcentaje_descuento String-patron Requerido

    Número del descuento

    Especificación: Separador con punto, hasta seis decimales
    valor_base_calculo_descuento String-patron Requerido

    Valor Base para calcular el descuento

    Especificación: Separador con punto, hasta seis decimales
    valor_total_descuento String-patron Requerido

    Valor total del descuento

    Especificación: Separador con punto, hasta seis decimales
    valor_factura Objeto Requerido

    Valor factura

    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, hasta seis 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, hasta seis 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, hasta seis decimales
    valor_anticipo String-patron Requerido

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

    Especificación: Separador con punto, hasta seis 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, hasta seis 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, hasta seis decimales
    valor_total_impuesto_2 String-patron Requerido

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

    Especificación: Separador con punto, hasta seis decimales
    valor_total_impuesto_3 String-patron Requerido

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

    Especificación: Separador con punto, hasta seis decimales
    valor_total_impuesto_4 String-patron Requerido

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

    Especificación: Separador con punto, hasta seis decimales
    valor_total_reteiva String-patron Requerido

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

    Especificación: Separador con punto, hasta seis decimales
    valor_total_retefuente String-patron Requerido

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

    Especificación: Separador con punto, hasta seis decimales
    valor_total_reteica String-patron Requerido

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

    Especificación: Separador con punto, hasta seis decimales
    valor_total_factura String-patron Requerido

    Valor Total de factura: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems)+valor de impuestos + valor cargos – valor descuentos

    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

    Especificación: Separador con punto, hasta seis decimales
    valor_total_a_pagar String-patron Requerido

    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

    Especificación: Separador con punto, hasta seis 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 Requerido

    Código único para identificar el paquete transmitido

    Especificación: Mínimo 5 caracteres
    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
    fabricante_software Objeto Requerido

    Datos del fabricante de software

    Especificación:

    nombre_apellido String Requerido

    Nombres y apellidos del fabricante del software

    Especificación: Mínimo 3 caracteres
    razon_social String Requerido

    Razon social del fabricante del software)

    Especificación: Mínimo 3 caracteres
    nombre_software String Requerido

    Nombre del Software

    Especificación: Mínimo 3 caracteres

    Estructura json

    							{
	"facturas": [
		{
			"encabezado": {
				"id_factura": "",
				"fecha": "",
				"hora": "",
				"nota": [
					"{'':''",
					"'':''}"
				],
				"moneda": "",
				"tipo_factura": "",
				"numero_orden": ""
			},
			"servicio": [
				{
					"pasaje_aereo": {
						"aerolinea": "",
						"operado_por": "",
						"localizador_reserva": ""
					},
					"itinerario": [
						{
							"numero_vuelo": "",
							"origen": "",
							"destino": "",
							"fecha_salida": "",
							"hora_salida": "",
							"fecha_llegada": "",
							"hora_llegada": "",
							"duracion": ""
						}
					],
					"otros_datos": [
						{
							"nombre": "",
							"informacion_adicional": [
								{
									"variable": "",
									"valor": ""
								}
							]
						}
					],
					"pasajeros": [
						{
							"tipo_identificacion": "",
							"identificacion": "",
							"nombre": {
								"primer_nombre": "",
								"otros_nombres": "",
								"primer_apellido": "",
								"otros_apellidos": ""
							},
							"correo_electronico": "",
							"movil": "",
							"equipaje": "",
							"numero_tiquete": "",
							"cabina": "",
							"tarifa": "",
							"silla": "",
							"informacion_adicional": [
								{
									"variable": "codigo",
									"valor": "12345"
								}
							]
						}
					]
				}
			],
			"informacion_adquiriente": {
				"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": [
						""
					]
				}
			},
			"formas_de_pago": [
				{
					"metodo_de_pago": "",
					"tipo_de_pago": "",
					"identificador_de_pago": "",
					"fecha_vencimiento": ""
				}
			],
			"detalle_factura": [
				{
					"numero_linea": "",
					"cantidad": "",
					"unidad_de_cantidad": "",
					"valor_unitario": "",
					"descripcion": "",
					"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": 1,
						"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": "",
					"porcentaje": "",
					"valor_base": "",
					"valor_retenido": ""
				}
			],
			"recargos": [
				{
					"nombre_recargo": "",
					"porcentaje_recargo": "",
					"valor_base_calculo_recargo": "",
					"valor_total_recargo": ""
				}
			],
			"descuentos": [
				{
					"codigo_descuento": "",
					"porcentaje_descuento": "",
					"descripcion_descuento": "",
					"valor_base_calculo_descuento": "",
					"valor_total_descuento": ""
				}
			],
			"valor_factura": {
				"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": "",
				"valor_total_reteiva": "",
				"valor_total_retefuente": "",
				"valor_total_reteica": "",
				"total_factura": "",
				"valor_total_a_pagar": ""
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": "",
		"version": "",
		"identificador_transmision": "",
		"fabricante_software": {
			"nombre_apellido": "",
			"razon_social": "",
			"nombre_software": ""
		}
	}
}

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

    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 equivalente transporte terrestre ejemplos


    Ejemplo 1.

     {
	"facturas": [
		{
			"encabezado": {
				"id_factura": "16",
				"fecha": "2024-08-15",
				"hora": "13:25:00",
				"nota": [],
				"moneda": "COP",
				"tipo_factura": 10,
				"numero_orden": ""
			},
			"servicio": [
				{
					"pasaje_aereo": {
						"aerolinea": "Latam SA",
						"operado_por": "Latam",
						"localizador_reserva": "2U3JCP"
					},
					"itinerario": [
						{
							"numero_vuelo": "AV8408",
							"origen": "Pereira",
							"destino": "Bogota",
							"fecha_salida": "2024-08-15",
							"hora_salida": "14:00",
							"fecha_llegada": "2024-08-15",
							"hora_llegada": "14:50",
							"duracion": "00:55"
						},
						{
							"numero_vuelo": "AV9263",
							"origen": "Bogota",
							"destino": "Barranquilla",
							"fecha_salida": "2024-08-15",
							"hora_salida": "18:00",
							"fecha_llegada": "2024-08-15",
							"hora_llegada": "19:30",
							"duracion": "01:30"
						}
					],
					"otros_datos": [
						{
							"nombre": "viajero_frecuente",
							"informacion_adicional": [
								{
									"variable": "codigo",
									"valor": "12345"
								},
								{
									"variable": "Puntoa acumulados",
									"valor": "12345"
								}
							]
						}
					],
					"pasajeros": [
						{
							"tipo_identificacion": 31,
							"identificacion": "79596914",
							"nombre": {
								"primer_nombre": "Juan",
								"otros_nombres": "Manuel",
								"primer_apellido": "Perez",
								"otros_apellidos": ""
							},
							"correo_electronico": "info@teleinte.com",
							"movil": "57314202122",
							"equipaje": "1 maleta 23Kg",
							"numero_tiquete": "1342108339715",
							"cabina": "economic",
							"tarifa": "S",
							"silla": "8F",
							"informacion_adicional": [
								{
									"variable": "codigo",
									"valor": "12345"
								},
								{
									"variable": "Puntoa acumulados",
									"valor": "12345"
								}
							]
						}
					]
				}
			],
			"informacion_adquiriente": {
				"tipo_contribuyente": 2,
				"tipo_regimen": 2,
				"tipo_identificacion": 13,
				"identificacion": "222222222222",
				"correo_electronico": "usuario@dominio.com",
				"numero_movil": "",
				"nombre": {
					"razon_social": "",
					"primer_nombre": "consumidor",
					"segundo_nombre": "",
					"apellido": "final"
				},
				"pais": "CO",
				"departamento": "11",
				"ciudad": "11001",
				"zona": "",
				"direccion": "",
				"RUT": {
					"resp_calidades_atributos": [
						"R-99-PN"
					],
					"usuario_aduanero": [
						""
					]
				}
			},
			"formas_de_pago": [
				{
					"metodo_de_pago": 1,
					"tipo_de_pago": 10,
					"identificador_de_pago": "",
					"fecha_vencimiento": ""
				}
			],
			"detalle_factura": [
				{
					"numero_linea": 1,
					"cantidad": 1,
					"unidad_de_cantidad": "94",
					"valor_unitario": "120000.00",
					"descripcion": "Tiquete de Pereira a Barranquilla",
					"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": "120000.00",
					"valor_total_detalle": "120000.00"
				}
			],
			"impuestos": [
				{
					"codigo_impuesto": 0,
					"porcentaje_impuesto": "0.00",
					"valor_base_calculo_impuesto": "0.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",
					"descripcion_descuento": "No aplica",
					"valor_base_calculo_descuento": "0.00",
					"valor_total_descuento": "0.00"
				}
			],
			"valor_factura": {
				"valor_base": "120000.00",
				"valor_base_calculo_impuestos": "0.00",
				"valor_base_mas_impuestos": "120000.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": "120000.00",
				"valor_total_a_pagar": "120000.00"
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 2,
		"version": 2,
		"identificador_transmision": "20240529",
		"integrador": {
			"nombre": "Integrador X",
			"tipo": "API"
		},
		"fabricante_software": {
			"nombre_apellido": "Nombre Apellido",
			"razon_social": "Empresa SAS",
			"nombre_software": "tiquetes OK"
		}
	}
}

    Consumo del API


    CURL

    								curl --location 'https://servicios-pruebas.afacturar.com/api/doc_equivalente/factura_pos' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer token_obligado' \
--form 'documento_obligado="100100100"' \
--form 'data="{
	\"facturas\": [
		{
			\"encabezado\": {
				\"id_factura\": \"33\",
				\"fecha\": \"2024-05-29\",
				\"hora\": \"13:03:00\",
				\"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\": \"\",
				\"codigo_venta\": \"505050\",
				\"prefijo\": \"EPOS\",
				\"cantidad_puntos\": \"60\"
				
			},
			\"punto_de_venta\": {
				\"nombre\": \"Salitre plaza\",
				\"tipo\": \"FISICO\",
				\"ubicacion\": \"Calle 63\",
				\"caja\": {
					\"numero\": \"123456\",
					\"tipo\": \"maquina\"
				},
				\"datos_cajero\": {
					\"codigo\": \"123456\",
					\"identificacion\": \"337002358\",
					\"nombre\": {
						\"primer_nombre\": \"Juan\",
						\"otros_nombres\": \"Sebastian\",
						\"primer_apellido\": \"Perez\",
						\"otros_apellidos\": \"Gamboa\"
					}
				},
				\"datos_vendedor\": {
					\"codigo\": \"123456\",
					\"identificacion\": \"337002358\",
					\"nombre\": {
						\"primer_nombre\": \"Juan\",
						\"otros_nombres\": \"Sebastian\",
						\"primer_apellido\": \"Perez\",
						\"otros_apellidos\": \"Gamboa\"
					}
				}
			},
			\"informacion_comprador\": {
				\"tipo_identificacion\": 13,
				\"identificacion\": \"33700230\",
				\"correo_electronico\": \"acanon@teleinte.com\",
				\"numero_movil\": \"3142925981\",
				\"nombre\": {
					\"primer_nombre\": \"Nubia\",
					\"otros_nombres\": \"Andrea\",
					\"primer_apellido\": \"Cañón\",
					\"otros_apellidos\": \"Castellanos\"
				}
			},
			\"detalle_factura\": [
				{
					\"numero_linea\": 1,
					\"cantidad\": 1.0,
					\"unidad_de_cantidad\": \"94\",
					\"valor_unitario\": \"60000.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\": \"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\",
					\"descripcion_descuento\": \"No aplica\",
					\"valor_base_calculo_descuento\": \"0.00\",
					\"valor_total_descuento\": \"0.00\"
				}
			],
			\"valor_factura\": {
				\"valor_base\": \"60000.00\",
				\"valor_base_calculo_impuestos\": \"60000.00\",
				\"valor_base_mas_impuestos\": \"71400.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\": \"71400.00\",
				\"valor_total_a_pagar\": \"71400.00\"
			}
		}
	],
	\"generalidades\": {
		\"tipo_ambiente_dian\": 2,
		\"version\": 2,
		\"identificador_transmision\": \"2019 validación previa\",
		\"integrador\": {
			\"nombre\": \"Afacturar.com\",
			\"tipo\": \"WEB\"
		}
	}
}"'

    C#

    								var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://servicios-pruebas.afacturar.com/api/doc_equivalente/factura_pos");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer token_obligado");
var content = new MultipartFormDataContent();
content.Add(new StringContent("100100100"), "documento_obligado");
content.Add(new StringContent("{
	\"facturas\": [
		{
			\"encabezado\": {
				\"id_factura\": \"33\",
				\"fecha\": \"2024-05-29\",
				\"hora\": \"13:03:00\",
				\"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\": \"\",
				\"codigo_venta\": \"505050\",
				\"prefijo\": \"EPOS\",
				\"cantidad_puntos\": \"60\"
				
			},
			\"punto_de_venta\": {
				\"nombre\": \"Salitre plaza\",
				\"tipo\": \"FISICO\",
				\"ubicacion\": \"Calle 63\",
				\"caja\": {
					\"numero\": \"123456\",
					\"tipo\": \"maquina\"
				},
				\"datos_cajero\": {
					\"codigo\": \"123456\",
					\"identificacion\": \"337002358\",
					\"nombre\": {
						\"primer_nombre\": \"Juan\",
						\"otros_nombres\": \"Sebastian\",
						\"primer_apellido\": \"Perez\",
						\"otros_apellidos\": \"Gamboa\"
					}
				},
				\"datos_vendedor\": {
					\"codigo\": \"123456\",
					\"identificacion\": \"337002358\",
					\"nombre\": {
						\"primer_nombre\": \"Juan\",
						\"otros_nombres\": \"Sebastian\",
						\"primer_apellido\": \"Perez\",
						\"otros_apellidos\": \"Gamboa\"
					}
				}
			},
			\"informacion_comprador\": {
				\"tipo_identificacion\": 13,
				\"identificacion\": \"33700230\",
				\"correo_electronico\": \"acanon@teleinte.com\",
				\"numero_movil\": \"3142925981\",
				\"nombre\": {
					\"primer_nombre\": \"Nubia\",
					\"otros_nombres\": \"Andrea\",
					\"primer_apellido\": \"Cañón\",
					\"otros_apellidos\": \"Castellanos\"
				}
			},
			\"detalle_factura\": [
				{
					\"numero_linea\": 1,
					\"cantidad\": 1.0,
					\"unidad_de_cantidad\": \"94\",
					\"valor_unitario\": \"60000.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\": \"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\",
					\"descripcion_descuento\": \"No aplica\",
					\"valor_base_calculo_descuento\": \"0.00\",
					\"valor_total_descuento\": \"0.00\"
				}
			],
			\"valor_factura\": {
				\"valor_base\": \"60000.00\",
				\"valor_base_calculo_impuestos\": \"60000.00\",
				\"valor_base_mas_impuestos\": \"71400.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\": \"71400.00\",
				\"valor_total_a_pagar\": \"71400.00\"
			}
		}
	],
	\"generalidades\": {
		\"tipo_ambiente_dian\": 2,
		\"version\": 2,
		\"identificador_transmision\": \"2019 validación previa\",
		\"integrador\": {
			\"nombre\": \"Afacturar.com\",
			\"tipo\": \"WEB\"
		}
	}
}"), "data");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

    Historico de cambios


    Versión Cambios Fecha de liberación
    2 Creación del API 19 de Julio de 2024