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

Factura

La estructura del archivo plano para crear una factura es la siguiente:

Encabezado

Número de columna y nombre del campo

Descripción

Códigos

Tipo

Este campo es requerido

Ancho del campo

1.Tipo registro

Debe ir "INV" para indicar que es el encabezado de una factura

Cadena de caracteres

Si

3

2.Tipo de documento factura DIAN

Código del tipo de factura

Cadena de caracteres

Si

2

3.Formato pdf documento

Formato pdf documento

Cadena de caracteres

Si

4.Consecutivo factura

Consecutivo factura

Numérico

Si

5.Número externo de las factura

Consecutivo factura

Númerico

6.Tipo moneda

Código tipo de moneda

Cadena de caracteres

3

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

TRM de los valores factura

Numérico

3

8.Fecha de expedición de la factura

Fecha en que expidió la factura, formato yyyy-MM-dd (2010-01-31)

Fecha

Si

10

9.Fecha de vencimiento de la factura

Fecha en que se vence la factura, formato yyyy-MM-dd (2010-01-31)

Fecha

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

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

10

12.Tipo de operación

Tipo de operación

Cadena de caracteres

Si

2

13.Código de condición de entrega

Código de condición de entrega, Es requerido cuando el tipo se llena el tipo de operación y el tipo de documento factura DIAN es igual a "02":"Factura de exportación"

Cadena de caracteres

3

14.Términos y condiciones

Términos y condiciones del documento

Cadena de caracteres

800

15.Pie de página

Pie de página

Cadena de caracteres

800

16.Nota / Observación

Notas u observaciones del documento

Cadena de caracteres

800

17.Días termino de pago

Días termino de pago

Numérico

18.(Sucursal) Nombre

Nombre de la sucursal para sobrescribir los datos de la empresa

Cadena de caracteres

19.(Sucursal) Dirección

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

Cadena de caracteres

20.(Sucursal) Teléfono

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

Cadena de caracteres

21.(Sucursal) Código país

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

Cadena de caracteres

22.(Sucursal) Nombre país

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

Cadena de caracteres

23.(Sucursal) Código departamento

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

Cadena de caracteres

24.(Sucursal) Nombre departamento

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

Cadena de caracteres

25.(Sucursal) Código ciudad

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

Cadena de caracteres

26.(Sucursal) Nombre ciudad

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

Cadena de caracteres

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

Llave de la resolución proporcionada por la DIAN

Cadena de caracteres

Si

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

Prefijo de facturación

Cadena de caracteres

Si

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

Número de la resolución proporcionado por DIAN

Numérico

Si

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

Rango inicial de facturación habilitado

Numérico

Si

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

Rango final de facturación habilitado

Numérico

Si

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

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

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

Razón social o nombre completo

Cadena de caracteres

Si

35.(Cliente) Tipo persona

Tipo persona

Cadena de caracteres

Si

1

36.(Cliente) Tipo de régimen

Tipo de régimen

Cadena de caracteres

Si

2

37.(Cliente) Nombres

Nombres

Cadena de caracteres

Si

38.(Cliente) Apellidos

Apellidos

Cadena de caracteres

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

Número documento identificación

Cadena de caracteres

Si

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

Dígito de verificación

Cadena de caracteres

Si

41.(Cliente) Tipo de identificación

Tipo de identificación

Cadena de caracteres

Si

2

42.(Cliente) Email/correo electrónico

Email/correo electrónico

Cadena de caracteres

43.(Cliente) Teléfono

Teléfono

Cadena de caracteres

44.(Cliente) Registro mercantil

Registro mercantil

Cadena de caracteres

45.(Cliente) Responsabilidades fiscales

Responsabilidades fiscales

Cadena de caracteres

Si

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

(Facturación) Dirección facturación

Cadena de caracteres

Si

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

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

Cadena de caracteres

Si

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

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

Cadena de caracteres

Si

2

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

(Facturación) Nombre del departamento

Cadena de caracteres

Si

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

(Facturación) Código del departamento

Cadena de caracteres

2

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

(Facturación) Nombre del municipio

Cadena de caracteres

Si

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

(Facturación) Código del municipio

Cadena de caracteres

5

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

(Facturación) Código postal

Cadena de caracteres

54.(Cliente-Facturación) Barrio

(Facturación) Barrio

Cadena de caracteres

55.(Cliente-Facturación) Teléfono

(Facturación) Teléfono

Cadena de caracteres

56.(Cliente-Facturación) Nombre contacto

(Facturación) Nombre contacto

Cadena de caracteres

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

(Datos-Entrega) Dirección facturación

Cadena de caracteres

Si

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

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

Cadena de caracteres

Si

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

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

Cadena de caracteres

Si

2

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

(Datos-Entrega) Nombre del departamento

Cadena de caracteres

Si

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

(Datos-Entrega) Código del departamento

Cadena de caracteres

2

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

(Datos-Entrega) Nombre del municipio

Cadena de caracteres

Si

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

(Datos-Entrega) Código del municipio

Cadena de caracteres

5

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

(Datos-Entrega) Código postal

Cadena de caracteres

65.(Cliente-Datos-Entrega) Barrio

(Datos-Entrega) Barrio

Cadena de caracteres

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

(Datos-Entrega) Teléfono

Cadena de caracteres

67.(Cliente-Datos-Entrega) Nombre contacto

(Datos-Entrega) Nombre contacto

Cadena de caracteres

68.(Total) Subtotal sin impuestos ni retenciones

Subtotal sin impuestos ni retenciones

Numérico

Si

69.(Total) Anticipos

Anticipos

Numérico

Si

70.(Total) impuestos

Impuestos

Numérico

Si

71.(Total) Retenciones

Retenciones

Numérico

Si

72.Medio de pago

Medio de pago

Cadena de caracteres

Detalle

Número de columna y nombre del 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

5.Descripción de la venta

Descripción de la venta

Cadena de caracteres

6.Marca del producto o servicio

Marca del producto o servicio

Cadena de caracteres

7.Código del producto colocado por el proveedor

Código del producto colocado por el proveedor

Cadena de caracteres

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

12.Valor total de los cargos aplicados

Valor total de los cargos aplicados

Numérico

13.(Descuento) Tipo valor

Tipo valor

Cadena de caracteres

1

14.(Descuento) Tarifa

Tarifa

Numérico

15.(Descuento) Valor

Valor

Numérico

16.(Cargos) Tipo valor

Tipo valor

Cadena de caracteres

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

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

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

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

21.(Mandante) Nombre

Nombre del mandante

Cadena de caracteres

22.(Mandante) Identificación

Identificación

Cadena de caracteres

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

Dígito de verificación

Cadena de caracteres

24.(Mandante) Tipo de identificación

Tipo de identificación

Cadena de caracteres

25.Tipo de código estándar DIAN

Tipo de código estándar DIAN

Cadena de caracteres

26.Código estándar DIAN

Código estándar DIAN

Cadena de caracteres

AnteriorEstructura del archivo planoSiguienteNota débito

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