QuetzaLink Docs
Nivel OrganizaciónProductos

Importar y Exportar Productos

Carga masiva de productos desde Excel/CSV y exportación del catálogo

Importa productos de forma masiva desde archivos Excel o CSV, y exporta tu catálogo para respaldos o análisis.

La importación/exportación de datos está disponible en el plan Emprendedor o superior.

Importar Productos

Preparar el Archivo

Formato Soportado

  • Excel (.xlsx, .xls)
  • CSV (separado por comas, codificación UTF-8)

Columnas Disponibles

ColumnaRequeridoDescripciónEjemplo
nombre✅ SíNombre del producto"Camiseta Polo Premium"
skuNoCódigo SKU (auto-genera si vacío)"CAM-POL-001"
codigo_barrasNoCódigo de barras EAN-13"7501234567890"
descripcionNoDescripción del producto"Camiseta de algodón..."
categoriaNoNombre de la categoría"Ropa > Camisas"
unidadNoUnidad de medida"unidad", "kg", "litro"
precio_costoNoCosto sin IVA"80.00"
precio_venta✅ SíPrecio con IVA"112.00"
ivaNoPorcentaje de IVA (default: 12)"12"
stock_minimoNoAlerta de stock bajo"5"
proveedorNoNombre del proveedor"Distribuidora ABC"
visible_ventasNoMostrar en POS (default: true)"true" o "false"
imagen_urlNoURL de imagen pública"https://..."

Plantilla de Ejemplo

nombre,sku,precio_venta,precio_costo,categoria,unidad,iva,stock_minimo
"Camiseta Polo Azul",CAM-001,112.00,80.00,Ropa,unidad,12,5
"Pantalón Jeans",PAN-001,280.00,200.00,Ropa,unidad,12,3
"Café Premium 1kg",CAF-001,145.00,100.00,Bebidas,kg,12,10

Proceso de Importación

  1. Ve a Productos
  2. Haz clic en Importar (ícono de flecha hacia arriba)
  3. Selecciona o arrastra tu archivo
  4. Mapeo de columnas: Verifica que cada columna se asigne correctamente
  5. Vista previa: Revisa los primeros registros
  6. Validación: El sistema detecta errores (SKUs duplicados, campos inválidos)
  7. Haz clic en Importar

Reglas de Importación

EscenarioComportamiento
SKU ya existeSe actualiza el producto existente
SKU vacíoSe genera automáticamente
Categoría no existeSe crea la categoría
Proveedor no existeSe crea el proveedor
Precio inválidoSe marca como error, no se importa

Manejo de Errores

Después de la importación, verás un resumen:

  • ✅ Productos creados exitosamente
  • 🔄 Productos actualizados
  • ❌ Registros con errores (descarga el reporte)

Revisa el archivo de errores para corregir registros fallidos. Los errores comunes son: SKU duplicado en el archivo, precio con formato incorrecto (usa punto como decimal), o campos requeridos vacíos.

Exportar Productos

Exportar Catálogo Completo

  1. Ve a Productos
  2. Haz clic en Exportar (ícono de flecha hacia abajo)
  3. Selecciona el formato:
    • Excel (.xlsx): Para edición en hojas de cálculo
    • CSV: Para sistemas externos
  4. El archivo se descargará automáticamente

Exportar con Filtros

  1. Aplica filtros en la lista de productos (categoría, proveedor, estado)
  2. Haz clic en Exportar
  3. Solo se exportarán los productos filtrados

Columnas Exportadas

La exportación incluye todos los campos del producto:

  • Información básica (nombre, SKU, código de barras)
  • Precios (costo, venta, IVA)
  • Clasificación (categoría, proveedor)
  • Configuración (unidad, stock mínimo, visible en ventas)
  • Inventario actual por ubicación
  • Variantes (si aplica)

Importar Inventario Inicial

Para cargar stock inicial masivamente:

  1. Exporta los productos existentes
  2. Agrega columnas de inventario por ubicación:
    • stock_sucursal_centro
    • stock_bodega_principal
  3. Importa el archivo actualizado
  4. Selecciona la opción "Actualizar inventario"

La importación de inventario crea movimientos de "Ajuste - Carga inicial" para mantener la trazabilidad.

Actualización Masiva de Precios

Para actualizar precios de múltiples productos:

  1. Exporta el catálogo actual
  2. Modifica las columnas de precio
  3. Importa el archivo
  4. El sistema actualizará los productos existentes por SKU

Mejores Prácticas

Antes de Importar

  • Respalda tu catálogo actual exportando primero
  • Prueba con un archivo pequeño (10-20 productos)
  • Verifica la codificación UTF-8 para caracteres especiales
  • Usa la plantilla proporcionada para evitar errores de formato

Formato del Archivo

  • Usa comillas para textos con comas
  • Usa punto (.) como separador decimal
  • No incluyas símbolos de moneda (Q, $)
  • Fechas en formato YYYY-MM-DD

Después de Importar

  • Revisa el reporte de errores
  • Verifica algunos productos aleatoriamente
  • Confirma que las categorías se crearon correctamente
  • Valida los precios y configuraciones

Límites

PlanProductos por Importación
GratisNo disponible
Emprendedor300 productos
Negocio1,000 productos
ProIlimitados

Para catálogos muy grandes, divide la importación en lotes por categoría o proveedor.

Solución de Problemas

ErrorCausaSolución
"SKU duplicado"El SKU ya existe en otro productoUsa otro SKU o deja vacío para auto-generar
"Precio inválido"Formato incorrectoUsa solo números con punto decimal
"Caracteres extraños"Codificación incorrectaGuarda como UTF-8
"Archivo muy grande"Excede el límite del planDivide en archivos más pequeños

On this page