/
Código de Município Inválido (Erro IBGE)

Código de Município Inválido (Erro IBGE)

Contexto do Problema

Durante a emissão de uma Nota Fiscal de Venda (NF-e) no SAC Gerencial, foi apresentado o erro:

“Código de Município do destinatário inválido. Verifique e tente novamente.”

O erro ocorreu mesmo com o município preenchido corretamente no cadastro do cliente.
Após análise remota, identificou-se que o destinatário também possuía cadastro como Funcionário, e neste cadastro o campo “Código IBGE” estava vazio (0).

Causa Raiz

O sistema SAC Gerencial utiliza os dados do cadastro de funcionário como referência quando o mesmo CPF/CNPJ existe nas duas tabelas:

  • Cadastro de Clientes

  • Cadastro de Funcionários

Caso o código IBGE (código do município) não esteja preenchido em um dos cadastros, o sistema prioriza o cadastro mais recente — e, nesse caso, o código ausente impede a validação da NF.

Etapas para Resolução

1. Identificar o destinatário com erro

Durante a emissão da nota, verifique o nome do destinatário no campo “Nome/Razão Social”.

Exemplo:

MARILEUSA SOUSA DE CASTRO CPF: 626.549.663-70

Se o nome também aparecer no módulo de Cadastro de Funcionários, siga para o próximo passo.

2. Acessar o cadastro de funcionário

  1. No menu principal do SAC, acesse:

    Cadastros → Funcionários

  2. Localize o nome ou CPF do destinatário.

  3. Abra o registro correspondente.

3. Preencher o Código IBGE

Na tela Alteração de Funcionário, localize o campo:

Código IBGE / Município

Preencha com o código correto da cidade do funcionário, conforme tabela oficial do IBGE.

Exemplo:

  • Cidade: Araguaína (TO)

  • Código IBGE: 1702109

💡 Dica: Você pode confirmar o código no site oficial https://cidades.ibge.gov.br/.

4. Salvar o cadastro

Após inserir o código IBGE, clique em Salvar.
O registro deve ser atualizado com sucesso.

5. Reemitir a Nota Fiscal

  1. Retorne à tela Emissão de NF de Venda.

  2. Reabra a pré-venda do cliente.

  3. Verifique se o campo Município agora está preenchido corretamente com o código IBGE.

  4. Clique em Gerar NF.

O sistema deverá emitir a nota normalmente.

📸 Evidências do Processo

🔹 Antes da correção

Erro apresentado:

“Código de Município do destinatário inválido.”

Cadastro de funcionário:

Código IBGE = 0

🔹 Após a correção

Após preenchimento do código IBGE, a emissão foi concluída com sucesso.

Conclusão

  • O erro não é causado por falha no sistema, mas sim por inconsistência de dados entre cadastros duplicados (Cliente e Funcionário).

  • O preenchimento correto do campo Código IBGE em ambos os cadastros garante a emissão correta da nota.

Boas Práticas Preventivas

  1. Evite cadastros duplicados com o mesmo CPF/CNPJ em diferentes módulos.

  2. Sempre preencha o Código IBGE no momento do cadastro de clientes e funcionários.

  3. Utilize a base oficial do IBGE para códigos válidos.

  4. Realize auditorias mensais com a ferramenta Relatórios → Clientes sem Código IBGE (se disponível).

  5. Caso o erro persista, valide se há sincronização incorreta entre PDV e Guarda.

Resumo Técnico

Campo

Situação Antes

Situação Corrigida

Campo

Situação Antes

Situação Corrigida

Município

Exibia nome mas não validava

Exibe e valida com código IBGE

Código IBGE

0 (inválido)

1702109 (válido)

Resultado NF

Erro “Código de Município inválido”

Nota fiscal emitida com sucesso

FAQs — Código de Município Inválido (Erro IBGE)

1. O que significa o erro “Código de Município do destinatário inválido”?

Esse erro indica que o campo de código IBGE do município não está preenchido corretamente no cadastro associado ao cliente da nota fiscal.
Mesmo que o município apareça na tela, o sistema depende do código IBGE válido (número oficial de 7 dígitos) para autorizar a NF-e.

2. Por que o erro ocorre se o município está preenchido no cadastro do cliente?

Ocorre porque o cliente também possui cadastro como funcionário, e o sistema prioriza este registro.
Se o campo “Código IBGE” estiver vazio (geralmente aparece como “0”) no cadastro de funcionário, o SAC utiliza esse dado incorreto e bloqueia a emissão da nota.

3. Como corrigir o erro de código de município inválido?

  1. Acesse Cadastros → Funcionários.

  2. Busque o nome ou CPF do cliente.

  3. No campo “Código IBGE”, insira o código correto conforme a cidade.

    • Exemplo: Araguaína (TO) → 1702109

  4. Clique em Salvar e tente emitir a nota novamente.

4. Como encontrar o código IBGE correto do município?

Você pode consultar o código oficial no site do IBGE:
🔗 https://cidades.ibge.gov.br/
Pesquise o nome da cidade e use o número de 7 dígitos exibido na página — esse é o código que deve ser inserido no campo “Código IBGE”.

5. Como prevenir que esse erro volte a ocorrer?

  • Preencha sempre o código IBGE nos cadastros de clientes e funcionários.

  • Evite duplicar cadastros (mesmo CPF/CNPJ em mais de um módulo).

  • Oriente o time de cadastro a validar os dados de endereço completos.

  • Execute revisões periódicas: Relatórios → Clientes sem código IBGE.