Positiva Jurídico 360 API

Como Usar

Todas as consultas são feitas em um único endpoint. Informe os produtos desejados no array product_code. O resultado é retornado agrupado por produto.

Exemplo cURL

curl -X POST \
  https://positivaconnect.positivaconsultas.com.br/api/client/provider/juridico360 \
  -H "Authorization: Bearer {seu_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "12345678901",
    "product_code": ["CRIMINAL","CIVIL"]
  }'

Formato da Resposta

{
  "success": true,
  "document": "12345678901",
  "provider": "juridico360",
  "query_date": "2026-03-18T10:00:00",
  "results": {
    "PRODUTO_A": { "success": true, "data": { ... } },
    "PRODUTO_B": { "success": true, "data": { ... } }
  }
}

Relatório Clássico e Relatório Avançado

Toda resposta do Jurídico 360 traz o campo modelo: classico ou avancado. O Relatório Clássico entrega os dados das bases consultadas. O Relatório Avançado, para empresas que o contrataram, acrescenta a pontuação de risco jurídico (abaixo) e é cobrado à parte.

Relatório Avançado: Risco Jurídico (0 a 1000)

Para receber o Relatório Avançado, inclua o código MODELO_AVANCADO em product_code, junto com ao menos uma base de processos (CIVIL, CRIMINAL ou TRABALHISTA). Ele não faz consulta a mais: a resposta traz o bloco risco_juridico com a pontuação calculada pela Positiva sobre os dados retornados. Quanto maior a pontuação, menor o risco. Se nenhuma base de processos responder, o campo vem null. Sem o produto contratado, o pedido volta com 403 product_not_authorized; sem base de processos, com 400 invalid_request.

Quanto maior a pontuação, menor o risco. Ela considera os processos em que o consultado é réu, pelo papel dele em cada processo, os registros no Ministério Público, no BNMP e no cadastro de Empregadores Irregulares, a recuperação judicial pedida pelo consultado e as ações dele para retirar restrição de crédito. Pedido de falência contra ele aparece em alertas, sem peso. Para a avaliação completa, consulte as seis bases; as que ficarem de fora aparecem em ressalvas.

Exemplo

{
  "document": "22222222222",
  "product_code": ["CIVIL", "CRIMINAL", "TRABALHISTA", "MP", "BNMP", "EMPREGADOR_IRREGULAR", "MODELO_AVANCADO"]
}

{
  "success": true,
  "document": "22222222222",
  "provider": "juridico360",
  "query_date": "2026-10-20 10:00:00",
  "modelo": "avancado",
  "results": { ... },
  "risco_juridico": {
    "pontuacao": 240,
    "pontuacao_maxima": 1000,
    "nivel": "critico",
    "rotulo": "Risco jurídico crítico",
    "faixa": { "minimo": 0, "maximo": 349 },
    "fatores": [
      { "id": "volume-recente", "descricao": "Média de 3,6 processos por ano como réu nos últimos 5 anos (referência para CPF: até 1 por ano)", "trava": null },
      { "id": "em-aberto", "descricao": "18 processos cíveis ou trabalhistas em aberto como réu", "trava": null }
    ],
    "alertas": [],
    "ressalvas": ["A consulta retornou 64 de 70 processos nas categorias com mais registros; a pontuação considera só os retornados."],
    "produtos_considerados": ["CIVIL", "CRIMINAL", "TRABALHISTA", "MP", "BNMP", "EMPREGADOR_IRREGULAR"],
    "versao_regua": "2026-10-26.2"
  }
}

Campos

Faixas

"Em aberto" = em tramitação, em grau de recurso ou suspenso. O ano de referência é o da data da consulta.

Gerar Relatório em PDF

Você pode consultar o endpoint exclusivo de PDF para obter o relatório renderizado visualmente, idêntico ao portal. O retorno é o arquivo PDF encodado em Base64.

Exemplo cURL

curl -X POST \
  https://positivaconnect.positivaconsultas.com.br/api/client/provider/juridico360/pdf \
  -H "Authorization: Bearer {seu_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "12345678901",
    "product_code": ["CRIMINAL","CIVIL"]
  }'

Formato da Resposta

{
  "success": true,
  "document": "12345678901",
  "provider": "juridico360",
  "query_date": "2026-06-22 10:00:00",
  "modelo": "classico",
  "risco_juridico": { ... },  // só no Relatório Avançado ("modelo": "avancado")
  "mime_type": "application/pdf",
  "pdf_base64": "JVBERi0xLjQK..."
}

Quando sua credencial está configurada no ambiente homolog, a API responde com dados fictícios determinísticos — sem consumir o provedor externo. Use os documentos de teste abaixo para validar sua integração. Os dados são anonimizados (nomes, documentos e números de processo não correspondem a pessoas ou processos reais).

Qualquer outro documento consultado em homologação retorna um cenário padrão. Em produção, a consulta é feita normalmente no provedor.