nro do emitente na NF-e: número do endereço como texto obrigatório

nro, em emit/enderEmit/nro, representa o número ou identificador cadastral do imóvel do emitente. Ele é obrigatório e aceita texto de 1 a 60 caracteres. Apesar do nome “número”, seu contrato XML não é um tipo numérico; não deve ser confundido com o número da nota em ide/nNF. MOC 7.0, C07, p. 13.

O XPath é /nfeProc/NFe/infNFe/emit/enderEmit/nro, no namespace http://www.portalfiscal.inf.br/nfe. O campo aparece depois de xLgr e antes de xCpl, se houver complemento, e de xBairro.

Por que não converter esse campo para inteiro

O tipo é uma restrição de TString, com mínimo 1 e máximo 60 caracteres, preservando texto admitido e sem espaço inicial ou final. Assim, o emissor não deve apagar uma letra ou outro componente que faça parte do identificador cadastral verdadeiro por presumir que só algarismos são permitidos. Schema PL010d v1.03, TEnderEmi/nro e TString.

Um número cadastral 200A, por exemplo, demonstra a capacidade textual do contrato. Ele não deve ser convertido em 200, porque a letra pode distinguir o imóvel. O exemplo não autoriza acrescentar uma letra a um endereço real nem inventar um identificador para preencher o campo.

Da mesma forma, zero e ausência não são equivalentes. Não preencha 0 automaticamente quando a origem está sem número só para alcançar o mínimo de um caractere. Se o cadastro representa um imóvel sem numeração, obtenha a forma verdadeira e documentada de identificação; o artigo não estabelece uma expressão universal para substituir qualquer lacuna cadastral.

Número, logradouro e complemento têm funções diferentes

xLgr representa o logradouro. nro representa o identificador do imóvel. xCpl, opcional, representa complemento. Não despeje o endereço completo no número para evitar preencher os outros campos. A existência de complemento não torna nro opcional, e a presença de bairro não compensa número ausente.

O endereço deve vir do estabelecimento identificado no CNPJ/CPF da nota. Número de uma matriz, filial, destinatário ou local de entrega não deve ser copiado para o emitente apenas por ser conhecido.

Exemplo com número textual e complemento

Trecho parcial e sintético, não pronto para transmissão. Rua, número, complemento e bairro são fictícios.

<enderEmit xmlns="http://www.portalfiscal.inf.br/nfe">
  <xLgr>RUA SINTETICA</xLgr>
  <nro>200A</nro>
  <xCpl>SALA SINTETICA</xCpl>
  <xBairro>BAIRRO SINTETICO</xBairro>
  <!-- município, UF, CEP e opcionais seguintes omitidos -->
</enderEmit>

O valor 200A tem quatro caracteres e cabe no tipo textual. O complemento foi separado. O fragmento omite outros campos obrigatórios de endereço, portanto não pode ser usado como grupo completo para validar uma nota.

Como investigar falta, espaço ou truncamento

Para campo ausente ou vazio, compare cadastro e XML da tentativa: houve falta de informação na origem ou perda no mapeamento? Para valor com espaços nas extremidades, confira a entrada e a serialização; não substitua o identificador por outro imóvel. Para mais de 60 caracteres, investigue se o endereço completo ou complemento foi colocado no número. Truncar texto até 60 sem confirmar seu significado pode alterar o endereço.

Depois de corrigir a origem ou o mapeamento autorizado, confira nro, logradouro e complemento juntos, além da ordem do grupo e do endereço verdadeiro. Uma string aceita pelo schema não demonstra localização real ou cadastro regular. Preserve o retorno e o XML anteriores; não altere arquivo assinado. A localização e seus efeitos tributários devem ser confirmados com documentos da operação, sem escolher tratamento por esse campo.

Veja enderEmit para conferir os campos obrigatórios que completam o endereço.