01. DADOS GERAIS

Produto:

Linha de Produto:

Segmento:

Módulo:

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.

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.


O campo Periodicidade no agendamento impacta no filtro dos documentos, conforme o exemplo abaixo:

Cenário 2004

Regras do cenário
101/03/202624/04/2026
310/03/202630/04/2026
427/02/202630/04/2026
501/03/202630/04/2026
602/04/202607/04/2026
702/03/2026

Como o agendamento foi de 01/04/2026 até 14/04/2026, o filtro de data das regras ficaram a seguinte:

Regra
101/04/202614/04/2026
301/04/202614/04/2026
401/04/202614/04/2026
501/04/202614/04/2026
701/04/202614/04/2026

A regra 6 como é menor que a data de periodicidade não será enviada para api de negócio.

Periodicidade será 

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:

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.

O campo Periodicidade no agendamento impacta no filtro dos documentos, conforme o exemplo abaixo:

Cenário 2003

Regras do cenário
101/03/202624/04/2026
202/04/202607/04/2026
302/03/2026

Como o agendamento foi de 01/04/2026 até 13/04/2026, o filtro de data das regras ficaram a seguinte:

Regra
101/04/202613/04/2026
301/04/202613/04/2026

A regra 2 como é menor que a data de periodicidade não será enviada para api de negócio.

Após cadastrar o agendamento, o agendamento 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.



07. ASSUNTOS RELACIONADOS

DT RT - Configurador e Agendador para Automatização dos Eventos