obsItem: observações por item e diferenças de infAdic

obsItem é o grupo de observações de uso livre vinculado a um item da NF-e. Ele separa a observação do contribuinte, obsCont, da observação de uso do Fisco, obsFisco, cada uma com identificação xCampo e conteúdo xTexto.

A estrutura descrita usa o pacote oficial PL_010f_v1.04, publicado em 31/08/2026. Esse pacote não altera a versão selecionada de um XML histórico na consulta; para arquivos de outra versão, confira a declaração correspondente e as regras vigentes na data e no ambiente do documento.

Neste artigo:

• O grupo pertence ao item, não à nota inteira
• Quantas observações podem existir no mesmo item
• Observação do contribuinte, do Fisco e complemento do produto
• Exemplo de obsItem com observação do contribuinte
• Cuidados de integração e diagnóstico

O grupo pertence ao item, não à nota inteira

O XPath é /nfeProc/NFe/infNFe/det/obsItem, VA01. A NT 2021.004 documentou esse grupo de observações por item. No schema 010f ele aparece depois de infAdProd, se presente, e antes de vItem, se presente. obsItem não fica dentro de prod, imposto ou infAdic.

O grupo infAdic também contém obsCont e obsFisco, mas em contexto de nota inteira. A coincidência dos nomes não autoriza usar o mesmo caminho, os mesmos limites de repetição ou a mesma associação de dados. Ao ler, use nItem para identificar a qual produto a observação se refere.

Schemas NF-e/NFC-e PL_010f_v1.04 NT 2021.004 — Regras de Validação e Novos Campos MOC 7.0 — Anexo I

Quantas observações podem existir no mesmo item

O XSD permite zero ou um obsItem por det. Dentro dele, permite zero ou um obsCont e zero ou um obsFisco, nessa ordem. Se ambos forem usados, obsCont vem primeiro. Não há lista de dez obsCont dentro de obsItem: a ocorrência 0–10 dos grupos homônimos de infAdic é de outro contexto.

Cada grupo informado exige um atributo xCampo de uma a 20 posições e um elemento xTexto de uma a 60. xCampo nomeia a observação; xTexto contém a informação. As duas partes são obrigatórias quando obsCont ou obsFisco existe. O XSD permite ausência dos dois filhos, mas um obsItem vazio não transporta informação útil; se não houver observação, a opcionalidade permite omitir o contêiner.

Schemas NF-e/NFC-e PL_010f_v1.04 Tipos básicos do leiaute NF-e NT 2021.004 — Regras de Validação e Novos Campos MOC 7.0 — Anexo I

Observação do contribuinte, do Fisco e complemento do produto

obsCont é o campo de uso livre do contribuinte para o item. obsFisco é o de uso livre do Fisco. O leiaute define a titularidade desses espaços; ele não atribui automaticamente significado normativo a qualquer rótulo inventado pelo emissor. Uma orientação específica de uma administração tributária precisa ser verificada na fonte dessa exigência.

infAdProd é outro campo: texto complementar de até 500 caracteres, sem par xCampo/xTexto. obsItem oferece pares identificados, com limites menores. Nenhum deles substitui tags estruturadas de código, quantidade, tributo, referência documental ou benefício. Escrever um valor tributário em uma observação não cria o respectivo dado numérico.

Schemas NF-e/NFC-e PL_010f_v1.04 NT 2021.004 — Regras de Validação e Novos Campos MOC 7.0 — Anexo I

Exemplo de obsItem com observação do contribuinte

O exemplo sintético associa uma referência interna ao item. REF_INTERNA é um rótulo ilustrativo, não um código oficial ou uma exigência fiscal. Não há observação do Fisco neste exemplo.

<obsItem xmlns="http://www.portalfiscal.inf.br/nfe">
  <obsCont xCampo="REF_INTERNA">
    <xTexto>Controle demonstrativo do item 1</xTexto>
  </obsCont>
</obsItem>

É o grupo completo para esse ramo e um fragmento da nota inteira. O validador estrutural pode conferir posição, filhos e tamanhos; não valida a veracidade ou a autoridade do conteúdo. Outros campos da NF-e continuam necessários.

Schemas NF-e/NFC-e PL_010f_v1.04 NT 2021.004 — Regras de Validação e Novos Campos

Cuidados de integração e diagnóstico

Mantenha separadas as duas observações e o nItem. Não importe automaticamente obsCont da nota inteira para todos os itens. Se o sistema recebeu mais de uma observação do contribuinte para um item, trate o conflito com a origem; concatenar ou descartar conteúdo para caber no schema pode alterar o significado.

Para erro de schema, confira pai det, ordem, ausência de repetição, atributo obrigatório, filho obrigatório e limites após a serialização. TString restringe caracteres e espaços nas extremidades; escape & e < com o serializador, sem duplicar o escape. Se o validador não reconhece obsItem, confira a versão do pacote usada antes de mudar o conteúdo.

Em divergência de impressão, compare primeiro o XML efetivo e o DANFE. O grupo no XML não garante uma área específica de impressão. Se houver exigência fiscal, leve o ato ou orientação, o item e a data ao responsável contábil para confirmar conteúdo e campo; depois valide a representação, sem editar XML assinado.

Schemas NF-e/NFC-e PL_010f_v1.04 Tipos básicos do leiaute NF-e NT 2021.004 — Regras de Validação e Novos Campos

Leitura relacionada

• obsCont — det/obsItem/obsCont
• obsFisco — det/obsItem/obsFisco
• infAdProd — det/infAdProd

Fontes oficiais

• Schemas NF-e/NFC-e PL_010f_v1.04, 010f v1.04, publicado em 31/08/2026 — /infNFe/det/obsItem; sequência e cardinalidade dos ancestrais.
• NT 2021.004 — Regras de Validação e Novos Campos, 1.30, maio/2022; histórico do grupo VA, não última edição nacional — NT 2021.004 v1.30, seção 3.4, p.13 VA01–VA07; edição histórica confrontada com XSD atual, sem inferência de cronograma vigente.
• MOC 7.0 — Anexo I, 7.00, novembro/2020 — MOC 7.0 p.58 V01; p.64 Z04–Z09: observações da nota inteira, contexto distinto.
• Tipos básicos do leiaute NF-e, PL_010f_v1.04 — TString; TDec_1302; TDec_0302Max100 conforme o campo.