1.Sobre
Os eventos da NF-e (Nota Fiscal Eletrônica) são registros feitos após a emissão da nota para documentar qualquer ocorrência relevante ao longo do seu processamento. Eles servem para que o autor informe à Secretaria da Fazenda (SEFAZ) atualizações ou complementos importantes, mantendo a operação fiscal íntegra e rastreável.
Esses registros incluem desde ajustes simples até situações operacionais, como a confirmação de entrega ou a comunicação de tentativa de entrega sem sucesso. Cada tipo de evento possui uma finalidade definida e deve ser enviado conforme as normas estabelecidas pela legislação vigente. Quando utilizados corretamente, os eventos tornam o processo mais transparente, fortalecem a segurança jurídica e aprimoram a comunicação entre as empresas e o fisco.
🔄 Mudança de Paradigma
Os Eventos sinalizam a transição de um modelo em que o contribuinte apurava o imposto para um modelo em que o Fisco pré-calcula o valor devido. Com base nessas informações detalhadas e padronizadas, o contribuinte passa a ter a responsabilidade de conferir o cálculo realizado pelo órgão fiscal.
O envio correto e a validação desses eventos são, portanto, requisitos técnicos fundamentais para a manutenção da conformidade fiscal da empresa no novo regime tributário.
Na linha Datasul, a criação dos eventos é centralizada no programa html.mcd.eventos (Evento Tributos), uma tela de monitoração dos Eventos de Tributos que também permite a inclusão manual desses eventos.
O fluxo de criação dos eventos nesta rotina é realizado da seguinte forma :
html.mcd.eventos (Programa que deve ser acessado para criação de um evento manual)
Clicar em 'Novo' (Inicia o processo de criação de um novo evento)
Escolher Tipo de Evento (Seleciona o tipo do evento, como 112130, 211128, etc.)
Inserir Dados do Evento (Preenche as informações específicas exigidas para o tipo de evento escolhido)
Transmitir Evento à Sefaz (Envio do XML do evento para validação e registro no ambiente da Secretaria da Fazenda)
Retorno Evento (Recebimento da resposta da SEFAZ, indicando se o evento foi aceito ou rejeitado)
O documento de referência com o detalhamento da tela html.mcd.eventos pode ser consultado em DR - Evento tributos - html.mcd.eventoTributos.
2.Configurações
Para que seja possível visualizar, cadastrar e transmitir novos eventos, são necessárias algumas configurações no sistema: a atualização do menu - módulo MCD - para liberar acesso, o cadastro de parâmetros na rotina html.mcd.paramEventos, e a configuração do transmissor no CD0360.
Para disponibilizar os novos programas de eventos, é necessário atualizar o menu do Datasul, importando o arquivo de menu men_mcd.d atualizado. Para atualizar o menu de um módulo do Datasul, acesse o programa Importação Menu Datasul - men706aa e selecione a opção Por Arquivo. No campo Arquivo, busque ou informe o nome do arquivo de menu do módulo à ser importado.
Os arquivos de menu do Datasul são expedidos na pasta ...\...\fnd\univdata.
Após a atualização do menu, é necessário configurar as permissões às novas telas de Parâmetros (html.mcd.paramEventos) e Eventos (html.mcd.eventos) no programa bas_prog_dtsul > Menu > Segurança
No programa html.mcd.paramEventoTributos - Parâmetros Eventos Tributos é importante cadastrar alguns atributos padrão que serão utilizados automaticamente durante a digitação ou geração do XML dos eventos da Reforma Tributária.
A descrição desses atributos, bem como de todos os campos da tela estão disponíveis em DR - Parâmetros evento tributos - html.mcd.paramEventoTributos.
Além disso, está disponível em Exemplo - Inclusão Tela Parâmetros de Eventos, um exemplo ilustrativo de um cadastro nesta tela.
A parametrização necessária para o envio do XML deve ser realizada no programa Parâmetros de Integração do Estabelecimento (CD0360).
No campo “Eventos dos Tributos”, o usuário deve informar qual parceiro TOTVS será utilizado para o envio dos eventos — TSS, TPF ou Neogrid, conforme o serviço contratado pela empresa.
3.Detalhamento dos Eventos
A seguir, são apresentados os objetivos de cada evento da NF-e, juntamente com os campos específicos existentes na rotina html.mcd.eventos.
Os demais campos da tela possuem detalhamento completo no documento de referência DR - Evento tributos - html.mcd.eventoTributos..
Os links para os documentos técnicos de cada evento também estão disponíveis nas respectivas seções de detalhamento.
Informações obrigatórias no cadastro de qualquer evento
Para cadastrar um evento, o usuário deve informar obrigatoriamente:
Tipo de evento
Módulo de origem
Chave de acesso do documento
O sistema busca a chave conforme o módulo de origem:
Faturamento: tabela nota-fiscal
Recebimento: tabela docum-est
Obrigações Fiscais: tabela doc-fiscal
Quando o módulo de origem for Não informado, o lookup da chave não será carregado, e o usuário deverá digitá-la manualmente.
Essa opção deve ser utilizada quando o documento ainda não está implantado no sistema.
Autor do evento
Apenas para o evento 211120 o usuário deve informar o autor, pois este evento admite dois autores possíveis.
Nos demais eventos, o autor já é sugerido automaticamente pelo sistema.
Cadastro de eventos com Módulo de Origem = “Não informado”
Quando o módulo de origem for definido como Não informado:
Não será possível utilizar a função Gerar Itens;
Todos os dados da aba Itens do Documento deverão ser preenchidos manualmente;
Além das informações obrigatórias citadas acima, o usuário também deverá informar:
Estabelecimento
Emitente
Essas informações adicionais, bem como os campos específicos de cada evento, estão detalhadas individualmente nas seções subsequentes deste guia.
4.Transmissão dos Eventos
Após o cadastro, inicia-se a etapa de transmissão dos eventos. No ambiente TOTVS, essa operação também é realizada na tela de monitoramento de eventos (html.mcd.eventos). Nessa tela, o usuário gera o XML e realiza a transmissão, que pode ocorrer por diferentes mecanismos, conforme a arquitetura adotada pelo cliente e o transmissor configurado no ambiente operacional.
Atualmente, a plataforma Datasul oferece integração com três modalidades de transmissão:
TSS - Totvs Service Soa: Serviço TOTVS responsável pela recepção, enfileiramento e transmissão dos eventos para os ambientes autorizadores. Mais informações a respeito podem ser consultados aqui Transmissão de Documentos Eletrônicos.
TPF – TOTVS Processos Fiscais: Plataforma de integração fiscal que centraliza a comunicação de documentos eletrônicos, permitindo controle, auditoria e gerenciamento de mensagens, atendendo empresas que operam com múltiplos sistemas.
TC2 – Conector Neogrid: Utilizado por clientes que realizam a transmissão via infraestrutura da Neogrid, permitindo integração com redes varejistas e outras plataformas externas que atuam como intermediárias no processo autorizador.
Visão Geral do Fluxo de Transmissão
Apesar das diferenças entre as plataformas, o fluxo padrão permanece similar:
Cadastro e parametrização do evento no ERP (rotinas html.mcd.paramEventos e html.mcd.Eventos);
Geração do XML, segundo a versão de layout vigente;
Seleção automática do transmissor, conforme configuração do estabelecimento ou do evento (deve ser realizado no CD0360 vide aba Configurações nessa página);
Envio do XML ao transmissor (TSS, TPF ou TC2);
Processamento pelo transmissor, incluindo validações, assinatura e encaminhamento;
Retorno do ambiente autorizador, contendo:
protocolo,
autorização,
rejeição,
ou pendência de processamento;
Atualização do status do evento no Datasul (html.mcd.eventos), permitindo nova tentativa, ajustes ou continuidade do processo.
Nesta página, é possível consultar um exemplo de transmissão de eventos na tela html.mcd.eventos: Exemplo - Inclusão/Transmissão/Cancelamento - Tela Evento Tributos - Evento 211124 .
Os documentos técnicos da transmissão dos eventos podem ser consultados em:
Na página MOC Online podem ser consultadas as descrições e os motivos de rejeição dos eventos. Nesse Manual de Orientação ao Contribuinte também estão disponíveis os detalhamentos dos leiautes dos eventos.
Pontos de Atenção
A versão de layout utilizada deve corresponder à prevista pela NT vigente.
- A parametrização no TSS, TPF ou TC2 deve estar concluída antes da primeira tentativa de transmissão.
Apenas é possível reenviar um evento se não houver outro com status "Não Autorizado" para a mesma chave.
O retorno do transmissor precisa ser monitorado para garantir consistência das autorizações.
- O processo de envio/retorno de todos os eventos é igual, o que diferencia é a parte do xml denominada <detevento> e particularidade de cada transmissor.
ASSUNTOS RELACIONADOS
- Espaço Legislação
- Reforma Tributária Datasul
- Cronograma Detalhado - Reforma Tributária Datasul
- DR - Evento tributos - html.mcd.eventoTributos
- DR - Parâmetros evento tributos - html.mcd.paramEventoTributos

