Logradouro do local de entrega na NF-e: o campo entrega/xLgr

entrega/xLgr informa o logradouro do endereço em que a mercadoria será entregue. O campo G03 aparece uma vez e é obrigatório quando entrega existe, com texto de 2 a 60 caracteres. O grupo registra endereço diferente do endereço do destinatário; a rua ou outra identificação de logradouro deve corresponder a esse local real. MOC, Grupo G, página 16.

A origem é o endereço de entrega, não um texto livre sobre a operação

Use a identificação documentada no pedido ou cadastro de entrega. Confira sua associação a número, complemento, bairro, município e UF. Um sistema pode selecionar corretamente o recebedor e continuar enviando a rua da sede se o mapeamento usa o endereço fiscal do cliente; nesse caso, o dado de origem precisa ser separado pelo papel do endereço.

xLgr não é o endereço completo. nro contém o número ou identificação correspondente; xCpl complementa o local; xBairro informa o bairro. O telefone e o nome do recebedor também têm campos próprios. Colocar tudo na rua não dispensa os filhos obrigatórios e pode exceder o limite textual.

Os homônimos em dest/enderDest/xLgr, emit/enderEmit/xLgr e retirada/xLgr apontam para outros endereços. Para conferir entrega, use o caminho completo, não a primeira tag xLgr que uma busca retornar.

Exemplo: manter as partes separadas

Fragmento sintético de um endereço fictício, parcial em relação a entrega e à NF-e; não está pronto para transmissão:

<xLgr>Avenida de Exemplo</xLgr>
<nro>600</nro>
<xCpl>Galpao 2</xCpl>
<xBairro>Bairro de Exemplo</xBairro>

Os elementos pertencem ao namespace http://www.portalfiscal.inf.br/nfe. O logradouro é Avenida de Exemplo, o número é 600 e a subdivisão é Galpao 2. O XPath de xLgr é /nfeProc/NFe/infNFe/entrega/xLgr. Na sequência TLocal, ele vem após a alternativa CNPJ/CPF e após xNome se o nome estiver presente, antes de nro. Schema oficial de referência, TLocal.

Formato, acentuação e espaços

O campo deriva de TString, tem mínimo de dois e máximo de 60 caracteres e não aceita espaços nas extremidades. Uma tag vazia ou contendo só espaços não atende ao contrato. Letras, números e caracteres permitidos pelo tipo podem compor a identificação; o campo não exige uma rua numérica. Schemas oficiais, TLocal/xLgr e TString.

O XML da NF-e usa UTF-8. Acentos do nome verdadeiro não precisam ser retirados para converter o endereço em outra grafia. Se aparecem caracteres trocados na prévia, confira a codificação do cadastro, integração e serialização. Caracteres reservados do XML devem ser escapados pelo gerador: por exemplo, um & literal no texto é representado por &. Isso é tratamento sintático, não mudança do nome do logradouro. MOC Visão Geral, seções 4.2.1 e 4.2.1.5.

Não confunda a quantidade de caracteres do valor com o número de bytes UTF-8 ou com o tamanho da entidade & no arquivo. A validação textual considera o conteúdo interpretado. Se o logradouro exceder 60 caracteres, confira uma representação documental correta e a separação dos demais componentes; não corte sem verificar se o resultado ainda identifica o local.

Endereço incompleto ou fora do padrão urbano

Se o local usa uma identificação documental que não é uma rua convencional, confirme a descrição aplicável ao endereço na origem. O leiaute chama o campo de logradouro, mas não cria um nome universal para estrada, área rural ou endereço desconhecido. Não preencha uma rua fictícia só para satisfazer o mínimo.

No contexto exterior, as indicações 9999999, EXTERIOR e EX pertencem a cMun, xMun e UF, respectivamente. Elas não autorizam usar EXTERIOR como logradouro nem omitir xLgr no grupo. Não transfira para entrega uma dispensa de endereço que pertence especificamente a outro XPath. MOC, Grupo G.

Como localizar e corrigir a causa

Para falha de schema, examine ausência, vazio, tamanho, caracteres, espaços nas extremidades, ordem e namespace. Para rua errada, compare o pedido, a seleção do endereço e o valor enviado no campo. Procure cópia da sede, cadastro antigo, concatenação de endereço inteiro ou truncamento.

Corrija o cadastro ou transformação comprovadamente equivocada e gere uma prévia pelo emissor. Compare novamente logradouro, número e demais dados do endereço. Não edite XML assinado ou autorizado e não use localização fictícia. O logradouro não determina CFOP, incidência ou alíquota: eventual dúvida sobre o papel dos locais na operação exige os documentos reais e análise contábil específica.

Veja o número do endereço de entrega e o bairro de entrega.