Consideraciones sobre el archivo plano
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 aquí (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 aquí. 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: 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:{% hint style="warning" %}
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.
{% endhint %}{% hint style="info" %}
Se pueden incluir ilimitados detalles por cada encabezado.
{% endhint %}{% hint style="info" %}
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:
{% endhint %} Modificado en 2026-07-08 15:40:26
.png)
.png)
.png)
.png)
.png)
.png)