Saltar al contenido
EasySoft Tech
dolibarr

Importar productos en Dolibarr desde Excel o CSV

Separador, decimales y unidades de medida: por esto falla la importación de productos en Dolibarr. Guía con los campos obligatorios y los errores típicos.

EasySoft Tech S.L.5 min de lectura

El asistente de importación de Dolibarr es la herramienta nativa que carga artículos desde un CSV o Excel, sin programar nada ni entrar en la base de datos a mano. Se abre en Herramientas, en «Asistente de importación», y no necesita ningún módulo de pago. Falla casi siempre por lo mismo: el fichero se genera con la configuración regional de Excel y el asistente espera otra cosa.

Qué es el asistente de importación y cómo funciona por pasos

El asistente es un proceso guiado: lee el fichero, lo enseña antes de escribir nada y solo importa si no hay errores. Eliges qué vas a importar (productos, terceros, contactos, usuarios), subes el fichero e indicas separador y carácter de texto. Después mapeas cada columna a un campo de Dolibarr y revisas la previsualización con el recuento de errores por línea.

Si la previsualización da errores, no se importa nada. Corriges el fichero y repites.

Admite CSV y xlsx, y trae una plantilla de ejemplo con las columnas que espera cada tipo de dato. Las columnas que no quieras importar se dejan como «ningún campo».

Por qué solo me detecta una columna: el separador

El error número uno es el separador. Excel en configuración regional española guarda el CSV con punto y coma y Dolibarr, por defecto, espera coma, así que el asistente lee el fichero entero como una sola columna.

Se arregla cambiando el separador en el paso de lectura, no rehaciendo el Excel. Es un desplegable.

Codificación y fila de cabecera

La codificación correcta es UTF-8. Si el fichero viene en otra, se rompen acentos y eñes.

La primera línea suele ser la cabecera: el asistente permite indicar desde qué línea lee, o se borra antes de subir. Si no, la primera fila entra como un artículo llamado «Referencia».

Decimales, precios y tipo de IVA

Dolibarr espera el punto como separador decimal. Si el Excel trae coma decimal, los precios se quedan en la parte entera: 12,50 entra como 12. Hay que exportar con punto o convertir la columna antes de subir.

El fichero distingue precio de venta y de compra, y el de venta puede ir sin IVA o con IVA. Conviene decidirlo antes de generar el fichero: si se mezcla, el catálogo sale incoherente. El precio medio ponderado (PMP) se deja a 0 si no quieres arrastrar un coste.

El tipo de IVA tiene que existir en el diccionario de tipos de IVA de esa instalación; si no, la línea da error. Igual con el código de país (ES para España).

Producto o servicio y los dos interruptores

Campo Qué poner Qué pasa si se cruza
Tipo de artículo 0 producto, 1 servicio El catálogo entero con el tipo cambiado
En venta / En compra 0 o 1 en cada uno Artículo invisible al facturar o al recibir

Cuando el mapeo se desplaza una columna, no salta ningún error: el fichero se importa igual y el resultado simplemente está mal. Eso no se ve en el recuento de errores, se ve en la previsualización, columna por columna.

Unidades de medida: el error que no entiendes

En varias versiones el asistente exige un valor válido en las columnas de unidad (peso, longitud, superficie, volumen) aunque estén vacías, y protesta con «no es un valor disponible en el campo code de la tabla Unidades de Medida».

Se resuelve mapeando esas columnas como «ningún campo» o poniendo el código del diccionario, según la versión. Si el catálogo no usa peso ni volumen, la primera opción tarda diez segundos.

Duplicados: actualizar sin repetir

La referencia del artículo es la clave. Si subes referencias que ya existen, el asistente te deja decidir qué hacer con el registro existente: crear uno nuevo o actualizar el que hay. Es también la vía para refrescar precios sin duplicar artículos.

Si la referencia cambia en origen, ya no hay actualización posible. Conviene que sea un dato estable antes de la primera carga.

Qué no hace la importación

Importar productos no genera movimientos de stock. El artículo se crea, pero el stock entra después con un movimiento, un inventario o la recepción de un pedido a proveedor.

Tampoco sube imágenes ni documentos adjuntos: las fotos y los PDF se añaden después.

Con ficheros grandes conviene trocear. Un catálogo de 9000 referencias venido de otra aplicación, subido de golpe, pesa en tiempo de ejecución y memoria, y cuesta saber qué línea falló.

Después de importar, revisa

Coge unos cuantos registros al azar y mira tipo, precios, tipo de IVA y unidad. Comprueba también que las referencias no chocan con las que ya había.

El mismo asistente vale para clientes y proveedores, sin cambiar de herramienta. En terceros el nombre es obligatorio, el código de cliente o proveedor puede generarlo el sistema, y la plantilla de cada tipo de dato marca qué campos no puedes dejar vacíos.

Si el catálogo se actualiza cada mes desde un proveedor o una tienda online, el asistente no es la herramienta: está pensado para cargas puntuales. Para eso hay una API o un conector.

Si prefieres que alguien lo deje montado, en EasySoft Tech S.L. hacemos implantación de Dolibarr, incluida la carga inicial del catálogo y de los terceros. Puedes comprobar si Dolibarr te encaja con una checklist y, si vienes de otro sistema, ver el cómo migrar a Dolibarr.

Preguntas frecuentes

¿Dolibarr puede importar Excel?

Sí, en CSV o xlsx. La plantilla de ejemplo viene con las columnas de cada tipo de dato, así que no hay que adivinar el formato.

¿Por qué solo me detecta una columna?

Porque el separador del fichero no coincide con el que espera el asistente: Excel en español guarda con punto y coma y Dolibarr espera coma. Se cambia en el paso de lectura.

¿Se importa el stock?

No. La importación crea el artículo, no los movimientos. El stock entra después, con un inventario o con la recepción de un pedido a proveedor.

¿Se puede actualizar el catálogo sin duplicar artículos?

Sí, si la referencia es la misma. El asistente permite elegir qué hacer cuando el registro ya existe: crear uno nuevo o actualizar el que hay.

Sobre el autor

EasySoft Tech S.L. — software factory española especializada en el ERP Dolibarr desde 2019: módulos a medida, implantación, migración y cumplimiento normativo (VeriFactu, SII, contabilidad). Este artículo refleja nuestra experiencia real con estos módulos.