Número do endereço de entrega na NF-e: o campo entrega/nro

entrega/nro registra o número do endereço do local de entrega. O campo G04 tem uma ocorrência obrigatória dentro de entrega, com texto de 1 a 60 caracteres. A tag não é o número da NF-e: identifica o endereço em que a mercadoria será recebida, quando diferente do endereço do destinatário. MOC, Grupo G, página 16.

De onde obter o número

Use o pedido ou cadastro do endereço efetivo de entrega. A seleção de um endereço diferente deve trazer o conjunto correspondente: logradouro, número, complemento, bairro, município e UF. Não combine o logradouro do galpão com o número da sede do cliente. Um dado isolado pode parecer plausível e ainda apontar para outro imóvel.

Compare entrega/nro com dest/enderDest/nro e retirada/nro apenas para identificar suas funções: são números de endereços distintos. ide/nNF tem outra finalidade, o número fiscal da nota. O fato de nro ter esse nome abreviado não muda seu tipo: é texto, não um inteiro a ser calculado.

Número, letra e complemento não são a mesma informação

O campo deriva de TString, não de tipo exclusivamente numérico. Se a identificação real do endereço é 120A, por exemplo, a letra não deve ser removida por conversão para inteiro. O conteúdo deve respeitar o intervalo de 1–60 caracteres, sem espaços nas extremidades. Schemas oficiais, TLocal/nro e TString.

xLgr contém o logradouro; nro, o número ou identificação correspondente; xCpl, o complemento que distingue sala, bloco ou outra subdivisão. Exemplo sintético e parcial em relação ao grupo e à NF-e, sem condição de transmissão:

<xLgr>Rua de Exemplo</xLgr>
<nro>120A</nro>
<xCpl>Bloco B, sala 3</xCpl>

Esses elementos são de entrega, no namespace http://www.portalfiscal.inf.br/nfe. Rua e subdivisão são fictícias. A leitura distingue a identificação 120A da sala 3; enviar só 120 altera o endereço demonstrado. Colocar todo esse texto em xLgr e omitir nro também não atende à estrutura.

O XPath do campo é /nfeProc/NFe/infNFe/entrega/nro. Na sequência do grupo, nro vem após xLgr e antes de xCpl, quando o complemento existe. Se xCpl não existir, o próximo campo é xBairro.

E se o local não tem número?

O leiaute exige conteúdo no campo quando o grupo está presente, mas as fontes deste campo não definem um literal universal para todo endereço sem número. Não se pode concluir que 0, S/N ou outra expressão resolva qualquer caso só porque cabe no tipo textual.

Confirme como a ausência de número ou a identificação equivalente aparece no cadastro/documento real do local e como deve ser representada no contrato aplicável do emissor. Se a origem apenas não tem o dado, isso é informação faltante; não prova que o imóvel seja sem número. Obtenha essa confirmação antes de preencher uma expressão ou número fictício. Uma tag vazia ou contendo somente espaços não atende ao conteúdo mínimo.

Como diagnosticar um número errado

Para falha de schema, confira ausência, vazio, limite, espaços nas extremidades, namespace e ordem. Para endereço incoerente, confronte a seleção do local de entrega com o pedido e o cadastro, incluindo sufixos de identificação, letra e complemento.

Se o cadastro contém 120A e a prévia mostra 120, a evidência aponta para conversão ou normalização da integração. Se a prévia usa o número da sede junto da rua do local de entrega, verifique a fonte de cada campo no mapeamento. Corrija essa causa comprovada e gere novamente a prévia para conferir o endereço inteiro.

Não altere XML assinado ou autorizado e não invente número para satisfazer o mínimo do schema. Um endereço estruturalmente válido não comprova a veracidade do local nem define tributação. A eventual análise fiscal da operação deve usar seus documentos reais, sem escolher CFOP ou incidência a partir desse campo.

O logradouro de entrega e o complemento de entrega detalham as partes que acompanham o número.