API Facturación Electrónica
  • Introducción
  • Cuotas y límites
  • Primeros Pasos
    • Consideraciones Importantes
    • Manual Operativo de la Plataforma
    • Generar X-API-KEY
    • Librerías
    • Estructura de los datos
      • Listas de códigos
        • Responsable de
        • Campos generales (Facturas, notas)
        • Códigos de moneda
        • Códigos de forma de pago
        • Códigos de actividades económicas
        • Códigos de país
        • Códigos de región
        • Códigos de ciudad
        • Códigos de unidades de medida
      • Factura
      • Documento soporte
      • Nota débito
      • Nota crédito
      • Nota de ajuste
    • Formatos PDF
  • Errores y rechazos
    • Códigos de rechazo y advertencia de la DIAN
      • Factura
      • Nota débito
      • Nota crédito
    • Errores comunes
  • Modo Pruebas
    • Facturas
      • Enviar factura en modo pruebas
    • Notas débito
      • Enviar nota débito en modo pruebas
    • Notas crédito
      • Enviar nota crédito en modo pruebas
    • Documento soporte
      • Enviar documento soporte en modo pruebas
    • Nota de ajuste
      • Enviar nota de ajuste en modo pruebas
  • Modo Habilitación
    • Facturas
      • Enviar factura para set de pruebas
    • Notas débito
      • Enviar nota débito para set de pruebas
    • Notas crédito
      • Enviar nota crédito para set de pruebas
  • Modo Producción
    • Facturas
      • Enviar factura
    • Notas débito
      • Enviar nota débito
    • Notas crédito
      • Enviar nota crédito
    • Documento soporte
      • Enviar documento soporte
    • Nota de ajuste
      • Enviar nota de ajuste
    • Resoluciones
      • Consultar resoluciones
  • Archivo Plano (.CSV)
    • Consideraciones sobre el archivo plano
    • Estructura del archivo plano
      • Factura
      • Nota débito
      • Nota crédito
    • Importar archivo plano
Con tecnología de GitBook
En esta página
  • Encabezado
  • Detalle

¿Te fue útil?

  1. Archivo Plano (.CSV)
  2. Estructura del archivo plano

Nota crédito

La estructura del archivo plano para una nota crédito es la siguiente:

Encabezado

Campo

Descripción

Códigos

Tipo

Este campo es requerido

Ancho del campo

1.Tipo registro

Debe ir "INC" para indicar que es el encabezado de una nota crédito

Cadena de caracteres

Si

3

2.Concepto nota crédito

Concepto nota crédito

Cadena de caracteres

Si

2

3.Formato pdf documento

Formato pdf documento

Cadena de caracteres

Si

4.Prefijo nota crédito

Campo (obsoleto) dejar vacío

Cadena de caracteres

Si

5.Consecutivo nota crédito

Campo (obsoleto) no se debe diligenciar, debes llenar el prefijo de resolución para asignar prefijo a la nota

Numérico

Si

6.Número externo de las factura

Consecutivo factura

Numérico

No

7.Tipo moneda

Código tipo de moneda

Cadena de caracteres

No

3

8.TRM del día cuando la factura es en moneda extranjera

TRM de los valores factura

Numérico

No

3

9.Fecha de expedición de la nota crédito

Fecha en que expidió la nota crédito, formato yyyy-MM-dd (2010-01-31)

Fecha

Si

10

10.Fecha inicial del periodo de facturación

Fecha inicio en que se inició el periodo a facturar, formato yyyy-MM-dd (2010-01-31)

Fecha

No

10

11.Fecha final del periodo de facturación

Fecha fin en que se finaliza el periodo a facturar, formato yyyy-MM-dd (2010-01-31)

Fecha

No

10

12.Tipo de operación

Tipo de operación

Cadena de caracteres

Si

2

13.Términos y condiciones

Términos y condiciones del documento

Cadena de caracteres

No

800

14.Pie de página

Pie de página

Cadena de caracteres

No

800

15.Nota / Observación

Notas u observaciones del documento

Cadena de caracteres

No

800

16.(Factura) Prefijo de la factura

Prefijo de la factura a la cual se le esta realizando la nota crédito

Cadena de caracteres

No

17.(Factura) Consecutivo de la factura

Consecutivo de la factura a la cual se le esta realizando la nota crédito

Cadena de caracteres

No

18.(Factura) Cufe de la factura

Cufe de la factura

Cadena de caracteres

No

19.(Factura) Fecha de la factura

Fecha de la factura, formato yyyy-MM-dd (2010-01-31)

Cadena de caracteres

No

20.(Sucursal) Nombre

Nombre de la sucursal para sobrescribir los datos de la empresa

Cadena de caracteres

No

21.(Sucursal) Dirección

Dirección de la sucursal para sobrescribir los datos de la empresa

Cadena de caracteres

No

22.(Sucursal) Teléfono

Teléfono de la sucursal para sobrescribir los datos de la empresa

Cadena de caracteres

No

23.(Sucursal) Código país

Código país de la sucursal para sobrescribir los datos de la empresa

Cadena de caracteres

No

24.(Sucursal) Nombre país

Nombre país de la sucursal para sobrescribir los datos de la empresa

Cadena de caracteres

No

25.(Sucursal) Código departamento

Código departamento de la sucursal para sobrescribir los datos de la empresa

Cadena de caracteres

No

26.(Sucursal) Nombre departamento

Nombre departamento de la sucursal para sobrescribir los datos de la empresa

Cadena de caracteres

No

27.(Sucursal) Código ciudad

Código ciudad de la sucursal para sobrescribir los datos de la empresa

Cadena de caracteres

No

28.(Sucursal) Nombre ciudad

Nombre ciudad de la sucursal para sobrescribir los datos de la empresa

Cadena de caracteres

No

29.(Resolución) Clave de la resolución

Llave de la resolución proporcionada por la DIAN

Cadena de caracteres

Si

30.(Resolución) Prefijo de la resolución

Prefijo con el que va a quedar la nota crédito

Cadena de caracteres

Si

31.(Resolución) Número de la resolución

Número de la resolución proporcionado por DIAN

Numérico

Si

32.(Resolución) Rango inicial de facturación

Rango inicial de facturación habilitado

Numérico

Si

33.(Resolución) Rango final de facturación

Rango final de facturación habilitado

Numérico

Si

34.(Resolución) Fecha inicial de validación de facturación

Fecha inicial de de validación de facturación, formato yyyy-MM-dd (2010-01-31)

Fecha

Si

35.(Resolución) Fecha final de validación de facturación

Fecha final de de validación de facturación, formato yyyy-MM-dd (2010-01-31)

Fecha

Si

36.(Cliente) Razón social o nombre completo

Razón social o nombre completo

Cadena de caracteres

Si

37.(Cliente) Tipo persona

Tipo persona

Cadena de caracteres

Si

1

38.(Cliente) Tipo de régimen

Tipo de régimen

Cadena de caracteres

Si

2

39.(Cliente) Nombres

Nombres

Cadena de caracteres

Si

40.(Cliente) Apellidos

Apellidos

Cadena de caracteres

No

41.(Cliente) Número documento identificación

Número documento identificación

Cadena de caracteres

Si

42.(Cliente) Dígito de verificación

Dígito de verificación

Cadena de caracteres

Si

43.(Cliente) Tipo de identificación

Tipo de identificación

Cadena de caracteres

Si

2

44.(Cliente) Email/correo electrónico

Email/correo electrónico

Cadena de caracteres

No

45.(Cliente) Teléfono

Teléfono

Cadena de caracteres

No

46.(Cliente) Registro mercantil

Registro mercantil

Cadena de caracteres

No

47.(Cliente) Responsabilidades fiscales

Responsabilidades fiscales

Cadena de caracteres

Si

48.(Cliente-Facturación) Dirección

(Facturación) Dirección facturación

Cadena de caracteres

Si

49.(Cliente-Facturación) Nombre del país

(Facturación) Nombre del país facturación

Cadena de caracteres

Si

50.(Cliente-Facturación) Código del país

(Facturación) Código del país

Cadena de caracteres

Si

2

51.(Cliente-Facturación) Nombre de la región

(Facturación) Nombre del departamento

Cadena de caracteres

Si

52.(Cliente-Facturación) Código de la región

(Facturación) Código del departamento

Cadena de caracteres

No

2

53.(Cliente-Facturación) Nombre de la ciudad

(Facturación) Nombre del municipio

Cadena de caracteres

Si

54.(Cliente-Facturación) Código de la ciudad

(Facturación) Código del municipio

Cadena de caracteres

No

5

55.(Cliente-Facturación) Código postal

(Facturación) Código postal

Cadena de caracteres

No

56.(Cliente-Facturación) Barrio

(Facturación) Barrio

Cadena de caracteres

No

57.(Cliente-Facturacion) Telefono

(Facturación) Teléfono

Cadena de caracteres

No

58.(Cliente-Facturacion) Nombre contacto

(Facturación) Nombre Contacto

Cadena de caractere

No

59.(Cliente-Datos-Entrega) Dirección

(Datos-Entrega) Dirección facturación

Cadena de caracteres

Si

60.(Cliente-Datos-Entrega) Nombre del país

(Datos-Entrega) Nombre del país facturación

Cadena de caracteres

Si

61.(Cliente-Datos-Entrega) Código del país

(Datos-Entrega) Código del país

Cadena de caracteres

Si

2

62.(Cliente-Datos-Entrega) Nombre de la región

(Datos-Entrega) Nombre del departamento

Cadena de caracteres

Si

63.(Cliente-Datos-Entrega) Código de la región

(Datos-Entrega) Código del departamento

Cadena de caracteres

No

2

64.(Cliente-Datos-Entrega) Nombre de la ciudad

(Datos-Entrega) Nombre del municipio

Cadena de caracteres

Si

65.(Cliente-Datos-Entrega) Código de la ciudad

(Datos-Entrega) Código del municipio

Cadena de caracteres

No

5

66.(Cliente-Datos-Entrega) Código postal

(Datos-Entrega) Código postal

Cadena de caracteres

No

67.(Cliente-Datos-Entrega) Barrio

(Datos-Entrega) Barrio

Cadena de caracteres

No

68.(Cliente-Datos-Entrega) Teléfono

Teléfono de entrega

Cadena de caracteres

No

69.(Cliente-Datos-Entrega) Nombre contacto

Contacto para entrega al cliente

Cadena de caracteres

No

70.(Total) Subtotal sin impuestos ni retenciones

Subtotal sin impuestos ni retenciones

Numérico

Si

71.(Total) Anticipos

Anticipos

Numérico

Si

72.(Total) impuestos

Impuestos

Numérico

Si

73.(Total) Retenciones

Retenciones

Numérico

Si

Detalle

Campo

Descripción

Códigos

Tipo

Este campo es requerido

Ancho del campo

1.Tipo registro

Debe ir "DTL" para indicar que es un detalle de factura

Cadena de caracteres

Si

3

2.Código ítem

Indique el código del ítem, producto o servicio que esta facturando

Cadena de caracteres

Si

3.Nombre servicio/producto

Nombre servicio/producto que esta facturando

Cadena de caracteres

Si

4.Modelo del producto o servicio

Modelo del producto o servicio que esta facturando

Cadena de caracteres

No

5.Descripción de la venta

Descripción de la venta

Cadena de caracteres

No

6.Marca del producto o servicio

Marca del producto o servicio

Cadena de caracteres

No

7.Código del producto colocado por el proveedor

Código del producto colocado por el proveedor

Cadena de caracteres

No

8.Es un regalo

Es un regalo

Booleano

Si

9.Precio unitario

Precio unitario

Numérico

Si

10.Cantidad

Cantidad

Numérico

Si

11.Valor total de los descuentos aplicados

Valor total de los descuentos aplicados

Numérico

No

12.Valor total de los cargos aplicados

Valor total de los cargos aplicados

Numérico

No

13.(Descuento) Tipo valor

Tipo valor

Cadena de caracteres

Si

1

14.(Descuento) Tarifa

Tarifa

Numérico

Si

15.(Descuento) Valor

Valor

Numérico

Si

16.(Cargos) Tipo valor

Tipo valor

Cadena de caracteres

Si

1

17.(Cargos) Tarifa

Tarifa, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual.

Numérico

Si

18.(Cargos) Valor

Valor, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual

Numérico

Si

19.Impuestos

Lista de impuestos separados por barra vertical "|" y valores separados por dos puntos ":", de la siguiente forma "Tipo Valor:Código impuesto: Tarifa impuesto:Valor Impuesto" Ejemplo: P:01:Iva:19:19000, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual, para el tipo de valor están las siguientes opciones: "V": Valor, "P": Porcentaje, "M": Por mil

Numérico

No

20.Retenciones

Lista de retenciones separados por barra vertical "|" y valores separados por dos puntos ":", de la siguiente forma "Tipo Valor:Código impuesto: Tarifa impuesto:Valor Impuesto" Ejemplo: P:01:ReteIva:2:2000, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual, para el tipo de valor están las siguientes opciones: "V": Valor, "P": Porcentaje, "M": Por mil

Numérico

No

21.(Mandante) Nombre

Nombre del mandante

Cadena de caracteres

No

22.(Mandante) Identificación

Identificación

Cadena de caracteres

No

23.(Mandante) Dígito de verificación

Dígito de verificación

Cadena de caracteres

No

24.(Mandante) Tipo de identificación

Tipo de identificación

Cadena de caracteres

No

AnteriorNota débitoSiguienteImportar archivo plano

Última actualización hace 1 año

¿Te fue útil?

Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos
Ver códigos