nro da retirada na NF-e: número do endereço como texto

retirada/nro informa o número do endereço do local de retirada. Embora a tag se chame “número”, o formato é texto de 1 a 60 caracteres, e não um campo restrito a algarismos. É obrigatório quando o grupo retirada está presente. Não representa número da NF-e, quantidade de volumes nem número do pedido. MOC 7.0, F04, p. 15.

O número pertence ao endereço de origem

Use a informação confirmada no cadastro ou na documentação do local de onde a mercadoria sai. O endereço pode pertencer ao expedidor escolhido para aquela operação, e não ao cliente. O número de um endereço de entrega correto não é fonte suficiente para preencher o número da retirada.

No MOC, retirada é informado somente se o endereço difere do remetente. Obrigatoriedade de nro dentro do grupo não exige criar retirada em toda nota, e ausência de um número no cadastro não autoriza inventar outro endereço. Se há local confirmado com identificação não convencional, confirme como essa identificação está documentada antes de representá-la.

Também há restrição para NFC-e e NF-e com DANFE Simplificado Tipo 2 (tpImp=6): F01-10/669 da NT 2026.002 v1.10a trata a presença do grupo como indevida. A linha correspondente do cronograma tem teste 01/07/2026 e produção 03/08/2026. Uma tag obrigatória interna não supera essa condição; confira modelo, ambiente e autorizador no diagnóstico.

Por que o campo aceita letras

O TLocal/nro do pacote anterior 010c v1.30 restringe o conteúdo ao tipo textual TString, mínimo 1 e máximo 60. Assim, uma identificação sintética como 120A cabe no formato, ao contrário de uma implementação que tenta converter todo número de endereço para inteiro.

O formato textual não torna verdadeira qualquer expressão colocada ali. Por exemplo, 0, S/N ou SEM NUMERO não são valores que este artigo recomende como substitutos universais de dado ausente. Há diferença entre um local documentado sem numeração e um cadastro que ainda não recebeu seu número; o segundo caso é uma lacuna de informação.

Também não se deve retirar a letra de 120A para gerar 120: a transformação pode apontar para outro acesso ou imóvel. A remoção de caracteres do endereço precisa preservar seu significado, não apenas satisfazer uma regra de software que indevidamente supõe campo numérico.

Como separar logradouro, número e complemento

O endereço tem três campos com responsabilidades diferentes: xLgr é o logradouro; nro, a identificação numérica/textual do endereço; xCpl, a informação adicional como galpão, bloco ou portão. O número não é um substituto para o complemento, e o complemento opcional não elimina a obrigatoriedade de nro.

Exemplo sintético e parcial que mostra essa separação; nome e endereço são fictícios, e os demais campos obrigatórios do grupo foram omitidos. Não é XML pronto para transmissão:

<retirada xmlns="http://www.portalfiscal.inf.br/nfe">
  <!-- Identificação e restante do endereço foram omitidos. -->
  <xLgr>Rua de Exemplo</xLgr>
  <nro>120A</nro>
  <xCpl>Galpão de Exemplo</xCpl>
</retirada>

O trecho conserva a letra como parte do número informado e usa o complemento para outra informação. Não afirma que esse imóvel exista. Se o cadastro originalmente trazia tudo em uma única linha, a integração precisa confirmar a separação das partes antes de gerar três valores.

Onde localizar nro e como diagnosticar falhas

O XPath é /nfeProc/NFe/infNFe/retirada/nro. No grupo, nro vem depois de xLgr e antes de xCpl, quando o complemento existir. Use o namespace da NF-e ao consultar. Uma busca apenas por nro pode retornar endereço do emitente, do destinatário ou da entrega.

Para falha de schema, confira tag ausente, conteúdo vazio, limite de comprimento, espaços nas extremidades e ordem dos filhos. <nro/> não satisfaz mínimo 1. Incluir o número na string de xLgr sem gerar nro também não resolve a estrutura do grupo.

Se o número saiu errado, compare origem e prévia. Um cadastro com 120A e XML com 120 indica perda durante conversão ou tratamento do campo. Se o XML reproduz o número de entrega, investigue mapeamento entre endereços. Se o cadastro está incompleto, obtenha a informação documentada do expedidor/local antes de corrigir.

Confira nova prévia para verificar o dado completo e a divisão entre logradouro, número e complemento. Não corte o endereço silenciosamente, não altere XML assinado nem retransmita por tentativa. Numeração de endereço não decide tratamento tributário de uma operação com depósitos ou terceiros; a identificação do local e seus vínculos documentais precisam ser confirmados separadamente. Veja logradouro da retirada e complemento da retirada.