Wortic

Wortic CNPJ / Guias

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