Bairro do local de entrega na NF-e: preenchimento de entrega/xBairro

entrega/xBairro informa o bairro do endereço em que a mercadoria será entregue. O campo G06 é obrigatório dentro de entrega, aparece uma vez e aceita texto de 2 a 60 caracteres. O grupo representa local diferente do endereço do destinatário; seu bairro deve pertencer a esse local efetivo. MOC, Grupo G, página 16.

Bairro não é município nem complemento

Confira a descrição do bairro no cadastro ou documento do endereço de entrega e compare com logradouro, número, município, UF e CEP, quando houver. Não copie o bairro do endereço fiscal do comprador se a mercadoria será entregue em outro ponto.

xBairro é a parte do endereço que identifica o bairro; xMun contém o município; cMun codifica esse município pela tabela IBGE; xCpl contém informação complementar, como bloco ou unidade. Um setor interno de um galpão não se torna bairro porque o cadastro o armazenou na coluna errada.

Também existem dest/enderDest/xBairro, emit/enderEmit/xBairro e retirada/xBairro. Eles se referem a outros endereços. Buscar só a primeira tag xBairro do XML pode retornar o bairro do emitente e produzir uma conferência equivocada.

Como representar e localizar no XML

O campo deriva de TString, com mínimo de dois e máximo de 60 caracteres, sem espaços nas extremidades. Espaços dentro do nome podem fazer parte do texto; preencher apenas dois espaços não cria um bairro válido. O limite é de caracteres do conteúdo, não de palavras. Schemas oficiais, TLocal/xBairro e TString.

Fragmento sintético e parcial em relação ao grupo e à nota, com nomes fictícios; não está pronto para transmissão:

<xLgr>Rua de Exemplo</xLgr>
<nro>120</nro>
<xCpl>Galpao B</xCpl>
<xBairro>Vila de Exemplo</xBairro>

Esses elementos pertencem a entrega, no namespace http://www.portalfiscal.inf.br/nfe. Vila de Exemplo é o bairro; Galpao B é a subdivisão complementar. O XPath é /nfeProc/NFe/infNFe/entrega/xBairro. Na sequência do grupo, xBairro aparece após xCpl quando esse opcional existe, ou após nro quando não existe, e antes de cMun.

O fragmento mostra por que mover todo o endereço para o bairro não é solução: os campos têm funções e requisitos separados. A presença de xBairro não dispensa xLgr, nro, cMun, xMun ou UF.

Dado ausente, área rural e exterior

O mínimo textual não autoriza inventar Centro, Zona Rural ou outra expressão para um bairro desconhecido. Se a área de entrega não possui bairro nos documentos disponíveis, confirme a identificação cadastral aplicável ao local antes de representar a informação. Uma expressão pode descrever uma área real, mas não é literal universal exigido pelo campo.

O MOC prevê valores específicos de exterior em cMun, xMun e UF; isso não cria automaticamente o literal EXTERIOR para xBairro nem elimina o filho obrigatório deste grupo. Não transporte uma exceção de dest/enderDest para entrega/xBairro apenas por ambos serem endereços. MOC, Grupo G.

Se a informação necessária falta, o próximo passo é obter o dado ou a representação comprovada do endereço na origem, em vez de produzir uma nota com campo fictício. Se o bairro tem mais de 60 caracteres no cadastro, confira sua forma correta de representação; truncar sem conferência pode retirar a parte que distingue o local.

Diagnóstico: conteúdo, origem ou município?

Para erro estrutural, verifique omissão, vazio, conteúdo abaixo de dois ou acima de 60 caracteres, espaços nas extremidades, sequência e namespace. Para bairro divergente, compare o pedido, o endereço selecionado e a prévia, procurando valor antigo ou cópia do bairro da sede.

As rejeições G07-20/278 e G07-30/279 tratam de código do município e de sua relação com a UF. Alterar xBairro não resolve essas condições. Corrija o campo e a origem que o retorno e os documentos efetivamente indicarem. MOC, página 88.

Após a correção comprovada no cadastro ou mapeamento, gere uma prévia pelo emissor e confira o endereço inteiro. Não edite XML assinado ou autorizado e não use bairro fictício para completar o mínimo. O bairro não define classificação tributária, CFOP ou alíquota.

O logradouro de entrega e o município de entrega ajudam a conferir as outras partes do endereço.