Skuvera

Corrige „Invalid CSV header: missing headers“ en una importación de productos a Shopify

Shopify no encontró una o más columnas obligatorias en la primera fila de su archivo. Renombre los encabezados de sus columnas para que coincidan exactamente con la plantilla de CSV de productos de Shopify, incluidos Title y URL handle, e importe de nuevo.

Mensaje de error en Shopify

Invalid CSV header: missing headers

Qué significa este error

La primera línea de un CSV de productos es la fila de encabezados, y Shopify empareja las columnas por sus nombres exactos. Si falta una columna obligatoria como Title o URL handle (Handle en plantillas antiguas), o su nombre está escrito de otra forma, Shopify no puede leer el archivo y detiene la importación.

Causas frecuentes

  • El archivo provenía de otra plataforma con sus propios nombres de columna, como Name en lugar de Title.
  • Se eliminó una columna obligatoria mientras se editaba el archivo.
  • Un encabezado tiene un espacio extra, un error tipográfico o una redacción distinta a la de la plantilla de Shopify.

Cómo corregirlo

  1. Descargue el CSV de ejemplo de productos de Shopify o exporte un producto de su tienda para ver los encabezados correctos.
  2. Compare la primera fila de su archivo con el ejemplo, columna por columna.
  3. Renombre cualquier columna cuyo nombre no coincida exactamente y añada las columnas obligatorias que falten.
  4. Elimine los espacios al principio o al final de cada encabezado.
  5. Guarde el archivo como CSV UTF-8 e impórtelo de nuevo.

Ejemplo

Antes
Handle,Name,Price
wool-scarf,Wool scarf,24.90
Después
URL handle,Title,Price
wool-scarf,Wool scarf,24.90

Name no es una columna de Shopify. Renombrarlo a Title, y Handle a URL handle, ajusta el archivo a la plantilla actual.

Cómo evitarlo

  • Empiece los archivos nuevos a partir de la plantilla de Shopify o de una exportación reciente en lugar de crear los encabezados a mano.
  • Use un validador que compare cada encabezado con los nombres de columna actuales y antiguos de Shopify.

Detecte este problema antes de importar

Skuvera comprueba su CSV de productos con todas las reglas de Shopify en su navegador y señala la fila y la columna exactas. Gratis y sin registro.

Preguntas frecuentes

¿Puedo usar los nombres de columna antiguos como Variant Price?
Shopify aún acepta archivos con su plantilla antigua, pero mantenga todas las columnas en un solo formato. Mezclar nombres antiguos y nuevos en un archivo puede hacer que las columnas se lean mal.
¿Qué es la ventana „Choose column headings“?
Shopify la muestra cuando sus encabezados no coinciden. Allí puede asignar cada columna, pero corregir los encabezados en el archivo es más fiable para futuras importaciones.

Comprobaciones relacionadas en Skuvera

Lea la explicación de Shopify

Otros errores de importación

Actualizado el 30 de octubre de 2026