xBairro do destinatário na NF-e: bairro, formato e origem do endereço

dest/enderDest/xBairro informa o bairro do endereço do destinatário. É um componente textual obrigatório quando enderDest existe e aceita de 2 a 60 caracteres. Seu conteúdo deve vir do endereço confirmado, e não de uma escolha padrão do emissor.

O caminho completo é /nfeProc/NFe/infNFe/dest/enderDest/xBairro, no namespace http://www.portalfiscal.inf.br/nfe. A posição identifica a quem pertence o endereço. MOC 7.0, E09, p. 14.

Bairro, município e outros endereços

O bairro descreve uma subdivisão ou identificação local do endereço. xMun registra o nome do município, e cMun seu código IBGE. Um bairro não recebe o código do município nesse campo. Também não se deve repetir automaticamente o nome da cidade em xBairro quando o bairro está desconhecido.

Distrito, localidade, área rural e bairro podem aparecer em cadastros com classificações diferentes. O leiaute não converte esses conceitos nem determina qual identificação local se aplica a um imóvel concreto. Confira como o endereço é identificado na documentação e na base cadastral utilizada. Não deduza o bairro apenas pelo nome da cidade ou pelo número do imóvel.

Compare os caminhos: emit/enderEmit/xBairro descreve o endereço do emitente; dest/enderDest/xBairro descreve o do destinatário; entrega/xBairro e retirada/xBairro pertencem aos locais específicos da operação. A mercadoria pode ser entregue em outro bairro. Isso não faz do endereço de entrega o endereço cadastral do destinatário.

Formato e presença no XML

Dentro do grupo, xBairro tem uma ocorrência, com nome e capitalização exatos. A sequência o posiciona depois de xCpl, quando o complemento existe, e antes de cMun. O tipo textual permite nomes com letras acentuadas, respeitando o conjunto de caracteres do schema. Espaços entre palavras são diferentes de espaços nas extremidades; um valor formado somente por espaços não atende ao campo.

O limite de 2 a 60 caracteres trata o texto informado, não a comprovação do bairro. Um nome inventado com dez caracteres pode passar pelo formato e continuar cadastralmente errado. Não transforme a validação estrutural numa certificação do endereço.

A obrigatoriedade do filho deve ser lida no contexto do grupo. Na NF-e modelo 55, a regra E05-10 exige endereço do destinatário; na NFC-e modelo 65 com entrega a domicílio, E05-20 também o exige. Outras condições para identificação e endereço dependem da operação e das regras vigentes. Quando o endereço é enviado, seu bairro não pode simplesmente ser omitido por a interface chamar o grupo de “opcional”. MOC, E05-10/20, p. 83.

Quando a identificação está ausente

Um campo vazio no sistema pode significar dado ainda não cadastrado, falha de importação ou endereço cuja identificação local precisa ser esclarecida. Antes de preencher, confronte o cadastro com a documentação do endereço e com o destinatário. Em endereço rural ou localidade com nomenclatura própria, confirme a identificação efetiva em vez de impor a divisão urbana de outra cidade.

As fontes de leiaute consultadas não estabelecem Centro, Zona Rural ou qualquer outro texto como bairro padrão universal. Esses valores só descrevem o endereço quando forem verdadeiros naquele caso. O fato de serem aceitos como texto não autoriza usá-los para contornar a falta de informação.

Se o dado necessário ainda não foi comprovado, a pendência é cadastral. O responsável pela emissão deve esclarecer o endereço aplicável e sua identificação. Não complete com texto fictício nem remova todo o grupo para esconder a falta do bairro.

Exemplo parcial e diagnóstico

O fragmento abaixo é parcial e sintético. Ele assume componentes demonstrativos de um endereço, apenas para mostrar a separação:

<enderDest xmlns="http://www.portalfiscal.inf.br/nfe">
  <xLgr>Rua de Exemplo</xLgr>
  <nro>120A</nro>
  <xBairro>Jardim São João</xBairro>
</enderDest>

Jardim São João é o bairro assumido no exemplo; Rua de Exemplo é o logradouro e 120A o número textual. O trecho omite município e UF obrigatórios, entre outros dados do documento, e não está pronto para transmissão. Não comprova existência desse endereço.

Se houver falha de estrutura, leia o caminho indicado no retorno e confira presença, ordem, tamanho e espaços de xBairro no XML efetivamente gerado. Se houver divergência cadastral, confronte o valor com o endereço de origem. Nome de bairro no lugar de xMun, nome de município no lugar de xBairro e importação do bairro da entrega são problemas de mapeamento diferentes.

Confira ainda truncamento do texto e perda de acentuação na importação. Cortar um nome para 60 caracteres sem uma regra cadastral confirmada pode produzir outra identificação. Corrija a fonte comprovadamente errada e confira a geração pelo fluxo autorizado; não edite XML assinado nem retransmita para descobrir qual bairro será aceito. O bairro não determina CFOP ou tratamento tributário.

Campos relacionados

enderDest no contexto do destinatário, xLgr no contexto do destinatário, xMun no contexto do destinatário, cMun no contexto do destinatário.