Ir al contenido principal

¿Cómo cargo Plantillas de Producto de forma masiva con un archivo CSV?

Cree muchas Plantillas de Producto a la vez cargando un CSV. Conozca los requisitos, columnas y reglas de validación.

Puede crear muchas Plantillas de Producto (SKUs) a la vez cargando un archivo CSV (valores separados por comas), en lugar de añadirlos de uno en uno. Una Plantilla de Producto es la definición de catálogo de un producto. La carga masiva valida el archivo completo primero y luego crea todas las plantillas de una sola vez.

Para información sobre el tipo de producto en sí, consulte ¿Qué es una Plantilla de Producto?


Descargar el CSV de ejemplo

La manera más fácil de preparar su archivo es comenzar con el CSV de ejemplo de Plantilla de Producto. Tiene exactamente los encabezados de columna que la carga espera, junto con una fila de ejemplo mínima y una fila de ejemplo completamente rellenada. Conserve la fila de encabezado, reemplace las filas de ejemplo con las suyas propias y guarde el archivo como .csv.


Iniciar una carga masiva

Para cargar Plantillas de Producto de forma masiva con un archivo CSV:

  1. Vaya a Ecosystem Registries > Product Templates.

  2. Abra el menú de tres puntos en la parte superior de la lista y elija Bulk Upload via CSV.

  3. Seleccione su archivo .csv preparado e inicie la carga.


Requisitos del archivo

Su archivo debe cumplir estos requisitos antes de ser aceptado:

Requisito

Detalle

Tipo de archivo

Un archivo .csv.

Tamaño del archivo

Menos de 20 MB.

Separador decimal

Los números usan "." (punto), por ejemplo 12.5.

Fechas del producto

Use el formato dd/MM/yyyy, por ejemplo 31/12/2026. Una fecha de fin no puede ser anterior a su fecha de inicio.


Lo que cubren las columnas

El CSV tiene un amplio conjunto de columnas. Se dividen en los siguientes grupos (el CSV de ejemplo anterior muestra los nombres exactos de los encabezados):

Grupo de columnas

Lo que contiene

Identity and description

ID, Name, Brand, Brand Owner, Manufacturer, Visibility, Country of Origin y descripciones.

Classification

GPC (la Clasificación Global de Productos GS1) y Uniclass, cada uno con un código y un título, para segmento, familia, clase y ladrillo.

Dimensions, weights and volume

Atributos físicos, cada uno asociado a su propia unidad.

Packaging and storage

Temperaturas de almacenamiento y tipo de embalaje.

Warranty and product dates

Detalles de garantía e intervalos de fechas.

Metadata

Columnas de formato libre llamadas Metadata.<Type>.<Field> para sus propios datos adicionales.


Campos obligatorios

Cada fila debe incluir los siguientes campos, o la carga es rechazada:

Campo obligatorio

Notas

ID

Debe ser único y no debe existir ya en su Product Template Registry.

Name

El nombre de la Plantilla de Producto.

Brand Owner

Tanto el ID como el tipo.

Visibility

Público o privado.

Country of Origin

Un país válido.

GS1 segment and family titles

El segmento y la familia GS1 de nivel superior.


Reglas de validación

El sistema comprueba cada fila según estas reglas antes de crear nada:

  • ID único: el ID no puede coincidir con una plantilla que ya exista.

  • Emparejamiento de medida y unidad: si proporciona una medida, debe proporcionar su unidad, y viceversa. La unidad debe ser válida para ese tipo de medida, y los valores numéricos deben ser positivos.

  • Datos de referencia: los países, las clasificaciones GS1 y Uniclass, los tipos de embalaje, y las Organizaciones de Brand Owner y Manufacturer se comprueban en relación con los datos de referencia existentes.

  • Fechas: las fechas del producto usan dd/MM/yyyy, y una fecha de fin no puede ser anterior a la fecha de inicio.


Qué ocurre después de la carga

La carga es todo o nada en la etapa de validación: cada fila se valida primero y, si alguna falla, la carga completa es rechazada y se muestra una lista de errores por fila. No se crea nada hasta que el archivo sea válido. Cuando el archivo supera la validación, las Plantillas de Producto se crean de inmediato. No se ponen en cola en segundo plano ni se crean como borradores; aparecen en su lista de Product Templates de forma inmediata.

Nota: Si un ID duplicado llega a pasar, se omite silenciosamente en lugar de crear una segunda plantilla, aunque en la práctica la verificación de "ID ya existe" suele detectarlo primero.

¿Ha quedado contestada tu pregunta?