Automação Financeira: Como conciliar pagamentos e emitir relatórios de inadimplência automáticos

A gestão financeira de uma empresa exige máxima precisão e controle de fluxo de caixa. Entretanto, muitas organizações ainda alocam profissionais do time administrativo para realizar tarefas de conciliação bancária manual: baixar relatórios de gateways de pagamento, cruzar registros de depósitos com planilhas internas de contas a receber e atualizar manualmente o status de adimplência de cada cliente.

Além de lento e sujeito a erros operacionais graves, o atraso no acompanhamento dessas transações prejudica a identificação imediata de inadimplência, enfraquecendo as ações de cobrança ativa da empresa.

Neste artigo prático, abordaremos como arquitetar um fluxo automatizado de conciliação financeira e tratamento de faturas vencidas integrando o gateway de pagamentos Asaas com bancos de dados e canais de notificação interna via n8n.

---

O que é Automação Financeira de Conciliação?

[!NOTE] Definição Direta: É a sincronização contínua e orientada a eventos entre os status das transações financeiras geradas nos gateways de faturamento e as ferramentas de controle interno da empresa. Quando uma cobrança muda de estado (paga, vencida ou estornada), gatilhos automáticos registram a receita e atualizam instantaneamente relatórios de auditoria e painéis de inadimplência.

---

Fluxo da Automação de Conciliação e Cobrança

O ecossistema é projetado para operar com base em dois gatilhos principais originados da API do gateway de pagamento:

graph TD
    A[Gatilho Webhook Asaas] --> B{Tipo de Evento}
    
    B -->|PAYMENT_RECEIVED| C[Registrar Entrada no ERP / Planilha]
    C --> D[Enviar Comprovante ao Cliente]
    D --> E[Notificar Canal #financeiro no Slack]
    
    B -->|PAYMENT_OVERDUE| F[Alterar Status para Inadimplente]
    F --> G[Atualizar CRM e Dashboard Financeiro]
    G --> H[Acionar Régua de Cobrança: WhatsApp/Email]

Componentes de Controle de Conciliação

Etapa	Ação Operacional	Canal Utilizado
Confirmação de Recebimento	Identifica pagamento por Pix, boleto ou cartão em segundos.	Webhook PAYMENT_RECEIVED
Atualização Cadastral	Sincroniza o pagamento nas planilhas e painéis de BI.	Google Sheets API / PostgreSQL / Looker
Notificação de Sucesso	Avisa a equipe interna e emite o recibo digital.	Slack / E-mail Transacional
Alerta de Inadimplência	Identifica faturas não pagas na data de vencimento.	Webhook PAYMENT_OVERDUE
Régua de Dunning (Cobrança)	Dispara avisos automáticos com link atualizado para o cliente.	WhatsApp API / E-mail HTML

---

Implementação Prática do Fluxo de Dados

1. Configurando o Recebimento do Webhook (Asaas)

O Asaas disponibiliza um webhook de alta confiabilidade para notificar transações em tempo real. O payload recebido quando uma fatura é quitada possui o seguinte formato:

{
  "event": "PAYMENT_RECEIVED",
  "payment": {
    "id": "pay_987456123045",
    "customer": "cus_000005748930",
    "value": 1500.00,
    "netValue": 1497.00,
    "billingType": "PIX",
    "paymentDate": "2026-06-15",
    "clientPaymentDate": "2026-06-15 14:35:10",
    "description": "Fatura Mensalidade de Software ERP"
  }
}

O n8n recebe o payload e executa passos sequenciais:

1. Validação e Criptografia: Verifica a assinatura do cabeçalho da requisição para garantir que os dados de faturamento partiram legitimamente dos servidores do Asaas.
2. Sincronização: Procura o ID do pagamento (payment.id) no banco de dados corporativo ou na planilha do Google Drive e altera o status correspondente para Pago, salvando o valor líquido recebido (netValue) para fins de cálculo de taxas financeiras.

2. Tratando a Inadimplência e Régua de Cobrança Automática

Quando o evento disparado for PAYMENT_OVERDUE, a automação deve agir preventivamente para evitar a extensão da inadimplência.

Abaixo está o código JavaScript utilizado no nó de processamento do n8n para calcular a data de vencimento e estruturar o payload do alerta que será enviado ao time comercial e ao cliente:

// Processamento de Inadimplência no n8n (JavaScript)
const eventData = items[0].json;

const paymentId = eventData.payment.id;
const customerId = eventData.payment.customer;
const value = eventData.payment.value;
const dueDate = new Date(eventData.payment.dueDate);
const today = new Date();

// Calcula a quantidade de dias em atraso
const diffTime = Math.abs(today - dueDate);
const diffDays = Math.ceil(diffTime / (1000 * 60 * 60 * 24));

return [{
  json: {
    paymentId: paymentId,
    customerId: customerId,
    valorFormatado: new Intl.NumberFormat('pt-BR', { style: 'currency', currency: 'BRL' }).format(value),
    diasAtraso: diffDays,
    linkCobranca: `https://www.asaas.com/c/checkout/${paymentId}`, // Link direto p/ pagamento
    status: "Inadimplente",
    dataVencimento: eventData.payment.dueDate
  }
}];

3. Disparando Mensagem de Cobrança no WhatsApp

Com o objeto resultante do código anterior, a automação chama a API do WhatsApp ou envia um e-mail transacional automatizado contendo o link de pagamento atualizado, permitindo que o cliente pague via PIX ou emita o boleto atualizado com juros e multas sem a necessidade de intervenção do suporte humano.

POST https://api.asaas.com/v3/payments/pay_987456123045/billingUrl
access_token: $YOUR_ASAAS_API_KEY

Dica: Chame o endpoint /billingUrl do Asaas para recuperar a URL de pagamento que permite ao cliente gerar o código copia e cola do Pix diretamente na tela do celular.

---

Boas Práticas para Automações Financeiras

1. Tratamento de Assinatura de Webhook (Webhook Token): No painel do Asaas, configure uma chave de validação de webhook (Token). No n8n, verifique se essa chave está presente nos headers de entrada da requisição antes de processar qualquer informação de pagamento no banco de dados para evitar fraudes.
2. Transações Seguras e Idempotência: Certifique-se de que a gravação dos dados de conciliação seja idempotente. Ou seja, mesmo que o webhook seja reenviado por falha de conexão temporária, o n8n não deve duplicar o registro da entrada financeira, mas sim atualizar o registro existente.
3. Auditoria (Log Histórico): Nunca delete registros de faturamento. Mantenha um histórico imutável das mudanças de status (Criada -> Vencida -> Paga) com datas e horários correspondentes para fins de conformidade tributária e auditorias de balanço anual.
4. Integração de BI: Use os registros unificados no banco PostgreSQL para alimentar dashboards interativos (no Looker Studio ou PowerBI), facilitando a visualização de métricas essenciais como o MRR (Monthly Recurring Revenue) e a taxa de Churn decorrente de inadimplência.