Skip to Content
Product Information

TDF: Como realizar a carga de eventos de sistemas legados no TDF Messaging Framework

(Scroll down for the English version, which is proudly presented by the SAP Translation Portal)

 

Olá pessoal,

Continuando a série de blogs posts do TDF, neste aqui você vai descobrir como realizar a carga de eventos criados em sistemas externos para dentro do TDF Messaging Framework.

Para realizar a tarefa de carregar esses eventos legados para o TDF Messaging Framework, você vai utilizar o serviço MF – Importing Events (/TMF/MF_ImportEvents).

Quais as características dessa atualização?

  • É possível carregar eventos legados para todas as obrigações suportadas pelo TDF Messaging Framework: eSocial, EFD-Reinf e e-Financeira.
  • Para carregar um evento legado, você precisa informar um número de recibo aceito pelo governo.
  • Este evento não será processado pela ferramenta Flow Execution (/TMF/MF_FLOW_EXEC), pois não precisará passar por nenhuma etapa de validação.
  • Esta atualização não impacta nenhum cenário já existente nos clientes.

Carregando um evento legado para o TDF Messaging Framework

A estrutura geral de entrada do serviço MF – Import Events, onde é informado o evento que será carregado, foi alterada. Nessa estrutura adicionamos o grupo <legacyEvent> e dentro dele a tag <nrRecibo>, como você pode ver no exemplo abaixo:

Estrutura de exemplo para entrada de eventos legados usando o MF – Import Events

As tags <legacyEvent> e <nrRecibo> são opcionais, preenchidas apenas para realizar a carga de eventos de sistema legado. Quando você informa um número de recibo, o serviço entende que será realizado a carga de um evento legado para a nossa solução.

No exemplo abaixo, iremos carregar o evento S-1005 do eSocial, que havia sido criado em uma solução não TDF.

Exemplo de implementação do serviço de importação de eventos para o TDF Messaging Framework

Caso o evento tenha sido carregado, você receberá uma mensagem de sucesso:

Evento foi importado com sucesso no TDF Messaging Framework

Visualizando o evento carregado no TDF Messaging Framework

Para esta funcionalidade, foi criado um novo passo exclusivo para eventos legados, o que facilita a busca dos mesmos no TDF Messaging Framework.

Para visualizar o evento, você pode realizar os seguintes filtros:

  • Filtrar pelo campo ID do evento importado e/ou
  • Filtrar pelo campo Status igual Aceito pelo Governo e/ou
  • Filtrar pelo campo Step igual Importado de sistema legado.

Visualizando evento importado no Messaging Framework

Na visualização dos eventos agora você também pode ver qual foi a fonte de um evento no TDF Messaging Framework.

Para visualizar essa informação, selecione o evento e clique na aba Additional Info, lá será possível observar o campo fonte conforme imagem abaixo:

Visualizando campo fonte que determina a origem do evento

O campo fonte possui os seguintes valores:

Fonte Significado
Desconhecida Não foi possível determinar a origem do evento
Ferramenta de importação do Excel Evento importado via Gerar planilhas Excel para disponibilização de evento
EFD-Reinf Evento criado através do EFD-Reinf Report
Web Service Evento importado via Web Service (serviço MF – Import Events)
Retorno do Governo Eventos de retorno do Governo (somente não legados)

Eventos não suportados

Não é possível carregar os eventos de retorno legados de nenhuma das obrigações eSocial, EFD-Reinf e e-Financeira.

Recomendações

Deve-se realizar a carga de somente a última versão de um evento. Por exemplo:

Caso você tenha três eventos R-1000 do EFD-Reinf ativos no seu sistema legado, referentes a um mesmo período específico, recomenda-se que você importe apenas o último evento gerado e enviado para o governo.

Outro exemplo, você pode ter dois eventos S-1200 do eSocial para um determinados mês, um é o arquivo original e outro é o arquivos retificado, ambos enviados para o governo. Nesse cenário, recomenda-se que você importe também apenas o último evento gerado e enviado para o governo.

Pré-requisitos

Você deve aplicar as SAP Notes:

[TDF SP14] Note 124: MF – Implementation of PI Objects for SAP Note 2932574

[TDF SP14] Note 125: MF – Proxies for Webservices Updates on Legacy Import

[TDF SP14] Note 126: MF – Webservices Updates on Legacy Import

Para mais informações sobre os relatórios eSocial, EFD-Reinf, e-Financeira e o Messaging Framework, veja os seguintes blog posts e a página do TDF no SAP Help Portal:

Gostaríamos muito de saber o seu feedback. Deixe seu comentário abaixo caso tenha alguma dúvida ou sugestão para um próximo post. E não esqueça de seguir a tag SAP Tax Declaration Framework for Brazil aqui na SAP Community para ficar ligado nas últimas notícias sobre o Tax Declaration Framework (TDF).

Além dos comentários, você pode entrar em contato conosco através da plataforma Customer Influence. Lá você pode propor ideias para melhorar o nosso produto, votar em outras ideias já lançadas e acompanhar ideias em implementação.

Até a próxima!

Rodolfo Felipe Celante

Time de desenvolvimento do TDF

#SAPGoGlobal #SAPLocalization

 

***

 

TDF: How to Load Events from Legacy Systems into TDF Messaging Framework

 

Hello guys,

Continuing the series of TDF blogs posts, in this one you will find out how to load events created in external systems into TDF Messaging Framework.

To perform the task of loading these legacy events into TDF Messaging Framework, you’ll use the MF – Importing Events (/TMF/MF_ImportEvents) service.

What are the characteristics of this update?

  • It’s possible to load legacy events for all obligations supported by the TDF Messaging Framework: eSocial, EFD-Reinf and e-Financeira.
  • To upload a legacy event, you need to enter a receipt number accepted by the government.
  • This event won’t be processed by the Flow Execution (/TMF/MF_FLOW_EXEC) tool, as it doesn’t need to go through any validation steps.
  • This update does not impact any existing customer scenarios.

Loading a Legacy Event to TDF Messaging Framework

The general input structure of the MF – Import Events service, where the event that will be uploaded is informed, has been changed. In this structure we have added the <legacyEvent> group and within it the <nrReceipt> tag, as you can see in the example below:

Example structure for the load of legacy events using MF

The <legacyEvent> and <nrReceipt> tags are optional, filled in only for the load of events from legacy systems. When you enter a receipt number, the service understands that a legacy event will be uploaded to our solution.

In the example below, we will load the eSocial event S-1005, which was created in a non-TDF solution.

Implementation example of the importing events service for TDF Messaging Framework

If the event was uploaded, you’ll receive a success message:

Event was successfully imported into TDF Messaging Framework

Viewing the Uploaded Event in TDF Messaging Framework

For this functionality, a new step was created exclusively for legacy events, which facilitates the search in the TDF Messaging Framework.

To view the event, you can use the following filters:

  • Filter by the imported Event ID and/or
  • Filter by the Status field equal to Accepted by Government and/or
  • Filter by the Step field equal to Imported from Legacy System.

Viewing the imported event in Messaging Framework

In the events preview you can now also see the source of an event in TDF Messaging Framework.

To view this information, select the event and click on the Additional Info tab, there you can see the Source field as shown below:

The source field determines the origin of an event

The Source field has the following values:

Source Meaning
Unknown It wasn’t possible to determine the origin of the event
Excel sheets tool Event imported via Generate Excel Sheets for Event Staging
EFD-Reinf Event created via EFD-Reinf Report
Web Service Event imported via Web Service (MF – Import Events service)
Government return Government return events (non-legacy only)

Events not supported

It’s not possible to load the legacy return events of any of the eSocial, EFD-Reinf and e-Financeira obligations.

Recommendations

Only the latest version of an event should be loaded. For example:

If you have three active EFD-Reinf R-1000 events in your legacy system for the same specific period, we recommend that you import only the last event generated and sent to the government.

Another example, you can have two eSocial events S-1200 for a given month, one is the original file and the other is the rectified archive, both sent to the government. In this scenario, we recommend that you also import only the last event generated and sent to the government.

Prerequisites

You must apply the following SAP Notes:

[TDF SP14] Note 124: MF – Implementation of PI Objects for SAP Note 2932574

[TDF SP14] Note 125: MF – Proxies for Webservices Updates on Legacy Import

[TDF SP14] Note 126: MF – Webservices Updates on Legacy Import

For more information about the eSocial, EFD-Reinf, e-Financeira reports and the Messaging Framework solution, see the following blog posts and the TDF page on SAP Help Portal:

Feel free to leave your feedback, comment or question below. And don’t forget to follow the SAP Tax Declaration Framework for Brazil tag to stay tuned on Tax Declaration Framework latest news.

In addition to the comments, you can contact us through the Customer Influence platform. There you can propose ideas to improve our product, vote on other ideas that have already been posted and track ideas in implementation.

 

See you next time!

Rodolfo Felipe Celante

TDF Development Team

#SAPGoGlobal #SAPLocalization

Be the first to leave a comment
You must be Logged on to comment or reply to a post.