Importar ventas históricas por CSV
Prepara un archivo, valida su período y evita duplicar ventas en vivo.
La importación histórica sirve para incorporar un período anterior. No reemplaza un webhook para recibir ventas nuevas ni ocupa un espacio de webhook.
Preparar el archivo
Desde Fuentes de ventas, abre la importación histórica y descarga la plantilla mínima o completa.
La plantilla mínima exige:
| Columna | Contenido |
|---|---|
external_sale_id | ID estable de la venta o pedido. No uses el número de fila. |
occurred_at | Fecha y hora de la venta; preferiblemente con zona u offset. |
amount | Valor bruto sin símbolo monetario ni separador de miles. |
Define los valores comunes de país, moneda, zona horaria, estado y tipo de producto. Si una fila trae un valor propio, debe corresponder a esa venta. Para archivos que mezclan mercados, incluye los datos en cada fila.
El ID de anuncio es opcional. Sin una atribución válida, la venta se conserva como Sin definir.
Importar
- Selecciona un CSV UTF-8, de hasta 100.000 ventas o 25 MB.
- Espera la revisión de todas las filas.
- Revisa fechas, cantidades, atribución, importes y advertencias.
- Confirma el plan de cobertura: el histórico no debe solaparse con el período que ya cubre una conexión.
- Confirma la importación y consulta su resultado e historial.
La carga parcial no se publica en el dashboard. Solo considera terminada una importación cuando el resultado confirme que su intervalo quedó publicado. Si hay errores, descarga el detalle y corrige el archivo completo.
Corregir o reintentar
Conserva los mismos IDs al corregir. Vuelve a subir el archivo completo del período, no solamente las filas modificadas. Omitir una venta no la cancela: indica su estado cancelado o reembolsado cuando corresponda.
Un reintento del mismo archivo y configuración no debe duplicar ventas. Si una carga quedó interrumpida, vuelve a seleccionar el archivo correcto y revisa el progreso guardado.
No subas por CSV las mismas ventas que ya entran por otra fuente. Consulta mercados y fechas.
Revisado el 3/10/2026