Importar productos por lotes

Usa una importación estructurada desde una hoja de cálculo cuando una tienda necesite agregar o actualizar muchas categorías, productos o modificadores. Un importador puede procesar filas usando identificadores externos estables, pero es una operación que escribe en el catálogo: antes de subir nada, confirma la tienda de destino, la estructura del archivo, las asignaciones y la ruta de aprobación.

Las importaciones pueden crear o sobrescribir datos del catálogo

Una carga puede cambiar categorías, productos, modificadores, descripciones, precios, impuestos, cargos, imágenes y disponibilidad. Prueba la importación con un conjunto de datos pequeño y aprobado en una tienda que no sea de producción; revisa el resultado antes de importar el catálogo completo.

Qué puede representar un importador

El flujo documentado de importación múltiple puede organizar:

• categorías;
• productos;
• modificadores de productos, incluidos extras, opciones y subopciones.

Cada fila representa un elemento que se crea o modifica. El importador asocia esa fila con el negocio, categoría, producto o modificador previstos mediante ID externos. Esto sirve para migrar un catálogo, subir un menú grande, aplicar actualizaciones masivas repetibles o gestionar una estructura compleja de modificadores.

Prepara el archivo y las asignaciones

El flujo de origen describe esta secuencia:

Prepare importer structure
        ↓
Prepare the importer file
        ↓
Match the Business External ID
        ↓
Upload the file
        ↓
Review the resulting categories, products, and modifiers

Antes de subir el archivo:

1. Usa CSV o un formato de hoja de cálculo compatible con el importador aprobado.
2. Define un ID externo único para cada negocio y cada elemento del catálogo asignado.
3. Confirma que Business External ID en el archivo coincida con la tienda prevista.
4. Si el importador seleccionado usa ese formato, conserva los valores decimales de precio con punto, como 5.5.
5. Decide qué asignaciones necesita el importador: Category, Product, Extra Product, Extras, Extra Options y Extra Option Sub-options.
6. Antes de usar el archivo completo, valida una muestra pequeña.

Configura el importador

Si la configuración aprobada no ofrece ya un importador múltiple, el responsable de implementación puede configurar las asignaciones requeridas, asignar nombre y slug al importador y guardarlo mediante el flujo controlado correspondiente. El material histórico incluye ejemplos de API y plantillas, pero no se verificaron para uso actual su endpoint, carga útil, enlaces externos abreviados ni medios. No reutilices esas URL históricas ni una solicitud de Postman como instrucción de producción.

Para consultar el modelo conceptual actual, revisa Modelo de importador. Explica los trabajos de importación, su estado, progreso, resultado y contexto de errores; por sí sola, no autoriza una solicitud ni documenta un endpoint de carga actual.

Sube el archivo y revisa el resultado

1. Selecciona el importador aprobado para la tienda prevista.
2. Sube el archivo validado mediante la interfaz aprobada.
3. Espera el estado devuelto del importador o del trabajo; un mensaje del cliente no significa que se hayan procesado todas las filas.
4. Antes de considerar listo el catálogo, inspecciona en la tienda de destino las categorías, productos, modificadores, precios e imágenes.
5. Registra los errores o cambios inesperados mediante el proceso de soporte aprobado y sin compartir datos de clientes, catálogos, tokens ni credenciales.

Patrones comunes de importación

• Solo categorías y productos: si el esquema aprobado lo permite, deja vacíos los campos de modificadores que no necesites.
• Actualizar productos existentes: conserva los ID externos actuales para que se identifiquen los registros previstos; verifica el resultado, porque una asignación de fila no demuestra que solo hayan cambiado los campos deseados.
• Varios modificadores: usa deliberadamente las asignaciones de modificadores cuando un producto necesite extras, opciones o subopciones.

Lista final de comprobación

• Cada ID externo es único cuando el importador lo requiere.
• El ID externo del negocio coincide con la tienda de destino.
• Los precios usan el formato decimal esperado.
• Primero se revisó un conjunto pequeño de datos de prueba aprobado.
• El importador, el archivo cargado, la tienda de destino y el estado devuelto corresponden a la operación prevista.

Guías relacionadas: Resumen de productos · Crear una categoría de productos · Importadores