xBairro da retirada na NF-e: bairro do local e campo obrigatório

retirada/xBairro descreve o bairro do endereço do local de retirada. É um campo obrigatório dentro do grupo, com conteúdo textual de 2 a 60 caracteres. Não é um código IBGE, não é o município e não deve ser preenchido automaticamente com o bairro do cliente. MOC 7.0, F06, p. 15.

O bairro vem do endereço do expedidor

O dado deve ser obtido do cadastro ou da documentação do local de saída física. Quando um pedido identifica um depósito ou outra unidade de expedição, o bairro precisa pertencer a esse endereço. O fato de o destinatário ser da mesma cidade não torna o bairro dele adequado para a retirada.

Uma conferência útil é reunir logradouro, número, complemento, bairro, município e UF do mesmo local. Se cada parte foi copiada de um cadastro diferente, a string de bairro pode respeitar o comprimento e continuar apontando para uma localização incorreta.

retirada tem ocorrência 0–1 e o MOC orienta informá-lo somente em endereço diferente do remetente. Assim, ser obrigatório no grupo não torna o bairro de retirada um campo obrigatório 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 do grupo. A linha que inclui essa regra tem teste 01/07/2026 e produção 03/08/2026; a análise real precisa identificar também ambiente e autorizador.

Como tratar vazio, abreviação e local sem bairro cadastrado

O mínimo 2 impede que uma tag vazia ou um único caractere seja tratado como bairro suficiente na estrutura documentada. O pacote anterior 010c v1.30 usa TString, com máximo 60 e regras lexicais de texto que não aceitam espaços como todo o conteúdo.

Não use CENTRO apenas para preencher uma lacuna. Um local rural, rodoviário ou com outra forma de endereçamento não se torna central porque falta bairro no cadastro. Da mesma forma, SEM BAIRRO não é uma resposta universal que esta página possa prescrever. É necessário confirmar qual descrição territorial pertence ao endereço documentado e qual representação é aplicável ao caso.

Se o nome verdadeiro ultrapassa 60 caracteres, não corte automaticamente até caber sem conferir o significado. A integração pode precisar de uma representação cadastral compatível que ainda identifique o mesmo bairro. Abreviar um nome também não deve ser confundido com escolher outra localidade.

O campo não contém imposto nem código de classificação fiscal. A informação é obtida do endereço; sua ausência não deve ser convertida em número zero ou em uma decisão sobre a operação.

Exemplo parcial: bairro e município são informações distintas

Fragmento sintético e parcial, com bairro fictício e município real apenas como referência de localização. Identificação, logradouro e número foram omitidos, portanto não é XML completo para transmissão:

<retirada xmlns="http://www.portalfiscal.inf.br/nfe">
  <!-- Identificação e início do endereço foram omitidos. -->
  <xBairro>Bairro de Exemplo</xBairro>
  <cMun>4106902</cMun>
  <xMun>Curitiba</xMun>
  <UF>PR</UF>
</retirada>

O código 4106902 é identificado pelo IBGE como Curitiba/PR. O texto “Bairro de Exemplo” não afirma que haja um bairro cadastrado com esse nome em Curitiba. Ele serve para mostrar a função da tag. O código municipal não comprova o nome de bairro nem preenche essa informação por si.

Na sequência do grupo, xBairro vem depois de xCpl, quando houver complemento, e antes de cMun. O XPath é /nfeProc/NFe/infNFe/retirada/xBairro; use o namespace da NF-e em consultas. dest/enderDest/xBairro e entrega/xBairro descrevem outros endereços.

Como investigar bairro errado ou falha de schema

Compare primeiro o local da operação e o endereço cadastral. Se o bairro correto na origem não chegou ao XML, confira se houve cópia do cliente, seleção de outra unidade ou mapeamento incompleto. Se a prévia contém o endereço inteiro em xBairro, investigue a separação dos campos de logradouro e número.

Para falha estrutural, confira ausência da tag, string vazia, tamanho mínimo/máximo, espaços nas extremidades e sequência. Não presuma um código de rejeição exclusivo de bairro sem correspondência no retorno. Rejeições 276/277 da retirada verificam cMun e UF; um nome de bairro diferente não é, sozinho, a condição documentada dessas regras.

Se o cadastro de origem é que está incompleto, confirme o endereço com o expedidor e a documentação do local. A confirmação permite corrigir a origem sem criar uma localidade fictícia. Confira nova prévia depois do ajuste, preservando o conjunto do endereço. Não edite XML assinado nem retransmita por tentativa.

O logradouro da retirada e o município da retirada aprofundam as partes relacionadas. Documentar uma retirada em estabelecimento de terceiros pode exigir decisões fiscais específicas; o nome do bairro não determina essas escolhas.