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

Nota credito

EndPoint


Método: POST

EndPoint:

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

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


Nota credito

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. Si no utiliza la variable prefijo por favor enviar un prefijo de nota credito, aconsejamos NC. Se debe tener en cuenta que el identificador de la nota credito es unico, no se debe repetir

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

Fecha de emisión de la nota credito debe ser igual a la fecha actual.

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

Código de tipo de operación

Especificación:

35= Nota de ajuste al documento Equivalente con referencia a un Doc Equivalente Tiquete de transporte de pasajeros Terrestre
tipo_nota_credito Parametrizado Requerido

Código de tipo de nota de crédito

Especificación:

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

2= Anulación del documento equivalente electrónico

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
prefijo String No_Requerido

Prefijo de la nota credito.

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

Datos del servicio de transporte

Especificación:

modo_transporte Parametrizado Requerido

Modo de transporte

Especificación:

TERRESTRE

lugar_origen String Requerido

Lugar de origen

Especificación: Minimo 2 caracteres
lugar_destino String Requerido

Lugar de destino

Especificación: Minimo 2 caracteres
hora_salida Hora Requerido

Hora de salida

Especificación: HH:MM
datos_vehiculo Array Requerido

Datos del vehiculo

Especificación:

codigo String Requerido

Identificador del vehiculo

Especificación: Minimo 2 caracteres
placa String Requerido

Placa del vehiculo

Especificación: Mínimo 2 caracteres.
tipo Parametrizado Requerido

Tipo de vehiculo

Especificación:

AUTOBUS

MICROBUS

BUS
informacion_documento Objeto Requerido

Información para referenciar el DE afectado por la Nota de ajuste

Especificación:

id_documento Parametrizado Requerido

Identificador del documento: Número del documento.

Especificación: Mínimo 1 caracteres
fecha Date Requerido

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

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

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

Especificación: HH24:MM:SS
codigo_unico_factura String Requerido

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

Especificación: Minimo de 18 caracteres
codigo_tipo_documento Parametrizado No_requerido

Código de tipo de documento al que se le va a realizar la nota credito

Especificación: Si es factura debe ir tipo de factura y si es nota debito el tipo de nota debito
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
cambio_de_moneda Objeto No_requerido

Cambio de moneda

Especificación:

fecha_cambio Date Requerido

Fecha del cambio de la moneda.

Especificación: 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
periodo_facturacion Objeto No_requerido

Periodo de facturación, aplica para notas credito sin referencia a factura

Especificación:

fecha_inicio Date Requerido

Fecha de inicio del periodo de facturación

Especificación: AAAA-MM-DD
fecha_fin Date Requerido

Fecha de fin del periodo de facturación

Especificación: AAAA-MM-DD
entrega_de_bienes Objeto No_requerido

Información para entrega de bienes

Especificación:

fecha_hora_entrega Date No_requerido

Fecha y hora de entrega de los bienes

Especificación: AAAA-MM-DDTHH:MM:SSZ
condicion_entrega Parametrizado Requerido

Condiciones de entrega

Especificación: Condiciones de entrega (INCOTERMS) Ver
metodo_pago_transporte String Requerido

Método de pago de costes de transporte: Se utilizar para indicar cómo se pagan los costes del transporte (por ejemplo, Portes Debidos, Portes Pagados) Puede ser un texto libre que entiendan el comprador y vendedor o codificarlo en una lista

Especificación:

direccion_entrega Objeto Requerido

Dirección de entrega

Especificación:

lenguaje_del_pais Parametrizado Requerido

Identificador del lenguaje utilizado en el nombre del país

Especificación: Para español, se utiliza el literal 'es', Ver el lstado ISO 6391 Ver
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
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
ciudad Parametrizado Requerido

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

Especificación: Inf adicional Ver
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
empresa_transportadora Objeto No_Requerido

Información sobre la empresa de transporte

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:

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

Especificación: String
razon_social String Requerido

Nombre comercial de la empresa de transporte

Especificación: Minimi 3 caracteres
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
lenguaje_del_pais Parametrizado Requerido

Identificador del lenguaje utilizado en el país

Especificación: Para español, se utiliza el literal 'es', Ver el lstado ISO 6391 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
ciudad Parametrizado Requerido

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

Especificación: Inf adicional Ver
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
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
detalles_tributarios Parametrizado Requerido

Codigo del detalles tributario de la empresa de transporte

Especificación:

01 = IVA

04 = INC

ZA = IVA E INC

ZZ = No aplica

contacto_transportador Objeto No_Requerido

Información del contacto del transportador

Especificación:

nombre_completo String Requerido

Nombre contacto

Especificación:

telefono_o_movil String Requerido

Número de teléfono, celular u otro

Especificación:

correo_electronico String Requerido

Correo electrónico de contacto

Especificación: Mínimo 3
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
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.

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
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. Para el caso de facturas por contratos de servicio tipo AIU en el item de administración se debe enviar la palabra clave 'ADMINISTRACION'

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

    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, 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
    retenciones_detalle Objeto No_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 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, dos 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, dos decimales
    valor_retenido String-patron Requerido

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

    Especificación: Separador con punto, dos decimales
    valores_unitarios Objeto No_requerido

    Información relacionada con el valor por producto de la linea de detalle, los datos recibidos son utilizados para la representación grafica cuando sea necesario

    Especificación:

    valor_impuesto_1 String-patron No_requerido

    Valor de la base imponible (IVA) del producto de la linea de detalle

    Especificación: Separador con punto, dos decimales
    valor_impuesto_2 String-patron No_requerido

    Valor de la base imponible (Impuesto al consumo) del producto de la linea de detalle

    Especificación: Separador con punto, dos decimales
    valor_impuesto_3 String-patron No_requerido

    Valor de la base imponible (ICA) del producto de la linea de detalle

    Especificación: Separador con punto, dos decimales
    valor_impuesto_4 String-patron No_requerido

    Valor de la base imponible (Impuesto nacional al consumo) del producto de la linea de detalle

    Especificación: Separador con punto, dos decimales
    valor_a_pagar String-patron No_requerido

    Valor total del producto de la linea de detalle, incluyendo descuentos, retenciónes e impuestos

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

    IDENTIFICACION_USUARIO => Para el caso del sector Salud

    NUMERO_AUTORIZACION => Para el caso del sector Salud

    CODIGO_PRESTADOR_SERVICIO => Para el caso del sector Salud

    Nombre de la variable definida por el cliente
    valor String Requerido

    Valor del elemento a informar

    Especificación:

    datos_remesa Objeto No_Requerido

    Datos correspondientes al sector transporte de carga registra en el RNDC, es decir la remesa. Cada remesa registrada en el RNDC debe estar asociada a una línea de la factura.

    Especificación:

    tipo_servicio Parametrizado Requerido

    Tipo de servicio relacionado

    Especificación:

    0 => Es un servicio adicional prestado que no está incluido en el flete de la remesa

    1 => Es una Remesa de transporte registrada en el RNDC
    numero_radicado_de_la_remesa String Requerido

    : Este es un consecutivo único nacional que controla el RNDC y que se le entrega a la empresa de transporte en señal de aceptación de que los datos enviados no tienen errores.

    Especificación:

    numero_de_remesa String Requerido

    Este es un consecutivo interno que lleva cada empresa de transporte. El RNDC no controla rangos. La empresa puede manejar prefijos.

    Especificación:

    valor_flete String-patron Requerido

    Es el valor del flete definido para la remesa.

    Especificación: Dato numérico sin decimales
    cantidad_transportada String-patron Requerido

    Cantidad entregada de la mercancía de la remesa

    Especificación: Dato numérico sin decimales
    unidad_medida Parametrizado Requerido

    Unidad de la cantidad trasnportada

    Especificación:

    KGM => Kilogramos

    GLL => Galones
    impuestos Objeto Requerido

    Información de la nota credito

    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 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
    retenciones Objeto Requerido

    Información de la nota credito

    Especificación:

    codigo Parametrizado No_requerido

    Identificador de las retenciónes

    Especificación:

    5= ReteIVA

    6= ReteFuente

    7= ReteICA

    0= No tiene retenciónes
    porcentaje Parametrizado

    		 No_requerido

    Importe del impuesto retenido al total de la factura

    Especificación: Separador con punto, dos decimales. Información adicional Ver
    valor_base String-patron No_requerido

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

    Especificación: Separador con punto, dos decimales
    valor_retenido String-patron No_requerido

    Valor total de la retención por factura

    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

    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, 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_impuesto_2 String-patron Requerido

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

    Especificación: Separador con punto, dos 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, dos 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, 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_retefuente String-patron No_requerido

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

    Especificación: Separador con punto, dos decimales
    valor_total_reteica String-patron No_requerido

    Suma de todos los reteica 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
    cambio_de_moneda_totales Objeto Requerido

    Valores totales de la nota credito en la conversión de la divisa

    Especificación:

    valor_base String-patron Requerido

    Conversión de la divisa del 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

    Conversión de la divisa del 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

    Conversión de la divisa del 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

    Conversión de la divisa del 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

    Conversión de la divisa del 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

    Conversión de la divisa del suma de todos los impuestos 1 aplicados a nivel de las lineas de detalle

    Especificación: Separador con punto, dos decimales
    valor_total_impuesto_2 String-patron Requerido

    Conversión de la divisa del suma de todos los impuestos 2 aplicados a nivel de las lineas de detalle

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

    Conversión de la divisa del suma de todos los impuestos 3 aplicados a nivel de las lineas de detalle

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

    Conversión de la divisa del suma de todos los impuestos 4 aplicados a nivel de las lineas de detalle

    Especificación: Separador con punto, dos decimales
    valor_total_reteiva String-patron No_requerido

    Conversión de la divisa del suma de todos los reteiva a nivel de las lineas de detalle

    Especificación: Separador con punto, dos decimales
    valor_total_retefuente String-patron No_requerido

    Conversión de la divisa del suma de todos los retefuente a nivel de las lineas de detalle

    Especificación: Separador con punto, dos decimales
    valor_total_reteica String-patron No_requerido

    Conversión de la divisa del suma de todos los reteica a nivel de las lineas de detalle

    Especificación: Separador con punto, dos decimales
    total_nota_credito String-patron Requerido

    Conversión de la divisa del total importe bruto +Total valor_impuestos

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

    Conversión de la divisa del 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

    Información de la nota credito

    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 si el tipo de archivo es HTML / PDF o PDF_PROPIO. Este último se usa cuando el pdf lo genera el obligado.

    Especificación: Si hay información en rg_base_64 debe ir HTML o PDF
    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
    x Numerico Requerido

    Posicionamiento en x dentro de la representación grafica

    Especificación: Coordenada en pixeles en x desde la posición (0,0)
    y 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
    x 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)
    y 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_operacion": "",
				"tipo_nota_credito": "",
				"numero_orden": "",
				"prefijo": ""
			},
			"servicio": {
				"modo_transporte": "",
				"lugar_origen": "",
				"lugar_destino": "",
				"hora_salida": "",
				"datos_vehiculo": {
					"codigo": "",
					"placa": "",
					"tipo": ""
				}
			},
			"informacion_documento": {
				"id_documento": "",
				"codigo_unico_documento": "",
				"fecha": "",
				"hora": "",
				"codigo_tipo_documento": ""
			},
			"formas_de_pago": [
				{
					"metodo_de_pago": "",
					"tipo_de_pago": "",
					"identificador_de_pago": "",
					"fecha_vencimiento": ""
				}
			],
			"cambio_de_moneda": {
				"fecha_cambio": "",
				"codigo": "",
				"valor_base_trm": ""
			},
			"entrega_de_bienes": {
				"fecha_hora_entrega": "",
				"condicion_entrega": "",
				"metodo_pago_transporte": "",
				"direccion_entrega": {
					"lenguaje_del_pais": "",
					"pais": "",
					"departamento": "",
					"ciudad": "",
					"direccion": ""
				},
				"empresa_transportadora": {
					"tipo_contribuyente": 0,
					"tipo_regimen": 0,
					"tipo_identificacion": 0,
					"identificacion": "",
					"razon_social": "",
					"lenguaje_del_pais": "",
					"pais": "",
					"departamento": "",
					"ciudad": "",
					"direccion": "",
					"resp_calidades_atributos": [
						""
					],
					"detalles_tributarios": ""
				},
				"contacto_transportador": {
					"nombre_completo": "",
					"telefono_o_movil": "",
					"correo_electronico": ""
				}
			},
			"informacion_adquiriente": {
				"tipo_contribuyente": "",
				"tipo_regimen": "",
				"tipo_identificacion": "",
				"identificacion": "",
				"correo_electronico": "",
				"numero_movil": "",
				"nombre": {
					"razon_social": "",
					"primer_nombre": "",
					"segundo_nombre": "",
					"apellido": ""
				},
				"pais": "",
				"nombre_pais": "",
				"departamento": "",
				"nombre_departamento": "",
				"zona": "",
				"ciudad": "",
				"nombre_ciudad": "",
				"direccion": "",
				"RUT": {
					"resp_calidades_atributos": [
						"",
						""
					],
					"usuario_aduanero": [
						""
					]
				}
			},
			"detalle_factura": [
				{
					"numero_linea": "",
					"cantidad": "",
					"unidad_de_cantidad": "",
					"valor_unitario": "",
					"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": ""
						}
					],
					"valores_unitarios": {
						"valor_impuesto_1": "",
						"valor_impuesto_2": "",
						"valor_impuesto_3": "",
						"valor_impuesto_4": "",
						"valor_a_pagar": ""
					},
					"valor_total_detalle_con_cargo_descuento": "",
					"valor_total_detalle": "",
					"informacion_adicional": [
						{
							"variable": "",
							"valor": ""
						}
					],
					"datos_remesa": {
						"tipo_servicio": "",
						"numero_radicado_de_la_remesa": "",
						"numero_de_remesa": "",
						"valor_flete": "",
						"cantidad_transportada": "",
						"unidad_medida": ""
					}
				}
			],
			"impuestos": [
				{
					"codigo_impuesto": "",
					"porcentaje_impuesto": "",
					"valor_base_calculo_impuesto": "",
					"valor_total_impuesto": ""
				}
			],
			"retenciones": [
				{
					"codigo": "",
					"porcentaje": "",
					"valor_base": "",
					"valor_retenido": ""
				}
			],
			"recargos": [
				{
					"nombre_recargo": "",
					"porcentaje_recargo": "",
					"valor_base_calculo_recargo": "",
					"valor_total_recargo": ""
				}
			],
			"descuentos": [
				{
					"codigo_descuento": "",
					"porcentaje_descuento": "",
					"valor_base_calculo_descuento": "",
					"valor_total_descuento": ""
				}
			],
			"valor_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_impuesto_2": "",
				"valor_total_impuesto_3": "",
				"valor_total_impuesto_4": "",
				"valor_total_reteiva": "",
				"valor_total_retefuente": "",
				"valor_total_reteica": "",
				"total_nota_credito": "",
				"valor_total_a_pagar": ""
			},
			"cambio_de_moneda_totales": {
				"valor_base": "",
				"valor_base_calculo_impuestos": "",
				"valor_base_mas_impuestos": "",
				"valor_anticipo": "",
				"valor_descuento_total": "",
				"valor_total_recargos": "",
				"valor_total_impuesto_1": "",
				"valor_total_impuesto_2": "",
				"valor_total_impuesto_3": "",
				"valor_total_impuesto_4": "",
				"valor_total_reteiva": "",
				"valor_total_retefuente": "",
				"valor_total_reteica": "",
				"total_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_nota_credito": "SETP990001502",
		"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
		"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
		"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
		"url_application_response": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ar083002047005520SETP990001502.xml",
		"url_attached_document_url": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ad083002047005520SETP990001502.xml",
		"url_representacion_grafica": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.pdf",
		"url_notificacion_aceptacion_rechazo": "http://app.afacturar.com/consulta_documento/?uid=5e5e5e5e5e55e"
	},
	"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
	"ErrorMessage_DIAN": ""
}

    Salida con errores de semantica

    
{
    "codigo_error": 400,
    "descripcion_error": "Hay un problema con la informacion entregada",
    "tiempo_ejecucion": 0.01330113410949707,
    "transaccion": "5e74ce82707f6",
    "resultado": [
        {
            "propiedad": "nota_credito[0].encabezado.tipo_nota_credito",
            "descripcion": "The property tipo_nota_credito is required"
        },
        {
            "propiedad": "nota_credito[0].encabezado.tipo_nota_credito",
            "descripcion": "Does not have a value in the enumeration [1,2,3,4,5,6]"
        },
        {
            "propiedad": "nota_credito[0].encabezado",
            "descripcion": "The property tipo_nota_credit is not defined and the definition does not allow additional properties"
        }
    ],
    "entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
    "ErrorMessage_DIAN": ""
}

    Salida con errores de datos

    
{
    "codigo_error": 400,
    "descripcion_error": "Hay problema(s) con la información entregada",
    "resultado": [
        [
            {
                "propiedad": "nota_credito->encabezado->fecha",
                "descripcion": "Fecha invalida"
            }
        ]
    ]
}

    Salida con errores HTTP

    
{
	"codigo_error": 500,
	"descripcion_error": "Unauthenticated."
}

    Salida con error de datos en la DIAN

    
{
    "codigo_error": 15,
    "descripcion_error": "La validación en la DIAN devuelve error(es)",
    "tiempo_ejecucion": 1.9776690006256104,
    "transaccion": "5e74d144dd565",
    "resultado": {
		"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
		"id_nota_credito": "SETP990001504",
        "url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
        "qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
        "url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
    },
    "entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
    "ErrorMessage_DIAN": "Regla: FAU06, Rechazo: Valor Bruto más tributos es diferente a Valor Bruto de la factura que contienen el valor comercial más la Suma de los Tributos de todas las líneas de detalle.Regla: FAU02, Rechazo: El Valor Bruto antes de tributos no es igual a la suma de los valores de las líneas de la factura que contienen el valor comercial"
}

    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.

    Nota credito ejemplos


    Ejemplo 1.

    {
	"nota_credito": [
		{
			"encabezado": {
				"id_nota_credito": "16",
				"fecha": "2024-07-26",
				"hora": "00:00:00",
				"nota": [
					"{'SON':'Cincuenta mil pesos'}"
				],
				"moneda": "COP",
				"tipo_operacion": 35,
				"tipo_nota_credito": 5,
				"numero_orden": "",
				"prefijo": ""
			},
			"servicio": {
				"modo_transporte": "TERRESTRE",
				"lugar_origen": "Bogota",
				"lugar_destino": "Chiquinquira",
				"hora_salida": "17:30",
				"datos_vehiculo": {
					"codigo": "2315",
					"placa": "EZN450",
					"tipo": "Bus servicio directo"
				}
			},
			"informacion_documento": {
				"id_documento": "14",
				"codigo_unico_documento": "2545a21554fa63351520932f2e27d1fa796e356d4dab5f9610fe5b00a4ceab8ed67f60222fa7bd6a73ce17de7d3ecdb1",
				"fecha": "2024-07-22",
				"hora": "00:00:00",
				"codigo_tipo_documento": 10
			},
			"informacion_adquiriente": {
				"tipo_contribuyente": 2,
				"tipo_regimen": 2,
				"tipo_identificacion": 13,
				"identificacion": "33700230",
				"correo_electronico": "acanon@teleinte.com",
				"numero_movil": "",
				"nombre": {
					"razon_social": "",
					"primer_nombre": "Nubia",
					"segundo_nombre": "Andrea",
					"apellido": "Cañón"
				},
				"pais": "CO",
				"departamento": "11",
				"ciudad": "11001",
				"zona": "",
				"direccion": "Carrera 10",
				"RUT": {
					"resp_calidades_atributos": [
						"R-99-PN"
					],
					"usuario_aduanero": [
						""
					]
				}
			},
			"formas_de_pago": [
				{
					"metodo_de_pago": 1,
					"tipo_de_pago": 41,
					"identificador_de_pago": "ABDC",
					"fecha_vencimiento": ""
				}
			],
			"detalle_factura": [
				{
					"numero_linea": 1,
					"cantidad": 2,
					"unidad_de_cantidad": "94",
					"valor_unitario": "25000.00",
					"descripcion": "Pasaje de Bogota - Chiquinquira",
					"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": "50000.00",
					"valor_total_detalle": "50000.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_nota_credito": {
				"valor_base": "50000.00",
				"valor_base_calculo_impuestos": "0.00",
				"valor_base_mas_impuestos": "50000.00",
				"valor_anticipo": "0.00",
				"valor_descuento_total": "0.00",
				"valor_total_recargos": "0.00",
				"valor_total_impuesto_1": "0.00",
				"valor_total_impuesto_2": "0.00",
				"valor_total_impuesto_3": "0.00",
				"valor_total_impuesto_4": "0.00",
				"valor_total_reteiva": "0.00",
				"valor_total_retefuente": "0.00",
				"valor_total_reteica": "0.00",
				"total_nota_credito": "50000.00",
				"valor_total_a_pagar": "50000.00"
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 2,
		"version": 2,
		"identificador_transmision": "20240529",
		"integrador": {
			"nombre": "Afacturar.com",
			"tipo": "WEB"
		},
		"integrador": {
			"nombre": "Afacturar.com",
			"tipo": "WEB"
		},
		"fabricante_software": {
			"nombre_apellido": "Ricardo Albornoz",
			"razon_social": "Teleinte S.A.S",
			"nombre_software": "Afacturar.com"
		}
	}
}

    Consumo del API


    CURL

    								curl --location 'https://servicios-pruebas.afacturar.com/api/doc_equivalente/TAP/nota_credito' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer TOKEN_OBLIGADO' \
--form 'documento_obligado="830020470"' \
--form 'data="{
	\"nota_credito\": [
		{
			\"encabezado\": {
				\"id_nota_credito\": \"1\",
				\"fecha\": \"2024-10-03\",
				\"hora\": \"13:25:00\",
				\"nota\": [],
				\"moneda\": \"COP\",
				\"tipo_operacion\": 50,
				\"tipo_nota_credito\": 5,
				\"numero_orden\": \"\",
				\"prefijo\": \"NC\"
			},
			\"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\"
						}
					],
					\"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_documento\": {
				\"id_documento\": \"3\",
				\"codigo_unico_documento\": \"5e9e9ec6f5f8681cc88b4f18006f0ae0e33d4e2be15be6d50de1d3430063c0860008e874b97fbaad09e5555d539764fb\",
				\"fecha\": \"2024-09-16\",
				\"hora\": \"00:00:00\",
				\"codigo_tipo_documento\": 10
			},
			\"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_nota_credito\": {
				\"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_nota_credito\": \"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\"
		}
	}
}"'

    C#

    								var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://servicios-pruebas.afacturar.com/api/doc_equivalente/TAP/nota_credito");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer TOKEN_OBLIGADO");
var content = new MultipartFormDataContent();
content.Add(new StringContent("830020470"), "documento_obligado");
content.Add(new StringContent("{
	\"nota_credito\": [
		{
			\"encabezado\": {
				\"id_nota_credito\": \"1\",
				\"fecha\": \"2024-10-03\",
				\"hora\": \"13:25:00\",
				\"nota\": [],
				\"moneda\": \"COP\",
				\"tipo_operacion\": 50,
				\"tipo_nota_credito\": 5,
				\"numero_orden\": \"\",
				\"prefijo\": \"NC\"
			},
			\"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\"
						}
					],
					\"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_documento\": {
				\"id_documento\": \"3\",
				\"codigo_unico_documento\": \"5e9e9ec6f5f8681cc88b4f18006f0ae0e33d4e2be15be6d50de1d3430063c0860008e874b97fbaad09e5555d539764fb\",
				\"fecha\": \"2024-09-16\",
				\"hora\": \"00:00:00\",
				\"codigo_tipo_documento\": 10
			},
			\"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_nota_credito\": {
				\"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_nota_credito\": \"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\"
		}
	}
}"), "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
    2 Creación API 04 de Octubre de 2024