Tempo aproximado para leitura: 00:05:20 min
Dúvida
Como realizar a geração em lote dos Eventos Tributos?
Ambiente
Cross Segmentos - TOTVS Backoffice (Linha Datasul) - Obrigações Fiscais (MOF) – A partir das versões: 12.1.2507.15, 12.1.2511.9 e 12.1.2603.3
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 automática desses processos.
1. Cenários Automatização Eventos (html.mcd.cenarioEventoTributos)
Esse programa oferece autonomia na parametrização da busca de documentos eletrônicos, permitindo ajustes conforme o tipo de evento e as particularidades de cada estabelecimento.
Na listagem das regras, é possível editar e duplicar o cenário existente, para assim avaliar necessidade de correção ou remoção dos cenários.
Ainda na listagem, é possível visualizar o histórico de atividade como inclusão, com a opção de filtrar as atividades por meio do botão Busca avançada, filtrando por data inicial e final da alteração, usuário e cenário.
1.1 Cadastro/Manutenção de regras:
Para cada cenário pode existe várias regras, pois o sistema oferece autonomia na configuração de buscas de documentos eletrônicos, adaptando-se às necessidades de cada evento e estabelecimento.
As colunas da listagem de regras são alteradas conforme o módulo que foi selecionado: Ativo Fixo, Recebimento, Faturamento e Obrigações Fiscais.
Existem alguns comportamentos a serem destacados, na tela de inclusão e edição das regras :
O campo Regra é utilizado para controle interno e não pode ser alterado. Seu valor é calculado automaticamente pelo sistema.
O campo Tipo de Nota Fiscal de Crédito e Débito só será habilitado caso a Finalidade NF-e escolhida seja NF-e Nota de Crédito ou NF-e Nota de Débito. As opções do campo são apresentadas conforme o tipo que foi escolhido.
A edição de regra tem o mesmo comportamento da inclusão, com a diferença de que o campo Data Inicial ficará desabilitado. A edição pode ser acessada pelo ícone de lápis presente na listagem de regras.
2. Agendar Geração Automática de Eventos (html.mcd.agendadorEventoTributos)
Através do programa: html.mcd.agendadorEventoTributos, é possível realizar a geração automática dos eventos, seguindo os cenários e regras pré-definidos, para os cenários que estiverem com status "ativo". Na listagem é apresentado a lista de todos os agendamentos do tipo Oficial, contendo a ação de eliminar o agendamento.
2.1 Botão Novo Agendamento:
O agendamento oferece dois tipos de execução, e para cada tipo de execução, os parâmetros da tela se adaptam:
No modo Prévia, não é realizado a efetivação e a criação dos eventos e deve ser usada para conferência e validação, dos documentos eletrônicos encontrados e dos eventos gerados.:
O campo Evento possui, no momento, a possibilidade de geração para três eventos: 211110, 211128 e 211130;
A data inicial e final deve ser no máximo um período de 1 mês, do contrário ocorrerá a mensagem de erro "O intervalo entre a Data Inicial e Data Final não pode ser superior a 1 mês".
Já no modo oficial, efetiva a criação dos eventos em lote e cria o agendamento na listagem da tela principal:
Poderá ser feito apenas um agendamento Oficial por Evento e Estabelecimento;
- Para criar novo agendamento oficial, para um mesmo Evento e Estabelecimento já criado, o agendamento oficial deve ser primeiramente eliminado e então poderá criar um novo agendamento.
2.2 Botão Atualizar:
Cada registro de agendamento na listagem há um um Status. Quando o agendamento está com o Status Aguardando na listagem, o botão Atualizar pode ser acionado para conferência do Status do pedido, e se o pedido já foi processado o status é atualizado na listagem, podendo ficar como Falha ou Concluído.
2.3 Botão Monitor de Pedidos:
É um facilitador para a consultar os pedidos agendados no programa Monitor Pedidos Execução (HTML).
O monitor será aberto já com o filtro aplicado, buscando pelo programa gerador dos eventos que é "cdGeraEventosAuto",
2.4 Botão Relatório excel:
Após cada pedido processado, será gerado uma planilha para acompanhamento no diretório SPOOL do servidor RPW, um relatório excel com o nome "ConfDoctosEventosAuto+Ano+Mês+Dia+_+Hora+Min+Segundo".
Exemplo: ConfDoctosEventosAuto20260316_111101.xls
Pontos importantes sobre o processamento para geração dos eventos:
-
Ao iniciar o processamento o produto irá buscar o cenário ativo e regras, de acordo com os parâmetros informados em tela;
A data inicial da regra deve ser menor/igual a data inicial da geração. Se a data final da regra for diferente de branco, e se a data final da regra for menor que a inicial da geração, então a regra deve ser desconsiderada.
-
Após localizar todas as regras, respeitando as datas, então as regras serão enviadas para para a API do módulo responsável.
O módulo responsável é o que foi informando durante o cadastro de cenário para o Evento em questão.
-
A API do módulo responsável, ou API da área, irá buscar todos os documentos eletrônicos, e itens do documentos dependendo do evento, para a geração dos eventos;
As notas fiscais eletrônicas devem estar lançadas dentro da base Datasul, para que sejam consideradas na busca da API da área.
Se o tipo de geração for oficial, a criação dos eventos será efetivada na base, podendo ser consultados no programa Evento Tributos (html.mcd.eventoTributos);
Será gerado a planilha de conferência no diretório SPOOL do servidor RPW, contendo a listagem de erro, documentos, itens do documento, eventos e parâmetros.
Inconsistências
Poderá ser apresentado mensagens de inconsistências, e todas as mensagens serão listadas na aba Inconsistências da planilha, garantindo a segurança da geração dos eventos em lote durante o processamento.
3. Evento Tributos (html.mcd.eventoTributos)
Para garantir a segurança na integração entre parceiros e o produto Datasul, foi implementada uma fila de controle de envio. Esta fila assegura que a ordem obrigatória das transmissões seja rigorosamente respeitada durante o processamento de eventos em lote.
É permitido criar múltiplas sequências para um mesmo documento eletrônico e código de evento, onde o ERP realiza o controle automático, transmitindo-as individualmente em ordem crescente.
Comportamento da Fila de Controle
O processamento segue uma lógica de interdependência, conforme detalhado abaixo:
Transmissão Inicial: Ao enviar um ou mais eventos, o sistema identifica a menor sequência disponível e transmite seu XML aos parceiros (TSS, TPF ou TC2). Esta sequência assume o status "Enviado", enquanto as demais permanecem com o status "Em fila", aguardando o processamento da anterior.
-
Fluxo de Continuidade: O envio é estritamente unitário (uma sequência por vez). O gatilho para a próxima transmissão ocorre apenas após o retorno da SEFAZ:
Se o evento em trânsito for "Autorizado" ou "Rejeitado", o produto identifica o encerramento do ciclo atual.
Automaticamente, a próxima sequência na fila (em ordem crescente) é disparada e atualizada para o status "Enviado".
Saiba Mais
DT Configurador e Gerador de Eventos para NF-e
Reforma Tributária
Comunica Fiscal Datasul
0 Comentários