cOperNFF: código da operação selecionada na Nota Fiscal Fácil
<cOperNFF>det › prod › infProdNFF › cOperNFFRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
cOperNFF, dentro de prod/infProdNFF, identifica a operação selecionada na Nota Fiscal Fácil e relacionada ao item. Seu caminho completo é /nfeProc/NFe/infNFe/det/prod/infProdNFF/cOperNFF.
Por que cOperNFF é diferente de CFOP
O leiaute define expressamente o campo como código da operação selecionada na NFF. Já prod/CFOP é outro elemento do produto, com finalidade fiscal própria. O fato de ambos poderem conter dígitos não prova equivalência. Não construa uma conversão substituindo automaticamente um pelo outro; obtenha a operação do fluxo oficial que produziu os dados da NFF. Fonte: NT 2021.002 — Nota Fiscal Fácil 1.12, janeiro/2025, I86b, p. 8; XSD NF-e/NFC-e PL_010f_v1.04, cOperNFF, linhas 1460–1470.
A operação também precisa continuar associada ao cProdFisco da mesma ocorrência e ao item correspondente. Reutilizar indiscriminadamente o primeiro código entre produtos pode produzir uma associação incorreta mesmo com formato válido.
Tamanho, ordem e exemplo
Quando infProdNFF existe, cOperNFF é obrigatório uma vez, depois de cProdFisco. O padrão aceita de 1 a 5 dígitos, sem sinal, letras ou máscara. Esse tamanho não é um catálogo de operações válidas. Fonte: XSD NF-e/NFC-e PL_010f_v1.04, infProdNFF, linhas 1444–1473.
Fragmento parcial com valor sintético que não seleciona operação para o leitor:
<cOperNFF xmlns="http://www.portalfiscal.inf.br/nfe">123</cOperNFF>
Um código recebido com zeros iniciais deve ser preservado conforme o contrato de origem; o campo é serializado como sequência textual de dígitos. Não acrescente zeros por suposição nem use uma descrição de operação como conteúdo.
O que conferir se o grupo for rejeitado
A rejeição 820 verifica o contexto de infProdNFF: tpEmis diferente de 3 e procEmi diferente de 1/2. Ela não é uma declaração específica de que o número de cOperNFF está errado. Fonte: NT 2021.002 — Nota Fiscal Fácil 1.12, janeiro/2025, I86-10, p. 21.
Diante de erro estrutural, confira presença, ordem e quantidade de dígitos do campo. Diante de divergência de operação, compare o valor gerado com o código efetivamente selecionado no processo oficial e com o produto correspondente. Não selecione uma nova operação ou CFOP só para obter um XML aceito; a classificação da operação depende dos fatos e parâmetros fiscais reais.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/prod/infProdNFF/cOperNFF- 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:xs:string · string
- 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.
- pattern
[0-9]{1,5}- whiteSpace
preserve