API de insolvência empresarial: o que é e como integrar dados de RJ e falência ao seu sistema

Com a API, quem lê o dado é o seu sistema: ele consulta na frequência que você define e aplica a regra que é sua. Os encaixes mais comuns:

• Motor de crédito. Quando a consulta encontra um pedido de RJ de um tomador, a sua regra pode abrir a reavaliação de risco, a revisão de limite e o recálculo de provisão — sem esperar a inadimplência aparecer.
• ERP e faturamento. Com o evento de insolvência de um cliente em mãos, a sua regra pode suspender novo faturamento a prazo e criar uma tarefa de cobrança.
• CRM e originação. Fundos e assessorias levam a consulta de novos casos ao pipeline de originação.
• Data warehouse. A carga periódica alimenta modelos internos de risco com o histórico capturado.

Como o registro está na API assim que entra na base, a consulta agendada do início do dia útil encontra o caso novo — o mesmo evento que uma pessoa veria no monitoramento de carteira, só que consumido por máquina em vez de por leitura.

A API REST autentica por token, responde em JSON e serve informações públicas dos tribunais e da Receita Federal, com tipo, data e contexto disponíveis conforme o acesso contratado. Cada objeto carrega a origem e a data do dado, e a base é a mesma dos painéis públicos de /dados (que saem com defasagem de vitrine; a API entrega sem essa defasagem).

O consumo casa com os produtos: você monitora CNPJs (Alertas), acompanha processos (Acompanhamento) e puxa relatórios de credores — e a API é o canal técnico de todos eles. As unidades, os períodos e os limites estão explicados em /dados/metodologia, para sua equipe interpretar os dados antes de integrar.

Integrar bem uma API de insolvência é menos sobre código e mais sobre desenhar a reação certa a cada evento. Algumas recomendações práticas:

• Separe a consulta de reação da consulta de reconciliação. Uma consulta curta no início do dia útil, filtrada pela sua carteira, resolve a ação imediata (revisar limite, bloquear faturamento); uma varredura mais larga e menos frequente reconcilia a base inteira e captura publicações tardias.
• Trate o vínculo por razão social com cautela. Quando o objeto vier sem CNPJ nos autos e com grau de confiança menor, encaminhe para conferência humana antes de uma ação irreversível.
• Guarde a origem e a data de cada registro. Elas são a sua trilha de auditoria quando uma decisão de crédito for questionada.
• Idempotência. Reprocessamentos e correções podem devolver o mesmo evento numa consulta seguinte; guarde o identificador estável do registro para não duplicar ações.

O mesmo evento consumido por máquina aqui é o que uma pessoa veria no monitoramento de carteira — a API só troca o leitor humano por uma regra de negócio.

Uma API é tão boa quanto o dado que serve — e o dado tem as mesmas ressalvas dos alertas:

• Latência de fonte. A entrega é em até 1 dia útil da captura; 9 em cada 10, em até 4 dias úteis, não à distribuição; publicações tardias entram no ciclo seguinte.
• Cobertura não integral. A captura nas publicações oficiais dos tribunais com captura ativa cobre os pedidos distribuídos desde jan/2026; segredo de justiça e omissões da fonte existem e são declarados.
• Vínculo por razão social. Sem CNPJ nos autos, o match é por nome e pode exigir conferência; o objeto traz o grau de confiança e os identificadores para o seu sistema decidir.
• Não é decisor. A API entrega fato estruturado, não recomendação de crédito ou investimento — a regra de negócio é sua.