xBairro do emitente na NF-e: bairro obrigatório, tamanho e diagnóstico

xBairro, em emit/enderEmit/xBairro, informa o bairro do endereço do emitente. É obrigatório e admite de 2 a 60 caracteres. O dado deve representar o bairro cadastral do estabelecimento identificado na nota, não o bairro do destinatário nem um texto genérico escolhido para preencher uma lacuna. MOC 7.0, C09, p. 13.

O XPath completo é /nfeProc/NFe/infNFe/emit/enderEmit/xBairro, no namespace http://www.portalfiscal.inf.br/nfe. O elemento aparece depois de nro e do complemento opcional, antes de cMun.

O que o tipo textual verifica

O campo usa TString, limitado a 2–60 caracteres. A restrição não aceita espaço inicial ou final nem string composta apenas de espaço. Espaços internos entre palavras, quando admitidos pelo tipo, fazem parte do texto. Não preencha dois espaços para tentar alcançar o mínimo nem acrescente caracteres fictícios a um nome incompleto. Schema PL010d v1.03, TEnderEmi/xBairro e TString.

O mínimo de dois caracteres e o máximo de sessenta são critérios de formato, não uma lista oficial de bairros. Um texto que passa nesse intervalo pode representar bairro errado, município diferente ou endereço de outro estabelecimento. O schema não demonstra vínculo cadastral com o CNPJ/CPF.

O emissor deve obter o bairro do cadastro e do endereço comprovados. Se o local usa uma forma cadastral específica de identificação e o campo está ausente, confirme essa forma na origem; não estabeleça automaticamente “Centro”, “Zona Rural” ou outro bairro como substituto de informação desconhecida.

Bairro não substitui complemento ou município

xCpl representa informações complementares do endereço e é opcional. xBairro representa bairro e é obrigatório. xMun e cMun representam nome e código do município. Um bairro denominado como uma cidade não permite trocar essas funções; cada informação deve ser obtida no contexto real do endereço.

Se uma integração usa o CEP para preencher bairro, compare o resultado com o comprovante do estabelecimento. O preenchimento automático pode facilitar o cadastro, mas sua origem e atualização precisam ser conferidas quando há divergência. Não copie o bairro da entrega para o endereço do emitente.

Fragmento XML comentado

Exemplo parcial e sintético, não pronto para transmissão. Bairro e demais dados não representam endereço real.

<enderEmit xmlns="http://www.portalfiscal.inf.br/nfe">
  <xLgr>RUA SINTETICA</xLgr>
  <nro>200</nro>
  <xBairro>BAIRRO SINTETICO</xBairro>
  <cMun>5208707</cMun>
  <xMun>Goiânia</xMun>
  <UF>GO</UF>
  <CEP>74000000</CEP>
</enderEmit>

O bairro ilustrativo está no campo próprio. A combinação município/UF mostra Goiânia/GO, confirmada pelo IBGE; não comprova a existência do bairro ou a correspondência do CEP. O fragmento é parcial em relação à nota inteira, mesmo exibindo os campos básicos do endereço.

Como investigar ausência, tamanho e informação errada

Compare o bairro cadastrado com o XML da tentativa. Se a tag estiver ausente ou vazia, verifique cadastro incompleto ou perda no mapeamento. Se houver apenas um caractere, confirme se ocorreu truncamento ou importação incompleta. Se o texto ultrapassar 60, investigue se logradouro, complemento ou município foram concatenados ao bairro; não corte caracteres apenas para fazer a validação passar.

Se houver espaço inicial ou final, confira a origem e a serialização mantendo o nome verdadeiro. Se o texto estiver dentro do tamanho, mas pertencer a outra pessoa ou local, investigue a seleção do cadastro do emitente e a associação com o estabelecimento.

Após a correção comprovada e autorizada na origem ou no mapeamento, confira bairro, município, UF, CEP e identidade do emitente no XML gerado. Preserve o retorno original, sem editar arquivo assinado ou usar texto fictício para tentar autorização. O campo de bairro não determina incidência, benefício ou classificação fiscal; essas decisões precisam dos documentos e da localização real da operação.