Pular para o conteúdo principal

Validacao de Pessoa Física

Requisição

GET [Url Ambiente]/Validacao/Valida-PF

IdentificadorValor
Acceptapplication/json
AuthorizationBearer [Valor do Token retornado na Autenticação]

Query

ParâmetroDescriçãoTipoExemplos
NomeCampo a ser comparado com o Bureau de dadosString"Nome Exemplo"
CpfCampo a ser comparado com o Bureau de dadosString"000.000.000-00"
DataNascimentoCampo a ser comparado com o Bureau de dadosString"dd/mm/aaaa"

Exemplo

curl -X POST --header 'Accept: application/json' --header 'Authorization: Bearer ababab1236-nbahdj-25' 'https://api.plataformaacert.com.br/Validacao/Valida-PF'
--data '{
"Nome": "Nome Exemplo",
"Cpf": "000.000.000-00",
"DataNascimento": "01/11/2000"
}'

Status Code 200

Retorno de sucesso.

Com acesso ao token e campos para validação, será possível obter o retorno da validação de Pessoa Física. Segue campos que são retornados na consulta:

ParâmetroDescriçãoTipoExemplos
CpfCPF enviado na requisiçãoString“000.000.000-00”
NomeNome enviado na requisiçãoString"Nome Exemplo"
DataNascimentoData Nascimento enviada na requisiçãoString"dd/mm/aaaa"
RegularReceitaRetorna se está regular na receita federalString"SIM" / "NÃO"
ObitoOKRetorna se esta pessoa veio está em situação de ÓbitoString"SIM" / "NÃO"
NomeOKRetorna se o Nome está ok em relação ao Bureau de dadosString"SIM" / "NÃO"
NomeBureauNome retornado pelo Bureau de dadosString"Nome Exemplo"
NascimentoOKRetorna se a Data de Nascimento está ok em relação ao Bureau de dadosString"SIM" / "NÃO"
NascimentoBureauData Nascimento retornada pelo Bureau de dadosString"dd/mm/aaaa"
StatusStatus da requisiçãoString'0' ou '1'
MensagensDescrição do status da requisiçãoString"SUCESSO" ou "NÃO ENCONTRADO"

Exemplo

{
"Validacao": {
"DadosValidacao": {
"Nome": "Nome Exemplo",
"Cpf": "00000000000",
"DataNascimento": "01/11/2000"
},
"ResultadoValidacao": {
"RegularReceita": "SIM",
"ObitoOK": "SIM",
"NomeOK": "SIM",
"NomeBureau": "Nome Exemplo",
"NascimentoOK": "SIM",
"NascimentoBureau": "01/11/2000"
}
},
"Status": 0,
"Mensagens": [
"SUCESSO"
]
}

Status Code 400

Não encontrado.

ParâmetroDescriçãoTipoExemplos
StatusStatus da requisiçãoOK = 0, ERRO = 11
MensagensDescrição dos errosString[]"Mensagens": "Mensagens": []

Status Code 401

Usuário/Senha inválidos.

ParâmetroDescriçãoTipoExemplos
StatusStatus da requisiçãoOK = 0, ERRO = 11
MensagensDescrição dos errosString[]"Mensagens": "Mensagens": []

Status Code 404

Erro 404 - Url não encontrado

O erro 404 é exibido quando um endpoint especificado pelo usuário não é encontrado na API. Isso pode ocorrer quando o usuário digitou um URL incorreto ou quando o endpoint não está mais disponível.

Status Code 500

Erro não tratado pelo sistema.

ParâmetroDescriçãoTipoExemplos
StatusStatus da requisiçãoOK/ERROERRO
MensagensDescrição dos errosString[]"Mensagens": []

Exemplo

{
"Status": "OK",
"Mensagens": [
"string"
]
}