Wortic

Wortic CEP / Guias

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