Importar y actualizar productos con una hoja de cálculo#

Descarga una plantilla de categoría, complétala con tus productos y cárgala en el Catálogo. Este flujo de trabajo no requiere escribir código ni usar credenciales de API.

Antes de empezar#

Selecciona la tienda correcta en el Panel. Necesitas permiso para editar su catálogo. Si falta el botón Cargar hoja de cálculo del producto, verifica la tienda seleccionada, tu permiso de escritura en el catálogo y si tu cuenta es de solo lectura.

Descargar la plantilla de categoría#

1. Abre Panel → Catálogo.
2. Haz clic en Cargar hoja de cálculo del producto para abrir el cuadro de diálogo Importar productos.
3. Debajo de Elige la categoría de producto, selecciona la categoría que deseas importar. Las opciones dependen de la configuración de tu tienda.
4. Haz clic en Descarga la plantilla de Excel. Usa una plantilla y una carga separadas para cada categoría.

Descarga una plantilla nueva cuando prepares una nueva importación para que sus columnas coincidan con los requisitos actuales de la categoría. El libro descargado es una plantilla, no una exportación de tu catálogo existente.

Completa el libro#

Usa las hojas de cálculo del libro de la siguiente manera:

Cada fila de producto debe contener sku, name, image_url y product_url, además de las dimensiones obligatorias para su categoría. Sigue los marcadores de campos obligatorios y las instrucciones de la plantilla descargada. No traduzcas los nombres de campos ni añadas columnas desconocidas o duplicadas.

• Mantén las celdas de SKU como texto para que el software de hojas de cálculo no elimine ceros iniciales ni modifique identificadores largos. Usa una fila por cada SKU; los valores duplicados en el mismo archivo son rechazados, incluidos los que difieren solo en mayúsculas/minúsculas.
• Usa una dirección de imagen HTTP o HTTPS directa y de acceso público para image_url; debe funcionar sin inicio de sesión, cookies o encabezados de solicitud personalizados. Coloca la dirección de la página de detalle del producto en product_url.
• Especifica dimensiones y unidades usando las instrucciones de la plantilla. Si no se indica ninguna unidad en una dimensión o en dimension_unit, la unidad predeterminada es in.
• Elige status de los valores aceptados en Enums. Dejarlo en blanco establece active como valor predeterminado; establécelo explícitamente al actualizar productos.

Guarda como .xlsx (recomendado). .csv también es aceptado si contiene solo la fila de encabezado de productos y datos. Los archivos antiguos .xls no son compatibles. Cada archivo puede contener hasta 50,000 filas de producto no vacías y debe tener un tamaño máximo de 50 MB.

Subir y comprobar el resultado#

1. Vuelve al cuadro de diálogo de importación y selecciona la misma categoría que la plantilla.
2. Debajo de Completa y sube, selecciona tu archivo guardado y haz clic en Iniciar importación.
3. Revisa Importaciones recientes para ver el nombre del archivo, el estado del procesamiento y el número de filas correctas y fallidas. El envío confirma la aceptación; el procesamiento continúa en segundo plano.
4. Espera a que el procesamiento termine y revisa las filas fallidas incluso si la tarea muestra Completado. Vuelve al Catálogo para verificar los datos de los productos importados y si están listos para la visualización.

Si hay filas fallidas, haz clic en Archivo de error, inspecciona los mensajes de error, corrige los datos del producto y sube el archivo corregido con la misma categoría. El libro de errores descargado contiene las filas fallidas y columnas de diagnóstico; estas columnas de diagnóstico se ignoran al volver a subir.

Si se produce un fallo temporal del procesamiento, usa Reintentar cuando esté disponible. Reintentar la misma tarea no corrige datos de productos no válidos. Si la interfaz indica que algunas filas requieren una revisión por parte de soporte, usa Contact support; esas filas no se reintentan automáticamente.

Actualizar productos existentes#

Para actualizar productos, usa la misma plantilla de categoría y conserva el SKU existente de cada producto. Completa todos los campos obligatorios para cada fila que incluyas, cambia los valores que desees actualizar y sube el archivo nuevamente.

• El mismo SKU en la misma tienda actualiza el producto existente. Un SKU que aún no existe crea un nuevo producto. Cambiar un SKU en la hoja de cálculo no renombrará el producto original.
• Puedes subir solo las filas de productos que deseas actualizar. Los productos ausentes en el archivo no se eliminan, deshabilitan ni despublican.
• Esto no es una actualización parcial de campos: los campos obligatorios aún necesitan valores. No asumas que una celda opcional en blanco conserva el valor anterior. En particular, el status en blanco se establece como active, y las unidades de dimensión faltantes usan in como valor predeterminado.
• Conserva tu propio libro completado para futuras actualizaciones. La descarga de plantilla no incluye tus datos actuales de productos.

Cuando termine la tarea, verifica los productos afectados en el Catálogo. Una importación correcta por sí sola no confirma la visibilidad en la tienda; comprueba si los productos están listos para la visualización y consulta la lista de verificación de lanzamiento del SDK.

Automatiza las importaciones#

Para sincronización recurrente del lado del servidor, utiliza la Product Import API. Sus campos de solicitud, límites y comportamiento de actualización parcial se documentan por separado de este flujo de trabajo de hoja de cálculo.