deduc em cana: descrição, valor e total das deduções
<deduc>cana › deducRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
deduc, dentro de cana, reúne uma dedução de taxas ou contribuições no registro da aquisição. Cada ocorrência tem uma descrição e um valor. O grupo não define quais cobranças são devidas nem representa automaticamente uma redução de base de cálculo de imposto.
Caminho desta página: /nfeProc/NFe/infNFe/cana/deduc. O prefixo nfeProc identifica a nota processada; a informação estudada pertence ao conteúdo da NF-e, dentro de NFe/infNFe.
Estrutura e quantidade de ocorrências
O grupo ocorre de 0 a 10 vezes dentro de cana. Quando existe, exige xDed antes de vDed: descrição de 1 a 60 caracteres e valor monetário com duas casas decimais. Omitir deduc quando não existe lançamento aplicável é diferente de gerar um grupo vazio ou apenas com valor.
O grupo cana é opcional no XSD compartilhado, mas a regra ZC01-10 do MOC relaciona sua presença em NFC-e, modelo 65, à rejeição 763. O contexto deste conteúdo é a NF-e modelo 55 de registro de aquisição de cana. Passar no XSD não dispensa a regra por modelo. MOC 7.0, p. 64–65 e 128.
A repetição permite discriminar deduções de naturezas diferentes dentro do limite. Se a origem contém mais lançamentos do que o grupo comporta, não descarte linhas silenciosamente nem invente agrupamento: confirme a discriminação documental adequada e o vínculo de cada valor antes da geração.
Exemplo de discriminação sem criar cobrança
Suponha um demonstrativo sintético que já individualiza R$ 12,50 para uma taxa contratual. O fragmento registra esse dado assumido:
<deduc xmlns="http://www.portalfiscal.inf.br/nfe">
<xDed>Taxa contratual demonstrativa</xDed>
<vDed>12.50</vDed>
</deduc>
O exemplo é parcial em relação a cana e à nota, sem XML completo de transmissão. Ele não orienta instituir a taxa. Se o demonstrativo possui outra dedução documentada de R$ 7,50, a soma para reconciliação com vTotDed é R$ 20,00. Com fornecimentos de R$ 300,00, a diferença aritmética para conferir o líquido seria R$ 280,00. Essas contas verificam o demonstrativo; não constituem uma nova regra de autorização.
Diferença para vTotDed e vDeducao
vDed é o valor de uma dedução; vTotDed é o valor total das deduções em cana. Repetir o total em cada ocorrência multiplicaria o desconto na liquidação. vLiqFor representa o valor líquido dos fornecimentos e não deve substituir cada valor individual.
Campos chamados vDeducao em outros grupos pertencem a contextos tributários distintos. A descrição “dedução” por si só não autoriza copiar a quantia para a base do ISSQN, IBS, CBS ou outro tributo. Confirme com o responsável fiscal a natureza da dedução e os documentos do caso; tecnicamente, mantenha o par dentro do XPath de aquisição de cana.
Como encontrar diferença na liquidação
Relacione cada ocorrência a uma linha do demonstrativo usando descrição, valor e referência do documento de origem. Compare a soma dos vDed com vTotDed e confira se o líquido usou o total uma única vez. Se a soma diverge, procure linha omitida, duplicidade ou valor transferido do total para a parcela.
Se a divergência é apenas estrutural, examine grupos incompletos, ordem e limites de descrição. Se é monetária, confirme valor em reais, sem sinal negativo nem separador de milhar. Preserve os lançamentos verdadeiros e corrija o erro na origem comprovada antes da assinatura, mantendo a trilha da mudança.
Fontes oficiais
- Leiaute NF-e/NFC-e — PL_010f_v1.04: cana/deduc l6435–6461; xDed/vDed; TDec_1302
- Tipos básicos NF-e/NFC-e — PL_010f_v1.04: TDec_1110v l247–256; TDec_1302; TString
- MOC 7.0 — Anexo I — 7.00, novembro/2020: Grupo ZC, p. 64–65; regra ZC01-10 e rejeição 763, p. 128
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/cana/deduc- 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.