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

To report this post you need to login first.

Be the first to leave a comment

You must be Logged on to comment or reply to a post.

Leave a Reply