Importando vendas (CSV)
Nem sempre todas as vendas entram automaticamente via webhook. Você pode ter vendas antigas, vendas de uma plataforma que não suporta webhooks ou vendas manuais que precisa registrar. Para esses casos, o Oráculo permite importar vendas por arquivo CSV.
Quando usar a importacao manual
- Vendas historicas — Vendas que aconteceram antes de configurar o webhook
- Migracao — Vendas de outro sistema que você quer consolidar no Oráculo
- Plataformas sem webhook — Se a plataforma de pagamento não suporta envio automatico
- Vendas manuais — Vendas feitas por transferencia, deposito ou outros meios fora do gateway
Como importar
1. Abra o importador
- No menu lateral, va até Operação > Vendas
- Certifique-se de que o evento correto está selecionado
- Clique no botao Importar CSV (icone de download no topo da pagina)
Screenshot: [Botao de Importar CSV no topo da página de Vendas]
2. Selecione o arquivo
Na janela que abrir:
- Clique em Selecionar arquivo ou arraste o arquivo CSV
- O sistema vai analisar o arquivo automaticamente
Screenshot: [Tela de upload do CSV mostrando area de drag-and-drop]
3. Revise a previa
Apos o upload, o sistema mostra uma previa dos dados encontrados:
- Gateway detectado — Qual plataforma o sistema identificou pelo formato do CSV
- Total de linhas — Quantas vendas estão no arquivo
- Linhas validas — Quantas estão corretas e prontas para importar
- Linhas com erro — Quantas tem problema (dados faltando, formato errado)
- Previa das vendas — Uma tabela com as primeiras linhas mostrando nome, email, telefone, valor, status e data
Se houver erros, eles aparecem listados com o número da linha é o motivo do erro.
Screenshot: [Tela de previa mostrando resumo, tabela de vendas e lista de erros]
4. Confirme a importacao
Se tudo estiver correto, clique em Importar. O sistema vai processar as vendas em etapas:
- Analisando arquivo — Leitura e validacao dos dados
- Verificando duplicatas — Conferindo se alguma venda já existe no sistema
- Fazendo match de vendas — Vinculando vendas a leads existentes
- Finalizando importacao — Salvando tudo no banco de dados
5. Veja o resultado
Apos a importacao, o sistema mostra um resumo:
| Campo | Significado |
|---|---|
| Importadas | Vendas novas que foram adicionadas |
| Atualizadas | Vendas que já existiam e foram atualizadas |
| Duplicadas | Vendas que já existiam e não precisaram de alteracao |
| Erros | Vendas que não puderam ser importadas (com motivo) |
Formato do arquivo CSV
O Oráculo reconhece automaticamente o formato do CSV baseado nas colunas. Ele suporta os formatos de exportacao das principais plataformas.
Campos que o sistema espera encontrar
| Campo | Obrigatorio | Descricao |
|---|---|---|
| ID da transacao | Sim | Identificador único da venda na plataforma |
| Nome | Não | Nome do comprador |
| Sim | Email do comprador | |
| Telefone | Não | Telefone do comprador (ajuda no match com lead) |
| Valor | Sim | Valor bruto da venda |
| Status | Sim | Status da venda (aprovada, pendente, reembolsada etc.) |
| Data da compra | Sim | Data e hora da compra |
Gateways reconhecidos automaticamente
O sistema identifica automaticamente o formato do CSV para estas plataformas:
- Eduzz
- Hotmart
- Kiwify
- Xgrow
- Monetizze
- Guru
- PerfectPay
Cada plataforma tem colunas com nomes diferentes, é o sistema sabe mapear cada uma.
Dicas para uma importacao bem-sucedida
1. Exporte o CSV direto da plataforma
Evite editar o CSV manualmente. Exporte diretamente da plataforma de pagamento para manter o formato correto.
2. Verifique a codificacao
O arquivo deve estar em UTF-8. Se os nomes aparecerem com caracteres estranhos na previa, o arquivo pode estar em outra codificacao.
3. Inclua o telefone
O telefone e importante para vincular a venda ao lead correto. Se o CSV não tem telefone, muitas vendas podem ficar como “órfãs”.
4. Não se preocupe com duplicatas
O sistema detecta duplicatas automaticamente pelo ID da transacao. Se você importar o mesmo arquivo duas vezes, as vendas que já existem não serão duplicadas.
Perguntas frequentes
Posso importar vendas de qualquer plataforma?
Sim, desde que o CSV tenha pelo menos: ID da transacao, email, valor, status e data. O sistema tenta identificar o formato automaticamente.
E se o CSV tiver erros?
As linhas com erro são ignoradas, e as linhas corretas são importadas normalmente. Você vera um relatório detalhado mostrando quais linhas falharam e por que.
Quantas vendas posso importar de uma vez?
Nao ha um limite explicito, mas recomendamos arquivos com até 10.000 linhas para evitar timeout. Para volumes maiores, divida o arquivo em partes.
As vendas importadas aparecem no funil?
Sim, desde que sejam vinculadas a leads existentes. Vendas sem vinculo com lead aparecem nas métricas gerais mas não no funil de conversao.
Resumo
- Use a importacao CSV para vendas historicas, migracoes ou vendas manuais
- O sistema reconhece automaticamente o formato de exportacao das principais plataformas
- Campos obrigatorios: ID da transacao, email, valor, status e data
- Duplicatas são detectadas automaticamente
- O importador mostra uma previa antes de confirmar
- Um relatório final mostra quantas vendas foram importadas, atualizadas ou com erro