A API Nível Socioeconômico e Renda Estimada permite sintetizar características socioeconômicas de indivíduos, como renda, ocupação e escolaridade. É amplamente utilizada para segmentação de perfis em análises de risco, onboarding e compliance.
Nível Socioeconômico e Renda Estimada
Nível socioeconômico (NSE) é uma forma de sintetizar as características de um indivíduo em relação à sua renda, ocupação e escolaridade. Ele é usado para identificar grupos de pessoas semelhantes em relação a essas características.
Casos de Uso
- Integração com Nível Socioeconômico e Renda Estimada
- Onboarding KYC e validação de identidade
- Análise de risco/crédito com dados cadastrais e socioeconômicos
- Prevenção a fraude em abertura de conta e cadastro
Aplicações
- Onboarding de Clientes e Fornecedores
- Prevenção de Lavagem de Dinheiro
- Análise de Risco/Crédito
Benefícios
- Documentação de Nível Socioeconômico e Renda Estimada acessível e atualizada
- Dados atualizados e padronizados
- Aumento de aprovação com menos atrito
- Conformidade com políticas internas e LGPD
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/nivelSocioeconomicoEndpoint
GET https://apiv3.directd.com.br/api/nivelSocioeconomico?CPF={0}&Token=Seu_TokenDescrição: Endpoint para realizar consultas Nível Socioeconômico e Renda Estimada.
Nota: Esta consulta não gera comprovantes.
Campos Retornados
- Classe Social: Classe social do indivíduo
- Classificação Brasileira de Ocupações: Informa os dados referentes a Classificação Brasileira de Ocupações.
- CPF: CPF do indivíduo
- Escolaridade: Escolaridade do indivíduo
- Renda e Faixa Salarial: Informa a Faixa de renda salarial baseada na quantidade de salários mínimos .
- Renda Estimada: Renda estimada do indivíduo consultado
- Renda IBGE: Informa a renda do indivíduo segundo o IBGE.
- Renda Máxima CBO: Informa a renda máxima baseado no CBO do indivíduo.
- Renda Média CBO: Informa a renda média baseado no CBO do indivíduo.
- Renda Mínima CBO: Informa a renda mínima baseado no CBO do indivíduo.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
CPF | string | Sim | O parâmetro CPF pode ser enviado com ou sem formatação. |
TOKEN | string | Sim | O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br |
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"enviarCallback": false,
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"cpf": "string",
"rendaEstimada": "string",
"rendaFaixaSalarial": "string",
"rendaMinimaCBO": "string",
"rendaMediaCBO": "string",
"rendaMaximaCBO": "string",
"rendaIBGE": "string",
"cbo": "string",
"classeSocial": "string",
"escolaridade": "string"
}
}Erros Comuns
| Código | Descrição |
|---|---|
400 | Requisição Inválida: a requisição está incorreta ou os parâmetros são inválidos. |
401 | Não Autenticado: o usuário não forneceu as credenciais corretas para acessar o recurso. |
403 | Não Autorizado: o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
404 | Não Encontrado: o servidor não encontrou uma representação atual do recurso solicitado. |
408 | Tempo Esgotado: o servidor não conseguiu retornar a requisição no prazo estabelecido. |
500 | Falha ao Realizar Consulta: o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
503 | Consulta em Manutenção: a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |
Notas Importantes
- Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
- Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228