Cómo incorporar productos, variantes, clientes y pedidos por CSV en Shopware 6 y qué errores evitar en una tienda online en España.
La importación CSV de Shopware es un módulo integrado en Shopware 6 con el que puede incorporar productos, clientes, categorías y otros datos desde un archivo CSV. En la administración lo encontrará en Configuración, Automatización, Importar/Exportar. Cada archivo se procesa con un perfil que define qué columna va a qué campo de Shopware. El archivo debe estar codificado en UTF-8, usar punto y coma como separador y punto como separador decimal.
Para áreas de datos concretas, el CSV es la vía más rápida; para un cambio completo de sistema, normalmente no. Productos, precios, stock y listas de clientes se gestionan bien por CSV. El historial de pedidos, las valoraciones, las URL SEO y los documentos se trasladan de forma más limpia con el asistente de migración cuando se viene de Shopware 5 o de otro Shopware 6. Las sincronizaciones continuas con un sistema de gestión de mercancías requieren una interfaz.
La mayoría de los errores de importación se producen antes de subir el archivo. Excel altera los caracteres especiales, los separadores y los ceros a la izquierda, las variantes necesitan un orden fijo y, sin preparación, los clientes reciben correos de registro. Si no quiere encargarse usted mismo de la importación: en la suscripción de tienda de solution25 damos de alta, según el paquete, hasta 200 o 500 productos, y en el paquete Enterprise la migración de datos está incluida.
Este artículo se dirige a responsables de tiendas online y de e-commerce y a desarrolladores en España que quieren incorporar datos a una tienda Shopware 6: al lanzar una tienda nueva, en un relanzamiento o en el mantenimiento periódico de surtidos grandes. Verá qué método encaja en cada caso, cómo preparar perfiles y archivos y cómo importar productos, variantes, clientes y pedidos sin perder datos.
El módulo Importar/Exportar forma parte del alcance estándar de Shopware 6. No necesita ninguna extensión. En la administración, abra Configuración, Automatización, Importar/Exportar. Allí hay tres pestañas: Importar, Exportar y Perfiles.
Shopware incluye perfiles estándar, entre otros, para productos, categorías, propiedades, suscriptores del newsletter y la configuración de variantes. La documentación contiene además referencias de campos para clientes, pedidos, medios, precios, venta cruzada y códigos promocionales. Para cada uno de estos tipos de objeto puede crear perfiles propios.
Al iniciar, Shopware comprueba cada registro. Las filas válidas se incorporan; las erróneas acaban en un archivo CSV propio con la columna adicional _error. Descargue ese archivo, corríjalo e impórtelo de nuevo. El registro muestra las importaciones de los últimos 30 días, con archivo de origen, perfil y archivo de errores.
Un botón importante es la ejecución de prueba (Dry Run). Simula la importación completa sin escribir datos. Así ve de antemano si fallan filas y evita una base de datos importada a medias.
Una importación solo puede añadir o sobrescribir datos, no eliminarlos. Un ejemplo de la documentación: una asignación a un canal de venta, una vez establecida, no se elimina mediante importación. Si quiere depurar asignaciones, debe hacerlo en la administración o por API. Tampoco una cancelación deshace nada: los registros escritos hasta ese momento permanecen en el sistema.
Antes de crear el primer archivo, aclare si el CSV es realmente la herramienta adecuada. Shopware ofrece tres vías para llevar datos a la tienda, y cada una encaja en un caso distinto.
| Método | Adecuado para | Límites |
|---|---|---|
| Importar/Exportar CSV | Configuración inicial de surtidos, cambios masivos de precios y stock, listas de clientes de un sistema antiguo | Sin eliminaciones, variantes solo en varios pasos, pedidos sin guía estándar |
| Asistente de migración | Cambio desde Shopware 5 u otro Shopware 6 y, según la documentación de Shopware, también desde Magento | Formas de pago, flows, grupos dinámicos de productos y datos de extensiones deben crearse de nuevo |
| API o interfaz | Sincronización continua con gestión de mercancías, ERP o PIM | Esfuerzo de desarrollo, operación y supervisión de la interfaz |
El CSV es fuerte cuando los datos llegan una sola vez o a intervalos largos y la estructura es manejable. Casos típicos: un comercio arranca con 800 artículos de una lista de proveedor. Una tienda cambia los precios de 2.000 productos antes del Black Friday. Un mayorista incorpora su lista de clientes desde un antiguo portal B2B. En todos estos casos, un CSV bien construido se importa en pocos minutos.
Si viene de Shopware 5, utilice el asistente de migración oficial. Según Shopware, traslada medios, categorías, productos, propiedades, fabricantes, valoraciones, venta cruzada, clientes, pedidos con sus documentos, URL SEO, suscriptores del newsletter, listas de deseos y promociones. Reproducir todo eso por CSV cuesta muchísimo más tiempo y pierde las relaciones entre los datos. Cómo funciona esta migración lo explicamos en el artículo Migrar de Shopware 5 a Shopware 6.
En cuanto los datos tienen que fluir a diario o cada hora, por ejemplo el stock del almacén o los pedidos de vuelta a contabilidad, el CSV manual es el camino equivocado. Entonces necesita una conexión con su sistema de gestión de mercancías. Qué sistemas existen y cómo funciona la conexión lo describe el artículo Gestión de mercancías para Shopware. Una solución intermedia son las importaciones CSV automatizadas por línea de comandos; más abajo encontrará más información.
Shopware espera un archivo CSV real con reglas fijas. La documentación menciona tres: UTF-8 como codificación de caracteres, punto y coma como separador de campos y comillas alrededor de los textos. A ello se suma, en los números, el punto como separador decimal, es decir, 5.00 y no 5,00.
La mayoría de los comercios crea sus listas en Excel. Al guardarlas como CSV suelen ocurrir tres cosas: los caracteres especiales como la ñ o las tildes se codifican mal, los puntos y coma se convierten en comas o al revés, y desaparecen los ceros a la izquierda. La referencia 00451 pasa a ser 451, y un EAN de 13 dígitos se convierte en un número en notación científica. Por eso Shopware recomienda en su documentación un programa que escriba archivos CSV nativos y menciona OpenOffice Calc como ejemplo. LibreOffice Calc o un editor de texto con selección de codificación funcionan igual de bien.
La vía más fiable para obtener la estructura correcta: cree dos o tres productos de prueba a mano, expórtelos con el perfil que usará después para la importación y utilice el archivo exportado como plantilla. Así, los nombres de columna, el orden y el formato serán seguro correctos. En el foro de Shopware se recomienda precisamente esta vía ante el mensaje de error de formatos de archivo no compatibles. Allí varios usuarios cuentan que la misma subida falló en Firefox y funcionó en Chrome.
Un perfil es la traducción entre su archivo y la base de datos de Shopware. Puede duplicar un perfil estándar o crear uno nuevo. Importante: seleccione el idioma predeterminado del sistema; de lo contrario, según la documentación, el perfil no funciona.
Estos dos interruptores son una protección sencilla. Para una simple actualización de precios, desactive la creación. Así, una errata en una referencia no genera un producto nuevo y vacío, sino que aparece como error en el archivo de errores.
En el mapeo asigna un nombre de columna a cada campo de la base de datos. Para cada fila define si el campo es obligatorio, qué valor predeterminado recibe y en qué posición se encuentra. Si sube un CSV existente, Shopware propone los campos a partir de la fila de cabecera. El sistema añade por sí mismo los campos obligatorios:
| Tipo de objeto | Campos obligatorios según la documentación |
|---|---|
| Producto | id, taxId, productNumber, stock, name |
| Cliente | id, defaultBillingAddressId, defaultShippingAddressId, customerNumber, firstName, lastName, email |
| Categoría | id, type, name |
Internamente, Shopware trabaja con UUID largos. Ningún sistema antiguo conoce estos ID. Por eso, en los ajustes avanzados del perfil puede definir un segundo identificador único, en productos normalmente la referencia (productNumber). Así, al actualizar, Shopware encuentra el producto correcto por su número. Asegúrese de que este identificador sea realmente único. Los valores duplicados hacen que se omitan registros.
La importación de productos es el caso más habitual y el que esconde más detalles. Con el perfil estándar para productos llegará lejos si tiene en cuenta los siguientes puntos.
Los campos de precio siguen el patrón price.DEFAULT.net y price.DEFAULT.gross. DEFAULT representa la moneda predeterminada. Indique ambos valores o aclare antes cuál prevalece. Un error frecuente es un precio bruto que se recalcula con un tipo impositivo incorrecto, de modo que en la tienda aparecen importes con céntimos extraños.
El archivo de productos contiene las columnas tax_id, tax_rate y tax_name. En tax_id introduzca el UUID de un tipo impositivo existente. Si el campo queda vacío, según la documentación Shopware crea un nuevo tipo impositivo. Parece inofensivo, pero enseguida da lugar a varios tipos duplicados con el mismo porcentaje que luego nadie sabe distinguir. Obtenga antes los UUID mediante una exportación o desde la administración.
El campo media recoge las URL de las imágenes del producto; la imagen principal va en un campo propio. Shopware descarga las imágenes desde esas direcciones. Por tanto, deben ser accesibles públicamente. Fallan los enlaces de carpetas compartidas en la nube con fecha de caducidad o de un portal de proveedor con inicio de sesión. En surtidos grandes compensa una carpeta de imágenes propia en un servidor, que vacía después de la importación.
Los productos se asignan mediante los ID de categoría. Por eso, cree la estructura de categorías antes que los productos, a mano o con el perfil estándar para categorías. Allí, parent_id determina la categoría padre. El ID de una categoría lo ve en la barra de direcciones de la administración cuando abre la categoría.
Los textos en otros idiomas se gestionan con campos que siguen el patrón translations.DEFAULT, donde DEFAULT se sustituye por el código de idioma, por ejemplo es-ES o en-GB. Para una tienda multilingüe, por ejemplo con español y catalán, prevea por cada idioma una columna para el nombre, la descripción y los metadatos. Shopware recomienda hacer una copia de seguridad de la base de datos antes de importar traducciones.
Las variantes son la parte en la que fracasan la mayoría de las importaciones CSV. El motivo: una variante depende de un producto principal y de propiedades que deben existir previamente. Por eso la documentación de Shopware describe cuatro pasos.
Al importar las variantes son obligatorios parent_id, product_number, active, stock y optionIds. Varios ID de opción se separan con una barra vertical, es decir, id-rojo|id-xl.
Generar es más rápido si deben existir todas las combinaciones y las variantes solo se diferencian en las opciones. Importar es mejor si tiene que incorporar referencias, EAN, stock o precios propios por variante. En la práctica solemos combinar ambas cosas: generar las variantes y después completar referencias, stock y precios con una importación de actualización. Es un valor de experiencia de nuestros proyectos, no una indicación de Shopware.
Un comercio de moda hipotético tiene 300 camisetas en 5 tallas y 4 colores cada una. Son 300 productos principales, 2 grupos de propiedades con 9 opciones, 2.700 filas de configuración de variantes (300 por 9) y 6.000 variantes (300 por 20). Quien intente meterlo todo en un único archivo fracasará. En cuatro archivos bien separados es una importación manejable.
En la importación de clientes se trata de algo más que nombres y direcciones. Tres puntos deciden si la migración pasa desapercibida para sus clientes.
Shopware envía un correo de registro al crear un cliente. Con 5.000 clientes importados serían 5.000 correos a personas que no se han registrado de nuevo. Por eso la documentación aconseja desactivar el envío de correos en Configuración, Sistema, Mailer antes de la importación y volver a activarlo después.
Los clientes deben poder iniciar sesión con su contraseña anterior tras la migración. Shopware prevé para ello los campos legacyPassword y legacyEncoder. En ellos figuran el hash cifrado del sistema antiguo y el procedimiento con el que se generó. Cuando el cliente inicia sesión, Shopware comprueba la contraseña antigua y la guarda de nuevo en su propio formato. Las contraseñas en texto plano no tienen cabida en un archivo de importación. Si Shopware no admite el procedimiento del sistema antiguo, solo queda la vía de un correo de restablecimiento de contraseña tras la puesta en marcha.
Cada cliente necesita una dirección de facturación y una dirección de envío predeterminadas. En clientes B2B se añaden el grupo de clientes, el nombre de la empresa y el NIF-IVA. Cree antes los grupos de clientes y compruebe si los países y los tratamientos del sistema antiguo tienen los mismos valores que en Shopware.
En España, antes de importar productos, cree los tipos de IVA del 21 %, 10 % y 4 % e introduzca sus ID en el archivo de productos. Si vende a Canarias, Ceuta o Melilla, tenga en cuenta que allí no se aplica el IVA. Para los datos de clientes rigen el RGPD y la LOPDGDD. Si una agencia o un proveedor de servicios trata sus archivos de importación, firme antes un contrato de encargo del tratamiento conforme al art. 28 del RGPD.
Con independencia del país: incorpore solo los clientes que todavía necesita. Una migración es una buena ocasión para depurar las cuentas inactivas según sus plazos de supresión. Los archivos de importación con datos de clientes no deben enviarse como adjuntos de correo ni guardarse en carpetas abiertas en la nube, y se eliminan tras la importación. Más información en el artículo Protección de datos en la tienda online.
Para los pedidos, la documentación de Shopware incluye una referencia de campos, pero no una guía paso a paso como para productos o variantes. Como campos mínimos indica id, salesChannelId, orderDateTime y stateId. A ellos se suman posiciones, direcciones y estados de pago y envío, que dependen cada uno de tablas propias.
Nuestra recomendación basada en proyectos: no traslade el historial de pedidos por CSV si existe otra vía.
Si planifica la migración desde otro sistema, merece la pena leer el artículo Cambiar de Shopware a Shopify. Muestra, desde la dirección contraria, qué datos suelen perderse en un cambio de plataforma.
Cuando llena una tienda nueva, el orden decide el esfuerzo. Cada paso necesita ID del anterior. Este proceso ha dado buen resultado:
La importación en sí rara vez es el problema de tiempo. El trabajo está en la preparación de los datos. Como orientación aproximada de nuestros proyectos, sin garantía para su caso:
| Situación de partida | Esfuerzo de preparación de datos |
|---|---|
| Hasta 500 productos sencillos, lista de proveedor limpia | De 1 a 2 jornadas de trabajo |
| 2.000 productos con variantes e imágenes de varias fuentes | De 1 a 2 semanas |
| Migración completa con clientes, variantes y traducciones | Parte de un proyecto de migración, planificación en semanas |
Lo que más tiempo consume casi siempre es la calidad de los datos de origen: referencias que faltan, EAN duplicados, tallas indicadas unas veces como M y otras como Mediana. Prevea una depuración antes de crear el primer archivo. Una instancia de prueba en la que pueda repetir importaciones sin riesgo ahorra tiempo en cualquier proyecto. Sobre versiones y actualizaciones del entorno de pruebas encontrará más en el artículo Actualizaciones y versiones de Shopware.
Para las importaciones recurrentes no tiene que abrir cada vez la administración. Shopware dispone del comando de consola import:entity, que según la referencia de comandos importa entidades desde un archivo CSV. Los argumentos exactos los muestra bin/console import:entity --help en su versión instalada. Así puede cargar, por ejemplo, cada noche una lista de stock del proveedor, controlada mediante un cronjob en el servidor.
Hay dos puntos que debe tener en cuenta:
messenger:consume en marcha, los trabajos posteriores como la indexación quedan pendientes. Un alojamiento bien configurado se encarga de ello; más información en el artículo Hosting para Shopware.import-export:delete-expired elimina los archivos de importación y exportación caducados. Sobre todo con datos de clientes, estos archivos no deberían permanecer en el servidor de forma indefinida.Si una importación CSV automática da servicio a más de una fuente de datos o debe funcionar en ambas direcciones, suele ser la antesala de una interfaz real. A partir de ese punto, compensa una conexión con el sistema de gestión de mercancías o el ERP.
Estos son los errores que más vemos en los proyectos. La mayoría se evitan con diez minutos de preparación.
Una importación escribe de inmediato. Un campo de precio mal mapeado cambia miles de precios a la vez, y una cancelación no deshace nada. Pruebe cada archivo nuevo primero con la ejecución de prueba y en un entorno de pruebas. Antes de actualizaciones grandes, haga también una copia de seguridad de la base de datos.
Si en una actualización deja vacía la columna ID y no ha definido un segundo identificador como la referencia, obtendrá productos nuevos en lugar de actualizados. Al final hay duplicados en la tienda. En actualizaciones puras, desactive en el perfil la creación de registros nuevos.
La propia Shopware advierte de que el mensaje tras la importación no significa que todo haya ido bien. Compruebe en el registro cuántos registros han fallado y descargue el archivo de errores.
Una importación añade y sobrescribe, no elimina. Si un producto debe desaparecer de una categoría, no basta con omitir la categoría en el archivo.
Muchas tiendas guardan datos en extensiones, por ejemplo campos adicionales para mercancías peligrosas o precios por unidad de medida. Compruebe antes si un plugin aporta perfiles de importación o campos propios. Qué extensiones han dado buen resultado lo explicamos en el artículo Plugins de Shopware 6.
En un relanzamiento cambian las URL de los productos. Sin redirecciones pierde posiciones y enlaces. Una importación CSV crea nuevas URL, pero no redirecciones desde las antiguas. Para ello necesita una lista propia.
No. El módulo Importar/Exportar está incluido en Shopware 6. Las extensiones del Shopware Store ofrecen formatos adicionales como XML o Excel, programaciones y asignaciones más cómodas. Para la mayoría de los casos basta con el estándar.
UTF-8 como codificación, punto y coma como separador, comillas alrededor de los textos y punto como separador decimal. Lo más seguro es empezar con un archivo que haya exportado antes desde Shopware.
La documentación contiene una referencia de campos para pedidos, pero no una guía. Para migraciones desde Shopware 5 o 6, el asistente de migración es la mejor vía; para otros sistemas, normalmente una importación por API.
Sí, si traslada el hash de la contraseña y el procedimiento a los campos legacyPassword y legacyEncoder y Shopware admite ese procedimiento. De lo contrario, los clientes restablecen su contraseña una vez.
No es posible. La importación añade o sobrescribe. Las eliminaciones se hacen en la administración o por API.
Muchos comercios hacen sus importaciones ellos mismos y, con esta guía, es perfectamente factible para productos, precios y listas de clientes. Cuando se juntan variantes, traducciones, contraseñas y redirecciones, aumenta el riesgo de que los errores solo se noten después de la puesta en marcha. Asesoramos en remoto a comercios online en España que trabajan con Shopware.
Le ayudamos de tres maneras:
Escríbanos a través de la página de contacto qué datos quiere incorporar y de qué sistema proceden. Le diremos con franqueza si puede hacerlo bien usted mismo.

Besnik Bilalli es fundador y CEO de solution25, la agencia de Shopware con sede en Bremen (Alemania). Antes de fundar la agencia en 2017, creó él mismo una tienda online y la llevó a más de 500 pedidos al día. Desde entonces acompaña a comercios en proyectos de Shopware, desde el primer cálculo hasta la operación continua. Responde con gusto personalmente a las preguntas sobre el artículo: Contactar.
Responsable del contenido y de su actualización: Besnik Bilalli. Estado: noviembre de 2026. Próxima revisión del contenido: febrero de 2027.