Developers
Portal do Desenvolvedor

Análise 360 — visão de crédito, restritiva e comportamental via API

Consulte informações comportamentais, cadastrais, financeiras e restritivas de pessoas físicas e jurídicas. Ideal para análise de crédito, prevenção a risco e recuperação de valores.

Todas as requisições usam a URL base https://api.assertivasolucoes.com.br e exigem um token OAuth2 no cabeçalho Authorization: Bearer.

Como o produto é organizado

Dois módulos

O Análise 360 é dividido em dois módulos, com formas de consumo distintas:

Análise Comportamental

Visão ampliada do perfil do cliente (dados cadastrais, socioeconômicos, financeiros e comportamentais). É assíncrona: você envia as consultas por POST e recebe o resultado depois, via callback.

Análise Restritiva

Scores, ações judiciais, protestos, cheques, dívidas e demais indicadores de risco e recuperação. São consultas diretas, feitas por GET, com resposta imediata (ou 202 enquanto processa).

O que dá para fazer

Módulo Restritivo — consultas diretas (GET)

Consulta Endpoint Entrada principal
Ações judiciais PF GET /score/v3/pf/acoes/{cpf} cpf
Score de crédito PF GET /score/v3/pf/credito/{cpf} cpf
Score de recuperação PF GET /score/v3/pf/recupere/{cpf} cpf
Ações judiciais PJ GET /score/v3/pj/acoes/{cnpj} cnpj
Score de crédito PJ GET /score/v3/pj/credito/{cnpj} cnpj
Score de recuperação PJ GET /score/v3/pj/recupere/{cnpj} cnpj

Módulo Comportamental — consultas assíncronas (POST)

POST /credito/v1/pf — análise comportamental de pessoa física (lote de CPFs)
POST /credito/v1/pj — análise comportamental de pessoa jurídica (lote de CNPJs)

Você envia uma lista de consultas e informa uma urlEntregaResultado. A API valida, registra e responde com os identificadores; o resultado de cada consulta chega depois, por POST, na sua URL de callback.

Escolha do módulo

Quando usar cada módulo

GET

Restritiva

Quando você precisa de um score ou de um indicador de risco específico na hora — na esteira de crédito, por exemplo.

POST

Comportamental

Quando você quer uma visão completa do cliente (vários módulos) e pode receber o resultado de forma assíncrona, em lote.

Conformidade

Finalidade de uso (LGPD)

As consultas com dados pessoais exigem o parâmetro idFinalidade, que declara a base legal para o tratamento. Ele é obrigatório nos endpoints do módulo Restritivo e nas consultas comportamentais. Para o Análise 360, os valores aceitos são:

idFinalidade Finalidade Descrição
2 Ciclo de crédito Uso no ciclo de proteção ao crédito, incluindo cobrança, verificação da situação financeira e identificação correta.
4 Execução de contrato Atualização, execução de contrato ou procedimentos preliminares relacionados ao contrato.
Escolha a finalidade que corresponde ao seu caso de uso real. Não utilize os dados retornados para finalidades diferentes da informada.
Próximos passos

Continue a integração

1

Autenticação

Gere o token de acesso — pré-requisito de todas as chamadas.

2

Primeira requisição

Faça sua primeira consulta de score, passo a passo.

3

Casos de uso

Combine as consultas em fluxos reais de crédito e recuperação.

Referência técnica

Respostas e esquemas completos

Veja a Referência de Análise 360 com todos os parâmetros, exemplos de requisição e os esquemas de resposta completos de cada endpoint.

Abrir a Referência técnica