nLote na NF-e: identificação e vários lotes por item
<nLote>det › prod › rastro › nLoteRevisã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&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
- MOC 7.0 — Anexo I — 7.00; p.21 I80/I81.
- Schemas NF-e/NFC-e — PL_010c_NT2022_002v1.30; prod/rastro maxOccurs500; nLote TString 1–20.
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