Carga masiva de productos

La carga masiva te permite gestionar cientos de productos sin hacerlo uno por uno. Es ideal para actualizaciones de precio, ajustes de stock o incorporación de nuevos productos.

• Generar una plantilla CSV con tu catálogo actual.
• Editar productos existentes de forma masiva.
• Crear productos nuevos dejando product_id vacío.
• Actualizar imágenes desde una URL externa.
• Actualizar tasas masivas en la vertical currency_exchange.

1. Ve a Inventario > Productos (/items).
2. Haz clic en el menú de tres puntos (⋮) en la parte superior.
3. Selecciona Carga masiva de productos.

La plantilla es un CSV con todos tus productos actuales ya cargados. Si es la primera vez, debes generarla.

1. Si no existe plantilla previa, haz clic en Generar plantilla y espera.
2. Si ya existe una plantilla lista, el botón principal muestra Descargar plantilla.
3. Descarga el archivo CSV y ábrelo en Excel, Google Sheets o cualquier editor de hojas de cálculo.

Antes de editar la plantilla, ten en cuenta estas reglas para evitar errores al importar.

• No elimines ni renombres los encabezados de columna.
• Para productos existentes, conserva el product_id.
• Para productos nuevos, deja product_id vacío y define un import_key único.
• Si un producto aparece en varias filas (una por sucursal), los campos compartidos deben ser consistentes en todas las filas.
• Para vaciar un campo compartido, vacíalo en todas las filas del mismo producto.

El campo inventory_tracking_mode define cómo se controla el stock del producto.

• quantity: controla el stock por unidades. Usa inventory_quantity para definir las existencias disponibles.
• availability: no lleva conteo numérico. Usa inventory_is_available (true/false) para marcar si el producto está disponible.

1. Descarga la plantilla.
2. Filtra las filas del producto o productos que quieres actualizar.
3. Edita price, inventory_tracking_mode, inventory_quantity e inventory_is_available según necesites.
4. Guarda el archivo y súbelo en el Paso 2.

import_key,product_id,inventory_scope,location_id,item_type,name,price,inventory_tracking_mode,inventory_quantity,inventory_is_available
3c9...,3c9...,location,6d2...,physical,Camiseta negra,79900,quantity,12,true

1. Duplica una fila de referencia o agrega una nueva al final del CSV.
2. Deja product_id vacío.
3. Define un import_key único para el nuevo producto.
4. Completa al menos name e item_type.
5. Opcionalmente agrega price, image_url e inventario.
6. Sube el CSV.

import_key,product_id,inventory_scope,location_id,item_type,name,description,price,image_url,inventory_tracking_mode,inventory_quantity,inventory_is_available
nuevo-cafe-01,,all,,prepared_food,Café de origen,Tostado medio,18000,https://example.com/cafe.jpg,availability,,true

Si tu vertical es currency_exchange, la plantilla incluye columnas para manejar tasas de cambio. Puedes editar márgenes o precios directamente.

1. Descarga la plantilla FX.
2. Edita fx_buy_margin_percent, fx_sell_margin_percent o los precios directos fx_buy_price y fx_sell_price.
3. Si tienes API de tasas configurada, deja fx_auto_pricing en true para que el sistema recalcule automáticamente.
4. Sube el CSV.

import_key,product_id,item_type,name,fx_base_currency,fx_quote_currency,fx_reference_code,fx_quote_unit,fx_auto_pricing,fx_buy_margin_percent,fx_sell_margin_percent
usd-cop,8f1...,foreign_exchange_asset,Dólar USD,USD,COP,USD,1,true,1.5,2.1

1. En el modal de carga masiva, ve al Paso 2.
2. Selecciona y sube el CSV editado.
3. Espera a que la corrida en segundo plano finalice.
4. Revisa el resumen de resultados y los errores si los hay.

Puedes actualizar la imagen de un producto usando la columna image_url.

• Si la URL no cambia respecto al valor actual, no se resincroniza.
• Si la URL cambia, el sistema descarga la imagen y la sube al almacenamiento interno.
• La imagen queda asociada al producto automáticamente.

• Los productos existentes se identifican por product_id. No cambies ese valor.
• No es posible sobrescribir el stock de productos con inventario por variantes.
• location_name es solo referencia visual; la sucursal se resuelve por location_id.
• El procesamiento es asíncrono; siempre revisa el resumen final.
• Valida cambios críticos en una organización de prueba antes de hacerlo en volumen.