Importar productos

Inventario y catálogo. Ruta base: /inventory/products/importar.

Para qué sirve

Importar productos da de alta el catálogo de una sola vez, desde un archivo CSV o Excel (hasta 5 MB) que viene de otro sistema, del catálogo de un proveedor o de tus libros. El proceso es por lotes y siempre revisable: el archivo se sube, Flux detecta qué columna es cada dato, ves la vista previa fila por fila y solo entonces confirmas. Si el lote ya confirmado no quedó bien, se revierte completo.

Antes de empezar

Descarga la plantilla desde la misma pantalla (formato CSV o Excel): ya trae los encabezados que Flux espera y una fila de ejemplo. También puedes subir un archivo con tus propios encabezados: la pantalla te deja indicar a qué dato corresponde cada columna antes de validar.

Las columnas disponibles cubren la ficha del producto:

• Obligatorias: sku, nombre y precio. El SKU es único por negocio: una fila con un SKU ya registrado se marca para revisión.
• Descriptivas: descripcion, categoria, marca, atributos, imagenes, ancho_cm, alto_cm, profundidad_cm.
• Comerciales: costo, impuesto, unidad, estado.
• Existencias: existencias con almacen, o existencias_por_almacen para repartir el mismo SKU entre varios almacenes: el alta masiva también puede cargar el inventario inicial.

Cómo funciona el lote

1. Sube el archivo. Flux lee los encabezados y propone a qué dato corresponde cada columna.
2. Revisa las columnas y corrige las que no correspondan. Aunque Flux las reconozca todas, la pantalla te pide revisarlas («Reconocimos todas las columnas. Revísalas y confirma el mapeo.»): no valida nada hasta que pulsas Confirmar mapeo. Entonces valida cada fila: SKU, obligatorios, importes, unidades y existencias.
3. Revisa la vista previa. Cada fila queda marcada como importable, con error o saltada, y los avisos dicen exactamente qué corregir y en qué renglón. Mientras haya errores que bloquean, el lote no se confirma.
4. Confirma con Confirmar importación. Solo cuando la vista previa lo permite, el lote se aplica: los productos aparecen en el catálogo con su existencia y el lote queda registrado con quién lo subió y quién lo confirmó.
5. Revierte si hace falta. Un lote confirmado se puede revertir completo: los productos que creó y las existencias que aplicó se deshacen como importación. La reversión ya no está disponible si el lote aún no se confirma o si ya fue revertido antes.

Qué ver en el historial de lotes

La pantalla conserva cada importación con su archivo, estado (validada, importada, revertida), conteos de filas y bitácora de auditoría: así se sabe qué entró, cuándo y por mano de quién.

Límites

• Archivo de hasta 5 MB, en CSV o Excel.
• La importación crea productos nuevos; no actualiza la ficha de uno que ya existe; para eso se edita desde el detalle del producto.
• La pantalla pide permiso de escritura de productos; ver los lotes no basta para confirmarlos.

Si el archivo trae variantes o estructuras complejas

La plantilla cubre el catálogo estándar. Productos con variantes (talla/color), recetas o empaques compuestos se capturan desde la ficha del producto una vez creado, o se revisan caso por caso con soporte.