xLgr do emitente: como conferir o logradouro no XML
<xLgr>emit › enderEmit › xLgrRevisão editorial em 27 de set. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
xLgr é o logradouro do endereço do emitente na NF-e e na NFC-e. Pode representar a rua, avenida ou outra denominação do logradouro que integra o endereço real do estabelecimento. Seu caminho é /nfeProc/NFe/infNFe/emit/enderEmit/xLgr. O campo C06 tem ocorrência obrigatória e única dentro de enderEmit, com texto de 2 a 60 caracteres. MOC 7.0, Grupo C, pp. 12–13.
De qual estabelecimento vem o logradouro?
O logradouro deve ser conferido no endereço da pessoa identificada em emit. Uma filial não recebe automaticamente o endereço da matriz, e o endereço do destinatário não se torna o endereço do emitente por ser o lugar de entrega da mercadoria. A relação entre o grupo de identificação e seu endereço está no leiaute: enderEmit é filho de emit. Em uma NF-e avulsa pelo Fisco, as informações do remetente continuam em emit; o grupo avulsa identifica o Fisco. MOC, C01–C06 e D01, pp. 12–13.
Confira o cadastro do estabelecimento e a origem usada pelo gerador do XML. Se a empresa mudou de endereço, a análise precisa distinguir o dado válido para o documento examinado do cadastro atualizado hoje. Não altere uma nota antiga assinada para fazê-la parecer emitida no endereço atual.
Logradouro não é o endereço inteiro
O leiaute separa xLgr, nro, xCpl, xBairro, cMun, xMun, UF e CEP. Assim, o número do imóvel, o complemento e o bairro não precisam ser fundidos em uma única linha de logradouro. xCpl é opcional; xLgr e nro têm elementos próprios obrigatórios. MOC, C05–C13, pp. 12–13.
Considere o endereço fictício “Avenida Exemplo, 500, Bloco B, Bairro Modelo”. O trecho abaixo é parcial e sintético: omite município, UF, CEP e outros elementos necessários. Não está pronto para transmissão.
<enderEmit xmlns="http://www.portalfiscal.inf.br/nfe">
<xLgr>Avenida Exemplo</xLgr>
<nro>500</nro>
<xCpl>Bloco B</xCpl>
<xBairro>Bairro Modelo</xBairro>
</enderEmit>
Avenida Exemplo é o conteúdo de xLgr. 500 permanece em nro; Bloco B fica em xCpl. Se o complemento não existir no endereço real, sua ausência não elimina nem torna opcional o logradouro.
O que o formato aceita e o que ele não comprova
No tipo TEnderEmi, xLgr deriva de TString, com mínimo de 2 e máximo de 60 caracteres. A restrição de texto não aceita espaço inicial ou final nem conteúdo apenas de espaços. A enumeração de um endereço verdadeiro não é feita pelo XSD: um texto pode respeitar o tamanho e ainda apontar para o local errado. Schemas oficiais 010d v1.03, TEnderEmi/xLgr e TString.
Por exemplo, uma integração que envia só R não atende ao mínimo de dois caracteres; uma que envia Rua Exemplo carrega um espaço final incompatível com TString. Um valor como Rua de Outra Filial pode satisfazer o formato e continuar materialmente incorreto. Esses três casos pedem conferências diferentes: conteúdo mínimo, serialização e seleção do cadastro, respectivamente.
Diagnóstico de ausência ou divergência
- Localize
emit/enderEmit/xLgrno XML, considerando o namespacehttp://www.portalfiscal.inf.br/nfe. - Compare com o logradouro do estabelecimento vinculado ao CNPJ ou CPF do grupo
emit. - Confira se o campo foi omitido, esvaziado, truncado ou substituído pelo endereço de outra parte.
- Examine o tamanho, os caracteres e a sequência:
xLgrvem antes denroemTEnderEmi. - Corrija a causa na origem cadastral ou no mapeamento comprovadamente incorreto e confira a próxima geração na preparação do documento. Preserve o XML assinado original.
Não use uma rejeição de município, de UF ou de destinatário como prova de que o texto do logradouro está errado. Leia o código e o caminho envolvidos na mensagem. O formato do logradouro não determina imposto, classificação ou regime; qualquer efeito fiscal do local depende da operação e dos documentos pertinentes.
As páginas de complemento do emitente e nome do município do emitente aprofundam os campos que completam esse endereço.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/emit/enderEmit/xLgr- Namespace
http://www.portalfiscal.inf.br/nfe- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 1–1 no contexto do elemento pai
- Tipo
- inline:TString · TString
- Preenchimento no catálogo
- Obrigatório
A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.
- maxLength
60- minLength
2- pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}- whiteSpace
preserve