API Jurídica para Monitoramento, Consultas e Background Check: DataJud vs. API Unificada

Equipes de engenharia, risco e operações jurídicas que pesquisam por busca de processos ou por uma API jurídica costumam enfrentar o mesmo dilema arquitetural: construir conectores próprios sobre a API pública do DataJud (CNJ) e sobre os portais dos tribunais ou adotar uma camada unificada pronta para produção.

No papel, consultar dados públicos do Judiciário parece simples. Na prática, o ecossistema brasileiro é distribuído entre mais de 90 tribunais estaduais (TJs), federais (TRFs), trabalhistas (TRTs), eleitorais, militares e superiores (STJ, TST, STF), operando sobre sistemas distintos como PJe, e-SAJ, eproc e Projudi. Quando o objetivo do produto é rodar background check para compliance (KYB/KYC), onboarding de fornecedores, análise de crédito ou monitoramento processual contínuo, a diferença entre consultar um número CNJ isolado e operar uma esteira automatizada por CPF ou CNPJ define o custo de manutenção do projeto.

Neste guia técnico da plataforma BuscaProcessos (buscaprocessos.app.br), comparamos a arquitetura das fontes públicas brutas com a API Jurídica REST/JSON do BuscaProcessos, detalhando endpoints, controle de custos em cascata, tratamento de respostas assíncronas (HTTP 202) e entrega de eventos via webhook assinado em HMAC-SHA256.

Comparativo técnico entre a consulta direta a índices regionais e sistemas de tribunais versus a arquitetura em 3 camadas da API Jurídica BuscaProcessos.

Por que o DataJud (CNJ) sozinho não resolve o fluxo de compliance e background check

Instituída pela Resolução CNJ nº 331/2020, a API pública do DataJud é um marco importante de transparência do Poder Judiciário. Ela funciona muito bem para pesquisas acadêmicas, levantamentos estatísticos por classe processual e conferência de metadados quando você já possui o número CNJ e sabe exatamente em qual tribunal o processo tramita.

Porém, quando uma equipe técnica tenta usar exclusivamente o DataJud para alimentar um motor de compliance (KYB/KYC), cadastro de fornecedores ou monitoramento de carteira, surgem cinco gargalos estruturais:

1. Fragmentação por índice de tribunal: o DataJud exige chamadas separadas para o endpoint de cada corte (api_publica_tjsp, api_publica_trf3, api_publica_trt2, etc.). Descobrir processos de uma empresa com atuação nacional obrigaria seu backend a disparar dezenas de requisições paralelas a cada onboarding.
2. Limitação na busca nacional por CPF ou CNPJ: em fluxos de KYB e KYC, o ponto de partida nunca é o número CNJ: é o CNPJ do fornecedor ou o CPF do sócio. A consulta pública do DataJud não foi desenhada como motor unificado de busca cadastral por documento das partes.
3. Ausência de atualização sob demanda nos portais de origem: o índice estatístico pode apresentar defasagem em relação ao andamento recém-publicado no sistema do tribunal (e-SAJ, PJe, eproc) e não extrai peças ou documentos públicos anexados aos autos.
4. Inexistência de webhooks e de radar de novas distribuições: o DataJud é passivo. Para saber se um processo sofreu movimentação hoje ou se um fornecedor recebeu uma nova execução fiscal, seu sistema precisaria refazer polling constante contra dezenas de índices.
5. Falta de integração com o BNMP e de leitura semântica: códigos numéricos das Tabelas Processuais Unificadas (TPU) exigem dicionários locais de tradução, e a consulta a mandados de prisão vigentes no BNMP (CNJ) corre em um sistema completamente separado.

Arquitetura em 3 camadas: como estruturar consultas, background check e monitoramento

Uma integração de compliance jurídico e KYB/KYC eficiente não consulta todos os endpoints para todos os cadastros. Ela divide a operação em três camadas progressivas, combinando velocidade no onboarding, economia de créditos e vigilância contínua sobre a carteira ativa.

Funil de decisão e controle de custo na API BuscaProcessos: triagem por documento na Etapa 1, aprofundamento seletivo por CNJ na Etapa 2 e monitoramento contínuo na Etapa 3.

Camada 1: Triagem de entrada por CPF ou CNPJ e conferência no BNMP

Quando um novo fornecedor, parceiro comercial, motorista ou tomador de crédito inicia o cadastro no seu sistema, a primeira pergunta é objetiva: existem processos públicos ou mandados de prisão vigentes associados a este documento?

Para responder a isso, o backend aciona dois endpoints de triagem:

• GET /v1/processos?cpf_cnpj={cpf_ou_cnpj}: retorna a lista de processos públicos localizados para o documento, informando número CNJ, tribunal, classe processual, data de distribuição e situação. O custo é de R$ 2,00 (retornando até 200 processos) ou R$ 0,25 por tribunal quando você aplica o filtro tribunais para até 5 cortes onde a operação se concentra.
• GET /v1/mandados?cpf={cpf}: consulta o Banco Nacional de Monitoramento de Prisões (BNMP/CNJ) por R$ 0,25 por consulta concluída, verificando a existência de mandados de prisão abertos e vigentes contra pessoas físicas (veja os detalhes na página da API de Mandados de Prisão (BNMP)).

Se o documento não apresentar ocorrências nas classes que importam para a sua política de risco, o cadastro segue o fluxo de aprovação sem gastar um único centavo adicional com detalhamento de capa ou movimentações.

Camada 2: Contextualização seletiva por número CNJ (Capa, Movimentações e IA)

Encontrar processos vinculados a um CNPJ é normal para qualquer empresa em operação no Brasil: uma rede varejista, transportadora ou construtora quase sempre possui dezenas de ações cíveis ou trabalhistas em andamento. Existência de processo não é sinônimo de risco nem de condenação.

Por isso, a segunda camada filtra os números CNJ da listagem inicial e aprofunda apenas aqueles que tocam nos critérios da sua matriz de risco (por exemplo, execuções de título extrajudicial, pedidos de falência, recuperações judiciais ou ações civis públicas):

• GET /v1/processos/cnj/{cnj} (R$ 0,12): retorna os dados de capa do processo, incluindo partes e polo processual (diferenciando se o CNPJ pesquisado é autor/credor no polo ativo ou réu/executado no polo passivo), valor da causa, assunto principal, órgão julgador e advogados habilitados.
• GET /v1/processos/cnj/{cnj}/movimentacoes (R$ 0,12): entrega a linha do tempo cronológica dos andamentos para identificar se o processo está ativo, suspenso, em fase de cumprimento de sentença ou já arquivado definitivamente.
• GET /v1/processos/cnj/{cnj}/resumo-ia (R$ 0,12): gera uma síntese executiva em linguagem clara a partir dos dados públicos dos autos, permitindo que o analista de compliance ou crédito compreenda o objeto da disputa em segundos antes de acionar o jurídico.
• GET /v1/processos/cnj/{cnj}/documentos-publicos (R$ 0,25): quando o caso exige auditoria documental aprofundada, recupera a lista de documentos e peças públicas disponíveis no processo.

Camada 3: Radar de novos processos e monitoramento contínuo via Webhook

O erro mais comum em operações de compliance B2B é fazer um background check impecável no dia da contratação e ficar cego nos 12 meses seguintes. Um fornecedor estratégico que estava saudável em janeiro pode sofrer uma execução relevante ou um pedido de bloqueio judicial em maio.

Para resolver essa lacuna sem reconsultar toda a base via polling, a API oferece dois recursos complementares de vigilância contínua:

1. Radar de Novos Processos (POST /v1/monitoramentos/novos-processos): você cadastra o CPF, CNPJ ou termo/nome do parceiro homologado (com filtro opcional de estados em ufs). Sempre que uma nova ação pública for distribuída envolvendo aquele documento, seu backend recebe um evento assinado via webhook.
2. Monitoramento de Andamentos (POST /v1/monitoramentos/processos): para os números CNJ críticos que o jurídico ou o comitê de risco decidiu acompanhar de perto, a API monitora a linha do tempo do processo e avisa a cada nova movimentação publicada.

A API Jurídica do BuscaProcessos consolida a comunicação com tribunais estaduais, federais, trabalhistas e superiores em um único contrato JSON.

Implementação prática: código de triagem em cascata e webhook seguro

Para demonstrar como as três camadas se conectam no código, veja um exemplo em Node.js / TypeScript que executa a triagem de um CNPJ, trata o retorno assíncrono (HTTP 202) quando o tribunal exige varredura ao vivo e aprofunda seletivamente apenas os processos ativos relevantes.

(Se você quiser exemplos completos em Python e Node.js com paginação e retries, consulte também nosso guia prático de integração da API em Python e Node.js).

1. Triagem por documento e enriquecimento seletivo (GET /v1/processos + GET /v1/processos/cnj/{cnj})

const API_BASE = "https://api.buscaprocessos.app.br/v1";
const API_KEY = process.env.BUSCAPROCESSOS_API_KEY!;

interface ProcessoResumo {
  numeroCnj: string;
  tribunal: string;
  classe?: string;
  situacao?: string;
}

export async function triagemFornecedorKyb(cnpj: string) {
  const docLimpo = cnpj.replace(/\D/g, "");

  // Camada 1: Listagem por CNPJ (R$ 2,00 até 200 processos)
  const listRes = await fetch(
    `${API_BASE}/processos?cpf_cnpj=${docLimpo}&limit=50`,
    {
      headers: {
        "X-API-Key": API_KEY,
        Accept: "application/json",
      },
    }
  );

  // Tratamento de HTTP 202 (busca assíncrona em andamento nos tribunais)
  if (listRes.status === 202) {
    const body202 = await listRes.json();
    return {
      status: "PENDING",
      retryAfterSeconds: body202?.meta?.retryAfterSeconds ?? 15,
      message: "Varredura em andamento; aguarde o webhook ou reconsulte após o intervalo.",
    };
  }

  if (!listRes.ok) {
    throw new Error(`Falha na triagem (${listRes.status}): ${await listRes.text()}`);
  }

  const listJson = await listRes.json();
  const processos: ProcessoResumo[] = listJson?.data?.processos ?? [];

  // Filtra apenas processos não arquivados de classes relevantes para a política de risco
  const classesRelevantes = /execu|falencia|recuperacao|cobranca|monitoria|improbidade/i;
  const candidatos = processos
    .filter((p) => !/arquivado|baixado/i.test(p.situacao ?? ""))
    .filter((p) => classesRelevantes.test(p.classe ?? ""))
    .slice(0, 5); // Limite de teto financeiro por avaliação automática

  // Camada 2: Aprofunda capa + resumo IA apenas dos processos filtrados (R$ 0,12 cada)
  const detalhados = [];
  for (const proc of candidatos) {
    const cnjLimpo = proc.numeroCnj.replace(/\D/g, "");
    const [capaRes, resumoRes] = await Promise.all([
      fetch(`${API_BASE}/processos/cnj/${cnjLimpo}`, {
        headers: { "X-API-Key": API_KEY },
      }),
      fetch(`${API_BASE}/processos/cnj/${cnjLimpo}/resumo-ia`, {
        headers: { "X-API-Key": API_KEY },
      }),
    ]);

    detalhados.push({
      numeroCnj: proc.numeroCnj,
      tribunal: proc.tribunal,
      capa: capaRes.status === 200 ? (await capaRes.json()).data : { status: capaRes.status },
      resumoIa: resumoRes.status === 200 ? (await resumoRes.json()).data : null,
    });
  }

  return {
    status: "COMPLETED",
    totalProcessosPublicos: processos.length,
    processosAprofundados: detalhados.length,
    detalhados,
  };
}

2. Recebendo eventos de monitoramento e radar via Webhook (HMAC-SHA256)

Quando você cadastra um documento no Radar de Novos Processos (POST /v1/monitoramentos/novos-processos) ou acompanha um CNJ em POST /v1/monitoramentos/processos, a API envia uma requisição POST para o endpoint de destino que você configurou assim que a novidade é detectada.

Payload de evento entregue via webhook com status HTTP 200 e identificador de entrega (deliveryId) para garantia de idempotência.

Para garantir que o payload partiu autenticamente do BuscaProcessos e evitar processamento duplicado em caso de reenvio de rede, valide o cabeçalho X-BuscaProcessos-Signature com comparação em tempo constante (crypto.timingSafeEqual) e registre o identificador único da entrega:

import crypto from "node:crypto";

export function validarAssinaturaWebhook(
  rawBody: Buffer,
  signatureHeader: string | undefined,
  webhookSecret: string
): boolean {
  if (!signatureHeader) return false;

  const recebido = signatureHeader.replace(/^sha256=/i, "").trim();
  const esperado = crypto
    .createHmac("sha256", webhookSecret)
    .update(rawBody)
    .digest("hex");

  const bufRecebido = Buffer.from(recebido, "hex");
  const bufEsperado = Buffer.from(esperado, "hex");

  if (bufRecebido.length !== bufEsperado.length) {
    return false;
  }

  return crypto.timingSafeEqual(bufRecebido, bufEsperado);
}

Simulação transparente de custos: quanto custa rodar na API Jurídica?

Na API Jurídica do BuscaProcessos, o modelo é 100% pré-pago por consumo, sem mensalidade fixa e sem cláusula de fidelidade. As recargas avulsas partem de R$ 150, e qualquer equipe pode começar pelo plano gratuito com R$ 50 em créditos (sem cartão).

Veja os valores unitários por endpoint e como o funil em cascata impacta o custo real de uma operação de compliance:

Exemplo prático em uma fila de 100 fornecedores (KYB regionalizado em TJSP + TRT2):

• Etapa 1 (100 CNPJs com filtro em 2 tribunais): 100 chamadas a GET /v1/processos?tribunais=TJSP,TRT2 (cobrando R$ 0,25 apenas por tribunal que retornar resultado; estimando retorno médio em 2 tribunais para metade da fila) = R$ 25,00 (ou R$ 2,00 por CNPJ com processos na busca nacional).
• Etapa 2 (Enriquecimento seletivo): suponha que 75 fornecedores não tenham ocorrências críticas e sejam aprovados na Etapa 1. Nos 25 restantes, o sistema aprofunda em média 3 processos relevantes por empresa, consultando capa (R$ 0,12) + resumo por IA (R$ 0,12) = 75 processos × R$ 0,24 = R$ 18,00.
• Custo total da triagem estruturada dos 100 CNPJs: a partir de R$ 43,00 com filtro regionalizado (com contexto de polo, valor da causa e resumo executivo).

Governança, LGPD e limites que toda operação de compliance deve respeitar

Automatizar a coleta de dados processuais via API aumenta a velocidade da sua operação, mas exige governança jurídica rigorosa. Ao desenhar suas regras de negócio, mantenha quatro premissas inegociáveis:

1. Existência de processo não é condenação nem reprovação automática: uma empresa ou pessoa física pode figurar em dezenas de processos como autora (cobrando clientes inadimplentes ou discutindo tributos), como testemunha ou em ações já arquivadas sem qualquer condenação. Automatize a triagem e a classificação, mas mantenha revisão humana antes de qualquer decisão restritiva de crédito, contratação ou parceria.
2. Base legal e finalidade legítima na LGPD: dados de processos públicos são de acesso público nos termos da Resolução CNJ nº 121/2010, mas seu tratamento por empresas privadas deve observar a boa-fé, a finalidade específica e a não discriminação exigidas pelo art. 7º, § 3º da Lei nº 13.709/2018 (LGPD), além de respeitar os limites da jurisprudência trabalhista (TST) contra listas discriminatórias.
3. Respeito ao segredo de justiça e cobertura real dos tribunais: nenhuma API jurídica idônea promete 100% dos processos existentes no país. Ações que tramitam em segredo de justiça (art. 189 do CPC) são restritas às partes e aos seus procuradores, e os portais dos tribunais podem apresentar indisponibilidade temporária ou diferenças de indexação (acompanhe a disponibilidade em tempo real na nossa página de status dos tribunais).
4. Não substituição de certidões oficiais nem de parecer jurídico: a consulta via API serve para inteligência operacional, triagem de risco e monitoramento contínuo. Quando um contrato, licitação ou operação imobiliária exigir certidão negativa formal com fé pública, ela deve ser emitida diretamente no portal oficial do respectivo tribunal.

API Jurídica vs. Painel Empresa: qual frente escolher para o seu time?

Dentro do ecossistema do BuscaProcessos, atendemos tanto times de engenharia quanto equipes de compliance e compras que precisam operar sem depender de desenvolvimento:

• Escolha a API Jurídica (/api-integracoes) se você quer embutir a consulta por CPF/CNPJ, o enriquecimento por CNJ e os webhooks de monitoramento diretamente no seu ERP, CRM, plataforma de onboarding, motor de crédito ou sistema jurídico interno.
• Escolha o Painel Empresa (/empresas) se a sua equipe de compliance, suprimentos ou jurídico já tem uma lista de CNPJs/CPFs em planilha CSV ou Excel e precisa processar o background check de fornecedores em lote hoje mesmo pelo navegador, com histórico e exportação para auditoria.