Financial Management Blogs by SAP
Get financial management insights from blog posts by SAP experts. Find and share tips on how to increase efficiency, reduce risk, and optimize working capital.
cancel
Showing results for 
Search instead for 
Did you mean: 
3,229
Olá,

Sejam bem-vindos, a mais um post de Messaging Framework, uma ferramenta do Tax Declaration Framework (TDF).

Nesse post irei falar sobre os dois webservices disponíveis até agora dentro da ferramenta, que são o MF_ImportEvents e o MF_GetEventData_ESO.

Não entrarei em detalhes de configuração de webservices aqui, mas detalharei algumas informações que são importantes para o uso desses webservices.

MF_ImportEvents

Esse webservice permite fazer o carregamento de qualquer evento dentro do Messaging Framework.

Segue abaixo o passo-a-passo de como encontrar as informações do webservice.

  1. Acesse a transação SOAMANAGER.

  2. Selecione Web Service Configuration.

  3. Procure por /TMF/MF_IMPORTEVENTS no campo Object Name da página que será aberta.

  4. Clique sobre o webservice /TMF/MF_IMPORTEVENTS.

  5. Clique no botão Open Binding WSDL Configuration.

  6. Aqui é possível fazer o download do arquivo WSDL e obter a URL para acesso.



Essas informações serão úteis na configuração da implementação de seu acesso ao webservice.

O webservice MF_ImportEvents aceita qualquer evento, seja de eSocial, REINF ou e-Financeira. A estrutura do evento a ser enviado deve seguir a mesma estrutura dos arquivos enviados ao governo.

O Messaging Framework identificará o evento e enviará para o programa correto automaticamente (eSocial, REINF ou e-Financeira).

Segue um exemplo de estrutura de um arquivo XML de entrada:



Como saída, haverá um XML com uma mensagem de sucesso ou erro juntamente com o ID usado na criação:



Essas são as informações necessárias para o uso desse webservice.

O evento então já poderá ser visto no cockpit da ferramenta.

Como já visto em postagens anteriores, existem algumas outras maneiras de fazer o carregamento de eventos para o Messaging Framework.

Para carregamentos por Excel, por favor, verifiquem o link abaixo:

https://blogs.sap.com/2017/04/17/tdf-esocial-como-criar-eventos-usando-planilhas-de-excel/

 

MF_GetEventData_ESO

Esse webservice permite fazer a extração dos dados de eventos presentes no Messaging Framework.

Os passos para encontrar e utilizar este webservice são os mesmos que expliquei acima neste post, mas procure por /TMF/MF_GETEVENTDATA_ESO no passo 3. Toda a informação necessária estará disponível como no exemplo anterior.

Atenção, o webservice MF_GetEventData_ESO permite extrair as informações apenas de eventos do eSocial.

A entrada usada no XML é uma procura por evento ou eventos existentes na ferramenta.

Você pode fazer essa procura pelo ID do evento (<byIdEvento>), para uma busca específica, ou pelo tipo de evento (<byEventType>), para buscar por um grupo de eventos.

Você também pode filtrar por eventos ativos ou não ativos (<eventActive>).

Para buscas mais específicas, utilize os IDs na busca; IDs do evento ou os gerados pelo governo.

Para buscas genéricas, utilize os campos da estrutura /TMF/EVENT_TYPE como parâmetro de busca.

Exemplo de entrada:



Como saída do webservice MF_GetEventData_ESO, será gerado um XML com as informações de cada evento dentro da seleção feita.

As informações serão as contidas dentro da estrutura /TMF/EVENTS_DATA.

Saída:



Em caso de erro um log com uma mensagem de erro será enviada.

Farei um outro post com mais informações sobre os parâmetros de entrada e saída desses webservices.

Você encontra mais informações sobre o Messaging Framework em:

Em caso de dúvidas e/ou sugestões, por favor deixem comentários abaixo.

Espero ter ajudado e até a próxima!

Felipe Prates Carvalho

Time de Desenvolvimento do TDF
17 Comments