⚠️ Importante: como a API trata CNPJs
CNPJs com menos de 14 dígitos são completados automaticamente.
CNPJs podem ser enviados para a API, por engano, com menos de 14 dígitos. Isso pode acontecer, por exemplo, quando os dados são enviados por meio de planilhas ou outros sistemas que interpretam o CNPJ como número e acabam removendo os zeros à esquerda.
Para evitar que essa perda de informação impeça uma consulta válida, a API de Empresas foi desenvolvida para identificar valores com menos de 14 dígitos e completar automaticamente os números faltantes com zeros à esquerda, considerando a possibilidade de que os zeros tenham sido removidos durante o tratamento dos dados.
Esse preenchimento acontece antes da validação do CNPJ, permitindo que a remoção dos zeros à esquerda não impeça uma consulta válida. Depois de completar os 14 dígitos, o valor resultante passa normalmente pelas regras de validação da API.
Cuidado com o tipo de documento enviadoA API de Empresas não identifica se o valor originalmente informado pertence a outro tipo de documento, como um CPF.
Se um documento diferente de CNPJ for enviado por engano e, após o preenchimento com zeros à esquerda, o valor resultante atender às regras de validação de CNPJ, a consulta poderá ser processada normalmente.
Por isso, confira o tipo e o valor do documento antes de realizar a consulta. Consultas processadas dessa forma podem ser contabilizadas normalmente para fins de consumo e cobrança.
Como funciona?
Se o CNPJ enviado tiver menos de 14 dígitos, a API completa o valor com zeros à esquerda até atingir os 14 dígitos esperados.
Depois do preenchimento, o CNPJ resultante passa normalmente pelas regras de validação.
Se o valor resultante for um CNPJ válido, ele será considerado na consulta.
Se o valor resultante não atender às regras de validação de CNPJ, a API retorna o erro de validação correspondente.
Exemplo:
3456000105
00003456000105
Nesse caso, a API identifica que o valor enviado possui menos de 14 dígitos, adiciona os quatro zeros necessários à esquerda e utiliza o CNPJ resultante para realizar a validação e, se válido, a consulta.
Boa práticaSempre que possível, envie o CNPJ completo, com 14 dígitos, incluindo os zeros à esquerda.
Isso evita alterações no valor enviado e ajuda a garantir que a consulta seja realizada exatamente com o documento esperado.
Updated 19 days ago