Consulta de CNPJ (legalEntityLookup)

$nfe->legalEntityLookup consulta dados cadastrais de pessoa jurídica por CNPJ, incluindo a inscrição estadual (IE) por UF. Recurso global (não recebe $companyId), servido por legalentity.api.nfe.io.

Família de dados — usa dataApiKey

Com fallback para apiKey. Um 403 com chave principal válida normalmente significa que o plano não inclui o produto de dados. Veja Configuração.

Métodos

Método	Descrição	Retorno
getBasicInfo($cnpj, $opts = null)	Dados cadastrais básicos da Receita.	LegalEntityResponse
getStateTaxInfo($state, $cnpj)	Inscrição estadual na UF.	LegalEntityResponse
getStateTaxForInvoice($state, $cnpj)	IE apta para emissão de NF-e.	LegalEntityResponse
getSuggestedStateTaxForInvoice($state, $cnpj)	IE sugerida para a NF-e.	LegalEntityResponse

Consultar os dados básicos

$resposta = $nfe->legalEntityLookup->getBasicInfo('11.444.555/0001-49');

$pj = $resposta->legalEntity;      // array com os dados desembrulhados (ou null)
$pj['name'] ?? null;
$pj['address'] ?? null;

$resposta->raw;                    // payload completo original

getBasicInfo() aceita um segundo argumento com parâmetros de query — por exemplo, ['updateAddress' => false, 'updateCityCode' => true].

Consultar a inscrição estadual por UF

$ie = $nfe->legalEntityLookup->getStateTaxInfo('SP', '11444555000149');

// Variantes voltadas à emissão de NF-e:
$nfe->legalEntityLookup->getStateTaxForInvoice('SP', '11444555000149');
$nfe->legalEntityLookup->getSuggestedStateTaxForInvoice('SP', '11444555000149');

UF é validada localmente

$state é normalizada para maiúsculas; uma UF desconhecida lança Nfe\Exception\InvalidRequestException antes de qualquer requisição.

Enriquecendo cadastros

Um fluxo comum: consultar o CNPJ aqui e usar o resultado para pré-preencher o cadastro do tomador em legalPeople antes de emitir a nota.

Veja também

• Consulta de CPF — o equivalente PF.
• Inscrições estaduais — IEs da sua empresa emissora.
• Configuração — modelo de duas chaves.