O Sherlocker consulta processos judiciais em múltiplos tribunais simultaneamente, retornando dados estruturados com classe, assunto, partes, movimentações e documentos.

​
Pontos de entrada

Dado disponívelEndpointResultado
CPFGET /processos/cpf/{cpf}Processos da pessoa
CNPJGET /processos/cnpj/{cnpj}Processos da empresa

​
Segmentação por Classes Processuais

Os processos retornados incluem a classe judicial, que permite segmentar e priorizar por tipo de ação. Exemplos comuns:

​
Recuperações Judiciais e Falências

ClasseO que indica
Recuperação JudicialEmpresa em processo de reestruturação de dívidas
FalênciaEmpresa insolvente em liquidação judicial
AutofalênciaEmpresa pediu a própria falência
Uso prático: monitorar empresas em dificuldade financeira para due diligence ou risco de crédito. 
processos = get(f"/processos/cnpj/{cnpj}")

falencias = [p for p in processos.get("processos", [])
    if any(t in p["processo"].get("classe_judicial", "").lower()
           for t in ["falencia", "recuperacao judicial"])]

if falencias:
    print(f"ALERTA: {len(falencias)} processos de falencia/recuperacao")

​
Execuções

ClasseO que indica
Execução FiscalCobrança de tributos não pagos
Execução de Título ExtrajudicialCobrança de cheque, nota promissória, contrato
Cumprimento de SentençaCobrança de valor já decidido em sentença
Uso prático: avaliar inadimplência e risco financeiro.

​
Ações Cíveis

ClasseO que indica
Procedimento Comum CívelAção genérica — verificar assunto para detalhar
Ação de IndenizaçãoPedido de reparação de danos
Ação MonitóriaCobrança simplificada com documento de dívida
Busca e ApreensãoRetomada de bem (alienação fiduciária)

​
Ações Trabalhistas

ClasseO que indica
Reclamação TrabalhistaAção de funcionário contra empregador
Ação Civil PúblicaMPT contra empresa (irregularidades coletivas)
Uso prático: volume de reclamações trabalhistas como réu indica problemas de gestão de pessoal.

​
Ações Criminais

ClasseO que indica
Ação PenalProcesso criminal — verificar se é réu
Termo CircunstanciadoInfrações de menor potencial ofensivo
Execução PenalCumprimento de pena

​
Exemplo: filtrar processos por categoria

import requests

BASE = "https://modulos.sherlocker.dev"

processos = requests.get(f"{BASE}/processos/cpf/{cpf}", params={"token": TOKEN}).json()

categorias = {
    "criminal": [],
    "trabalhista": [],
    "execucao": [],
    "falencia": [],
    "civel": [],
}

for p in processos.get("processos", []):
    classe = p["processo"].get("classe_judicial", "").lower()

    if any(t in classe for t in ["criminal", "penal"]):
        categorias["criminal"].append(p)
    elif "trabalhista" in classe or "reclamacao trabalhista" in classe:
        categorias["trabalhista"].append(p)
    elif any(t in classe for t in ["execucao", "cumprimento de sentenca"]):
        categorias["execucao"].append(p)
    elif any(t in classe for t in ["falencia", "recuperacao judicial"]):
        categorias["falencia"].append(p)
    else:
        categorias["civel"].append(p)

for cat, procs in categorias.items():
    if procs:
        print(f"{cat}: {len(procs)} processos")

​
Estrutura do processo

Cada processo retornado contém:
CampoDescrição
numeroNúmero unificado CNJ (ex: 0001234-56.2023.8.26.0100)
data_distribuicaoData de distribuição
classe_judicialEx: Procedimento Comum Cível, Execução Fiscal
assuntoEx: Indenização por Dano Moral, Cobrança
jurisdicaoTribunal (TJSP, TRF2, etc)
orgao_julgadorVara ou turma responsável

​
Participantes (polo)

Cada participante tem:
  • Nome e CPF (quando disponível)
  • Qualificação: Autor, Réu, Advogado, Terceiro Interessado, etc.
  • OAB: número da OAB (para advogados)

​
Movimentações

Histórico cronológico do processo com data, descrição e complemento.

​
Paginação

GET /processos/cpf/{cpf}?pagina=1&por_pagina=25
A resposta inclui: 
{
  "paginacao": {
    "pagina_atual": 1,
    "processos_por_pagina": 25,
    "total_paginas": 3,
    "total_processos": 72
  }
}

​
Modo assíncrono

Para evitar timeout, adicione ?async=true: 
POST /processos/async/cpf/{cpf}  →  { "jobId": "abc123", "statusUrl": "..." }
GET  /processos/jobs/abc123      →  { "status": "completed", "resultado": {...} }
Veja mais detalhes em Jobs Assíncronos.

Processos por CPF

Processos de pessoa física

Processos por CNPJ

Processos de pessoa jurídica