Preencher um cadastro pelo CNPJ
A pessoa digita o CNPJ e o formulário se preenche sozinho: razão social, endereço, telefone e e-mail públicos, com o código IBGE da cidade.
Publicado em .
Fontes oficiais: o CNPJ na Receita Federal e os dados abertos do CNPJ.
Cadastro de cliente ou de fornecedor costuma começar pelo CNPJ. Com uma consulta, o resto do formulário vem pronto, igual ao que está na Receita.
Da ficha para o formulário
export function camposDoCadastro(f) {
const e = f.endereco || {};
return {
razao_social: f.razao_social,
nome_fantasia: f.nome_fantasia || f.razao_social,
logradouro: [e.tipo_logradouro, e.logradouro].filter(Boolean).join(" "),
numero: e.numero, complemento: (e.complemento || "").replace(/\s+/g, " ").trim(),
bairro: e.bairro, cep: e.cep, cidade: e.cidade, uf: e.uf, cidade_ibge: e.cidade_ibge,
telefone: f.telefone, email: f.email,
};
}
No formulário
const campo = document.querySelector("#cnpj");
campo.addEventListener("change", async () => {
if (!cnpjValido(campo.value)) return; // guia "Validar o CNPJ"
const r = await fetch(`https://cnpj.wortic.com/cnpj/${limparCnpj(campo.value)}`);
if (r.status !== 200) return; // 404: deixe a pessoa digitar à mão
const dados = camposDoCadastro(await r.json());
for (const [nome, valor] of Object.entries(dados)) {
const entrada = document.querySelector(`[name="${nome}"]`);
if (entrada && !entrada.value) entrada.value = valor ?? ""; // não apaga o que a pessoa já digitou
}
});
O que sai para o CNPJ 37.853.407/0001-71
{
"razao_social": "WORTIC LTDA",
"nome_fantasia": "WORTIC LTDA",
"logradouro": "RUA ALEXANDRE DUMAS",
"numero": "1562",
"complemento": "ANDAR 6 CONJ 63",
"bairro": "CHACARA SANTO ANTONIO (ZONA SUL)",
"cep": "04717914",
"cidade": "SAO PAULO",
"uf": "SP",
"cidade_ibge": 3550308,
"telefone": "(11) 91568557",
"email": "E-MAIL DECLARADO"
}
Repare no complemento: a Receita guarda espaços de sobra, e a função junta tudo num espaço só. Repare também no e-mail (trocado aqui por E-MAIL DECLARADO): é o que a empresa declarou à Receita, e muitas vezes é o do escritório que cuida do registro. Por isso o formulário deixa a pessoa corrigir.
O código IBGE da cidade (cidade_ibge) é o que a nota fiscal pede. Guarde junto.
Perguntas e respostas
Quais campos do cadastro a API preenche?
Razão social, nome fantasia, endereço completo com CEP, cidade, estado e código IBGE do município, e o telefone e o e-mail públicos que a empresa declarou à Receita.
O e-mail e o telefone da ficha são do contato da empresa?
São os que a empresa declarou à Receita. Muitas vezes são do contador. Deixe o campo editável e peça confirmação.
Quando chamar a API no formulário?
Quando o CNPJ estiver completo e passar na validação dos dígitos, uma vez só. Não chame a cada tecla.
Todos os guias · Documentação com exemplos em 10 linguagens · openapi.json · Versão para IA