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.
- Acesse a transação SOAMANAGER.
- Selecione Web Service Configuration.
- Procure por /TMF/MF_IMPORTEVENTS no campo Object Name da página que será aberta.
- Clique sobre o webservice /TMF/MF_IMPORTEVENTS.

- Clique no botão Open Binding WSDL Configuration.

- 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