Visão geral
A Central de reconciliação reúne registros históricos com vínculos ausentes ou divergentes entre cobranças, pedidos do CRM e eventos de comércio. A verificação automática só sugere relações com identidade exata; nomes, valores ou datas parecidos nunca unem vendas.
Além de confirmar a contraparte da venda, a ação Corrigir cliente e vínculos da venda alinha o contato, a organização, o negócio e, quando solicitado, a conversa, o vendedor e o afiliado em todo o grafo. Ela não importa dinheiro nem altera valor, status, liquidação, datas ou identificadores do gateway. Um contato novo é apenas proposto na prévia e só nasce após a confirmação final.
Pré-requisitos
- O módulo Recuperação de vendas precisa estar habilitado para a conta.
- Você precisa da permissão de gestão de Comércio.
- As integrações e importações históricas já devem ter trazido os registros que deseja revisar.
Passo a passo
- Abra Recuperação de vendas no menu comercial e selecione a aba Reconciliação.
- Clique em Executar verificação. A análise é enfileirada; ela pode levar alguns instantes em contas com muito histórico.
- Atualize a lista. Filtre por situação, tipo de origem, motivo ou ID de origem. Cada linha reúne cliente, e-mail/telefone, organização, negócio, responsável ou criador, afiliado, conversa e os principais fatos da origem disponíveis. Campos protegidos podem aparecer mascarados ou ocultos conforme seu perfil.
- Abra um item pendente. Só use Vincular quando a sugestão mostrar a mesma origem de gateway e o mesmo identificador externo.
- Quando o cliente estiver ausente ou divergente, escolha Corrigir cliente e vínculos da venda na própria linha da fila, na cobrança, no pedido ou no evento. Selecione um contato existente ou proponha um novo com nome e e-mail, telefone ou documento. Decida também como tratar uma conversa incompatível.
- Revise a prévia completa: registros alcançados, alterações, conflitos, projeções históricas e impacto em crédito/comissão. Confirme o impacto de atribuição quando houver e aplique. Se algum registro mudar entre a prévia e a confirmação, a operação é recusada inteira e você precisa revisar novamente.
- Confirme o vínculo. A fila registra a decisão, o responsável e a data.
- Se o registro não for uma venda da conta, escolha Ignorar e informe um motivo quando útil.
- Use Desfazer se a decisão ainda precisar ser revertida. A plataforma só desfaz quando o vínculo continua exatamente como foi gravado, para não substituir uma alteração mais recente.
Configurações & opções
- Pendente: precisa de revisão humana.
- Vinculado: a relação entre registros existentes foi confirmada.
- Ignorado: a conta decidiu que o item não deve voltar à fila. Para cobranças, a exclusão também é respeitada por importações e webhooks futuros.
- Duplicado: reservado para consolidações de registros equivalentes.
- Ações em massa: é possível ignorar ou desfazer itens acionáveis selecionados. Selecionar todos os itens acionáveis destes filtros percorre todas as páginas, pula decisões que não admitem ação em massa e respeita o limite de 500 itens. O resultado mostra cada falha; uma seleção mista nunca é apresentada como sucesso total.
- Filtros e ordenação: ficam no endereço da página, permitindo retomar ou compartilhar o mesmo recorte.
- Correção do grafo da venda: usa uma transação única. Ou cobrança, pedido e recuperação ficam alinhados, ou nada é alterado. Projeções históricas ausentes são internas e não enviam mensagem, automação nem conversão externa. Ao concluir, todos os itens ainda pendentes dos registros alcançados são encerrados na fila; uma verificação posterior também encerra automaticamente um alerta já sanado.
Casos de uso
- Uma cobrança importada no Asaas já tem um pedido antigo com o mesmo ID de pagamento.
- Um evento histórico da Hotmart ou Kiwify chegou antes do pedido correspondente.
- Uma cobrança de teste, de outra empresa ou que não representa venda deve ser excluída de novas análises.
Dicas, limites e boas práticas
- Confirme sempre gateway + identificador externo. Nomes, e-mails, datas e valores parecidos não são prova suficiente de que duas vendas são a mesma.
- A correção automática não associa contatos ou organizações por aproximação. Para um cliente sem correspondência exata, faça uma escolha manual explícita na prévia.
- Use Corrigir cliente e vínculos para associações. Para valor, status, liquidação ou identificador do gateway, corrija a operação financeira ou a fonte de origem; esses fatos continuam imutáveis aqui.
- Revise os itens pendentes antes de ignorá-los em massa. Cobranças ignoradas deixam de reaparecer até uma ação explícita de desfazer.
- A reconciliação não cria receita nem comissão. Ela reutiliza as chaves canônicas dos registros existentes para que relatórios e créditos não sejam contados duas vezes.
Solução de problemas
- A fila está vazia: execute uma verificação e aguarde a conclusão; também confirme os filtros ativos.
- Não há sugestão para vincular: não existe uma contraparte com identidade exata. Deixe o item pendente ou corrija/sincronize a origem.
- Não consigo desfazer: alguém ou alguma integração alterou o vínculo depois da sua decisão. Revise o histórico em vez de sobrescrever a mudança.
- A correção foi bloqueada por conflito: a mesma identidade externa aponta para mais de uma cobrança, pedido ou conversa incompatível. Resolva a duplicidade indicada e gere outra prévia; nada foi alterado.
- A prévia ficou desatualizada: algum registro mudou antes da confirmação. Abra a correção novamente e revise o novo impacto.
- Uma cobrança ignorada não volta: isso é esperado. Desfaça a decisão na própria fila antes de executar nova importação ou verificação.
- Não vejo a aba Reconciliação: confirme a habilitação do módulo e a permissão de gestão de Comércio.