01. DADOS GERAIS
| Produto: | TOTVS Manufatura TOTVS Backoffice |
|---|---|
| Linha de Produto: | Linha Datasul |
| Segmento: | Manufatura |
| Módulo: | TOTVS Backoffice (Linha Datasul) - Recebimento (MRE) |
| Função: | html.mcd.eventoTributos - Eventos tributos |
| País: | Brasil |
| Requisito/Story/Issue (informe o requisito relacionado) : | DBACKRTDTS-7830 DBACKRTDTS-7875 |
02. SITUAÇÃO/REQUISITO
Embora o programa Evento Tributos (html.mcd.eventoTributos) permita a gestão individual por documento, deveremos permitir a geração de alguns eventos em lote, para isso será necessário ajustar a geração dos eventos 211128 - Aceite de Débito por Nota de Crédito e 211110 - Solicitação de Apropriação de crédito presumido, permitindo a geração em lote dos eventos por intermédio dos programas Cenários Automatização Eventos - html.mcd.cenarioEventoTributos e Agendar Geração Automática de Eventos - html.mcd.agendadorEventoTributos.
03. SOLUÇÃO
Para viabilizar a geração em lote, a solução foi estruturada em duas frentes: o Cenário Automatização Eventos (html.mcd.cenarioEventoTributos), que centraliza a inteligência das regras e cenários fiscais, e o Agendar Geração Automática de Eventos (html.mcd.agendadorEventoTributos), que garante a execução programada e automática desses processos. Para maiores informações sobre a tela de agendamento da geração automática ao final desta documentação técnica disponibilizamos o link da documentação.
Para efetuar a geração do evento 211128 - Aceite de Débito por Nota de Crédito, lançar documentos que possuam valores de CBS, IBS UF e IBS MUN, abaixo vamos detalhar um exemplo com um documento, este evento será gerando com o indicador de aceitação selecionada com a opção "Aceite".
Lançamos um documento no recebimento fiscal, no exemplo abaixo vamos fazer com nota de crédito do tipo juros e multa.
Na regra que vamos utilizar vamos filtrar utilizando a classificação fiscal do item
Ao consultar os tributos do item deste documento, poderemos verificar que ele possui cálculo para os tributos CBS, IBS UF e IBS MUN.
Para que o evento seja gerado o documento precisa estar atualizado no estoque.
No cadastro Cenário Automatização Eventos (html.mcd.cenarioEventoTributos), já havíamos cadastrado o cenário para o evento 211128 para o módulo de recebimento, com várias regras.
Para o documento que lançamos, a geração do evento, utilizará a regra 5, essa regra criamos mais específica, sendo somente para nota de crédito do tipo multa e juros, quando a natureza de operação do documento for igual a "111NCD", que o código do item do documento seja o ".scl" e que a classificação fiscal do item do documento seja igual 17049020.
Informações
Para os eventos do recebimento o campo de finalidade NF-e será permitido utilizar as opções:
- Todos
- NF-e Devolução de mercadoria
- NF-e Nota de Crédito
- NF-e Nota de Débito
O campo de natureza de operação disponível na tela de regras do configurador de regras, será utilizado para filtrar os documentos pelo campo de natureza de operação do documento, não será utilizado o campo de natureza fiscal.
Agora acessamos o programa Agendar Geração Automática de Eventos (html.mcd.agendadorEventoTributos) para efetuar o agendamento da execução rpw, para que sempre que existir um documento que atenda a regra que exemplificamos, gere o evento de forma automática.
Importante
O campo Periodicidade no agendamento impacta no filtro dos documentos, conforme o exemplo abaixo:
Cenário 2004
| Regras do cenário | ||
| 1 | 01/03/2026 | 24/04/2026 |
| 3 | 10/03/2026 | 30/04/2026 |
| 4 | 27/02/2026 | 30/04/2026 |
| 5 | 01/03/2026 | 30/04/2026 |
| 6 | 02/04/2026 | 07/04/2026 |
| 7 | 02/03/2026 | |
Como o agendamento foi de 01/04/2026 até 14/04/2026, o filtro de data das regras ficaram a seguinte:
| Regra | ||
| 1 | 01/04/2026 | 14/04/2026 |
| 3 | 01/04/2026 | 14/04/2026 |
| 4 | 01/04/2026 | 14/04/2026 |
| 5 | 01/04/2026 | 14/04/2026 |
| 7 | 01/04/2026 | 14/04/2026 |
A regra 6 como a data inicial é maior que a data inicial da periodicidade não será enviada para api de negócio.
Após cadastrar o agendamento, o mesmo ficará com status igual aguardando.
Após o término da execução do agendamento RPW, poderemos consultar no programa Eventos tributos - html.mcd.eventoTributos, que o evento foi gerado com a situação não enviado.
Ao detalhar o evento, será possível verificar que o indicador de aceitação foi selecionado a opção "Aceite", na tab "Dados complementares" será possível visualizar as informações do documento fiscal eletrônico (DFE) e no agrupamento "Evento DF-e", será possível verificar o usuário que realizou a inclusão, data e hora da inclusão, que o evento foi gerado automaticamente e utilizou cenário para criação.
Para efetuar a geração do evento 211110 - Solicitação de Apropriação de crédito presumido, lançar documentos que possuam valores de crédito presumido, abaixo vamos detalhar um exemplo com um documento.
Lançamos um documento no recebimento fiscal
Atualizamos o documento e realizou a integração com o módulo de estoque.
Ao consultar os tributos do item deste documento, poderemos verificar que ele possui cálculo do crédito presumido para o tributos CBS e IBS UF.
No cadastro Cenário Automatização Eventos (html.mcd.cenarioEventoTributos), já havíamos cadastrado o cenário para o evento 211110 para o módulo de recebimento.
Também já havíamos cadastrado uma regra para o evento 211110, onde criamos uma regra mais específica, para gerar o evento apenas se os dados do documento possuírem essa configuração:
Informações
Para os eventos do recebimento o campo de finalidade NF-e será permitido utilizar as opções:
- Todos
- NF-e Devolução de mercadoria
- NF-e Nota de Crédito
- NF-e Nota de Débito
O campo de natureza de operação disponível na tela de regras do configurador de regras, será utilizado para filtrar os documentos pelo campo de natureza de operação do documento, não será utilizado o campo de natureza fiscal.
Agora com a regra criada, vamos no Agendar Geração Automática de Eventos (html.mcd.agendadorEventoTributos) efetuar o agendamento da execução rpw, para que sempre que existir um documento que atenda a regra que exemplificamos, gere o evento de forma automática.
Importante
O campo Periodicidade no agendamento impacta no filtro dos documentos, conforme o exemplo abaixo:
Cenário 2003
| Regras do cenário | ||
| 1 | 01/03/2026 | 24/04/2026 |
| 2 | 02/04/2026 | 07/04/2026 |
| 3 | 02/03/2026 | |
Como o agendamento foi de 01/04/2026 até 13/04/2026, o filtro de data das regras ficaram a seguinte:
| Regra | ||
| 1 | 01/04/2026 | 13/04/2026 |
| 3 | 01/04/2026 | 13/04/2026 |
A regra 2 como a data inicial é maior que a data inicial da periodicidade não será enviada para api de negócio.
Após cadastrar o agendamento, o mesmo ficará com status igual aguardando.
Após o término da execução do agendamento RPW, poderemos consultar no programa Eventos tributos - html.mcd.eventoTributos, que o evento foi gerado com a situação não enviado.
Ao acessar o detalhe do evento, poderemos verificar na tab de Itens documento que foi gerado com o item que estava no documento que utilizamos como exemplo.
Na tab dados complementares, será possível visualizar as informações do documento fiscal eletrônico (DFE) e também informações do evento DF-e que indicam o usuário que fez a geração, data e hora de inclusão do evento e que ele foi gerado automaticamente utilizando um cenário.























