obsFisco na NF-e: finalidade do grupo e diferença para observações livres
<obsFisco>infAdic › obsFiscoRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
obsFisco é o grupo de observação nas informações adicionais da nota, localizado em /nfeProc/NFe/infNFe/infAdic/obsFisco. O MOC o apresenta como campo de uso livre do Fisco; o XSD o descreve como de uso exclusivo do Fisco. A liberdade de nome/conteúdo não o transforma em campo livre do contribuinte.
Quem determina o significado da observação?
Quando houver uma instrução ou conteúdo fiscal específico para esse grupo, confira sua origem oficial, contexto e aplicabilidade. Não invente um rótulo ou mensagem para aparentar aprovação do Fisco. O grupo pode ser lido e conferido tecnicamente sem que o leitor assuma autoridade para criar seu conteúdo.
obsCont é a estrutura de uso livre do contribuinte. infAdFisco contém informação adicional de interesse do Fisco, em texto de até 2.000 caracteres. São finalidades distintas: “interesse fiscal” não significa “uso exclusivo do Fisco”, e um rótulo genérico na interface não permite equipará-los.
Como é a estrutura e quantas ocorrências existem?
obsFisco ocorre de zero a dez vezes dentro de infAdic. Cada ocorrência exige atributo xCampo, de 1 a 20 caracteres, e filho xTexto, de 1 a 60. O atributo identifica o campo e o filho contém seu conteúdo. O grupo aparece depois das observações do contribuinte e antes dos processos referenciados na sequência do pai.
O fato de o grupo ser opcional não permite enviar pares incompletos quando ele for utilizado. Se não houver conteúdo aplicável, não crie uma observação vazia. Também não há um código nacional de aprovação formado pela combinação dos dois textos.
Como ler um exemplo sem atribuir-lhe valor oficial?
O fragmento abaixo é estritamente sintético, parcial em relação à nota e apenas demonstra o formato. CAMPO_EXEMPLO e o texto não são instruções do Fisco e não devem ser copiados como informação fiscal real:
<obsFisco xmlns="http://www.portalfiscal.inf.br/nfe" xCampo="CAMPO_EXEMPLO">
<xTexto>DEMONSTRACAO ESTRUTURAL SEM VALOR OFICIAL</xTexto>
</obsFisco>
Ao interpretar uma nota real, substitua a hipótese do exemplo pela evidência que efetivamente originou a observação. Validação no XSD demonstraria formato, não autoria oficial ou concordância da administração tributária.
Como investigar uma observação inesperada?
Localize o XML da nota e o pai exato do par: um xTexto encontrado sem ancestral pode pertencer a obsCont, não a obsFisco. Compare com a configuração de geração e com a eventual instrução oficial. Se uma observação comercial estiver sendo enviada em obsFisco, investigue o mapeamento em vez de assumir que o campo correto é aquele onde coube o texto.
Para erro de schema, confira atributo obrigatório, filho, tamanhos, namespace e sequência. Para dúvida sobre a origem, solicite a instrução ou documento que fundamenta o preenchimento; não invente um código de rejeição ou efeito fiscal. O grupo não substitui tributos estruturados, processo, fundamento legal aplicável ou autorização da NF-e. Corrija somente a causa demonstrada, preservando a integridade do XML e o procedimento adequado à situação do documento.
Fontes técnicas
MOC 7.0 — Anexo I — 7.0: p. 64, Z07–Z09.
XSD NF-e/NFC-e — PL_010f_v1.04: linhas 6190–6216, obsFisco.
Tipos básicos NF-e/NFC-e — PL_010f_v1.04: linhas 519–527, TString.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/infAdic/obsFisco- Namespace
http://www.portalfiscal.inf.br/nfe- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 0–10 no contexto do elemento pai
- Tipo
- inline:complexType
- 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.