O código IBGE da cidade para a nota fiscal
A nota fiscal pede o código IBGE do município. A API de CEP traz esse código junto com o endereço, sem uma tabela à parte no seu sistema.
Publicado em .
Fontes oficiais: o CEP nos Correios e os códigos de município do IBGE.
Na nota fiscal eletrônica o município vai pelo código do IBGE, não pelo nome. Pegar o código pelo CEP evita digitar o município à mão.
O campo na resposta
{ "cep": "01001000", "cidade": "São Paulo", "cidade_ibge": 3550308, "uf": "SP", ... }
O código
const r = await fetch("https://cep.wortic.com/cep/01001000");
const e = await r.json();
const destinatario = {
cep: e.cep, // a nota usa o CEP só com números
municipio: e.cidade,
codigo_municipio: e.cidade_ibge,
uf: e.uf,
};
console.log(destinatario);
// { cep: "01001000", municipio: "São Paulo", codigo_municipio: 3550308, uf: "SP" }
Repare que o campo cep vem só com números e o cep_formatado vem com traço. Use o primeiro na nota e o segundo na tela.
Perguntas e respostas
Qual campo traz o código IBGE?
O campo cidade_ibge, um número de 7 dígitos. Para São Paulo é 3550308.
Preciso manter uma tabela de municípios no meu sistema?
Não para o endereço do cliente: a consulta pelo CEP já devolve o código IBGE da cidade.
O código IBGE da API de CEP é o mesmo da API de CNPJ?
Sim. A ficha da empresa em cnpj.wortic.com traz o mesmo campo cidade_ibge no endereço, e os dois batem.
Todos os guias · Documentação com exemplos em 10 linguagens · openapi.json · Versão para IA