Wortic

Wortic CEP / Guias

CEP e CNPJ juntos: conferir o endereço de uma empresa

A ficha da empresa traz o CEP que ela declarou à Receita. Com a API de CEP, você confere esse endereço na base dos Correios em uma consulta.

Publicado em .

Fontes oficiais: o CEP nos Correios e os códigos de município do IBGE.

As duas APIs são da Wortic e falam a mesma língua: o mesmo jeito de chamar, o mesmo formato de erro e o mesmo código IBGE da cidade.

O código

export async function conferirEnderecoDaEmpresa(cnpj) {
  const f = await (await fetch(`https://cnpj.wortic.com/cnpj/${cnpj}`)).json();
  const e = await (await fetch(`https://cep.wortic.com/cep/${f.endereco.cep}`)).json();
  return {
    empresa: f.razao_social, cep: e.cep_formatado,
    mesma_cidade: e.cidade_ibge === f.endereco.cidade_ibge,
    rua_receita: [f.endereco.tipo_logradouro, f.endereco.logradouro].join(" "), rua_correios: e.logradouro,
  };
}

console.log(await conferirEnderecoDaEmpresa("37853407000171"));

O que volta

{
  empresa: "WORTIC LTDA",
  cep: "04717-914",
  mesma_cidade: true,
  rua_receita: "RUA ALEXANDRE DUMAS",
  rua_correios: "Rua Alexandre Dumas"
}

Repare na escrita: a Receita guarda o endereço em maiúsculas e sem acento, e os Correios com maiúsculas e minúsculas e acento. Para comparar ruas, tire os acentos e passe tudo para maiúsculas antes. Para a cidade, o código IBGE já resolve.

A ficha completa da empresa e os guias da API de CNPJ estão em cnpj.wortic.com/guias.

Perguntas e respostas

Por que conferir o CEP da ficha do CNPJ?

O endereço da ficha é o que a empresa declarou à Receita. A base dos Correios diz a que rua e cidade aquele CEP pertence; se não baterem, vale confirmar com o cliente antes de mandar mercadoria.

Como saber se a cidade bate?

Compare o campo cidade_ibge das duas respostas: a ficha do CNPJ e a resposta do CEP trazem o mesmo código do IBGE.

As duas APIs têm o mesmo limite?

Sim. Cada uma permite 60 consultas por minuto por IP, sem chave, e cada uma conta separado.

Todos os guias · Documentação com exemplos em 10 linguagens · openapi.json · Versão para IA