Importar y exportar plantillas por CSV

Carga nuevas plantillas, actualiza líneas y exporta selecciones.

Antes de empezar

Prepara un CSV en UTF-8, separado por punto y coma. El cliente Academia Horizonte debe existir. Consulta el formato y las columnas más abajo.

0:00

Importar y exportar plantillas por CSV · narración en español, con subtítulos

Abrir la importación
1. Abre Ventas → Recurrentes para el ejemplo de cliente. Para proveedores utiliza Compras → Recurrentes.
2. Abre Más acciones —el botón de tres puntos del listado— y pulsa Importar....
Cargar una plantilla nueva
1. En Tipo de actualización, selecciona Documentos nuevos.
2. En Archivo CSV, carga el ejemplo de abajo: dos unidades de servicio a 25 € cada una.
3. Pulsa Aceptar.
Revisar lo importado
1. En Documentos importados, abre el enlace Cuota importada y comprueba el destinatario.
2. En Líneas, verifica Servicio importado, cantidad 2 y precio 25.
Exportar las plantillas
1. Vuelve al listado, abre Más acciones y pulsa Exportar....
2. En Documentos a exportar, selecciona Todos los documentos y revisa las columnas, incluidos los identificadores de línea.
3. Pulsa Aceptar y comprueba el archivo descargado.

Resultado

La importación crea una plantilla, sin emitir documentos. Para actualizar una existente, utiliza sus identificadores reales; conserva los del archivo exportado.

Contrato CSV

Elemento	Uso y comprobación
Codificación y separador	UTF-8; separador punto y coma.
Límites	8 MiB y 10.000 filas.
Documentos nuevos	Crea plantillas; no genera facturas ni envía correo.
Actualizar documentos	Usa el ID real de plantilla. Si no existe, este modo puede crear una nueva; no es una garantía de solo actualizar. Incluye `idlinea` para identificar sin ambigüedad la línea.
Líneas omitidas	Se conservan durante una actualización.
Archivo inválido	Revierte la importación completa.
Exportar seleccionados / todos	Elige ámbito y columnas opcionales. Sin selección se exportan cabeceras.
Plantilla sin líneas	No aporta filas al CSV de líneas; puede previsualizarse y generarse con total cero.

Columnas y valores

Cada fila representa una línea. Las filas con el mismo iddocumento se agrupan en una plantilla y deben repetir exactamente sus datos de cabecera. Los nombres de columnas se escriben tal cual: se rechazan nombres desconocidos, repetidos o la ausencia de alguna cabecera obligatoria. Todas las filas deben tener el mismo número de columnas; se admiten campos entre comillas y un marcador BOM UTF-8. Utiliza punto decimal para los números, sin símbolos de moneda.

Cabeceras obligatorias

Columna	Contenido
`iddocumento`	Clave no vacía, hasta 100 caracteres. En Documentos nuevos agrupa filas del archivo, no impone el identificador que asignará el programa. En Actualizar documentos, un identificador numérico existente busca esa plantilla.
`codcliente` / `codproveedor`	Usa únicamente la columna del listado desde el que importas y el código real del tercero existente, no su nombre.
`documento`	Descripción de la plantilla.
`generar`	En ventas: `PresupuestoCliente`, `PedidoCliente`, `AlbaranCliente` o `FacturaCliente`. En compras: `PresupuestoProveedor`, `PedidoProveedor`, `AlbaranProveedor` o `FacturaProveedor`.
`fechainicio`	Fecha válida en `AAAA-MM-DD`, `DD/MM/AAAA` o `DD-MM-AAAA`.
`referencia`	Referencia existente del producto/variante; puede estar vacía para un concepto libre. La columna sigue siendo obligatoria.
`cantidad`	Cantidad numérica de la línea; debe tener un valor.

Columnas opcionales

Columna	Contenido y efecto
`codalmacen`	Código de almacén existente; determina la empresa del documento.
`coddivisa`	Código de divisa existente.
`codpago`	Código de forma de pago existente.
`codserie`	Código de serie existente.
`periodo`	`1` días, `2` semanas, `3` meses, `4` personalizado o `99` manual. Vacío usa meses. Un alta sin esta columna también empieza con meses.
`numperiodo`	Entero positivo para Cada; vacío o no indicado en un alta utiliza 1.
`fechafin`	Fecha final opcional, en los formatos anteriores; vacía quita el límite.
`fechaprimer`	Primera fecha, en los formatos anteriores. En un alta, si falta o está vacía, se utiliza la fecha inicial como primera emisión: no se espera un intervalo completo.
`pctprimer`	Porcentaje inicial de la plantilla, entre 0 y 100; vacío utiliza 100. No es el porcentaje de la próxima emisión de cada línea.
`notes`	Observaciones internas de la plantilla.
`notesdocument`	Observaciones que se copian al documento.
`idlinea`	Identificador real de la línea al actualizar. Debe pertenecer a la plantilla; no puede usarse dos veces en la misma importación.
`descripcion`	Texto de la línea; admite los patrones de fecha.
`precio`	Precio unitario; vacío permite resolver el valor predeterminado. Cero es un valor explícito.
`descuento`	Descuento de línea de 0 a 100; vacío permite resolver el valor predeterminado.
`irpf`	Porcentaje de retención de 0 a 100; vacío permite resolver el valor predeterminado.

El CSV no contiene todas las opciones de la ficha: no incluye días seleccionados, impuesto de línea, pausa ni envío de correo, entre otras. No lo utilices como una copia íntegra para reconstruir cualquier configuración. Para Personalizado, revisa y guarda los días desde Periodo; exportar periodo=4 no exporta esas casillas. Completa y comprueba los impuestos desde la plantilla.

Actualizar sin confundir plantillas y líneas

Exporta primero los identificadores reales y selecciona Actualizar documentos. Si el iddocumento no identifica una plantilla existente, puede crearse otra. Los miembros de grupos no se actualizan con este recorrido. Una plantilla de compras no se puede actualizar desde el listado de ventas, ni al revés.

Para cada línea, utiliza idlinea. Sin ese dato se busca una coincidencia de referencia entre las líneas existentes: una coincidencia se actualiza, ninguna crea una línea y varias hacen fallar el archivo. Esto también afecta a conceptos libres con referencia vacía. Las líneas que no incluyas se conservan.

Omitir una columna opcional conserva el valor existente al actualizar; incluirla vacía puede limpiarlo o aplicar su valor predeterminado. No vacíes columnas indiscriminadamente. Las cabeceras de todas las filas de una misma plantilla deben coincidir; si cualquier fila falla se revierte la importación completa.

Exportar con el alcance correcto

Documentos seleccionados exporta las filas marcadas. Sin filas marcadas genera solo las cabeceras. Todos los documentos recorre las plantillas independientes autorizadas del lado de ventas o compras: no se limita a la búsqueda ni a los filtros visuales del listado. Una plantilla sin líneas no aporta filas al archivo.

En Columnas opcionales puedes añadir o quitar los datos de la tabla anterior. Inicialmente están marcados almacén, divisa, forma de pago, serie, tipo de plazo, Cada, ID de línea, descripción de línea, precio y descuento. Incluye ID de línea si vas a reimportar cambios. La exportación está limitada a 10.000 documentos, 10.000 filas y 8 MiB; comprueba el archivo descargado antes de utilizarlo para una actualización. En Todos los documentos, el límite de 10.000 plantillas se comprueba sobre el conjunto independiente de ventas o compras antes de excluir los registros no autorizados; puede impedir esa exportación aunque tu usuario vea menos. Acota con Documentos seleccionados si necesitas exportar un conjunto menor.

Importar requiere permisos de modificación en recurrentes y en el tipo documental; exportar requiere los permisos de exportación correspondientes. Si una acción no aparece o se rechaza, revisa esos permisos y el acceso a los registros.

En ambos diálogos, Cancelar o Cerrar sale sin iniciar la operación. Aceptar ejecuta la importación o descarga según el diálogo abierto.

Ejemplo mínimo de alta de venta

El cliente CL001 (Academia Horizonte) debe existir. Este ejemplo prepara un presupuesto manual con una línea de dos unidades a 25; no lo emite.

iddocumento;codcliente;documento;generar;fechainicio;referencia;cantidad;descripcion;precio;periodo
cuota-mensual;CL001;Cuota importada;PresupuestoCliente;2026-09-15;;2;Servicio importado;25;99

Vídeo · Subtítulos