xCampo de obsFisco no item: identificação da observação

xCampo em obsItem/obsFisco identifica a observação de uso livre do Fisco de um item. É um atributo de obsFisco, separado de xTexto, que contém a informação correspondente.

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:

• Identificação do campo no contexto do Fisco
• Obrigatoriedade e limite de 20 posições
• O leiaute não oferece uma lista universal de nomes
• Exemplo estrutural com conteúdo separado
• Como conferir um erro de atributo ou de associação

Identificação do campo no contexto do Fisco

O XPath é /nfeProc/NFe/infNFe/det/obsItem/obsFisco/@xCampo, VA06. O @ indica atributo: xCampo é escrito na abertura de obsFisco. Não há, nessa declaração, uma tag filha xCampo para receber o identificador.

O xCampo de obsCont pertence à observação do contribuinte. O xCampo de infAdic/obsFisco pertence à nota inteira. Os nomes iguais não tornam esses contextos intercambiáveis. Ao extrair, preserve os ancestrais obsItem/obsFisco e selecione o det correto por nItem.

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

Obrigatoriedade e limite de 20 posições

Se obsFisco existe, xCampo é obrigatório e deve ter uma a 20 posições. Sua base TString preserva espaços e restringe caracteres, sem espaços nas extremidades. Um atributo vazio ou só com espaços não é uma identificação válida no tipo.

O tamanho pertence ao nome interpretado, não aos bytes do arquivo UTF-8. Aspas ou & que façam parte do valor precisam de escape XML adequado. Use um serializador de atributos e depois compare o valor retornado pelo parser com o valor definido pela origem. Não corte um identificador exigido apenas para obter validação estrutural.

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

O leiaute não oferece uma lista universal de nomes

A definição geral descreve identificação do campo, sem uma tabela universal de códigos fiscais para esse atributo. Um nome inventado não cria obrigação, benefício, autorização ou manifestação do Fisco. Quando uma orientação específica determina identificador e conteúdo, a fonte dessa orientação deve sustentar a escolha.

Confirme o ato ou orientação, administração responsável, UF, data e contexto do item. O artigo explica a representação, sem decidir qual identificador fiscal a operação do leitor deve usar. Se não há observação pertinente confirmada, a opcionalidade do grupo não exige preencher um nome fictício.

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

Exemplo estrutural com conteúdo separado

Exemplo sintético, sem efeito fiscal e sem indicação de um identificador oficial. O atributo demonstra o nome; o elemento xTexto demonstra o conteúdo. O fragmento não é documento pronto para transmissão.

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

xTexto tem limite separado de uma a 60 posições e também é obrigatório quando obsFisco existe. Não use xCampo como depósito do texto para aumentar esse espaço. Os dois dados formam um par e precisam continuar semanticamente correspondentes.

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

Como conferir um erro de atributo ou de associação

Para erro de schema, confira se o identificador é atributo de obsFisco, está preenchido, respeita 20 posições e os caracteres de TString. Verifique também xTexto e a ocorrência única de obsFisco no obsItem. A cardinalidade de até dez do grupo homônimo de infAdic não se aplica a esse pai.

Para um nome inesperado, trace a origem oficial e o mapeamento. Um extrator pode ter capturado o atributo de obsCont ou de outro item. Compare sempre caminho, nItem e valor interpretado. Se a divergência é normativa, confirme identificador e alcance com o responsável contábil com a orientação em mãos; não renomeie ou atribua autoridade fiscal por suposiçã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 MOC 7.0 — Anexo I

Leitura relacionada

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

Fontes oficiais

• Schemas NF-e/NFC-e PL_010f_v1.04, 010f v1.04, publicado em 31/08/2026 — /infNFe/det/obsItem/obsFisco/@xCampo; 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.
• Tipos básicos do leiaute NF-e, PL_010f_v1.04 — TString; TDec_1302; TDec_0302Max100 conforme o campo.
• 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.