El mapeo de campos es el paso que conecta tu archivo CSV o Excel con Shopify.
En vez de que el sistema adivine qué columna corresponde a qué campo, tú decides explícitamente esa correspondencia.
Una vez configurado, puedes guardar el mapeo como una configuración reutilizable para no tener que repetir el proceso en cada importación.
1) ¿Qué es el mapeo de campos?
Cuando importas un archivo personalizado (CSV o Excel), el sistema desconoce qué significa cada columna. El mapeo resuelve esto: tú indicas "la columna Nombre del producto corresponde al campo Título en Shopify".
Tu CSV o Excel
| Nombre | Cod | PVP |
|---|
| Silla XL | SKU-01 | 49.99 |
→
Campo en Shopify
- Nombre → Title
- Cod → SKU
- PVP → Price
¿Cuándo se usa el mapeo?
Solo en las Importaciones Personalizadas. Las Importaciones Estándar no requieren mapeo porque el archivo proviene de una exportación propia y ya tiene la estructura conocida.
2) Crear una configuración de mapeo
Sigue estos pasos la primera vez que uses un tipo de importación personalizada:
-
Selecciona el tipo de importación
(ej. "Actualización de Productos", "Actualización de precios", "Productos completos"…).
-
Sube o proporciona el archivo CSV o Excel (.xlsx/.xls)
para que el sistema detecte sus columnas.
-
Accede a la pantalla de mapeo.
Verás dos columnas: a la izquierda las cabeceras detectadas en tu archivo, a la derecha el desplegable de campos de Shopify.
-
Asocia cada columna del archivo con su campo Shopify
usando los desplegables. Las columnas que no necesites importar puedes dejarlas sin asignar.
-
Asigna un nombre a la configuración
y haz clic en "Guardar configuración".
Consejo:
Pon un nombre descriptivo que incluya el tipo y origen del archivo, por ejemplo "Proveedor ABC – Actualización precios".
Así será fácil identificarlo en futuras importaciones.
3) Tipos de campos: estándar, metafields y valores fijos
Campos estándar
Son los campos nativos de Shopify accesibles directamente desde el desplegable: Título, SKU, Precio, Stock, Tipo de producto, Proveedor, Campos SEO, Imágenes, Variantes…
Actualización de Productos:
mapea siempre el SKU como identificador. Este tipo de importación solo acepta campos estándar de producto y variante; los metafields no aparecen como opción y se ignoran si proceden de una configuración antigua.
Permiten almacenar datos adicionales que no caben en los campos estándar de Shopify. Al seleccionar "Metafield" en el desplegable, deberás indicar:
| Parámetro |
Descripción |
Ejemplo |
| Namespace | Agrupación lógica del metafield | custom |
| Key | Nombre único dentro del namespace | ean |
| Type | Tipo de dato: texto, número, booleano… | single_line_text_field |
Valores fijos (Fixed values)
Un valor fijo asigna el mismo dato a todos los productos de esa importación, sin necesidad de que esté en el CSV.
Ejemplo de uso:
- Todos los productos de este CSV son del proveedor "Distribuidora Norte" → campo Vendor = valor fijo "Distribuidora Norte".
- Todos los productos importados pertenecen al tipo "Accesorios" → campo Product Type = "Accesorios".
Para usar un valor fijo, selecciona el campo Shopify de destino y activa la opción "Valor fijo" en lugar de seleccionar una columna del CSV. Escribe el valor que quieres asignar.
4) Reutilizar configuraciones guardadas
Una vez guardada una configuración, en las siguientes importaciones del mismo tipo no necesitas volver a mapear. El proceso es:
- Selecciona el tipo de importación.
- Sube o proporciona el archivo CSV.
- En la pantalla de mapeo, abre el desplegable "Configuraciones guardadas" y selecciona la que corresponde.
- El sistema rellena automáticamente todas las asignaciones. Revisa que no haya columnas nuevas sin mapear.
- Continúa con las opciones e inicia la importación normalmente.
Importante:
Si tu proveedor añade o renombra columnas entre versiones del archivo, la configuración guardada no cubrirá esas columnas nuevas. Revisa siempre el mapeo antes de confirmar la importación.
5) Editar o borrar una configuración existente
La gestión de configuraciones guardadas se realiza desde la propia pantalla de Importación:
- Ve a Importaciones y elige el tipo de importación personalizada.
- En el apartado de mapeo, abre el desplegable de "Configuraciones guardadas" y selecciona la que quieres modificar.
- Haz los cambios en las asignaciones de campos y pulsa "Guardar configuración" para actualizar.
- Para borrarla, selecciona la configuración en el desplegable y usa el botón "Eliminar configuración".
Atención:
Borrar una configuración es permanente. Si una importación recurrente la usa, las siguientes ejecuciones fallarán. Desactiva o actualiza primero la recurrencia si corresponde.
6) Buenas prácticas: consistencia de nombres de columnas
La configuración de mapeo se basa en los nombres exactos de las cabeceras del archivo (CSV o Excel). Si el nombre cambia, el mapeo deja de funcionar.
❌ Inconsistente
- Versión 1:
Precio Venta
- Versión 2:
precio_venta
- Versión 3:
PVP
Cada cambio rompe el mapeo guardado.
✅ Consistente
- Versión 1:
precio_venta
- Versión 2:
precio_venta
- Versión 3:
precio_venta
El mapeo funciona siempre sin tocar nada.
Recomendaciones:
- Usa minúsculas y guiones bajos: <code>precio_venta</code>, <code>codigo_sku</code>.
- Evita espacios, tildes y caracteres especiales en las cabeceras.
- Si recibes el archivo de un proveedor externo, crea una plantilla de transformación (en Excel o un script) para normalizar las cabeceras antes de importar.
- Documenta internamente qué configuración de mapeo corresponde a cada proveedor o fuente.