NFCom — cancelamento e substituição¶
Captura do Telvora ERP em ambiente autorizado. Valores de tabelas e formulários foram ocultados para privacidade.
Módulo: Fiscal
Menu: Operações → Fiscal → NFCom
Público: Operador fiscal / Administrador / QA
Status: Publicado
Atualizado: 2026-09-11
Refs técnicas: ADR-024 ·01-ARQUITETURA/66-nfcom-emissao.md· MOC NFCom (evento 110111) · SINIEF 07/22 cl. 15
O que faz¶
Permite cancelar uma NFCom autorizada (evento SEFAZ 110111) dentro do prazo legal, ou emitir uma NFCom de substituição (finNFCom=3) quando o cancelamento não é mais possível ou a correção exige nova nota.
A contabilidade estorna os impostos da nota original (FISCAL_NFCOM_CANCELLED) e, na substituta autorizada, lança novos impostos (FISCAL_NFCOM_TAXES). A receita continua no CRE (Financeiro → Receber), não na NFCom.
Quem pode usar¶
fiscal.nfcom.cancel— cancelarfiscal.nfcom.substitute— emitir substituiçãofiscal.nfcom.read/transmit— consultar e transmitir
Pré-requisitos¶
- NFCom com status AUTHORIZED.
- Filial com certificado A1 válido.
- Cancelamento: prazo de até 120 horas após o último dia do mês da autorização; motivo com mínimo 15 caracteres.
- Não cancelar: NFCom de finalidade SUBSTITUTION, nem nota já SUBSTITUTED.
Passo a passo — cancelar¶
- Abra Operações → Fiscal → NFCom.
- Abra o Detalhe de uma nota AUTHORIZED (finalidade NORMAL).
- Clique Cancelar NFCom.
- Informe o motivo (≥ 15 caracteres) e confirme.
- Se a SEFAZ homologar (cStat 135), o status vira CANCELLED e o histórico registra o evento.
- Conferir estorno de impostos em Contabilidade → Diário / Eventos (quando houver impostos lançados).
Passo a passo — substituição¶
- No detalhe de uma NFCom AUTHORIZED (NORMAL ou já SUBSTITUTION anterior), clique Emitir substituição.
- O sistema clona itens/tributos, gera nova numeração, monta XML com
finNFCom=3,gSub/chNFComda original emotSub(motivo da substituição; padrão01), assina e transmite (padrão). - Se autorizada: a nova fica AUTHORIZED (SUBSTITUTION); a original fica SUBSTITUTED.
- A original não pode mais ser cancelada.
Regras importantes¶
| Situação | Comportamento |
|---|---|
| Dentro do prazo + AUTHORIZED NORMAL | Cancelamento via evento SEFAZ |
| Fora do prazo | Sistema bloqueia cancelamento → use substituição |
| Já substituída / cancelada | Bloqueia nova operação inválida |
| Substituição autorizada | Original SUBSTITUTED; impostos da original estornados; impostos da nova lançados |
| Receita / CRE | Não é alterada automaticamente por este fluxo |
Erros / avisos comuns¶
| Situação | O que fazer |
|---|---|
| Motivo < 15 caracteres | Ampliar a justificativa |
| Prazo vencido | Emitir substituição |
| NFCom de substituição | Não cancela — emita outra substituição |
| Já substituída | Não cancela nem substitui de novo a mesma original |
| Schema gSub (cStat 215 / incompleto) | Corrigido: gSub após assinante e com motSub obrigatório |
| SEFAZ HTTP 500 / SOAP Fault | Toast mostra o motivo real (Fault / título HTML) quando a SEFAZ não devolve cStat; conferir certificado A1, ambiente (homolog/prod) e tentar de novo |
| Rejeição SEFAZ no evento | Leia a mensagem do toast — inclui [cStat] xMotivo quando a SEFAZ responde XML fiscal |
