Formato del archivo
Se aceptan tres formatos: .csv, .json y .xlsx. Elija el que le resulte más fácil de sostener — el que ya exporte su ERP suele ser el mejor.
Los envíos de ventas y de stock van por separado: son dos subidas, cada una con su archivo.
Se suben en la página de envío, hasta 4,5 MB por archivo. Si su exportación de stock pesa más en .csv, mándela en .xlsx, que ocupa bastante menos.
El grano diario multiplica las filas: el mismo artículo en la misma tienda aparece una vez por cada día que vendió. Si su exportación de ventas en .csv se pasa del límite, mándela en .xlsx.
Reglas del archivo
| Codificación | UTF-8 |
| Separador | Coma |
| Decimales | Punto. Sin separador de miles |
| Fechas | YYYY-MM-DD, por ejemplo 2026-08-03. Nunca 03/08/2026 |
| Comillas | Dobles, sólo donde el valor lleva una coma |
| Encabezado | Obligatorio, en la primera fila, con los nombres exactos |
| Vacíos | Celda vacía es dato ausente, no cero |
| Booleanos | true o false |
product_sku_size, product_sku_model, product_sku_retail_number y product_ean son texto, aunque parezcan números. Un talle 42 es la cadena 42, y un EAN que empieza con cero conserva el cero. Si su exportador los convierte a número, el talle 07 llega como 7 y el EAN pierde dígitos.
Excel en configuración regional argentina exporta con punto y coma y coma decimal, y reescribe las fechas. Antes de guardar, formatee las columnas de fecha como texto. Use las plantillas de abajo, que ya vienen configuradas.
Cómo se llaman las columnas
El nombre de cada columna es la ruta del campo en el JSON, con los puntos reemplazados por guiones bajos.
| En el JSON | En el CSV |
|---|---|
date | date |
banner.name | banner_name |
point_of_sale.type | point_of_sale_type |
product.sku.model | product_sku_model |
product.sku.size_scale | product_sku_size_scale |
quantity | quantity |
sales.csv
date,banner_name,banner_market_seller,
point_of_sale_name,point_of_sale_type,warehouse_name,warehouse_is_central,
product_sku_model,product_sku_variation,product_sku_size,product_sku_size_scale,
product_sku_retail_number,product_brand,product_name,product_ean,product_supplier_code,
currency,quantity,total_amount_at_sale_price_excl_vat,
total_amount_at_list_price_excl_vat,total_amount_at_cost_excl_vatVeintiuna columnas. Obligatorias: date, banner_name, point_of_sale_name, point_of_sale_type, product_sku_model, product_brand, currency, quantity y los importes a precio de venta y a precio de lista.
product_sku_variation y product_sku_size no figuran como obligatorias porque hay artículos que no tienen color ni talle, pero las pedimos en todo lo que los tenga.
total_amount_at_cost_excl_vat también es opcional, pero es lo único que muestra si el descuento que hizo se comió el margen. Mándelo si su sistema lo exporta.
stock.csv
as_of,banner_name,warehouse_name,warehouse_is_central,
product_sku_model,product_sku_variation,product_sku_size,product_sku_size_scale,
product_sku_retail_number,product_brand,product_ean,on_hand,on_transit,
unit_list_price_excl_vat,unit_cost_excl_vatQuince columnas. Obligatorias: as_of, warehouse_name, warehouse_is_central, product_sku_model, product_brand y on_hand.
unit_cost_excl_vat también es opcional. Es lo que permite saber cuánta plata propia tiene inmovilizada en lo que no rota.
Plantillas
Con los mismos datos que el ejemplo de Qué lleva cada fila, para que pueda comparar fila por fila:
Qué devuelve
Un código de envío en pantalla. Guárdelo: es lo que hay que citar si nos escribe por ese envío.
El archivo se guarda tal cual llega y se revisa después. Que la subida salga bien no significa que el contenido esté completo — si algo no cierra, le escribimos.