(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