Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

Consulta de CPF (naturalPersonLookup)

$nfe->naturalPersonLookup consulta a situação cadastral de uma pessoa física na Receita Federal. Recurso global, servido por naturalperson.api.nfe.io.

Família de dados — usa dataApiKey

Com fallback para apiKey. Veja Configuração.

Métodos​

MétodoDescriçãoRetorno
getStatus($cpf, $birthDate)Situação cadastral do CPF.NaturalPersonStatus

A consulta de CPF exige duas credenciais do titular: o CPF e a data de nascimento.

Consultar a situação cadastral​

$status = $nfe->naturalPersonLookup->getStatus('311.192.980-00', '1990-05-20');

$birthDate aceita uma string ISO (YYYY-MM-DD) ou um \DateTimeImmutable:

$status = $nfe->naturalPersonLookup->getStatus(
    '31119298000',
    new \DateTimeImmutable('1990-05-20'),
);
Validação local da data

Datas malformadas ou fora de faixa lançam Nfe\Exception\InvalidRequestException antes de qualquer requisição. O CPF também é validado quanto ao formato.

Dado sensível

CPF e data de nascimento são dados pessoais — trate o resultado conforme a LGPD: não logue o payload bruto e restrinja o acesso ao propósito da consulta.

Veja também​

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.