Saiba o endereço cadastral do titular e os anteriores
Endereço digitado no cadastro não diz se a pessoa já morou ali ou se escolheu um CEP qualquer para passar pelo formulário. Aqui você recebe, junto com nome, nascimento e situação do CPF, o endereço que a fonte cadastral registra para o titular e a lista dos endereços que ele teve antes.
Confirma o CPF do documento e devolve nome, nascimento, situação na Receita e endereço completo com histórico.
- Documento (OCR)
- Face Match
- Liveness
- CPF - Endereços
"status": "approved"Para quem é
Serve a quem entrega coisa física ou precisa encontrar o cliente depois: e-commerce com frete caro, locadoras de veículo e de equipamento, operadoras que instalam serviço na casa do cliente, empresas de cobrança e de recuperação de crédito. Com o CEP registrado em mãos, a primeira entrega vai ao lugar certo e a notificação de débito tem para onde ir.
Serve também a quem precisa conferir o endereço declarado sem pedir mais um arquivo ao cliente. Se o CEP do formulário não aparece nem no endereço atual nem no histórico, o seu time sabe que vale uma pergunta a mais antes de liberar o pedido.
Seguradoras de automóvel e de residência usam o CEP para precificar o risco do pernoite e do imóvel, e bancos usam o endereço para enviar cartão físico. Em todos esses casos, um endereço que só existe no formulário vira devolução dos Correios, cartão extraviado ou apólice calculada sobre o bairro errado.
O que você recebe
O endereço principal chega solto no topo do bloco data: endereco, numero, complemento, bairro, cep, cidade, uf e o código ibge do município. Os anteriores vêm na lista enderecos, cada um com os mesmos campos, prontos para o seu sistema comparar CEP por CEP.
O mesmo retorno traz nome, nascimento e situacao, a situação cadastral do CPF em texto. Não confunda situacao com status: o segundo diz apenas que a chamada à fonte deu certo. As datas deste tier seguem o padrão brasileiro de dia, mês e ano, e não o formato ISO.
Os sete módulos de consulta cadastral de CPF e de CNPJ, com o que cada um traz e o payload de resultado de cada consulta.
O módulo se chama cpf_enderecos no flow e no webhook.
Como entra no seu flow
No mesmo flow, ele liga junto: Documento (OCR), Face Match, Liveness.
O check cpf_enderecos chega no webhook depois da decisão de identidade, e o resultado dele fica fora da aprovação biométrica. Se a situação do CPF não for regular, o próprio check sai failed, e isso é informação para a sua política, que continua dona do destino do cadastro.
Quando a fonte está indisponível o check fica pending e volta a ser consultado mais tarde. Normalize o CEP antes de comparar, porque formulário costuma vir com hífen e o retorno vem só com dígitos, e guarde o histórico como está: é ele que mostra mudança recente de endereço.
O grupo do módulo
Confere o CPF lido do documento nas fontes oficiais. Exigem documento, face match e prova de vida: sem isso a consulta seria sobre um CPF de terceiro.
Preço
R$ 3,82por verificação
O valor é lido do mesmo catálogo que o painel usa para montar um flow, somando os módulos que este exige, se exigir. Ver preços.
Perguntas frequentes
Ler a documentaçãoO endereço devolvido prova que a pessoa mora lá?
É o endereço que a fonte cadastral registra para o CPF, e ele pode estar atrás de uma mudança recente. Se a sua operação exige prova de residência, o catálogo tem a leitura do comprovante enviado pelo titular, com data de emissão e cruzamento de nome, que é outro produto.
Por que o histórico importa?
Porque ele separa o cliente que mudou do que inventou. Um CEP do formulário que aparece entre os endereços anteriores é mudança comum; um CEP que não aparece em lugar nenhum é o caso que merece olhar humano antes do envio.
O que vem no ambiente de teste?
Um titular fictício com endereço principal e um endereço anterior, sempre os mesmos, sem consulta real. Serve para montar o parser que separa o endereço do topo da lista de anteriores antes do primeiro cliente de verdade.
Como o meu sistema deve guardar o histórico?
Numa tabela filha do cliente, uma linha por endereço, com a data da verificação que o trouxe. Assim, numa segunda verificação meses depois, a comparação entre as duas listas revela mudança, e o seu atendimento consegue confirmar com o cliente antes de despachar uma encomenda de valor alto.
Crie a conta, monte um flow com este módulo e rode a verificação inteira no ambiente de teste, sem consumir saldo.
