Importar o actualizar productos desde Excel

Crea productos nuevos o actualiza los existentes de forma masiva con el Importador de productos y su modelo de Excel.

El Importador de productos carga un Excel y, según el modo que elijas, crea productos nuevos o actualiza los que ya existen. Los productos se identifican por su código, que en el archivo va en la columna codigo_item.

Este importador trabaja sobre el maestro de productos. Para cargar cantidades de stock, usa el Excel de una operación de inventario.

En WeSyncro:InventarioProductosImportar

Los dos modos#

Modo	Qué hace	Qué no hace
Crear	Crea los productos cuyo código no existe	Nunca actualiza registros existentes. Si el código ya existe, esa fila no se procesa
Actualizar	Modifica los productos cuyo código ya existe	Nunca crea registros nuevos. Si el código no existe, esa fila no se procesa

Elige el modo en Modo de importación antes de seleccionar el archivo. Si lo cambias después, el análisis se reinicia.

Columnas del archivo#

Presiona Descargar modelo Excel para obtener la plantilla, o Información del modelo para ver cada columna con su marca de Obligatorio u Opcional.

Columna	Contenido	En modo Crear	En modo Actualizar
`description`	Nombre del producto	Obligatoria	Opcional
`codigo_item`	Código del producto	Obligatoria	Obligatoria
`short_description`	Descripción corta	Opcional	Opcional
`long_description`	Descripción larga	Opcional	Opcional
`gtin`	Código de barras o GTIN	Opcional	Opcional
`category`	Nombre de la categoría. Si no existe se crea automáticamente	Opcional	Opcional
`image_url`	URL principal de la imagen	Opcional	Opcional
`peso`, `alto`, `ancho`, `largo`	Medidas del producto	Opcional	Opcional
`price`	Precio	Opcional	Opcional
`costo`	Costo del producto	Opcional	Opcional
`sale_price`	Precio oferta	Opcional	Opcional
`sale_start_date`, `sale_end_date`	Inicio y fin del descuento, en formato año-mes-día	Opcional	Opcional

Si tienes campos personalizados para productos, puedes agregar una columna con el nombre de cada campo. Información del modelo los lista al final.

Pasos#

Elige el modo y carga el archivo
Selecciona Crear o Actualizar y presiona Seleccionar archivo. Se lee la primera hoja del Excel.
Analiza el archivo
Aparece el número de registros cargados. Presiona Analizar archivo: se revisa cada código contra tu maestro y se marcan las filas como Válido o Inválido.
Revisa el resumen
Tres tarjetas muestran Total archivo, cuántos Se pueden crear (o Se pueden actualizar) y cuántos No se pueden procesar. Si hay problemas, Ver detalle abre la lista con el motivo y la fila de cada uno.
Sube los registros
Si todo es válido, presiona el botón Crear o Actualizar con el número de registros. Si hay inválidos, puedes corregir el archivo y repetir, o presionar Subir válidos para procesar solo los correctos.
Lee el resultado final
Resultado final indica cuántos fueron creados o actualizados, cuántos quedaron con error y el total procesado. Ir a productos te lleva al listado.

En modo Crear, antes de subir puedes usar Asignar cliente (opcional) para asociar los productos nuevos a un cliente.

Problemas frecuentes#

"Faltan columnas requeridas en el archivo"#

Al archivo le falta codigo_item, o description si estás en modo Crear. El detalle indica "Columna requerida no encontrada" con el nombre. Los nombres de columna deben coincidir con los del modelo; no importan las mayúsculas.

"Código ... ya existe"#

Estás en modo Crear y ese código ya está en tu maestro. Quita la fila, o cambia a modo Actualizar si lo que quieres es modificarlo.

"Código ... no existe para actualizar"#

Estás en modo Actualizar y no hay ningún producto con ese código. Revisa que el código esté escrito igual que en la ficha, o crea el producto primero.

"Código ... está repetido dentro del archivo"#

El mismo código aparece en más de una fila. Deja una sola.

"Debes indicar al menos un campo adicional junto a codigo_item para actualizar"#

En modo Actualizar, una fila trae solo el código y ningún dato que cambiar.

"sale_start_date inválida en la fila ..."#

La fecha no se pudo interpretar. Escríbela como año-mes-día, por ejemplo 2026-11-27. El mismo mensaje existe para sale_end_date.

"Primero corrige los inválidos o sube solo los válidos"#

Intentaste subir todo habiendo filas inválidas. Usa Subir válidos o corrige el archivo.