ℹ️ CNPJ enviado na consulta

Em alguns sistemas e planilhas, CNPJs podem ser armazenados como números, fazendo com que os zeros à esquerda sejam removidos. Para evitar que isso impeça uma consulta válida, a API de Empresas completa automaticamente o CNPJ com zeros à esquerda até atingir os 14 dígitos esperados.

Esse tratamento acontece antes da validação do CNPJ.

👍
Esse tratamento evita que a remoção dos zeros iniciais impeça uma consulta válida.
O CNPJ resultante continua sujeito às regras normais de validação.

Como funciona?

Se o CNPJ enviado tiver menos de 14 dígitos, a API completa o valor com zeros à esquerda.

Depois do preenchimento, o CNPJ resultante passa pela validação normalmente.

Se o valor resultante formar um CNPJ semanticamente válido, ele será considerado na consulta.

Se o valor não formar um CNPJ semanticamente válido, a API retorna erro de validação.

Exemplo

CNPJ enviado

3456000105

CNPJ considerado

00003456000105

Nesse caso, a API adiciona os quatro zeros à esquerda e utiliza o valor resultante para realizar a consulta do CNPJ.

💡
Boa prática
Sempre que possível, envie o CNPJ completo, com 14 dígitos, incluindo os zeros à esquerda.
Isso ajuda a garantir que a consulta seja realizada exatamente com o documento esperado.