Erro E0238: O código do município do endereço do tomador não existe na tabela do IBGE

O Erro E0238 acontece quando o código do município do endereço do tomador não existe na tabela oficial do IBGE.

Abrir NFS-e

Por que acontece o Erro E0238

Na nota, município não é texto: é um código numérico de 7 dígitos definido pelo IBGE. É ele que distingue cidades homônimas — e existem muitas com o mesmo nome em estados diferentes.

As causas mais comuns:

Código digitado errado. É a causa principal.

CEP usado no lugar do código, por serem os dois numéricos.

Código com 6 dígitos, sem o verificador que completa os 7.

Cadastro antigo importado, com códigos de uma tabela desatualizada.

Cidade recém-criada ou incorporada, com código alterado.

Como resolver o Erro E0238

1. 1
   Confira o código do município no endereço do tomador.
2. 2
   Consulte a tabela do IBGE para confirmar o código da cidade.
3. 3
   Reenvie.

Como evitar o Erro E0238

Selecione a cidade por lista no cadastro, em vez de digitar o código. Melhor ainda: use a busca por CEP, que traz cidade e código corretos juntos — e evita de quebra o erro do par CEP/município, que é o mais frequente da NFS-e.

Código de município é uma das poucas coisas na nota que não dá para conferir a olho: sete dígitos sem significado aparente, em que um número trocado aponta para outra cidade sem parecer errado.

Se o Erro E0238 continuar

Erros vizinhos do endereço do tomador: CEP que não pertence ao município e endereço obrigatório conforme a operação, o CNPJ ou a retenção.

Erro irmão: o mesmo código inexistente no endereço do prestador.

Persistindo, abra um chamado informando o código usado e a cidade pretendida.

Referência: Anexo I do leiaute da DPS e da NFS-e (SEFIN/ADN), Sistema Nacional NFS-e.