Errores del CSV de productos de Shopify: encabezado inválido y filas omitidas

El CSV de productos de Shopify es implacable de una forma muy concreta: acepta el archivo, anuncia que la importación ha terminado, y te deja con productos sin variantes, precios a cero o la mitad del catálogo ausente. Los errores que sí reporta son escuetos.

Esto es lo que significa cada uno.

«Invalid header» — un nombre de columna no reconocido

Shopify identifica las columnas por el texto exacto de su encabezado. Variant price, variant_price y Price son todos incorrectos; la columna se llama Variant Price. Las mayúsculas y los espacios cuentan.

La solución. Exporta un producto existente desde Productos → Exportar y usa la fila de encabezados de ese archivo como plantilla. Siempre es el conjunto de nombres correcto y actualizado para tu tienda.

El handle es lo que une las filas de variantes

URL handle es el slug de URL del producto: minúsculas, números y guiones. Si lo omites en un producto nuevo, Shopify lo deduce del Title, así que un handle vacío no es lo que hace desaparecer productos.

Donde lo decide todo es en las variantes. Cada fila de variante debe repetir el mismo handle que su producto padre, porque es lo único que las vincula. Una fila de variante con el handle vacío o mal escrito se convierte en un producto aparte: la causa real del «el producto se importó, pero cada talla es un artículo distinto».

Y cuando actualizas productos existentes en lugar de crearlos, la documentación de Shopify es explícita: URL handle y Title son las columnas obligatorias.

Variantes no creadas, o fusionadas en un solo producto

Esta es la parte del formato que hace tropezar a casi todo el mundo. Las variantes no son columnas: son filas adicionales.

Un producto con tres tallas ocupa cuatro filas en el archivo:

• Fila 1 lleva el producto completo: Handle, Title, Body (HTML), Vendor, Type, Tags, más Option1 Name (Talla), Option1 Value (S), y el precio y el SKU de esa variante.
• Filas 2 a 4 repiten el mismo Handle, dejan Title y todas las demás columnas de nivel producto vacías, y solo rellenan Option1 Value (M, L) con su propio precio, SKU y stock.

De hacerlo mal se derivan dos fallos:

• Repetir el Title en cada fila hace que Shopify trate cada una como un producto distinto.
• Rellenar Option1 Value dejando Option1 Name vacío en la primera fila hace que las opciones se ignoren por completo.

Precios importados como 0, o rechazados

Variant Price y Variant Compare At Price deben ser números puros con el punto como separador decimal. Sin símbolo de moneda, sin separador de miles, sin espacios.

1 299,00 € falla. 1299.00 funciona.

Es un problema sistemático con las exportaciones de herramientas europeas, donde 1.299,00 es la forma normal de escribir el importe — y Excel volverá a aplicar ese formato cada vez que abras el archivo.

La solución. Pon la columna de precio en formato Texto y escribe el valor en bruto, o haz la conversión en el momento de exportar. Ojo: cambiar cómo Excel muestra el número no basta — lo que importa es lo que acaba en el CSV guardado.

Acentos rotos

El archivo debe ser UTF-8. Un CSV guardado desde un Excel en español está en Windows-1252, así que Café llega como Café.

La solución. Guardar como → CSV UTF-8 (delimitado por comas) — la entrada separada en la lista de formatos de Excel. La opción CSV a secas no sirve.

Imágenes no importadas

Image Src debe ser una URL completa y accesible públicamente — https://…, no una ruta local ni un enlace tras un inicio de sesión. Shopify descarga cada una durante la importación; todo lo que no pueda obtener se omite en silencio.

Para un producto con varias imágenes, añade filas extra que compartan el Handle, rellenando solo Image Src e Image Position.

Otras cosas que conviene saber

• Published acepta TRUE o FALSE; Status acepta active, draft o archived.
• Variant SKU debería ser único en toda la tienda — los duplicados hacen que el inventario se comporte de forma impredecible.
• Importar un Handle que ya existe actualiza ese producto en lugar de crear uno nuevo. Muy útil a propósito, destructivo por accidente.

Lista de comprobación previa

• Fila de encabezados copiada de una exportación real de Shopify
• URL handle indicado al actualizar productos existentes (Shopify lo deduce para los nuevos)
• Las filas de variante repiten el handle y dejan vacías las columnas de producto
• Option1 Name relleno en la primera fila de cada producto
• Precios como números puros con punto decimal
• Archivo guardado como CSV UTF-8
• URLs de imagen públicas y absolutas

Cuando es el mismo archivo de proveedor cada semana

Montar esto a mano una vez, para migrar un catálogo, es una tarde razonable.

Hacerlo cada semana con una tarifa de proveedor, no. Importly toma la exportación en bruto, renombra las columnas a los nombres de Shopify (Title, Variant SKU, Variant Price, Variant Grams, Image Src…), quita los símbolos de moneda y convierte los separadores decimales, normaliza pesos, cantidades y códigos de barras, corrige la codificación y elimina las filas vacías. Guárdalo como perfil y el archivo de la semana siguiente pasa por las mismas reglas — el Handle y las filas de variantes siguen siendo cosa tuya, porque Importly limpia nombres de columnas y valores, no reestructura filas.

Limpia tu primera exportación gratis →