positiva-consultas-python-sdk

Client HTTP Python para a API Positiva Consultas (PositivaConnect).

Escopo inicial:

• Autenticacao OAuth 2.0 Client Credentials (POST /client/token)
• Positiva Juridico 360 (POST /api/client/provider/juridico360 e /pdf)

Instalacao

pip install positiva-consultas-python-sdk

Requer Python >= 3.11 e o ecossistema fmconsult (ApiBase).

Credenciais

Configure as variaveis de ambiente:

export positiva.consultas.api.client_id="seu_client_id"
export positiva.consultas.api.client_secret="seu_client_secret"

Uso

from positiva.consultas import Juridico360Api, Juridico360ProductCode
from positiva.consultas.dtos.juridico360 import Juridico360Request

api = Juridico360Api()  # autentica automaticamente via /client/token

# Consulta processual (um ou mais produtos)
response = api.consultar(
  Juridico360Request(
    document="11111111111",
    product_code=[
      Juridico360ProductCode.CRIMINAL,
      Juridico360ProductCode.CIVIL,
    ],
  )
)

print(response.success, response.query_date)
criminal = response.results.get("CRIMINAL")
if criminal and criminal.success and criminal.data:
  print(criminal.data.nome, len(criminal.data.processos or []))

# PDF do relatorio (Base64)
pdf = api.gerar_pdf(
  document="11111111111",
  product_code=["CRIMINAL", "CIVIL"],
)
print(pdf.mime_type, len(pdf.pdf_base64 or ""))

Autenticacao utilitaria

from positiva.consultas import PositivaConsultasApi

api = PositivaConsultasApi()
me = api.me()
print(me.client.name, me.client.cnpj)

api.refresh()   # renova o Bearer
api.logout()    # invalida o token atual

Produtos Juridico 360

Homologacao (credencial em ambiente homolog): use documentos de teste 11111111111 … 55555555555 — a API devolve dados ficticios determinísticos.

Documentacao oficial

• Visao geral
• Authentication
• Juridico 360