xMun da retirada na NF-e: nome do município e uso de EXTERIOR

retirada/xMun contém o nome do município do local de retirada, com texto de 2 a 60 caracteres. É obrigatório quando o grupo existe. Não substitui o código IBGE cMun: código, nome e UF precisam representar o mesmo local. Para o cenário exterior, o MOC orienta usar EXTERIOR. MOC 7.0, F07–F09, pp. 15–16.

Como obter o nome sem misturar endereços

O município vem do endereço de origem física associado ao expedidor. O cadastro pode guardar uma descrição e um código oficial; ambos precisam ter o mesmo significado. Selecionar pelo código IBGE e obter o nome da mesma tabela é uma forma de evitar que uma string antiga de outra cidade permaneça junto de um código atualizado.

Confira qual local da operação está sendo usado. Município do comprador pertence ao contexto do destinatário; município de entrega descreve o destino físico. Mesmo que os três coincidam numa nota, não são fontes intercambiáveis para todas as operações.

O grupo retirada é indicado pelo MOC quando o endereço difere do remetente. Obrigatoriedade de xMun no grupo não cria obrigação de um grupo em toda nota. Na NFC-e e na NF-e com DANFE Simplificado Tipo 2 (tpImp=6), F01-10/669 da NT 2026.002 v1.10a restringe a presença de retirada. A linha dessa regra prevê teste 01/07/2026 e produção 03/08/2026; confira também ambiente e autorizador ao diagnosticar uma nota.

Nome legível e código IBGE cumprem funções diferentes

xMun é descrição textual. cMun tem sete dígitos da tabela IBGE. UF tem duas posições do domínio de siglas. Não escreva um código de sete dígitos em xMun para substituir uma descrição ausente, nem use o nome do bairro como município.

O código existente e o prefixo coerente com a UF não provam que o texto gerado seja o nome correto. Uma integração pode manter cMun=4106902 e produzir o nome de outra cidade por erro de cache, associação ou cópia de endereço. Essa combinação pode passar por algumas checagens de código e continuar incorreta como cadastro.

A API de Localidades do IBGE informa que 4106902 é Curitiba, no Paraná. Esse par código/nome é uma referência verificável; não se deve completar o nome por adivinhação a partir dos sete dígitos ou de um ID do sistema.

Exemplo brasileiro e representação exterior

Fragmento sintético e parcial de comparação entre código, descrição e UF. Os outros campos da retirada foram omitidos; não é nota pronta para transmissão:

<retirada xmlns="http://www.portalfiscal.inf.br/nfe">
  <!-- Identificação e demais campos de endereço foram omitidos. -->
  <cMun>4106902</cMun>
  <xMun>Curitiba</xMun>
  <UF>PR</UF>
</retirada>

O trecho corresponde ao município confirmado pelo IBGE, sem afirmar local de retirada real. xMun mostra o nome, enquanto cMun permite conferir a referência oficial.

Quando o local é efetivamente exterior, o MOC prevê outro conjunto:

<retirada xmlns="http://www.portalfiscal.inf.br/nfe">
  <!-- Fragmento sintético e parcial de localização exterior. -->
  <cMun>9999999</cMun>
  <xMun>EXTERIOR</xMun>
  <UF>EX</UF>
</retirada>

Nessa representação, não se troca EXTERIOR pelo nome de uma cidade estrangeira por uma regra genérica de cadastro. O país tem campos próprios. Tampouco se usa esse marcador numa retirada brasileira apenas porque o comprador é estrangeiro: a informação continua descrevendo a origem física.

Onde localizar xMun e conferir seu formato

O XPath é /nfeProc/NFe/infNFe/retirada/xMun. O campo vem depois de cMun e antes de UF. Use o namespace da NF-e nas consultas; a descrição em dest/enderDest/xMun ou entrega/xMun pertence a outro endereço.

No pacote anterior 010c v1.30, o tipo é TString com mínimo 2 e máximo 60. Texto vazio, um caractere ou espaços como único conteúdo não satisfazem a estrutura. Não corte nome longo silenciosamente nem elimine acentuação por supor uma exigência universal: confirme a forma oficial e o padrão lexical do pacote aplicado.

Se o sistema obtém nome e código automaticamente de um cadastro, não é necessário transformar essa informação numa obrigação de digitar a cidade novamente. O objetivo técnico é conservar o vínculo correto e mostrar o resultado para conferência.

Como diagnosticar nome incorreto e rejeições de município

Compare nome, código e UF do cadastro do local com a prévia XML. Se o código está correto e a descrição não, investigue associação com a tabela, cache ou origem da string. Se todos os campos vêm do endereço do cliente, investigue a seleção do local e o mapeamento entre participantes. Se a cidade está errada na própria origem, confirme o endereço documentado do expedidor antes de corrigir.

Nos modelos 55/65, as rejeições da retirada 513/F07-10, 276/F07-20 e 277/F07-30 verificam, respectivamente: com UF=EX, cMun diferente de 9999999; com UF diferente de EX, código inexistente na tabela IBGE; e, também com UF diferente de EX, prefixo municipal incompatível com a UF. Elas não devem ser descritas como uma comparação literal universal de xMun com a tabela. O MOC, p.87 identifica essas condições em cMun e UF. A falha textual de xMun pode ser um problema de estrutura ou um erro cadastral diferente.

Confira uma nova prévia depois de corrigir a causa comprovada, mantendo código e descrição coerentes. Não troque o município para contornar uma regra, não edite XML assinado nem retransmita por tentativa. A cidade de origem não determina por si o tratamento tributário da operação. Código municipal da retirada e UF da retirada aprofundam as validações relacionadas.