Robô de Recebimentos
Um agente autônomo que concilia pagamentos com parcelas em aberto e dá baixa no ERP sozinho.
- etapas encadeadas no pipeline
- 6
- da importação automatizada
- 100%
- risco de duplo recebimento
- 0
Da dor ao resultado
Antes
Conciliação à mão, olhando duas telas. E o erro caro — dar baixa duas vezes na mesma parcela — passava sem ninguém ver.
A conciliação entre o que entrou na conta e as parcelas em aberto era feita à mão, olhando duas telas. Repetitiva, demorada e sujeita a erro que só aparecia dias depois, no fechamento.
E o erro caro não é deixar de dar baixa — é dar baixa duas vezes na mesma parcela, o que sai do controle silenciosamente.
Como · 1/3
Construí um pipeline de seis etapas em Python: sincroniza o cadastro de obras e contas, importa os pagamentos efetuados, busca as parcelas em aberto pela API do ERP, faz o match entre pagamento e venda, envia o recebimento e monitora divergências.
Como · 2/3
O match é o coração do robô. A prioridade é a chave estruturada extraída do histórico do lançamento; só quando ela falha entra a similaridade textual entre a descrição da obra e o nome no pagamento, com score mínimo de confiança configurável.
Como · 3/3
Antes de confirmar qualquer recebimento, o robô pergunta ao próprio ERP se aquela parcela já foi recebida. É a guarda contra o pior erro possível aqui: receber duas vezes.
Depois
O robô descobre qual pagamento quita qual parcela, pergunta ao ERP se ela já foi recebida antes de gravar e manda por e-mail o que quase casou.
- 6
- etapas encadeadas no pipeline
- 100%
- da importação automatizada
- 0
- risco de duplo recebimento
Como ler o diagrama
Nenhum humano no caminho. O passo que decide tudo é o match: sem ele, o robô ou deixa dinheiro sem baixa ou recebe duas vezes — por isso ele confirma no próprio ERP antes de gravar.
Destaques técnicos
- 1 Match em duas camadas: chave estruturada primeiro, similaridade textual como fallback — com score mínimo e exigência opcional de coincidência de valor.
- 2 A conta bancária do recebimento vem do cadastro da obra, não do processo de pagamento. Parece detalhe, mas é o que garante que cada obra receba na conta certa mesmo quando a contabilidade registrou outra.
- 3 Todas as etapas usam upsert, então reexecutar é seguro. A limpeza das tabelas de trabalho só acontece se o pipeline inteiro passar — falhou no meio, os dados ficam para diagnóstico.
- 4 A etapa de divergências é deliberadamente não-bloqueante: ela reporta casos que quase casaram (centavos de diferença) por e-mail, sem nunca derrubar o pipeline.