xPais da retirada na NF-e: nome do país e relação com cPais

retirada/xPais contém o nome do país do local de retirada, em texto de 2 a 60 caracteres. É opcional dentro do grupo. Sua função é descrever a localização da origem física da mercadoria, complementando cPais quando o código é informado. Não substitui o código BACEN nem o nome do município. MOC 7.0, F11–F12, p. 16.

O nome descreve o país da origem física

O dado deve vir do cadastro do local relacionado à retirada da operação. O país do comprador, da entrega e da retirada pode ser diferente. Se a mercadoria sai de um endereço brasileiro para destinatário no exterior, o país estrangeiro do comprador não se torna automaticamente o nome do país da retirada.

Quando o cadastro guarda uma seleção de país com código e descrição, confirme que os dois vêm da mesma referência. O gerador não deve conservar uma descrição antiga depois de trocar o código, nem obter cada um de um participante diferente.

O grupo retirada é indicado quando seu endereço difere do remetente. O campo opcional de país não exige criar esse grupo numa operação que não o utiliza. Na NFC-e ou NF-e com DANFE Simplificado Tipo 2 (tpImp=6), F01-10/669 da NT 2026.002 v1.10a restringe a presença do grupo inteiro. A linha de cronograma tem teste 01/07/2026 e produção 03/08/2026; confira modelo, ambiente e autorizador na análise concreta.

Nome do país, código BACEN e EXTERIOR são diferentes

xPais é uma descrição, como Brasil. cPais é o código do domínio de países usado pela NF-e. No exemplo da tabela 8-3 do MOC 7, Visão Geral, p.131, Brasil corresponde a 1058. A mesma grafia de país em outro cadastro não garante que aquele sistema use o mesmo código.

EXTERIOR é o marcador de nome do município em xMun no contexto de localização exterior, junto de cMun=9999999 e UF=EX. Não é um país que se deva copiar para xPais como descrição universal. O nome do país, quando informado, precisa indicar o país correspondente ao local.

Uma sigla ISO ou DDI telefônico também não é o nome do país. O formato textual pode aceitar uma string curta sem conferir seu significado; isso não torna qualquer código uma descrição adequada. A origem cadastral e o domínio são necessários para interpretar o valor.

Formato e ausência do campo

O TLocal/xPais do pacote anterior 010c v1.30 é TString, com ocorrência 0–1 e mínimo 2/máximo 60. A ausência de nome confirmado não deve ser representada por tag vazia ou descrição fictícia. Na geração, o opcional sem conteúdo é omitido; valores existentes precisam ser preservados até sua revisão.

Código e nome possuem ocorrências opcionais próprias no XSD. Isso não prova que qualquer combinação dos dois seja correta para uma operação real. Se apenas o nome está disponível no cadastro, não se deve calcular um código por adivinhação; faça a associação à tabela oficial antes de gerar cPais. Se há código e descrição, confira o vínculo entre eles.

O limite de texto não justifica cortar o nome e tornar o país ambíguo. Confirme uma descrição compatível com a referência oficial e a versão pertinente. A Visão Geral do MOC também orienta considerar a data de emissão na validade do país; isso importa ao conferir documentos históricos ou mudanças de tabela.

Exemplo parcial: código e descrição do mesmo país

O fragmento é sintético e parcial, limitado ao par de país. Os demais campos obrigatórios da retirada foram omitidos; não representa uma operação ou nota pronta para transmissão:

<retirada xmlns="http://www.portalfiscal.inf.br/nfe">
  <!-- Identificação e endereço foram omitidos. -->
  <cPais>1058</cPais>
  <xPais>Brasil</xPais>
</retirada>

O exemplo reproduz o par do MOC para explicar a função do código e da descrição, sem afirmar um expedidor real. O nome correto não certifica o endereço, a inscrição nem a autorização fiscal.

O XPath é /nfeProc/NFe/infNFe/retirada/xPais. O campo fica depois de cPais e antes de fone, quando esses opcionais existem. Use o namespace da NF-e em consultas; dest/enderDest/xPais, emit/enderEmit/xPais e entrega/xPais têm outros endereços como origem.

Como diagnosticar nome de país divergente e rejeição 970

Compare o local selecionado, código e descrição no cadastro e na prévia XML. Se a descrição pertence ao país do cliente, mas o local de origem é outro, investigue cópia entre participantes. Se o código mudou e o nome não, confira tabela, cache e mapeamento. Se os dois estão errados na origem, confirme a localização verdadeira antes de corrigir.

A rejeição 970/F11-10, no MOC, p.87, verifica o código do país informado na retirada para NF-e modelo 55, por inexistência na tabela BACEN. Não é uma regra de comparação literal universal do nome em xPais. A mesma mensagem pode ser da entrega por G11-10, portanto localize ambos os grupos quando necessário. Trocar somente a descrição não resolve um código inexistente.

Para falha de estrutura do nome, confira comprimento, vazio, espaços nas extremidades, sequência e namespace. Depois de corrigir a causa comprovada, confira uma nova prévia e o vínculo código/descrição/local. Não invente país, não transforme a origem em exterior por conveniência, não edite XML assinado nem retransmita por tentativa.

O tratamento fiscal de uma operação internacional precisa dos documentos e participantes reais; este campo apenas registra parte da localização. Para aprofundar, veja código do país da retirada e nome do município da retirada.