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/juridico360e/pdf)
Instalacao
pip install positiva-consultas-python-sdk
Requer Python >= 3.11 e o ecossistema fmconsult (ApiBase).
Credenciais
Configure as variaveis de ambiente. O SDK resolve credenciais por environment
(sandbox | live, default sandbox):
export positiva.consultas.api.environment="sandbox"
# Preferencial: um par por environment
export positiva.consultas.api.client_id.sandbox="client_xxx_sandbox"
export positiva.consultas.api.client_secret.sandbox="secret_sandbox"
export positiva.consultas.api.client_id.live="client_xxx_live"
export positiva.consultas.api.client_secret.live="secret_live"
# Legado (ainda suportado): um unico par, sem sufixo
# export positiva.consultas.api.client_id="seu_client_id"
# export positiva.consultas.api.client_secret="seu_client_secret"
# Opcional: override da URL base
# export positiva.consultas.api.base_url="https://positivaconnect.positivaconsultas.com.br/api"
No Unit Consult Core API isso vem de [POSITIVA360] no configs.ini
(positiva360.environment + positiva360.api.client.id|secret.{sandbox|live}).
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
| Codigo | Descricao |
|---|---|
CRIMINAL |
Processos criminais |
CIVIL |
Processos civis |
TRABALHISTA |
Processos trabalhistas |
MP |
Registros do Ministerio Publico |
BNMP |
Banco Nacional de Mandados de Prisao |
EMPREGADOR_IRREGULAR |
Empregadores irregulares |
Homologacao (credencial em ambiente homolog): use documentos de teste 11111111111 … 55555555555 — a API devolve dados ficticios determinísticos.
Documentacao oficial
Metadata
Release files for positiva-consultas-python-sdk 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| positiva_consultas_python_sdk-1.0.1.tar.gz | 16.2 kB | Without provenance | Details for positiva_consultas_python_sdk-1.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| positiva_consultas_python_sdk-1.0.1-py3-none-any.whl | Python 3 | none | any | Details for positiva_consultas_python_sdk-1.0.1-py3-none-any.whl |
Total release size: 31.3 kB
Release files / positiva_consultas_python_sdk-1.0.1.tar.gz
| Download URL | positiva_consultas_python_sdk-1.0.1.tar.gz |
|---|---|
| Size | 16.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e26306138409fe5ee3e3fd6a18703ae6a74945a5e1460b656c4a2b1ecc293246
|
|
BLAKE2b-256 checksum How to use checksums |
d8414c4f4ae1a2a413291aa2591b3ea0785f56a613c683a585a265e50c0b973e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / positiva_consultas_python_sdk-1.0.1-py3-none-any.whl
| Download URL | positiva_consultas_python_sdk-1.0.1-py3-none-any.whl |
|---|---|
| Size | 15.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a15a5dde11d5aff267e3120b55b3b3fc5295a2c8cdf65a30f31fcb6b85433ee8
|
|
BLAKE2b-256 checksum How to use checksums |
a50415e5610d7495035afe14c93d9d532ecdc119b52ddbc2f4a2704704c64118
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for positiva-consultas-python-sdk 1.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.