01. DADOS GERAIS
| Produto: | TOTVS Backoffice |
|---|---|
| Linha de Produto: | Linha Datasul |
| Segmento: | Manufatura |
| Módulo: | TOTVS Backoffice (Linha Datasul) - Obrigações Fiscais (MOF) |
| Função: | html.fiscalDocument - Movimentação Documentos Fiscais (Web) |
| País: | Brasil |
| Requisito/Story/Issue (informe o requisito relacionado) : | DBACKRTDTS-2417, DBACKRTDTS-1025, DBACKRTDTS-2434, DBACKRTDTS-2435, DBACKRTDTS-2436, DBACKRTDTS-2710 |
02. SITUAÇÃO/REQUISITO
Com a Reforma Tributária do Consumo prevista na Emenda Constitucional nº 132/2023 e regulamentada pela Lei Complementar nº 214/2025, foi introduzida a necessidade de emissão de Notas Fiscais de Crédito e Débito. Essas notas têm como finalidade realizar ajustes em operações anteriores, como estornos, complementações ou correções tributárias, sem necessidade de cancelamento da nota original. A obrigatoriedade dessa funcionalidade está prevista para janeiro de 2026, exigindo que os sistemas estejam preparados para tratar essa nova finalidade de emissão.
03. SOLUÇÃO
A manutenção dos documentos fiscais foi atualizada para iniciar a adequação aos novos tributos previstos pela Reforma Tributária. Essa adaptação contempla a criação de novos programas e ajustes nos programas já existentes, garantindo que os sistemas possam apresentar corretamente os novos impostos e suas respectivas demandas.
Para atender à exigência de emissão das Notas de Crédito e Débito prevista na Reforma Tributária do Consumo, foram incluídos dois novos campos na tabela de documentos fiscais:
- Finalidade de emissão da NF-e
- Tipo de Nota de Crédito/Débito
Foi criado um novo campo na tabela de Documentos Fiscais denominado “Finalidade NF-e”. Esse campo é utilizado no layout da NF-e modelo 55 e já estava disponível nos módulos de Recebimento e Faturamento do Datasul, porém ainda não existia no módulo de Obrigações Fiscais.
A Finalidade NF-e pode assumir seis valores:
- NF-e normal (emissão regular)
- NF-e complementar
- NF-e de ajuste
- Devolução de mercadoria
- Nota de crédito – exclusiva para ajustes dos novos tributos CBS e IBS
- Nota de débito – exclusiva para ajustes dos novos tributos CBS e IBS
Antes da Reforma Tributária, o campo contemplava apenas as finalidades 1 a 4. Com as alterações trazidas pela LC nº 214/2025, foram incluídas as novas finalidades 5 e 6, voltadas para ajustes tributários de CBS e IBS, o que tornou necessária a inclusão do campo também no lançamento manual de documentos fiscais no módulo de Obrigações Fiscais.
Por padrão, esse campo só será preenchido quando liberado na tela do Documento Fiscal Web. Entretanto, estamos disponibilizando um programa especial para clientes que desejarem popular retroativamente esse campo em documentos já integrados no Fiscal, originados dos módulos de Recebimento e Faturamento.
Foi desenvolvido o programa especial SPOF010 – Preenchimento do campo “Finalidade NF-e”, que permite atribuir valor a este campo em documentos antigos (já integrados anteriormente), conforme a origem (Faturamento ou Recebimento). O recurso possibilita informar uma faixa de estabelecimentos e/ou um intervalo de datas para localizar os registros e atualizar o respectivo campo. Documentos novos já terão o preenchimento realizado automaticamente.
Instruções para execução do programa
- Acesso ao programa
Execute o programaspp/ofp/spof010.r. Parâmetros de execução
Informe a faixa de estabelecimentos a ser processada.
Defina a data inicial e a data final dos documentos fiscais que deverão ter o campo “Finalidade NF-e” populado.
- Acesso ao programa
Observações importantes
O tempo de processamento pode variar conforme o intervalo de datas informado. Intervalos muito amplos podem gerar maior tempo de execução devido ao volume de registros.
Serão atualizados apenas os documentos fiscais integrados no módulo de Obrigações Fiscais com origem nos módulos Recebimento e Faturamento, do modelo 55, que já possuam valor preenchido no campo “Finalidade NF-e” na origem.
Não serão atualizados documentos fiscais lançados manualmente no módulo de Obrigações Fiscais antes da liberação desse campo na tela de inclusão/alteração.
Documento Fiscal Web:
Para atender a essa demanda, foi realizada uma modificação no programa Documento Fiscal Web (html.fiscalDocument). A partir de agora, na busca avançada de documentos fiscais, foi implementado o novo campo Finalidade NF-e, possibilitando utilizar esse atributo como filtro na pesquisa. Dessa forma, o usuário pode localizar de forma mais ágil e precisa documentos emitidos como NF-e normal, complementar, de ajuste, de devolução de mercadoria, além das novas Notas de Crédito e Débito criadas pela Reforma Tributária.
Instruções para utilização do novo recurso
Acesse o Documento Fiscal Web (ou pesquise por html.fiscalDocument) via menu Datasul.
Na página inicial de listagem dos documentos, abra a opção Busca Avançada.
No campo Finalidade NF-e, selecione a finalidade desejada.
Execute a pesquisa para retornar apenas os documentos fiscais correspondentes à finalidade informada.
Além da utilização na Busca Avançada, os campos Finalidade NF-e e Tipo da Nota Fiscal de Crédito/Débito agora estão disponíveis também na capa do Documento Fiscal Web.
Finalidade NF-e
Campo exibido na capa do documento fiscal, logo após as informações principais da nota (especificamente abaixo do campo "Mensagem).
Opções disponíveis:
NF-e Normal
NF-e Complementar
NF-e Ajuste
NF-e Devolução de Mercadoria
NF-e Nota de Crédito (novo, somente com NT2024002 ativa)
NF-e Nota de Débito (novo, somente com NT2024002 ativa)
- Regras específicas:
As finalidades Nota de Crédito (5) e Nota de Débito (6) somente serão exibidas se a função NT2024002 estiver ativa.
Caso a finalidade seja 5 ou 6, os tributos “legados” (ICMS, IPI, PIS, COFINS, ISS, FCP) terão seus valores zerados automaticamente e permanecerão apenas os tributos novos (IBS e CBS).
Notas com finalidade 1 a 4 (Normal, Complementar, Ajuste, Devolução):
Mantêm o comportamento atual.
Tela de totais apresenta todos os tributos “legados” (ICMS, IPI, PIS, COFINS, ISS, FCP).
- Tela de totais da capa e tela de totais por item exibem somente os novos tributos da Reforma Tributária (IBS e CBS). Este comportamento é aplicado tanto na capa do documento fiscal quanto na listagem dos itens.
Tipo da Nota Fiscal de Crédito/Débito
Campo disponibilizado na capa (ao lado do campo de Finalidade NF-e), dependente da finalidade selecionada.
Regras de habilitação:
O campo fica desabilitado para finalidades 1 a 4.
O campo fica habilitado apenas quando a finalidade for 5 (Crédito) ou 6 (Débito).
Opções apresentadas:
Para finalidade 5 (Crédito) → lista de tipos de crédito (ex.: Multa e Juros, Apropriação de Crédito Presumido, Retorno).
Para finalidade 6 (Débito) → lista de tipos de débito (ex.: Débitos não processados, Transferência de Crédito, Pagamento Antecipado, etc.).
Informações Adicionais da Nota - Tipo Documento Referencia Item:
Produto alterado para permitir a inclusão, alteração e exclusão das Informações Adicionais da Nota do tipo de informação “Docto Fiscal Referenciado Item” no módulo de Obrigações Fiscais.
Exportação - Relatório de Documentos Fiscais:
A geração do relatório de Documentos Fiscais foi ajustado para apresentar os novos campos Finalidade NF-e e Tipo Nota Crédito/Débito nos tipos de relatórios resumido e detalhado, logo em seguida a coluna “Tp Nat Op”, apenas quando a função NT2024002 estiver ativa.
Importação - Documentos Fiscais:
Para a importação dos documentos fiscais foi ajustado o layout e a importação, incluindo os campos Finalidade NF-e e Tipo Nota Crédito/Débito na capa do Documento Fiscal. Também disponibilizando o tipo de registro “R” para informar o Docto Referenciado Item, e o tipo de registro “S” para informar o Docto Referenciado.
As alterações na importação estarão disponíveis apenas quando a função NT2024002 estiver ativa. Criado duas novas validações:
- Erro 153 = "Docto possui finalidade da nota de Crédito ou Débito, deve ser informado o tipo da Nota de Cred/Deb.". Essa mensagem de erro será apresentada apenas quando o Documento Fiscal possuir a Finalidade NF-e igual a nota de Crédito ou Débito, e nesse caso deverá informar o tipo de nota de crédito ou débito.
- Erro 154 = "Tipo de Registro (R) Docto Referenciado Item já informado, não pode haver Tipo de Registro (S) Docto Referenciado.". Essa mensagem de erro será apresentada apenas quando o Documento Fiscal possuir o Tipo de Registro (R) e Tipo de Registro (S), no documento fiscal pode existir os dois tipos.
Importante
Ao incluir um novo "Tipo de Registro (R) Docto Referenciado Item" ou "Tipo de Registro (S) Docto Referenciado" é importante frisar que deve ser informado o "Tipo de registro (1) Nota Fiscal", para que o produto possa identificar a qual documento fiscal pertence os dados adicionais que estão sendo importados. A ordem para informar os tipos de registros que serão importados deverão seguir o layout, ou seja primeiro "Tipo de registro (1) Nota Fiscal" e na sequencia os registros para os item e então os dados adicionais da nota se houver.
Foram alterados os programas OF0305 (Movimentação Documentos Fiscais) e OF0306 (Movimentação / Eliminação Documentos Fiscais) para adequação às regras da Reforma Tributária. Tais alterações visam à validação e ao tratamento adequado para documentos fiscais com finalidade 5 (Nota de Crédito) ou 6 (Nota de Débito), bem como documentos que contenham valores de IBS e/ou CBS.
Alterações Realizadas
Programa OF0305 - Movimentação Documentos Fiscais:
- Implementado verificação do campo Finalidade do documento fiscal (finNFe ou equivalente).
- Se a finalidade for 5 (Nota de Crédito) ou 6 (Nota de Débito), bloqueia a edição/cópia pelo programa Progress, exibindo mensagem de erro orientando o usuário a usar o programa Web html.FiscalDocument - Movimentação Documentos Fiscais.
- Se o documento possuir valor de IBS e/ou CBS (campos de base, imposto ou outros que indiquem presença desses tributos novos), na edição/cópia pelo OF0305 exibe mensagem de alerta informando sobre possível inconsistência nos totais/tributos, mas permite que a alteração continue.
- Ao excluir um documento, além de remover o documento fiscal principal, é eliminado todos os registros associados nas novas tabelas de IBS e CBS relacionadas a esse documento (para evitar registros órfãos ou inconsistentes).
Programa OF0306 - Movimentação / Eliminação Documentos Fiscais
- Ao excluir um documento, além de remover o documento fiscal principal, é eliminado todos os registros associados nas novas tabelas de IBS e CBS relacionadas a esse documento (para evitar registros órfãos ou inconsistentes).
04. ASSUNTOS RELACIONADOS
- documento_tecnico
- manufatura
- backoffice
- versao_12
- bra
- datasul
- rt
- reforma_tributária
- ibs
- cbs
- mof
- fiscal
- nt2024002
- fiscaldocument
- documento_fiscal
- exportacao_documento_fiscal
- dbackrtdts-2435
- dbackrtdts-2434
- 12_1_2511
- dbackrtdts-1025
- dbackrtdts-2417
- dbackrtdts-2710
- spof010
- finalidade_nf-e
- tipo_de_nota_de_credito_debito
- finalidade_de_emissao_da_nf-e
- finalidade_nfe
- nota_de_credito
- nota_de_debito



