Importar CSV Shopify: límites del nativo y sincronización vía API
El importador CSV nativo de Shopify funciona para 50 productos. Más allá, la sincronización por Admin API evita timeouts, variantes rotas y fichas duplicadas.
Gestionas una tienda Shopify con algunos cientos de productos y la importación CSV nativa empieza a mostrar sus límites. Tus variantes se importan mal, las imágenes quedan recortadas, algunas filas no pasan en silencio, y descubres en producción que tus descripciones son idénticas a las de tres competidores que revenden el mismo catálogo de proveedor.
Este artículo es para ti si:
- Tu catálogo Shopify supera los 200 productos o varios cientos de variantes
- Trabajas con varios proveedores con sus propios formatos de archivo
- Sincronizas stock, precios o fichas de producto más de una vez por semana
- Vendes en varios idiomas (Shopify Markets) o en varias tiendas
Para una importación puntual de 30 productos al año, la herramienta nativa de Shopify es perfectamente válida. Para todo lo demás, sigue leyendo.
Lo que hace el importador CSV nativo de Shopify
Formato esperado y columnas reconocidas
El importador CSV está en Shopify Admin > Productos > Importar. Shopify solo acepta archivos .csv (no Excel) en UTF-8 con coma como separador.
Las principales columnas esperadas por el motor nativo:
| Columna | Descripción |
|---|---|
Handle | Slug del producto (clave de identificación — obligatoria para agrupar variantes) |
Title | Nombre del producto |
Body (HTML) | Descripción larga (HTML permitido) |
Vendor | Marca / proveedor |
Product Category | Categoría estándar Shopify |
Type | Tipo personalizado |
Tags | Etiquetas separadas por coma |
Published | Visible o no |
Option1 Name / Option1 Value | Primer eje de variante (talla, color…) |
Variant SKU | Referencia de variante |
Variant Price | Precio de venta |
Variant Inventory Qty | Stock |
Variant Barcode | Código de barras EAN/UPC |
Image Src | URL de imagen (1 por fila) |
Image Alt Text | Texto alternativo |
SEO Title | Title SEO |
SEO Description | Meta description SEO |
Nota técnica: una variante = una fila CSV. Un producto con 12 variantes ocupa 12 filas compartiendo el mismo Handle. Las imágenes adicionales también ocupan filas dedicadas. Un catálogo de 800 productos con un promedio de 5 variantes genera fácilmente un archivo de 6.000 a 8.000 filas.
Cómo lanzar una importación
Subes el archivo al Admin, Shopify procesa del lado del servidor y te envía un email al terminar. No hay configuración de mapping: los nombres de columnas deben coincidir exactamente, de lo contrario se ignoran en silencio.
Los 6 límites concretos del importador CSV de Shopify
1. Variantes: una fila por combinación y todo se rompe rápido
La trampa principal. Si el mismo Handle aparece con valores de Option1 Name que varían (“Color” en una fila, “color” en otra, o un espacio extra), Shopify crea combinaciones fantasma. Una variante mal nombrada simplemente desaparece de la importación sin mensaje de error útil.
2. Sin rollback ni idempotencia
Reimportar el mismo archivo dos veces da resultados impredecibles según si los Handle se reconocen como existentes o no. Shopify sobrescribe los campos presentes y conserva los ausentes — no hay opción nativa “crear solo lo que falta”.
3. Imágenes: una por fila y descarga lenta
Cada fila Image Src descarga el archivo remoto desde la URL. En un catálogo con varias imágenes por producto, la importación pasa la mayor parte del tiempo descargando. Si la URL de origen se vuelve inaccesible antes de finalizar (límite del proveedor, enlace expirado), la imagen simplemente queda ausente — sin alerta.
4. Sin planificación, sin webhook entrante
La importación es estrictamente manual. Sin programación desde el Admin, sin forma nativa de desencadenar la importación al recibir un archivo de proveedor. La única vía de automatización pasa por la Admin API o una herramienta externa.
5. Reporting mínimo
Al final de la importación, Shopify envía un email de resumen: “X productos importados, Y errores”. La lista detallada de filas en error llega en un CSV adjunto, pero sin contexto de causa más allá del mensaje técnico bruto. Diagnosticar por qué 47 productos fallaron sobre 800 sigue siendo trabajo manual.
6. Contenido = lo que el proveedor escribió
Es el límite más estructural. El CSV transporta el título, la descripción y las características del proveedor. No tu tono, no tus palabras clave SEO, no tus traducciones Shopify Markets. Tus competidores que revenden el mismo catálogo tienen la misma descripción. Google penaliza sistemáticamente las fichas duplicadas entre revendedores en competencia.
Lo que aporta una automatización externa vía Admin API
Sincronización granular por producto
Shopify expone una Admin API (REST y GraphQL) que permite crear, leer, modificar y eliminar cada recurso (producto, variante, imagen, inventario, precio) sin pasar por CSV. Una solución como PropulseCom usa esta API para enviar únicamente los cambios pertinentes — modificar 15 precios requiere 15 llamadas API, no reimportar un archivo de 8.000 filas.
PropulseCom se conecta a tu tienda Shopify vía OAuth (o mediante la creación de una Custom App en Shopify Admin > Settings > Apps), luego lee automáticamente tus colecciones, mercados (Markets), idiomas activos y opciones de variantes — sin reintroducir datos.
Idempotencia y gestión de duplicados
Una sincronización bien diseñada es idempotente: el mismo dato enviado dos veces produce el mismo resultado. La deduplicación se apoya en un identificador estable — Handle, SKU o Barcode — para decidir crear o actualizar. Sin productos fantasma, sin variantes duplicadas.
Flujo de errores y observabilidad
Para cada producto enviado, la API devuelve el detalle del éxito o fracaso:
- El error se captura con su causa (variante inválida, imagen inaccesible, SKU duplicado, conflicto de Product Category)
- El producto en error pasa a reintento automático sin bloquear el resto
- Todas las operaciones se registran con timestamp, ID Shopify, acción y resultado
- El seguimiento avanza en tiempo real en la interfaz PropulseCom
Después de generar 3.000 productos, sabes exactamente qué se creó, qué se actualizó y qué falló — y por qué.
Casos de uso concretos
Análisis del catálogo del proveedor: nuevos, existentes, faltantes
A cada nuevo archivo de proveedor, PropulseCom compara automáticamente el CSV entregado con el estado real de tu catálogo Shopify vía la API:
- Nuevos productos: presentes en el archivo, ausentes de Shopify → importables en un clic
- Productos existentes: ya en la tienda → el módulo muestra las diferencias de precio de compra (delta en € y %) para validar las actualizaciones
- Productos faltantes: en Shopify, ausentes del archivo → identificados para decidir su desactivación
El mapping de columnas de cada proveedor se memoriza en la primera importación y se reutiliza automáticamente en cada entrega siguiente.
Generación de fichas de producto en el tono de la tienda
PropulseCom añade una capa de generación IA entre la importación CSV y la creación en Shopify. Configuras prompts personalizables por campo: título, descripción corta, descripción larga, SEO title, SEO description, etiquetas. Estos prompts codifican el tono, vocabulario y ángulos diferenciadores de tu marca. La IA genera luego en este marco preciso para cada producto del archivo del proveedor.
Un modo test sobre 3 productos permite validar la calidad antes de lanzar la generación en masa — accesible directamente vía el generador de fichas de producto.
Shopify Markets: multilingüe sin sobrecoste
Si usas Shopify Markets para vender en varios idiomas, PropulseCom detecta automáticamente todos los idiomas activos al conectarse y genera el contenido en cada uno en una sola pasada: 1 crédito = 1 producto, todos los idiomas incluidos. Sin configuración adicional, sin coste multiplicado por número de mercados.
Más allá del texto: reconocimiento de imágenes y descripciones enriquecibles
Vision IA sobre imágenes de producto
Un CSV de proveedor suele contener URLs de imágenes. La importación nativa Shopify las descarga y adjunta a los productos — sin verificar que sean utilizables. PropulseCom analiza cada visual antes de la publicación y detecta:
- Marcas de agua del proveedor o partner, no utilizables en escaparate
- Coherencia producto/imagen: ¿la imagen representa realmente el producto listado?
- Resolución: las imágenes demasiado bajas degradan la experiencia zoom y la tasa de conversión
En 2.000 nuevos productos entregados, el análisis IA marca automáticamente los visuales no conformes antes de la publicación — evitando devoluciones de clientes y una auditoría manual semanas después. Beneficio SEO: Google penaliza las imágenes duplicadas entre revendedores y las imágenes de mala calidad. Identificar problemas en origen evita correcciones a posteriori que requieren desindexación y nuevo paso del bot. Puedes verificar el estado actual de tu tienda con nuestra auditoría SEO de tienda.
Descripciones enriquecibles: un activo editorial que se construye en el tiempo
El workflow típico:
- CSV bruto del proveedor — título + características + una frase descriptiva genérica
- PropulseCom genera — descripción corta, descripción larga, SEO title, SEO description, etiquetas, en el tono definido por tus prompts
- Recibes en Shopify — una ficha pre-rellenada, editable, a la que añades tus elementos diferenciadores (reseñas de clientes, garantías específicas, comparativos internos)
La IA genera contenido único a tu tienda — en tu estilo, tus palabras clave, todos tus idiomas. Nuestra guía SEO de fichas de producto detalla los 6 criterios que marcan la diferencia frente a un competidor que revende los mismos productos.
Tabla comparativa: CSV nativo vs Matrixify vs PropulseCom
| Criterio | CSV nativo Shopify | Matrixify (ex-Excelify) | PropulseCom |
|---|---|---|---|
| Volumen soportado | < 1.000 filas fiable | Decenas de miles | Ilimitado, batch automático |
| Gestión de errores | Email resumen + CSV de errores | Informe detallado por fila | Captura por producto, reintento auto, logs con timestamp |
| Idempotencia | Parcial | Sí | Sí — dedup por Handle/SKU/Barcode |
| Templates de mapping reutilizables | No | Sí | Sí — guardado + recarga |
| Generación IA de descripciones | No | No | Sí — prompts personalizables por campo |
| Modo test (3 productos antes de masa) | No | No | Sí |
| Multilingüe automático (Markets) | No | Parcial (vía export/import) | Sí — 1 crédito = 1 producto todos los idiomas |
| Vision IA sobre imágenes | No | No | Sí — marca de agua, coherencia, resolución |
| Análisis catálogo proveedor | No | No | Sí — nuevos / existentes / faltantes + delta precio |
| Créditos prepagados | N/A | Suscripción mensual (25–80 $/mes) | Sí — 100 créditos al registrarse |
| Intervención humana | En cada importación | Configuración + supervisión | Configuración inicial + validación de calidad |
Nota sobre el TCO: el coste aparente de 0 € del CSV nativo no contempla el tiempo de operador. En un catálogo sincronizado dos veces por semana, 1 a 2 horas por operación = 100 a 200 horas/año. A un coste horario de 30 € (coste cargado de un empleado e-commerce), son 3.000 a 6.000 €/año de coste oculto — sin contar las correcciones de errores de importación y las fichas incompletas.
FAQ
¿Por qué la importación CSV Shopify pierde variantes en silencio?
Shopify usa el par Handle + valores de Option1/2/3 para identificar una variante. Cualquier diferencia de mayúsculas, espaciado o tipografía en el nombre de opción crea una variante distinta en lugar de actualizar una existente. La herramienta nativa no alerta: las variantes huérfanas solo son visibles navegando por el producto tras la importación. La sincronización por API empareja variantes por SKU en lugar de por nombre de opción, eliminando esta trampa.
¿Cuál es la diferencia entre Matrixify y la sincronización por Admin API?
Matrixify se mantiene en la lógica de archivo: mejora el formato CSV/Excel y el reporting, pero sigue procesando un archivo batch. La sincronización por Admin API es granular — los datos se leen desde cualquier fuente (CSV proveedor, feed, base interna) y se envían directamente a los endpoints GraphQL/REST de Shopify, producto por producto. Las reglas de negocio se aplican en el flujo, no en preprocesamiento.
¿Cómo actualizar los precios Shopify automáticamente desde un archivo de proveedor?
PropulseCom lee el precio de compra del archivo del proveedor durante el mapping, aplica tu regla de margen (configurada una vez), y escribe el precio de venta en Shopify vía la Admin API. La misma lógica se reaplica en cada entrega del proveedor sin intervención manual.
¿Se pueden importar variantes complejas (3 ejes) en CSV Shopify?
Sí, hasta 3 ejes (Option1, Option2, Option3). Pero cada combinación = una fila. Un producto con 5 colores × 4 tallas × 2 materiales ocupa 40 filas, todas compartiendo el mismo Handle. La fragilidad viene de la consistencia absoluta requerida entre todas estas filas — un solo desvío de nomenclatura rompe silenciosamente la variante. PropulseCom genera el mapping de variantes desde tus atributos origen y garantiza la consistencia de las combinaciones.
¿Qué frecuencia de sincronización es posible con la Admin API de Shopify?
Shopify limita la Admin API a 2 peticiones por segundo en el plan estándar (con un bucket burst de 40), 4 en Shopify Plus. PropulseCom respeta automáticamente estos cuotas con backoff y reintento — la frecuencia práctica de sincronización está limitada por tu número de créditos, no por los cuotas Shopify.
¿Cómo puede la IA generar contenido único cuando mis competidores revenden los mismos productos?
Porque el contenido generado no es la descripción del proveedor reformateada — es una creación dentro del marco preciso que has definido. Los prompts personalizables permiten inyectar tu tono, vocabulario y ángulos diferenciadores (servicio, experiencia, garantías) en cada ficha. Dos revendedores importando el mismo archivo obtendrán descripciones estructuralmente diferentes si sus prompts difieren. Palanca adicional con Shopify Markets: PropulseCom genera en todos tus idiomas activos en una sola pasada, al mismo coste (1 crédito / producto). Más páginas indexables = más superficie SEO frente a un competidor monolingüe.
Pasa a la automatización
Si tu catálogo Shopify evoluciona más de una vez por semana, si tienes varios proveedores con sus propios formatos, o si pierdes tiempo retratando archivos CSV en Excel antes de cada importación — la herramienta nativa te cuesta más de lo que te ahorra.
PropulseCom conecta tus fuentes de datos a Shopify vía la Admin API, genera descripciones en tu tono, cubre todos tus idiomas (Shopify Markets), y analiza tus imágenes antes de la publicación. Las primeras fichas se generan con 100 créditos al registrarse — sin tarjeta bancaria.
Probar PropulseCom gratis en tu tienda Shopify
Para ir más lejos:
Prueba la herramienta relacionada
Pon en práctica los consejos de este artículo con nuestra herramienta gratuita.
Probar la herramienta gratis