Generar GARAN-Labels en masa para un catálogo grande: CSV o API
Quieres generar GARAN-Labels en masa para varios cientos o varios miles de productos y antes necesitas tres respuestas: si la herramienta aguanta mi catálogo, cuánto me va a costar y cuánto voy a tardar. Esta página responde a las tres con cifras concretas.
¿Qué método encaja con tu catálogo?
El método adecuado depende de dos cosas: cuántos productos necesitan label y con qué frecuencia cambian esos datos.
| Método | Tamaño del catálogo | Frecuencia de cambios | Ideal para |
|---|---|---|---|
| Entrada manual | Menos de 10 labels | Rara vez | Tiendas pequeñas, un puñado de productos con garantía, altas puntuales. |
| Carga CSV | De 10 a 10.000 labels | Mayormente estático, una actualización cada pocos meses | Retailers y marcas con un catálogo grande pero estable. Sin programar nada. |
| API | Cualquier tamaño | Cambios frecuentes, productos nuevos cada semana | Tiendas gestionadas desde un PIM o ERP, agencias y cualquiera que quiera que el label se cree automáticamente al dar de alta un producto. |
Puedes combinarlos: la mayoría de los catálogos grandes empiezan con una carga CSV para la gama existente y pasan a la API para los productos nuevos. Los detalles técnicos de ambos están en la página de referencia de API & CSV.
Primero filtra, después genera: qué SKU necesitan realmente un label
La forma más eficaz de reducir el coste de una carga masiva ocurre antes de subir el archivo. El GARAN-Label solo es obligatorio para los productos en los que un fabricante ofrece una garantía comercial de durabilidad gratuita que cubre todo el producto durante más de dos años. Todos los demás productos necesitan el aviso de garantía legal gratuito, pero ningún GARAN-Label.
Pasa tu exportación de productos por tres preguntas:
- ¿Es un bien físico? Los contenidos digitales y los servicios quedan fuera.
- ¿Existe una garantía del fabricante de más de dos años? Una garantía de exactamente dos años o menos no obliga a mostrar el label.
- ¿Es gratuita y cubre todo el producto? Las extensiones de garantía de pago y las garantías sobre componentes sueltos no cuentan.
En la práctica, un catálogo de 5.000 SKU suele quedarse en unos pocos cientos de productos que realmente cumplen los requisitos. Todo lo demás lo puedes quitar del CSV antes de subirlo. Detalles sobre a quién se aplica la obligación →
Qué necesitas por SKU: marca, modelo y duración
El label en sí es sencillo. Lleva tres valores, y el CSV necesita exactamente estas tres columnas:
brand
La marca o marca comercial tal como aparece en el producto.
model
El identificador de modelo. Las variantes que lo comparten comparten el label.
duration
La duración de la garantía en años, enteros o medios años, por ejemplo 3 o 2.5.
La parte difícil, sin rodeos: la duración de la garantía
Marca y modelo existen en cualquier sistema de tienda. La duración de la garantía del fabricante, normalmente no. La mayoría de las bases de datos de producto tienen, como mucho, un campo «garantía», y ese campo suele contener las condiciones del propio comercio en lugar de la garantía del fabricante. Dónde suele esconderse el dato:
- Tarifas de proveedores y fichas técnicas de producto, muchas veces como observación en texto libre.
- Las condiciones de garantía en la web del fabricante o en el folleto del embalaje.
- Un atributo del PIM o ERP que se rellenó una vez para unas pocas marcas y nunca se volvió a mantener.
Atajo práctico: los fabricantes rara vez fijan la duración por SKU. Suele ser constante por marca o por serie de productos. Recopila la duración una vez por marca y serie y crúzala después con tu exportación de SKU. Así, una tarea de investigación sobre miles de filas se convierte en una lista de unas pocas docenas de entradas.
Ejemplo con cifras: un catálogo de 1.000 SKU
Las cifras siguientes son una ilustración con números redondos, no la medición de un cliente concreto. Muestran cómo funciona el cálculo para que puedas aplicarlo a tu propio catálogo.
| SKU en la tienda | 1.000 | Exportación completa, todas las categorías. |
| SKU con garantía del fabricante de más de dos años | 380 | Tras las tres preguntas de filtrado anteriores. Los otros 620 solo necesitan el aviso gratuito. |
| Combinaciones únicas de marca + modelo + duración | 240 | Tallas y colores comparten identificador de modelo y, por tanto, label. |
| Créditos consumidos | 240 | Un crédito por label generado. Las filas con una combinación repetida reutilizan el label existente. |
| Paquete de créditos | 500 créditos por 49 € | Te quedan 260 créditos para productos nuevos. Como alternativa, dos paquetes de 100 créditos por 38 € si sabes que la gama no va a crecer. |
| Tu tiempo | Media jornada | Casi todo se va en recopilar las duraciones de garantía. La carga tarda minutos y la generación corre sola. |
El resultado es un archivo con una línea por fila de entrada y la URL del label correspondiente. Después descargas las imágenes y las colocas en tu tienda, como se explica más abajo.
Preparar el archivo CSV
Cualquier programa de hoja de cálculo puede generar el archivo. Lo que importa:
- Columnas:
brand,model,durationy, opcionalmente,force_regeneration(1fuerza una nueva generación; vacío o0reutiliza un label existente). - Separador: coma o punto y coma. Excel en español guarda los CSV con punto y coma por defecto, y no pasa nada: la carga detecta el separador a partir de la línea de cabecera.
- Codificación: UTF-8, para que las tildes, la eñe y los caracteres especiales de marcas y modelos lleguen intactos.
- Límite de filas o de tamaño de archivo: ninguno. El archivo se lee línea a línea, sea cual sea su tamaño.
- Formato: antes de subirlo eliges PNG, EPS o PDF para todo el archivo. PNG es lo que necesitas para la tienda; EPS y PDF son para imprimir.
- Procesamiento: se ejecuta en segundo plano con un indicador de progreso. Puedes cerrar la pestaña, cerrar sesión y volver más tarde; el trabajo continúa.
brand;model;duration;force_regeneration
Bosch;GSR 18V-55;3;
Bosch;GSR 18V-55;3;
Makita;DHP486;3;
Miele;W1 WCD 120;5;Las dos filas de Bosch están ahí a propósito: muestran lo que hace la deduplicación. Ambas filas reciben la misma URL de label y solo se consume un crédito.
Entrada: una fila por producto o por modelo.
Salida: las mismas filas más la URL del label de cada una.
Deduplicación: la palanca de coste en las cargas masivas
Un crédito paga un label generado, no una fila de tu archivo. La regla es simple: la misma marca + modelo + duración equivale a un solo label, da igual cuántas filas o cuántas variantes de producto apunten a él. Tres consecuencias para un catálogo grande:
- Las variantes salen gratis. Diez variantes de color de un mismo modelo consumen un crédito.
- Volver a subir el mismo archivo no cuesta nada mientras los labels sigan existiendo en nuestro servidor. Recibes de vuelta las URL existentes.
- Solo los cambios reales cuestan créditos. Una duración de garantía distinta es una combinación nueva y, por tanto, un label nuevo. Poner
force_regenerationa1también vuelve a generar y consume un crédito, así que déjalo vacío salvo que necesites un archivo nuevo.
El cálculo del ejemplo anterior: 1.000 filas, 240 combinaciones únicas, 240 créditos. El precio es por label generado, no por mes ni por usuario, así que un catálogo que no cambia no sigue generando costes.
Paquetes de créditos
| Créditos | Precio | Precio por label |
|---|---|---|
| 100 | 19,00 € | 0,19 € |
| 500 | 49,00 € | 0,10 € |
| 2000 | 144,00 € | 0,07 € |
| 10.000 | 569,00 € | 0,06 € |
Todos los precios no incluyen el IVA legal. 1 crédito equivale a 1 label generado de nuevo. Las repeticiones idénticas (misma marca, mismo modelo, misma duración de garantía) no consumen un crédito adicional. Sin suscripción, sin compra mínima.
Llevar los archivos a tu tienda: URL alojadas o alojamiento propio
Cada label generado es accesible mediante la URL de tu archivo de resultado. Para un catálogo grande tienes dos formas de usarla:
URL alojada (a corto plazo)
Enlaza la imagen directamente. Vale para pruebas y para llenar la tienda rápido, pero los labels se archivan 30 días después de su generación. Pasado ese plazo el enlace se rompe y una nueva solicitud vuelve a generar el label, consumiendo un crédito.
Alojamiento propio (recomendado)
Descarga las imágenes dentro de los 30 días, súbelas a tu propia biblioteca de medios o CDN y asócialas a tus productos por SKU o modelo. Es un trabajo que se hace una sola vez y el label permanece en línea todo el tiempo que necesites.
Cómo se hace esa asociación depende de tu plataforma: un metafield en Shopify, un atributo de producto en Magento 2, un campo personalizado en WooCommerce. Cada guía describe la ruta masiva. Guías por canal de venta →
Errores y casos especiales en archivos grandes
| Situación | Qué ocurre | Qué hacer |
|---|---|---|
| Una fila no tiene modelo (o marca o duración) | Solo esa fila se marca como error en el archivo de resultado. Todas las demás filas se procesan. | Corrige la fila y súbela de nuevo en un pequeño archivo complementario. |
| Falta una columna obligatoria en la cabecera | Todo el trabajo se detiene con el mensaje «Missing required column». | Comprueba los nombres de la cabecera: exactamente brand, model, duration. |
La cabecera parece correcta, pero el trabajo sigue avisando de que falta la columna brand | Lo más probable es que el archivo empiece con una marca de orden de bytes (BOM) invisible. Excel la añade al guardar como «CSV UTF-8». | Guárdalo como CSV normal o elimina la marca con un editor de texto. Los nombres de columna deben empezar en el primer byte. |
| Filas con una duración de dos años o menos | Se generan como cualquier otra fila y consumen un crédito. La herramienta no decide por ti si el label es obligatorio. | Fíltralas antes de subir el archivo; estos productos no necesitan GARAN-Label. |
| Tallas y colores como filas separadas | Las filas con la misma marca, modelo y duración comparten un label y un crédito. | Nada. Conserva las filas si te facilita asociar el resultado a tus SKU. |
| Comas o puntos y coma dentro de un nombre de modelo | Se aplica el entrecomillado CSV estándar. | Pon el valor entre comillas dobles, como hace automáticamente cualquier hoja de cálculo. |
| Las tildes y la eñe se ven mal en el label | El archivo se guardó con una codificación antigua. | Guárdalo como UTF-8 y súbelo de nuevo con force_regeneration a 1 en las filas afectadas. |
Prueba primero la estructura de tu archivo: el modo sandbox también funciona con cargas CSV y genera muestras PNG con marca de agua sin consumir créditos.
¿Listo para etiquetar todo tu catálogo?
Regístrate gratis, sube un archivo de prueba en modo sandbox y revisa el resultado antes de comprar un solo crédito.
Probar gratis¿Necesitas los parámetros técnicos y el código de ejemplo? Referencia de API & CSV →
Quién necesita realmente el GARAN-Label →
Guías de integración por canal de venta →
Preguntas sobre la generación masiva de GARAN-Labels
¿Cuánto se tarda en generar 1.000 GARAN-Labels?
Unos dos a cuatro minutos. Subes el archivo una vez y la generación se ejecuta en segundo plano en nuestros servidores, por lotes, aunque cierres el navegador. Después descargas el archivo de resultados. Para un catálogo de este tamaño, reserva una tarde para preparar los datos, no para la generación en sí.
¿Hay un límite de filas o de tamaño en la carga CSV?
No, ni de filas ni de tamaño de archivo. El archivo se lee línea a línea y se procesa en segundo plano, así que los catálogos muy grandes funcionan sin dividir el archivo. Si lo prefieres, puedes subir un archivo por marca o por proveedor para que los archivos de resultado sean más manejables.
¿Pago por cada fila de mi CSV?
No. Un crédito solo se consume cuando se genera realmente un label. Las filas con la misma combinación de marca, modelo y duración de garantía comparten un único label, y una fila que solo vuelve a solicitar un label existente dentro de su plazo de 30 días no cuesta nada.
¿Las variantes de producto, como tallas o colores, necesitan cada una su propio label?
Normalmente no. El label muestra marca, modelo y duración de la garantía. Si tus variantes comparten el mismo identificador de modelo y la misma garantía, un solo label las cubre a todas. Ahí es exactamente donde la deduplicación te ahorra créditos.
¿En qué se diferencia esta página de la página de la API?
Esta página te ayuda a decidir cómo etiquetar un catálogo grande y cuánto cuesta. La página de la API es la referencia técnica, con parámetros y código de ejemplo para cURL, PHP, Python y Node.js. Referencia de API & CSV →