Importación masiva de productos o servicios

En resumen: cómo importar productos desde Excel

1. En el listado de Productos, presiona Más acciones → Importar → Productos (Excel).
2. Descarga la plantilla oficial y complétala — no uses un Excel armado por ti mismo.
3. Sube el archivo. El sistema revisa todo antes de dejarte avanzar.
4. Si hay errores, corrígelos en el Excel y vuelve a subirlo — no puedes continuar con errores pendientes.
5. Confirma la importación.

Usa el “Código interno” con cuidado

Si el código interno de una fila ya existe, el sistema actualiza ese producto (y suma el stock de la fila al que ya tenía) en vez de crear uno nuevo. Si el código está vacío o no existe, crea un producto nuevo. Revisa bien esa columna antes de subir.

Si el archivo falla a medio camino

El sistema procesa el Excel fila por fila. Si una fila (por ejemplo, la 340 de 500) tiene un error que no se detectó antes de subir, las filas anteriores que ya se procesaron quedan creadas/actualizadas — no se revierte todo el archivo. Por eso conviene subir en bloques de 500-1000 filas: si algo falla, es más fácil identificar qué se alcanzó a cargar.

El resto del artículo detalla las columnas exactas de la plantilla, cómo se manejan errores e imágenes, y los límites reales del sistema.

---

La plantilla Excel — columnas exactas

Descárgala siempre desde el botón de la pantalla (no reutilices una plantilla vieja). Tiene 21 columnas, en este orden:

Columna	Campo	¿Obligatoria?
A	Descripción del producto	Sí
B	Código interno	No (pero define si crea o actualiza — ver arriba)
C	Modelo	No
D	Código de producto SUNAT	No
E	Unidad de medida (NIU, ZZ, KGM, BX, etc.)	Sí
F	Moneda (PEN o USD)	Sí
G	Precio de venta	Sí
H	Tipo de afectación IGV de venta	Sí
I	¿Incluye IGV? (SI/NO)	Solo si H es “Gravado”
J	Precio de compra	No (por defecto 0)
K	Tipo de afectación IGV de compra	Sí
L	Stock inicial	Sí
M	Stock mínimo	Sí
N	Categoría	No (se crea sola si no existe)
O	Marca	No (se crea sola si no existe)
P	Nombre corto (el que sale en ticket/PDV)	No
Q	Nombre secundario	No
R	Código de lote	No
S	Fecha de vencimiento del lote	Obligatoria si llenaste R
T	Código de barras	No
U	URL de imagen	No

Lotes

Si llenas la columna R (código de lote) pero dejas S vacía (fecha de vencimiento), el sistema no te deja avanzar.

Cómo se detectan errores

Antes de dejarte subir el archivo, el sistema revisa todas las filas del Excel (no solo las primeras) y separa los problemas en dos grupos:

• Errores que bloquean todo — campos obligatorios vacíos, o un lote sin fecha de vencimiento. Mientras existan, el botón dice “Corrige N errores primero” y no puedes continuar.
• Advertencias — moneda distinta a PEN/USD, precio o stock que no parece un número, IGV gravado sin marcar la columna I. Estas te dejan seguir, pero revísalas.

También revisa que no haya códigos internos repetidos dentro del mismo archivo — si encuentra duplicados, rechaza el archivo completo antes de crear nada.

Si el error viene del servidor (por ejemplo, una categoría con nombre demasiado largo), el sistema traduce el mensaje técnico a algo entendible en vez de mostrarte el error crudo.

Imágenes durante la importación

Solo se cargan por URL (columna U) — no hay forma de subir archivos de imagen locales en la importación masiva. El sistema:

1. Verifica que la URL sea válida y pública (rechaza direcciones internas por seguridad).
2. Confirma que el contenido sea realmente una imagen.
3. Genera 3 tamaños (grande, mediano, pequeño), igual que cuando subes una imagen manualmente.

Si la URL falla o no la pusiste, el producto queda con la imagen genérica “no disponible” — puedes subirle la foto real después, editando el producto.

Si tu archivo trae imágenes, tarda más

El sistema te avisa antes de procesar si detecta URLs de imagen en el archivo — la carga va a demorar más porque tiene que descargar cada imagen una por una.

Límites reales

• Tamaño de archivo: 5 MB máximo.
• Formato: solo .xlsx.
• Filas: no hay un límite fijo en el sistema, pero el procesamiento es en el momento (no es una tarea en segundo plano) — archivos muy grandes pueden demorar tanto que el servidor corte la conexión antes de terminar. Por eso la recomendación práctica es subir en bloques de 500 a 1000 filas.

Actualizar vs. crear — la regla exacta

El sistema decide únicamente por el código interno (columna B):

• Código vacío → siempre crea un producto nuevo.
• Código que ya existe → actualiza ese producto: descripción, precios, IGV, stock mínimo, nombres y código de barras. El stock de la fila se suma al stock que el producto ya tenía (no lo reemplaza). Si trae un lote nuevo, también se suma.
• Código que no coincide con nada → crea un producto nuevo con ese código.

No hay forma de encontrar el producto por nombre, código de barras u otro campo — solo por código interno exacto.