Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Produtos e serviços

nLote na NF-e: identificação e vários lotes por item

<nLote>det › prod › rastro › nLote

Revisão editorial em 26 de set. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

nLote identifica o lote do produto no grupo de rastreabilidade. Fica em /nfeProc/NFe/infNFe/det/prod/rastro/nLote. É obrigatório em cada ocorrência de rastro e aceita texto de 1 a 20 caracteres conforme as restrições do schema. Letras e zeros iniciais podem fazer parte da identidade; não é um número destinado a cálculo.

Lote de produto e outros números da nota

O lote do produto não é o número da NF-e, det/@nItem, o lote de envio à SEFAZ ou um protocolo de autorização. Um fabricante pode usar código alfanumérico para identificar uma partida. A existência de uma sequência parecida em outro grupo do XML não autoriza transferi-la para nLote.

Confirme o dado pela embalagem, documentos do fornecedor/fabricante e controles de rastreabilidade aplicáveis. Não gere um novo lote apenas porque o cadastro local não o armazenou. Se dois fabricantes usam a mesma sequência textual, a identidade do produto e a documentação do lote continuam necessárias; nLote isolado não é uma chave universal de toda a cadeia.

Vários lotes são várias ocorrências de rastro

O item pode ter até 500 ocorrências de rastro no schema consultado. Cada bloco possui seu nLote, qLote, dFab e dVal, além de cAgreg opcional. Se a quantidade do item vem de dois lotes, representar os dois blocos preserva a relação entre quantidades e datas. Concatenar os nomes com vírgula em um único nLote não cria duas ocorrências nem separa suas validades. MOC, grupo I80.

O exemplo usa dois lotes fictícios com quantidades ilustrativas expressas na mesma unidade documental. É parcial e não está pronto para transmissão; os demais campos de prod foram omitidos.

<prod xmlns="http://www.portalfiscal.inf.br/nfe">
  <!-- Campos anteriores omitidos -->
  <rastro>
    <nLote>000A-26</nLote><qLote>6.000</qLote>
    <dFab>2026-07-01</dFab><dVal>2027-07-31</dVal>
  </rastro>
  <rastro>
    <nLote>000B-26</nLote><qLote>4.000</qLote>
    <dFab>2026-08-01</dFab><dVal>2027-08-31</dVal>
  </rastro>
</prod>

A soma ilustrativa é dez nessa unidade comum. Ela não institui uma regra universal de igualdade a qCom ou qTrib, pois o bloco rastro não contém uma tag própria de unidade. A conferência quantitativa depende da apresentação e conversão documentadas.

Texto integral e limite de tamanho

Preserve letras, zeros e separadores que pertençam ao identificador real e sejam admitidos no schema. Um valor com vinte e um caracteres não deve ser cortado silenciosamente: o corte pode criar outro identificador. Confirme se a origem incluiu indevidamente o rótulo “LOTE”, espaços externos ou outros dados impressos, distinguindo apresentação do código real.

O tipo TString preserva o conteúdo e não admite espaço no primeiro ou no último caractere. Isso não autoriza eliminar um separador interno verdadeiro ou converter o código em número. Se o identificador documentado contém um caractere reservado do XML, o gerador deve escapá-lo: o lote fictício A&026 aparece no arquivo como A&amp;026 e é interpretado como o mesmo código, sem contar a grafia da entidade como caracteres adicionais do lote.

Não use tag vazia para representar lote desconhecido. Se rastro deve existir na operação, sua ocorrência exige os quatro campos obrigatórios. A opcionalidade estrutural do grupo não resolve a ausência de documentação quando uma regra exige rastreabilidade.

Diagnóstico de lote ausente ou misturado

Localize o item e compare todas as ocorrências com as partidas realmente movimentadas. Confira se a importação transformou texto em número e perdeu zeros, se o gerador emitiu só o primeiro lote ou se copiou datas de uma partida para outra. Verifique a cardinalidade e a posição do grupo no XML efetivo.

Para erro de transferência comprovado, corrija o mapeamento e confira novamente a relação completa. Quando a origem está incompleta, obtenha a identificação do lote e os dados correspondentes, sem inventar número ou eliminar a informação para conseguir autorização. Não altere XML assinado.

Fontes oficiais

Leitura relacionada

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/prod/rastro/nLote
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
Condicional

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
20
minLength
1
pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}
whiteSpace
preserve