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

¿Te fue útil?

  1. Archivo Plano (.CSV)

Consideraciones sobre el archivo plano

AnteriorConsultar resolucionesSiguienteEstructura del archivo plano

Última actualización hace 1 año

¿Te fue útil?

El archivo plano es un documento en formato CSV delimitado por punto y coma (;) con el cual se pueden importar registros masivamente al portal ISV.

Con el archivo plano tienes la facilidad de importar tus facturas, notas débito y notas crédito habiéndolas creado en una aplicación que permita guardar un archivo con extensión .csv.

Para poder usar archivos planos en nuestro portal debes tener en cuenta lo siguiente:

  • Los archivos .csv deben tener sus "items" separados por punto y coma (;). Si la aplicación que usas para crear el archivo plano tiene configurada la delimitación por comas (,), e.g. Microsoft Excel, deberás cambiar dicha configuración como se indica (Realizar el proceso hasta la tercera imagen).

  • Los campos con valores numéricos obligatorios y opcionales deben cómo mínimo tener un cero 0 ya que estos campos no pueden estar vacíos.

  • El archivo plano tiene su propia estructura, cómo se indica .

  • El archivo plano puede tener un tamaño máximo de 3MB (MegaBytes).

  • El archivo plano no tiene relación alguna con la API.

  • Los documentos que vas a importar (Facturas, notas crédito / débito) tienen un encabezado que es donde se indica toda la información relacionada con tu empresa, tu cliente, entre otros. Estos documentos también tienen un detalle que es donde se indica todo lo relacionado con los productos a facturar.

  • Los códigos que identifican algunos valores, cómo por ejemplo los tipos de documento, aplican tanto para la API como para el Archivo Plano.

  • La descripción Tipo de registro indica qué tipo de documento estamos haciendo:

    • INV = Factura de venta

    • INC = Nota crédito

    • IND = Nota débito

    • DTL = Detalle del documento (Aplica para todos los tipos de documento)

Organización interna del archivo plano

Los archivos planos tienen una organización como la siguiente:

Descripción del encabezado:

La primera línea indica la descripción de cada uno de los valores del encabezado del documento:

Descripción del detalle:

La segunda línea indica la descripción de los valores del detalle del documento:

Valores del encabezado:

La tercera línea es la que tiene los valores del encabezado del documento acorde a la descripción de la primera línea.

Valores del detalle:

La cuarta línea indica los valores del detalle del documento acorde a la descripción de la segunda línea:

La primer y segunda línea sólo son indicativas, es decir, sólo sirven cómo guía para que puedas saber qué valor va en qué columna, por lo que debes eliminar dichas líneas (línea 1 y 2) antes de cargar el archivo.

Se pueden incluir ilimitados detalles por cada encabezado.

Se pueden incluir ilimitados documentos del mismo tipo dentro de un solo archivo plano.

Esto se hace creando un nuevo encabezado junto con sus respectivos detalles, como se muestra a continuación:

aquí
aquí
La primera línea está resaltada en rojo
La segunda línea está resaltada en rojo
La tercera línea está resaltada en rojo
La cuarta línea está resaltada en rojo
Varios documentos en un solo archivo plano