Avisar a cobrança e o CRM

Quando um cliente atrasa, quem cobra precisa saber no mesmo dia; quando ele paga, o CRM precisa parar de cobrar. O Financeiro publica um evento a cada fato — conta lançada, parcela paga, pagamento estornado, conta cancelada, parcela vencida — e a empresa decide o que acontece: enviar ao seu sistema por webhook, avisar alguém, abrir um card ou mandar e-mail ao próprio cliente.

Quando usar	Um CRM, uma ferramenta de cobrança ou um canal de mensagens precisa reagir ao que acontece nas contas
Porta	Webhook · Automação · REST (consulta periódica)
Você vai precisar	Módulo FINANCEIRO; acesso a Processos › Central de Automações (dono da conta ou administrador); uma URL HTTPS que receba o webhook

Como funciona

Financeiro ── PARCELA_VENCIDA, PARCELA_BAIXADA, PARCELA_ESTORNADA, TITULO_CANCELADO…
                │
                ├─▶ webhook assinando os eventos ──▶ POST https://cobranca.suaempresa.com.br/tai
                │     (envelope padrão, assinado, com novas tentativas)
                │
                └─▶ fluxo automatizado ("Quando algo acontece")
                      └─ bloco "Chamar outro sistema" ──▶ corpo no formato do seu sistema

O webhook é o caminho mais curto: escolhe os eventos uma vez e todos chegam. O fluxo automatizado entra quando o seu sistema espera outro formato, só parte dos eventos ou o envio junto de outras ações. A escolha entre os dois está em Da TAI para o seu sistema; aqui está o recorte do Financeiro.

Os eventos

Evento	Quando	Campos (dados)
TITULO_CRIADO	Conta lançada — pela tela, pela API, pela Tali, pela conciliação, importada de NF-e ou por recorrência	tituloId, direcao, descricao, valorTotal, contraparte
PARCELA_BAIXADA	Pagamento ou recebimento registrado, inclusive pela conciliação do extrato	tituloId, parcelaId, direcao, valor, statusTitulo
PARCELA_ESTORNADA	Uma baixa foi desfeita, com motivo	tituloId, parcelaId, baixaId, direcao, valor, motivo, statusTitulo
PARCELA_PAGAMENTO_APROVADO	Alguém autorizou o pagamento de uma parcela a pagar	tituloId, parcelaId, valor, vencimento, aprovadoPorId
TITULO_CANCELADO	Conta cancelada	tituloId, direcao, motivo
PARCELA_VENCIDA	Parcela passou do vencimento sem quitação	tituloId, parcelaId, direcao, vencimento, saldo, contraparte
CONTRAPARTE_CADASTRADO, CONTRAPARTE_ALTERADO, CONTRAPARTE_EXCLUIDO	Cliente ou fornecedor cadastrado, alterado (inclui ativar e desativar) ou excluído	contraparteId, nome, tipo, ativo (só contraparteId na exclusão)

• direcao é PAGAR ou RECEBER.
• PARCELA_VENCIDA sai uma vez por parcela, publicado pela rotina diária de vencimentos (de manhã), e só para parcelas vencidas há até 30 dias.
• statusTitulo em PARCELA_BAIXADA diz se a conta ficou PARCIAL ou LIQUIDADO.
• contraparte é o nome da contraparte. Para o CPF/CNPJ ou o e-mail, use Enviar também o registro completo (o título como GET /financeiro/titulo/{tituloId} o devolve) ou consulte GET /financeiro/contraparte/{id}.

Passo a passo: avisar o sistema de cobrança

1. Crie o webhook. Em Processos › Central de Automações, aba Webhooks, clique em Novo webhook, dê um nome (“Cobrança”) e o endereço do seu sistema.

2. Escolha os eventos. Em O que enviar, marque Uma parcela vence sem pagamento, Uma parcela é paga ou recebida, O pagamento de uma parcela é estornado e Uma conta é cancelada — ou Tudo de Financeiro. Marque Enviar também o registro completo se o seu sistema precisa do título inteiro.

3. Copie o segredo, teste e ligue. O segredo aparece uma vez; com ele o seu sistema confere a assinatura. Testar manda um exemplo; se chegou, ligue o interruptor.

4. Trate cada evento no seu sistema. Uma parcela vencida chega assim:

   {
     "id": "evt_60231",
     "tipo": "PARCELA_VENCIDA",
     "descricao": "Uma parcela vence sem pagamento",
     "versao": 1,
     "ocorridoEm": "2026-10-17T10:00:12.381Z",
     "empresa": { "id": 12, "nome": "Sua Empresa Ltda" },
     "dados": {
       "tituloId": 1290,
       "parcelaId": 5521,
       "direcao": "RECEBER",
       "vencimento": "2026-10-16",
       "saldo": 600.0,
       "contraparte": "Mercado Sol"
     }
   }

   O webhook manda as contas a pagar e a receber: descarte no seu sistema as de direcao PAGAR. PARCELA_BAIXADA com statusTitulo igual a LIQUIDADO é o sinal para o CRM encerrar a cobrança; PARCELA_ESTORNADA, para retomá-la; TITULO_CANCELADO, para descartar a conta.

Processe cada aviso uma vez

Uma entrega que falha é tentada de novo por cerca de 21 horas, sempre com o mesmo X-Tai-Entrega — guarde-o (ou o id do evento) e ignore o que já processou. Veja Entregas e novas tentativas.

No formato do seu sistema

Quando o seu sistema espera outro corpo, troque o webhook por um fluxo automatizado. Em Processos › Fluxos › Novo processo › Fluxo automatizado, comece pelo bloco Quando algo acontece com Uma parcela vence sem pagamento; em Só quando, deixe passar só direcao igual a RECEBER. Acrescente o bloco Chamar outro sistema: o Corpo (JSON) usa Inserir informação para os dados do evento:

{
  "evento": "parcela_vencida",
  "direcao": "{{gatilho.direcao}}",
  "tituloId": "{{gatilho.tituloId}}",
  "parcelaId": "{{gatilho.parcelaId}}",
  "cliente": "{{gatilho.contraparte}}",
  "saldo": "{{gatilho.saldo}}",
  "vencimento": "{{gatilho.vencimento}}"
}

O envio do fluxo não leva assinatura: informe em Cabeçalhos o token do seu sistema. Testar percorre o desenho sem enviar nada; Publicar liga o fluxo.

Sem sair da TAI

O mesmo fluxo automatizado também age dentro da TAI, junto com o envio ou no lugar dele:

• Avisar alguém no sino — por exemplo, quem cuida do contas a receber;
• Abrir card num quadro — quando cada cobrança precisa de acompanhamento, com fases, responsável e prazo;
• Fazer algo na plataforma — por exemplo, criar uma tarefa no quadro da equipe de cobrança (veja Tarefas vindas de outro sistema). Atos irreversíveis, como registrar pagamento, não rodam sozinhos num fluxo: viram decisão na Caixa de uma pessoa.

Régua de cobrança por e-mail

A rotina Vencimentos e régua de cobrança (financeiro-vencimentos) roda todo dia de manhã. Com a régua ligada pela empresa — desligada por padrão —, ela escreve aos clientes:

• só para contas a receber, com saldo em aberto e contraparte com e-mail cadastrado;
• um lembrete alguns dias antes do vencimento e cobranças nos dias configurados depois;
• se a rotina ficou dias sem rodar, o cliente recebe só a cobrança mais recente devida;
• cada envio fica na trilha da conta (GET /financeiro/titulo/{id}/eventos).

A régua se liga na tela (Financeiro › Contas a pagar e receber › Mais › Régua de cobrança) ou pela API:

PUT /financeiro/config
Authorization: Bearer $TAI_TOKEN
Content-Type: application/json

{
  "reguaCobranca": true,
  "reguaDiasAntes": 3,
  "reguaDiasDepois": "1,7,15",
  "reguaResponderPara": "cobranca@suaempresa.com.br"
}

Campo	Valor
reguaCobranca	Liga ou desliga a régua (padrão: desligada)
reguaDiasAntes	Lembrete N dias antes do vencimento, de 0 (sem lembrete) a 15. Padrão: 3
reguaDiasDepois	De 1 a 4 cobranças depois do vencimento, em dias (até 60), separados por vírgula. Padrão: 1,7
reguaResponderPara	E-mail que recebe as respostas dos clientes; sem ele, o e-mail corporativo da empresa

Campos nulos mantêm o que está gravado. A configuração atual sai em GET /financeiro/config.

Cuidado

Ligar a régua faz a TAI escrever para os clientes da empresa. Confirme com quem responde pela cobrança antes de ativá-la por integração.

A régua nunca dá baixa. O pagamento entra pela baixa direta ou pela conciliação do extrato — veja Registrar pagamentos e conciliar o extrato.

Consulta periódica

As novas tentativas cobrem quedas de horas, não de dias. Para reconciliar o seu sistema com a TAI de tempos em tempos (ou no lugar do webhook):

GET /financeiro/titulo/parcela/abertas?empresaId=3&direcao=RECEBER
Authorization: Bearer $TAI_TOKEN

Devolve até 100 parcelas em aberto com saldo e dataVencimento; para varrer tudo, use GET /financeiro/titulo/page?empresaId=3&direcao=RECEBER&status=ABERTO página a página (e de novo com status=PARCIAL). O resumo da empresa — em aberto e vencido, a pagar e a receber — sai em GET /financeiro/titulo/resumo?empresaId=3.

Pelo seu agente de IA

“Quais clientes estão com parcelas vencidas há mais de 7 dias, e quanto cada um deve?”

O agente consulta as parcelas em aberto e responde, só com leitura. Webhooks ficam em Processos › Central de Automações; fluxos automatizados, em Processos › Fluxos.

Cuidados

• Eventos não são retroativos: um webhook ou um fluxo criados hoje não disparam para o que aconteceu antes. Faça a carga inicial pela consulta periódica.
• Cada fluxo roda uma vez por evento. Vencimentos que chegam juntos esperam na fila, um de cada vez. Reprocessar um evento na aba Eventos (Processos › Central de Automações) só roda o que ainda não tinha rodado para ele.
• PARCELA_VENCIDA não se repete para a mesma parcela; o lembrete diário de inadimplência, se você quiser um, sai da consulta periódica.
• Valores chegam como número em reais; datas de vencimento como yyyy-MM-dd. Veja Datas e formatos.