​

🔎 Buscar por Raiz de CNPJ (Parte)

​

💡 A Vantagem da Busca por Raiz

​

🔗 Endpoint

POST https://api.predictus.com.br/predictus-api/processos/judiciais/buscarPorRaizCNPJParte

​

🧾 Exemplo mínimo

raizCnpj é o único campo obrigatório. Todos os demais são filtros opcionais.

{
  "raizCnpj": "12345678"
}

​

🧾 Exemplo completo (com todos os filtros)

{
  "raizCnpj": "42194191",
  "polo": "PASSIVO",
  "nome": "EMPRESA",
  "grausProcesso": [1, 2],
  "origensDocumento": [
    "TRIBUNAL",
    "CATALOGO"
  ],
  "limiteResultados": 10000,
  "tribunais": ["TJ-SP", "TRT-2"],
  "valorCausa": {
    "maiorQue": 50000
  },
  "dataDistribuicao": {
    "maiorIgualQue": "2020-01-01"
  },
  "classesProcessuais": [
    "PROCEDIMENTO COMUM CIVEL",
    "EXECUCAO DE TITULO EXTRAJUDICIAL"
  ],
  "assuntosCNJ": [
    "CONTRATOS BANCARIOS",
    "RESPONSABILIDADE DO FORNECEDOR"
  ],
  "statusProcessuais": [
    "EM TRAMITACAO"
  ],
  "ramosDoDireito": [
    "DIREITO CIVIL"
  ],
  "segmentos": [
    "JUSTICA ESTADUAL"
  ],
  "camposRetorno": {
    "incluir": [
      "numeroProcessoUnico",
      "tribunal",
      "valorCausa",
      "partes"
    ]
  }
}

​

📚 Campos importantes

• raizCnpj (string) — único campo obrigatório
  • Deve conter exatamente os 8 primeiros dígitos de um CNPJ.
• polo — ATIVO ou PASSIVO
• nome (string) — campo opcional usado como filtro auxiliar.
  • Deve ser utilizado apenas para restringir resultados quando há risco de homônimos.
  • Não substitui a busca principal pela raizCnpj.
• origensDocumento (array de strings) — indica a origem da associação do documento:
  • TRIBUNAL → documento oficial capturado diretamente na capa do processo (confiança alta).
  • CATALOGO → documento obtido por consulta de CPF/CNPJ nos sites dos tribunais (confiança alta).
  • AGREGADO → documento atribuído por algoritmos de matching da Predictus (confiança média, pode conter ruídos).
• grausProcesso — lista de inteiros entre 1 e 4.
• tribunais — lista de siglas válidas (ex: TJ-SP, TRT-9, STF)
  • Ver lista completa de tribunais
• valorCausa, dataDistribuicao — permitem filtragem por faixa (menorQue/menorIgualQue/maiorQue/maiorIgualQue)
• classesProcessuais, assuntosCNJ — até 65.000 valores cada
• statusProcessuais — veja valores válidos
• ramosDoDireito — veja valores válidos
• segmentos — veja lista completa de segmentos
• limiteResultados — mínimo: 1 / máximo: 10.000 (padrão: 10.000)

​

📌 Como funcionam os filtros

​

🧾 Códigos de resposta

​

🛡️ Validações aplicadas

• Raiz de CNPJ:
  • Não nulo
  • 8 dígitos numéricos
• Polo:
  • ATIVO ou PASSIVO
• Lista de statusProcessuais, ramosDoDireito, segmentos, tribunais:
  • Todos os valores devem estar na lista de permitidos
• Campos com listas extensas (classesProcessuais, assuntosCNJ):
  • Máximo de 65.000 itens
• limiteResultados: entre 1 e 10.000

​

🧾 Retorno