obsFisco do item: observação de uso livre do Fisco

obsFisco em obsItem é o grupo de observação de uso livre do Fisco vinculado a um item da NF-e. Ele reúne um atributo xCampo para identificar a informação e um filho xTexto para seu conteúdo.

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 que o nome de uso do Fisco significa
• Caminho, ordem e ocorrência no item
• Quais dados o grupo exige
• Exemplo sintético de representação
• Diagnóstico sem trocar a titularidade da mensagem

O que o nome de uso do Fisco significa

A NT 2021.004 descreve VA05 como observação de uso livre do Fisco para o item. Isso a distingue de obsCont, de uso do contribuinte. O espaço no XML não é uma chancela do texto: a existência de obsFisco não prova que seu conteúdo foi produzido, analisado ou aprovado pela administração tributária.

O leiaute geral não define uma mensagem universal nem autoriza o emitente a inventar um benefício, número de processo ou fundamento legal para preencher esse grupo. Se há orientação específica, confira a fonte oficial, o identificador, o texto, a UF, a vigência e a operação a que ela se aplica.

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

Caminho, ordem e ocorrência no item

O XPath desta página é /nfeProc/NFe/infNFe/det/obsItem/obsFisco. obsItem fica diretamente em det. Dentro dele, obsCont é declarado primeiro e obsFisco depois; ambos são opcionais. obsFisco pode aparecer uma única vez por obsItem, e cada det pode ter no máximo um obsItem.

Há outro obsFisco em infAdic, referente à nota inteira e com cardinalidade própria 0–10. Não transporte essa lista para o item. Use det/nItem e o caminho completo para evitar que uma observação geral seja repetida em todos os produtos ou que dados de um item apareçam em outro.

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

Quais dados o grupo exige

Quando obsFisco é informado, o atributo xCampo é obrigatório, com uma a 20 posições; o elemento xTexto também é obrigatório, com uma a 60. O primeiro é o nome da informação, e o segundo seu conteúdo. Um grupo vazio ou um texto diretamente dentro de obsFisco não satisfaz esse par.

As restrições se baseiam em TString, que preserva espaços, limita a faixa de caracteres e não admite espaços nas extremidades. O tamanho é conferido no valor interpretado pelo parser. Não trate CDATA ou escape XML como forma de aumentar o limite. Não há valor numérico ou cálculo tributário próprio nesse grupo.

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

Exemplo sintético de representação

Exemplo exclusivamente estrutural: DEMO_FISCO e seu texto são fictícios, sem efeito ou reconhecimento fiscal. Em uma nota real, a origem e a pertinência do conteúdo precisam estar confirmadas. O fragmento é parcial em relação à NF-e.

<obsFisco xmlns="http://www.portalfiscal.inf.br/nfe" xCampo="DEMO_FISCO">
  <xTexto>Texto sintetico sem efeito fiscal</xTexto>
</obsFisco>

Na nota completa, obsFisco pertence a det/obsItem e aparece depois de obsCont quando ambos existem. Validar esse fragmento confirma a declaração do grupo do item, não a validade normativa de qualquer mensagem.

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

Diagnóstico sem trocar a titularidade da mensagem

Em falha de schema, confira pai, ordem, ocorrência única, atributo e filho obrigatórios, tamanhos e caracteres. Um validador que desconhece obsItem pode estar usando pacote anterior; confira sua versão antes de remover uma informação pertinente.

Em conteúdo divergente, compare a orientação oficial com a origem cadastrada, o mapeamento e o item efetivo no XML. Não mova uma observação do contribuinte para obsFisco para dar aparência de aprovação, nem acrescente texto fiscal para tentar evitar uma rejeição de tributo. Campos tributários continuam em seus grupos próprios.

Para uma exigência concreta, reúna ato ou orientação, UF, data, finalidade e produto, e confirme conteúdo e aplicabilidade com o responsável contábil. Após a definição, confira a representação exata e, se necessário, sua apresentação no DANFE. A presença no XML não garante uma área específica de impressão.

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

• xCampo — det/obsItem/obsFisco/@xCampo
• xTexto — det/obsItem/obsFisco/xTexto
• obsCont — det/obsItem/obsCont
• obsItem — det/obsItem

Fontes oficiais

• 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.
• Schemas NF-e/NFC-e PL_010f_v1.04, 010f v1.04, publicado em 31/08/2026 — /infNFe/det/obsItem/obsFisco; sequência e cardinalidade dos ancestrais.
• 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.