Importar vendas históricas por CSV
Prepare um arquivo, valide seu período e evite duplicar vendas ao vivo.
A importação histórica incorpora um período anterior. Não substitui um webhook para receber vendas novas nem ocupa um espaço de webhook.
Preparar o arquivo
Em Fontes de vendas, abra a importação histórica e baixe o modelo mínimo ou completo.
O modelo mínimo exige:
| Coluna | Conteúdo |
|---|---|
external_sale_id | ID estável da venda ou pedido. Não use o número da linha. |
occurred_at | Data e hora da venda; de preferência com fuso ou offset. |
amount | Valor bruto sem símbolo monetário ou separador de milhares. |
Defina os valores comuns de país, moeda, fuso horário, estado e tipo de produto. Se uma linha trouxer um valor próprio, ele deve corresponder àquela venda. Em arquivos que misturam mercados, inclua os dados em cada linha.
O ID do anúncio é opcional. Sem atribuição válida, a venda é preservada como Sem definir.
Importar
- Selecione um CSV UTF-8 com até 100.000 vendas ou 25 MB.
- Aguarde a revisão de todas as linhas.
- Confira datas, quantidades, atribuição, valores e avisos.
- Confirme o plano de cobertura: o histórico não pode se sobrepor ao período já coberto por uma conexão.
- Confirme a importação e consulte o resultado e o histórico.
Uma carga parcial não é publicada no dashboard. Considere a importação concluída somente quando o resultado confirmar que o intervalo foi publicado. Se houver erros, baixe os detalhes e corrija o arquivo completo.
Corrigir ou tentar novamente
Mantenha os mesmos IDs ao corrigir. Envie novamente o arquivo completo do período, não apenas as linhas alteradas. Omitir uma venda não a cancela: informe o estado cancelado ou reembolsado quando aplicável.
Uma nova tentativa do mesmo arquivo e configuração não deve duplicar vendas. Se a carga foi interrompida, selecione novamente o arquivo correto e confira o progresso salvo.
Não importe por CSV as mesmas vendas que já chegam de outra fonte. Consulte mercados e datas.
Revisado em 3 de out. de 2026