1. estructura-del-archivo-plano
APIs Rest de Aliaddo
  • API Nitro (Facturacón Masiva)
    • Introducción
    • Autenticación
    • Códigos de respuesta de la API
    • Facturas electrónicas
      • Crear factura electrónica
      • Crear factura sector salud
      • Crear factura divisas
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Documentos soporte
      • Crear documento soporte
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Documentos equivalentes
      • Crear tiquete P.O.S
      • Crear tiquete de transporte terrestre
      • Crear tiquete de cine
      • Crear tiquete de cobro de peajes
      • Crear tiquete aereo
      • Crear boleta de ingreso a espectáculos públicos
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Notas crédito
      • Crear nota crédito
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Notas débito
      • Crear nota débito
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Nota crédito al documento equivalente
      • Crear nota crédito al documento equivalente
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Nota débito al documento equivalente
      • Crear nota débito al documento equivalente
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Nota de ajuste al documento soporte
      • Crear nota de ajuste
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Lista de valores
      • Actividades económicas
      • Ciudades
      • Códigos de monedas
      • Código estandar del producto
      • Condiciones de entrega (INCOTERMS)
      • Departamentos
      • Medios de pagos
      • Paises
      • Responsabilidades fiscales
      • Tipos de identificacion
      • Tipos de documentos electrónicos
      • Tipos de operación
      • Tipos de persona
      • Tipos de regimen
      • Tributos (Impuestos/Retenciones)
      • Unidades de cantidad
      • Responsable de impuestos
      • Códigos Postales de Colombia
    • Estructura de datos
      • Ancho del PDF
      • Descuentos y cargos
      • Direcciones del cliente
      • Documentos equivalentes
      • Extensiones de facturas
      • Factura electrónica de venta
      • Factura electrónica sector salud
      • Factura electrónica de venta y compra de divisas
      • Formatos permitidos PDF
      • ID set de pruebas DIAN
      • Modo contingencia
      • Modos de ambiente de facturación
      • Notas de ajuste débito y crédito al documento equivalente
      • Notas crédito y débito de factura electrónica de venta
    • Guía para importar archivos
      • Introducción
  • API ERP Cloud
    • Autenticación
    • Respuestas API
    • Límite de request
    • VENTAS
      • Facturas
        • Crear factura de venta
        • Consultar facturas
        • Consultar una factura
        • Editar factura de venta
        • Pagar factura
        • Anular una factura
      • Cotizaciones
        • Crear cotización
        • Consultar cotizaciones
        • Consultar una cotización
        • Editar cotización
        • Anular cotización
      • Ordenes de Venta
        • Crear orden de venta
        • Consultar ordenes de venta
        • Consultar una orden de venta
        • Editar orden de venta
        • Anular orden de venta
      • Remisiones
        • Crear remisión
        • Consultar remisiones
        • Consultar una remisión
        • Editar remisión
        • Anular remisión
    • COMPRAS
      • Facturas de compra
        • Consultar una factura
        • Editar factura
        • Anular una factura
        • Consultar facturas
        • Pagar factura de compra
        • Crear factura
    • Contactos
      • Consultar los contactos
      • Crear contacto
      • Eliminar un contacto
      • Consultar un contacto
      • Editar contacto
    • Productos
      • Consultar un producto
      • Eliminar un producto
      • Editar un producto
      • Crear un producto
      • Consultar los productos
      • Consultar categorías
      • Consultar unidades de medidas
      • Consultar listas de precios
      • Consultar stock
    • Bodegas
      • Consultar bodegas
    • Contabilidad
      • Consultar tipos de comprobantes
      • Crear asiento contable
      • Consultar asientos contables
      • Anular asiento contable
      • Consultar cuentas contables
      • Consultar un asiento contable
      • Consultar cuentas contables por código
      • Consultar tipos de comprobantes por código
    • Centros de costo
      • Consultar centros de costos
    • Impuestos
      • Consultar un impuesto
      • Consultar los impuestos
      • Editar impuesto
      • Crear impuesto
      • Eliminar un impuesto
    • Retenciones
      • Consultar las retenciones
      • Crear retención
      • Eliminar una retención
      • Editar retención
    • Sucursales
      • Consultar sucursales
    • Vendedores
      • Lista de vendedores
    • Usuarios
      • Consultar usuarios
    • CRM
      • Deals
        • Crear negocio
        • Consultar negocios
        • Editar negocio
        • Eliminar un negocio
      • Leads
        • Consultar Leads
        • Crear lead
        • Consultar etapas del ciclo de vida
        • Editar lead
        • Eliminar lead
      • Territorios
        • Consultar territorios
      • Pipelines
        • Consultar procesos
        • Consultar etapas de un proceso
      • Fuentes
        • Consultar fuentes
      • Activities
        • Crear actividad
        • Consultar actividades
        • Consultar actividades
        • Editar actividad
        • Eliminar actividad
      • Consultar propietarios
  • APIs Heredadas (Legacy)
    • API FE de primera generación
      • Introducción
      • Cuotas y Límites
      • Primeros Pasos
        • Consideraciones Importantes
        • Manual Operativo de la Plataforma
        • Generar X-API-KEY
        • Librerías
        • Formatos PDF
        • Diccionario de Datos
          • Sobre el Diccionario de Datos
          • Factura
          • Nota Crédito
          • Nota Débito
          • Documento Soporte
          • Nota de Ajuste
          • Listas de Códigos
            • Sobre las Listas de Códigos
            • Códigos de Factura
            • Códigos de Nota Crédito
            • Códigos de Nota Débito
            • Códigos de Actividades Económicas
            • Códigos de Ciudad
            • Códigos de Forma de Pago
            • Códigos de Moneda
            • Códigos de País
            • Códigos de Región
            • Códigos de Unidades de Medida
            • Códigos de Responsabilidad Fiscal
      • Errores y Rechazos
        • Errores Comunes
        • Códigos de Rechazo y Advertencia de la DIAN
          • Códigos de Rechazo y Advertencia de la DIAN
          • Rechazos de Factura
          • Rechazos de Nota Crédito
          • Rechazos de Nota Débito
      • Modo Pruebas
        • Enviar Factura a Pruebas
        • Enviar Nota Crédito a Pruebas
        • Enviar Nota Débito a Pruebas
        • Enviar Documento Soporte a Pruebas
        • Enviar Nota de Ajuste a Pruebas
      • Modo Habilitacion
        • Enviar Factura para Habilitación
        • Enviar Nota Crédito para Habilitación
        • Enviar Nota Débito para Habilitación
      • produccion
        • Documento sin título
        • Documento sin título
        • Documento sin título
        • Documento sin título
        • Documento sin título
      • archivo-plano.csv
        • Importar archivo plano
        • Consideraciones sobre el archivo plano
        • estructura-del-archivo-plano
          • Factura
          • Nota crédito
          • Nota débito
          • Estructura del archivo plano
    • API Nómina de primera generación
      • Table of contents
      • Cuotas y límites
      • Introducción
      • primeros-pasos
        • Documento sin título
        • estructura-de-los-datos
          • Documento sin título
          • Documento sin título
          • Documento sin título
          • Estructura de los datos
          • listas-de-codigos
            • Códigos de ciudad
            • Códigos de moneda
            • Códigos de municipio
            • Códigos de país
            • Códigos de departamento
            • Documento de identificación
            • Medios de pago
            • Periodo de Nómina
            • Listas de códigos
            • Subtipo de Trabajador
            • Tipo de contrato
            • Tipo de Hora Extra o Recargo: Porcentaje
            • Tipo de Incapacidad
            • Tipo de trabajador
      • modo-produccion
        • reemplazar-nomina
          • Enviar reemplazo de nómina para producción
          • Reemplazar Nómina
        • enviar-nomina
          • Enviar documento para producción
          • Enviar Nómina
        • eliminar-nomina
          • Eliminación de nómina para producción
          • Eliminar Nómina
      • modo-habilitacion
        • untitled-1
          • Enviar reemplazo de nómina en habilitación
          • Reemplazar Nómina
        • enviar-nomina
          • Enviar documento para habilitación
          • Enviar Nómina
        • eliminar-nomina
          • Eliminación de nómina en habilitación
          • Eliminar Nómina
      • modo-pruebas
        • untitled
          • Enviar documento para pruebas
          • Enviar Nómina
        • reemplazar-nomina
          • Enviar reemplazo de nómina para pruebas
          • Reemplazar Nómina
        • eliminar-nomina
          • Eliminación de nómina para pruebas
          • Eliminar Nómina
  • Schemas
    • Documentos electrónicos
      • FacturaElectronica
      • Divisas
      • DocumentoSoporteRequest
      • DocumentoEquivalenteRequest
      • BoletaEspectaculosRequest
    • Schemas ERP Cloud API
    • ISV Legacy
      • Factura Electrónica
      • Sucursal
      • Resolución
      • Cliente
      • Detalle
      • Descuentos
      • Cargos
      • Impuestos
      • Retenciones
      • Mandante
      • Total
      • Campos Personalizados
      • Nota Crédito
      • Nota Débito
      • Documento Soporte
      • Nota de Ajuste
      • Proveedor
    • Impuestos
    • Mandante
    • Retencioness
    • Resolución Pos
    • FacturaRequestPOS
    • FacturaRequest
    • Supplier
    • Dirección
    • Resolución
    • Cliente
    • Productos
    • LineaProductoPeaje
    • Totales
    • SectorSalud
    • Transporte
    • Sucursal
    • RequestResponse
    • Cinema
    • TikectAereo
    • EspectaculoPublico
    • ComprayVentaDeDivisas
    • Retenciones
    • Descuento
    • Propinas
    • Cargos
    • Supplier2
    • NotasCred/Deb/Ajus
  1. estructura-del-archivo-plano

Nota débito

La estructura del archivo plano para crear una nota débito es la siguiente:

Encabezado#

Número de la columna y nombre del campoDescripciónCódigosTipoEste campo es requeridoAncho del campo
Número de la columna y nombre del campoDescripciónCódigosTipoEste campo es requeridoAncho del campo
1.Tipo registroDebe ir "IND" para indicar que es el encabezado de una nota débitoCadena de caracteresSi3
2.Concepto nota débitoConcepto nota débitoVer códigosCadena de caracteresSi2
3.Formato pdf documentoFormato pdf documentoVer códigosCadena de caracteresSi
4.Prefijo nota débitoCampo (obsoleto) no se debe diligenciar, debes llenar el prefijo de resolución para asignar prefijo a la notaCadena de caracteresSi
5.Consecutivo nota débitoConsecutivo nota débitoNuméricoSi
6.Número externo de las facturas (Orden de compra)Consecutivo facturaNuméricoNo
7.Tipo monedaCódigo tipo de monedaVer códigosCadena de caracteresNo3
8.TRM del día cuando la factura es en moneda extranjeraTRM de los valores facturaNuméricoNo3
9.Fecha de la nota débitoFecha en que expidió la nota débito, formato yyyy-MM-dd (2010-01-31)FechaSi10
10.Fecha inicial del periodo de facturaciónFecha incio en que se inició el periodo a facturar, formato yyyy-MM-dd (2010-01-31)FechaNo10
11.Fecha final del periodo de facturaciónFecha fin en que se finaliza el periodo a facturar, formato yyyy-MM-dd (2010-01-31)FechaNo10
12.Tipo de operaciónTipo de operaciónVer códigosCadena de caracteresSi2
13.Terminos y condicionesTerminos y condiciones del documentoCadena de caracteresNo800
14.Pie de páginaPie de páginaCadena de caracteresNo800
15.Nota / ObservaciónNotas u observaciones del documentoCadena de caracteresNo800
16.(Factura) Prefijo de la facturaPrefijo de la factura a la cual se le esta realizando la nota débitoCadena de caracteresNo
17.(Factura) Consecutivo de la facturaConsecutivo de la factura a la cual se le esta realizando la nota débitoCadena de caracteresNo
18.(Factura) Cufe de la facturaCufe de la facturaCadena de caracteresNo
19.(Factura) Fecha de la facturaFecha de la factura, formato yyyy-MM-dd (2010-01-31)Cadena de caracteresNo
20.(Sucursal) NombreNombre de la sucursal para sobrescribir los datos de la empresaCadena de caracteresNo
21.(Sucursal) DirecciónDirección de la sucursal para sobrescribir los datos de la empresaCadena de caracteresNo
22.(Sucursal) TeléfonoTeléfono de la sucursal para sobrescribir los datos de la empresaCadena de caracteresNo
23.(Sucursal) Código paísCódigo país de la sucursal para sobrescribir los datos de la empresaVer códigosCadena de caracteresNo
24.(Sucursal) Nombre paísNombre país de la sucursal para sobrescribir los datos de la empresaVer códigosCadena de caracteresNo
25.(Sucursal) Código departamentoCódigo departamento de la sucursal para sobrescribir los datos de la empresaVer códigosCadena de caracteresNo
26.(Sucursal) Nombre departamentoNombre departamento de la sucursal para sobrescribir los datos de la empresaVer códigosCadena de caracteresNo
27.(Sucursal) Código ciudadCódigo ciudad de la sucursal para sobrescribir los datos de la empresaVer códigosCadena de caracteresNo
28.(Sucursal) Nombre ciudadNombre ciudad de la sucursal para sobrescribir los datos de la empresaVer códigosCadena de caracteresNo
29.(Resolución) Clave de la resoluciónLlave de la resolución proporcionada por la DIANCadena de caracteresSi
30.(Resolución) Prefijo de la resoluciónPrefijo de la nota.Cadena de caracteresSi
31.(Resolución) Número de la resoluciónNúmero de la resolución proporcionado por DIANNuméricoSi
32.(Resolución) Rango inicial de facturaciónRango inicial de facturación habilitadoNuméricoSi
33.(Resolución) Rango final de facturaciónRango final de facturación habilitadoNuméricoSi
34.(Resolución) Fecha inicial de validación de facturaciónFecha inicial de de validación de facturación, formato yyyy-MM-dd (2010-01-31)FechaSi
35.(Resolución) Fecha final de validación de facturaciónFecha final de de validación de facturación, formato yyyy-MM-dd (2010-01-31)FechaSi
36.(Cliente) Razón social o nombre completoRazón social o nombre completoCadena de caracteresSi
37.(Cliente) Tipo personaTipo personaVer códigosCadena de caracteresSi1
38.(Cliente) Tipo de régimenTipo de régimenVer códigosCadena de caracteresSi2
39.(Cliente) NombresNombresCadena de caracteresSi
40.(Cliente) ApellidosApellidosCadena de caracteresNo
41.(Cliente) Número documento identificaciónNúmero documento identificaciónCadena de caracteresSi
42.(Cliente) Dígito de verificaciónDígito de verificaciónCadena de caracteresSi
43.(Cliente) Tipo de identificaciónTipo de identificaciónVer códigosCadena de caracteresSi2
44.(Cliente) Email/correo electrónicoEmail/correo electrónicoCadena de caracteresNo
45.(Cliente) TeléfonoTeléfonoCadena de caracteresNo
46.(Cliente) Registro mercantilRegistro mercantilCadena de caracteresNo
47.(Cliente) Responsabilidades fiscalesResponsabilidades fiscalesVer códigosCadena de caracteresSi
48.(Cliente-Facturación) Dirección(Facturación) Dirección facturaciónCadena de caracteresSi
49.(Cliente-Facturación) Nombre del país(Facturación) Nombre del país facturaciónVer códigosCadena de caracteresSi
50.(Cliente-Facturación) Código del país(Facturación) Código del paísVer códigosCadena de caracteresSi2
51.(Cliente-Facturación) Nombre de la región(Facturación) Nombre del departamentoVer códigosCadena de caracteresSi
52.(Cliente-Facturación) Código de la región(Facturación) Código del departamentoVer códigosCadena de caracteresNo2
53.(Cliente-Facturación) Nombre de la ciudad(Facturación) Nombre del municipioVer códigosCadena de caracteresSi
54.(Cliente-Facturación) Código de la ciudad(Facturación) Código del municipioVer códigosCadena de caracteresNo5
55.(Cliente-Facturación) Código postal(Facturación) Código postalCadena de caracteresNo
56.(Cliente-Facturacion) Barrio(Facturación) BarrioCadena de caracteresNo
57.(Cliente-Facturacion) Telefono(Facturación) TélefonoCadena de caracteresNo
58.(Cliente-Facturacion) Nombre contacto(Facturación) BarrioCadena de caracteresNo
59.(Cliente-Datos-Entrega) Dirección(Datos-Entrega) Dirección facturaciónCadena de caracteresSi
60.(Cliente-Datos-Entrega) Nombre del país(Datos-Entrega) Nombre del país facturaciónVer códigosCadena de caracteresSi
61.(Cliente-Datos-Entrega) Código del país(Datos-Entrega) Código del paísVer códigosCadena de caracteresSi2
62.(Cliente-Datos-Entrega) Nombre de la región(Datos-Entrega) Nombre del departamentoVer códigosCadena de caracteresSi
63.(Cliente-Datos-Entrega) Código de la región(Datos-Entrega) Código del departamentoVer códigosCadena de caracteresNo2
64.(Cliente-Datos-Entrega) Nombre de la ciudad(Datos-Entrega) Nombre del municipioVer códigosCadena de caracteresSi
65.(Cliente-Datos-Entrega) Código de la ciudad(Datos-Entrega) Código del municipioVer códigosCadena de caracteresNo5
66.(Cliente-Datos-Entrega) Código postal(Datos-Entrega) Código postalCadena de caracteresNo
67.(Cliente-Datos-Entrega) Barrio(Datos-Entrega) BarrioCadena de caracteresNo
68.(Cliente-Datos-Entrega) TeléfonoTeléfono de entregaCadena de caracteresNo
69.(Cliente-Datos-Entrega) Nombre contactoContacto para entrega al clienteCadena de caracteresNo
70.(Total) Subtotal sin impuestos ni retencionesSubtotal sin impuestos ni retencionesNuméricoSi
71.(Total) AnticiposAnticiposNuméricoSi
72.(Total) impuestosImpuestosNuméricoSi
73.(Total) RetencionesRetencionesNuméricoSi

Detalle#

Número de la columna y nombre del campoDescripciónCódigosTipoEste campo es requeridoAncho del campo
Número de la columna y nombre del campoDescripciónCódigosTipoEste campo es requeridoAncho del campo
1.Tipo registroDebe ir "DTL" para indicar que es un detalle de facturaCadena de caracteresSi3
2.Código ítemIndique el código del ítem, producto o servicio que esta facturandoCadena de caracteresSi
3.Nombre servicio/productoNombre servicio/producto que esta facturandoCadena de caracteresSi
4.Modelo del producto o servicioModelo del producto o servicio que esta facturandoCadena de caracteresNo
5.Descripción de la ventaDescripción de la ventaCadena de caracteresNo
6.Marca del producto o servicioMarca del producto o servicioCadena de caracteresNo
7.Código del producto colocado por el proveedorCódigo del producto colocado por el proveedorCadena de caracteresNo
8.Es un regaloEs un regaloBooleanoSi
9.Precio unitarioPrecio unitarioNuméricoSi
10.CantidadCantidadNuméricoSi
11.Valor total de los descuentos aplicadosValor total de los descuentos aplicadosNuméricoNo
12.Valor total de los cargos aplicadosValor total de los cargos aplicadosNuméricoNo
13.(Descuento) Tipo valorTipo valorVer códigosCadena de caracteresSi1
14.(Descuento) TarifaTarifaNuméricoSi
15.(Descuento) ValorValorNuméricoSi
16.(Cargos) Tipo valorTipo valorVer códigosCadena de caracteresSi1
17.(Cargos) TarifaTarifa, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igual.NuméricoSi
18.(Cargos) ValorValor, tenga en cuenta que si el tipo de valor es "V" el valor y la tarifa deben ser igualNuméricoSi
19.ImpuestosLista 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 milVer códigosNuméricoNo
20.RetencionesLista 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 milVer códigosNuméricoNo
21.(Mandante) NombreNombre del mandanteCadena de caracteresNo
22.(Mandante) IdentificaciónIdentificaciónCadena de caracteresNo
23.(Mandante) Dígito de verificaciónDígito de verificaciónCadena de caracteresNo
24.(Mandante) Tipo de identificaciónTipo de identificaciónVer códigosCadena de caracteresNo
Modificado en 2026-07-08 15:40:26
Anterior
Nota crédito
Siguiente
Estructura del archivo plano
Built with