# Importar productos masivos
## Cuándo conviene importar
- Carga inicial del sistema (cientos o miles de productos)
- Migración desde otro sistema
- Actualización masiva de campos puntuales (precios, costos, stock)
- Sincronización con catálogo de proveedor
## Formato del archivo
El sistema acepta **CSV** o **XLSX** (Excel).
Plantilla descargable desde **Productos → Importar → Descargar plantilla**.
Columnas mínimas obligatorias:
| Columna | Obligatoria | Descripción |
|---------|-------------|-------------|
| `Nombre del producto` | ✅ | Nombre tal como aparece en POS |
| `SKU` | ✅ | Único, no se puede repetir |
| `Tipo de impuesto` | ✅ | Ej: "IVA Básico" |
| `Unidad` | ✅ | "Pieza", "Kg", "Litro" |
| `Categoría` | ✅ | Si no existe la crea automático |
| `Precio venta` | ✅ | Número, con o sin IVA según config |
Columnas opcionales:
| Columna | Descripción |
|---------|-------------|
| `Código de barras` | EAN/UPC |
| `Costo de compra` | Para cálculo de margen |
| `Marca` | Si no existe la crea automático |
| `Stock alerta` | Umbral de aviso |
| `Stock inicial` | Stock al momento de importar |
| `Proveedor` | Nombre del proveedor por defecto |
| `Descripción` | Texto largo |
| `Custom field 1-20` | Datos extra |
## Paso a paso
### 1. Preparar el archivo
- Abrí la plantilla en Excel
- Cargá los productos (uno por fila)
- **Verificá codificación UTF-8** al guardar como CSV (importante para tildes y ñ)
- Guardá como `.csv` o `.xlsx`
### 2. Subir al sistema
**Productos → Importar productos**
- Adjuntar archivo
- Elegir si las cantidades vienen con o sin IVA
- Confirmar mapeo de columnas (el sistema detecta auto si los nombres coinciden con la plantilla)
### 3. Previsualizar
Antes de importar, el sistema muestra una **previsualización** con las primeras 50 filas:
- ✅ Verde: fila lista para importar
- ⚠️ Amarillo: warning (ej: SKU ya existe, se va a sobreescribir)
- ❌ Rojo: error (ej: precio vacío, categoría no existe y no se puede crear)
Corregí los errores en el archivo y volvé a subir.
### 4. Ejecutar la importación
Hacé clic en **Importar**. El sistema procesa en lote:
- ~500 productos por minuto
- Muestra una barra de progreso
- Al final muestra el resumen: importados / actualizados / errores
> ⚠️ **NO cierres la pestaña** durante la importación grande. Si la conexión se corta, los productos ya procesados quedan, pero hay que reiniciar la importación con el resto.
## Actualizar precios masivos
Para actualizar SOLO precios (sin tocar el resto):
1. Exportar productos a Excel (filtrando lo necesario)
2. Modificar la columna **Precio venta** o **Costo**
3. Importar de nuevo activando **Actualizar existentes (matching por SKU)**
El sistema solo modifica los campos que vienen en el archivo, deja el resto intacto.
## Errores comunes
| Error | Causa | Solución |
|-------|-------|----------|
| "SKU duplicado en archivo" | Hay 2 filas con el mismo SKU | Renombrar uno o dejar solo uno |
| "Categoría no encontrada y auto-crear desactivado" | La categoría no existe | Activar auto-crear o crear manualmente antes |
| "Caracteres raros (ñ, tildes)" | Encoding no UTF-8 | Re-guardar el CSV como UTF-8 en Excel |
| "Precio inválido" | Formato con punto y coma mezclados (1.234,56) | Usar formato 1234.56 (punto como decimal) |