Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.gyramais.com.br/llms.txt

Use this file to discover all available pages before exploring further.

A seção PROCESSES traz os processos judiciais do documento analisado e, quando CNPJ, também dos sócios.
  • Relatório COMPLETO: processos desde 2014
  • Relatório COMPLETO+: processos desde 1980

Tipos de processos normalizados

O campo type de cada processo é classificado em uma das dez categorias canônicas abaixo. A normalização é determinística: o raw vindo dos tribunais é mapeado por palavras-chave para uma destas categorias — não há passthrough do valor original.
CódigoDescrição
CIVELCíveis em geral (cobranças, danos, consumidor, saúde, infância, educação, marítimo, internacional).
TRABALHISTATrabalhistas.
TRIBUTARIATributárias e fazenda pública (execução fiscal, dívida ativa).
FINANCEIROExecução de dívida bancária, cobrança por instituição financeira.
CRIMINALPenais e criminais.
AMBIENTALAmbientais.
ADMINISTRATIVAAdministrativas.
ELEITORALEleitorais.
PREVIDENCIARIAPrevidenciárias e assistenciais.
OUTROSO tipo não pôde ser mapeado com confiança. Comum em processos antigos, classificações neutras (ex.: “cumprimento de sentença”) ou raw inconsistente.
Recomendação para OUTROS: sempre crie uma regra de alerta sobre quantidade ou valor de processos OUTROS. Como agrupa o que não foi possível classificar (especialmente processos antigos), pode haver passivo relevante. Use o alerta para migrar o relatório para análise manual em vez de aprovar/negar automaticamente.

Campos do details

Totalizadores da empresa

CampoTipoDescrição
passive.countnumberTotal de processos como réu
passive.totalAmountnumberValor total como réu (R$)
active.countnumberTotal de processos como autor
active.totalAmountnumberValor total como autor (R$)

Breakdown por natureza, empresa (passivo)

CampoTipoDescrição
countCivelnumberProcessos civis
amountCivelnumberValor em processos civis (R$)
countLabornumberProcessos trabalhistas
amountLabornumberValor em processos trabalhistas (R$)
countCriminalnumberProcessos criminais
amountCriminalnumberValor em processos criminais (R$)
countFinancialnumberProcessos financeiros
amountFinancialnumberValor em processos financeiros (R$)
countEnvironmentnumberProcessos ambientais
amountEnvironmentnumberValor em processos ambientais (R$)

Processos dos sócios

CampoTipoDescrição
ownersobject[]Lista de sócios com processos
owners[].namestringNome do sócio
owners[].documentstringCPF do sócio
owners[].passive.countnumberProcessos como réu
owners[].passive.totalAmountnumberValor total como réu (R$)
owners[].hasCriminalbooleanTem processo criminal
owners[].hasFinancialbooleanTem processo financeiro
owners[].hasLaborbooleanTem processo trabalhista
owners[].hasCivelbooleanTem processo civil

Detalhes dos processos (processes[])

CampoTipoDescrição
idstringID do processo
numberstringNúmero do processo (CNJ)
courtstringTribunal
typestringNatureza canônica do processo. Um de: CIVEL, TRABALHISTA, TRIBUTARIA, FINANCEIRO, CRIMINAL, AMBIENTAL, ADMINISTRATIVA, ELEITORAL, PREVIDENCIARIA, OUTROS.
rolestringPosição: PASSIVE (réu) ou ACTIVE (autor)
amountnumberValor da causa (R$)
distributedAtstringData de distribuição (YYYY-MM-DD)
statestringEstado do tribunal
partiesobject[]Partes envolvidas
parties[].namestringNome da parte
parties[].rolestringPapel no processo
lastMovementobjectÚltima movimentação
lastMovement.datestringData
lastMovement.descriptionstringDescrição da movimentação

Exemplo de resposta

{
  "type": { "value": "PROCESSES" },
  "details": {
    "passive": {
      "count": 3,
      "totalAmount": 125000.00
    },
    "active": {
      "count": 1,
      "totalAmount": 15000.00
    },
    "countLabor": 2,
    "amountLabor": 85000.00,
    "countCivel": 1,
    "amountCivel": 40000.00,
    "processes": [
      {
        "number": "1234567-89.2022.5.02.0001",
        "court": "2ª Vara do Trabalho de São Paulo",
        "type": "TRABALHISTA",
        "role": "PASSIVE",
        "amount": 45000.00,
        "distributedAt": "2022-03-15",
        "state": "SP",
        "lastMovement": {
          "date": "2024-11-20",
          "description": "Audiência de instrução e julgamento"
        }
      }
    ]
  }
}
Processos com valores acima de R$ 500.000 são sinais de alerta crítico em análises B2B. Configure uma regra LAWSUITS_PASSIVE_AMOUNT na sua política para tratar esse cenário automaticamente.