Skip to Content

TDF – Messaging Framework: Webservices

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
You must be Logged on to comment or reply to a post.
  • Olá Felipe,

    Mais alguma atualização sobre o assunto?

    Pode-se considerar que os mesmos pacotes XML de e-Social que seriam enviados ao governo diretamente podem ser enviados ao TDF? Alguma ressalva?

    Abraço,

    Leandro Mengue

     

    • Oi Leandro,

      Desculpe a demora em responder.

      Não sei se entendi bem teu questionamento, em breve haverão mais posts sobre o Messaging Framework e os proxys. Mas quanto aos pacotes XML, se a pergunta é, se eu posso ter um arquivo que foi “montado” fora do MF e importa-lo, sim isso é possível. E é exatamente do que esse post trata superficialmente.

      Era isso?

      Sempre nos procure se alguma dúvida persistir.

      Muito obrigado,

      Felipe Carvalho

    • Oi Janfer,

      Não há integração via SOA Manager, mas sim através de RFC e webservices. Para mais informações por favor verifique através das SAP Notes: HCM – 2475372 e TDF – 2469919.

      Att,

      Felipe

  • Bom dia, Felipe !

    Primeira excelente post, muito útil.

     

    Nos estamos utilizando o TDF para envio do Reinf, conseguimos gerar os eventos através da solução dentro do TDF, assinar, adicionar ao lote, etc. Entretanto ao enviar para a produção restrita estamos com erro de mensangeria dentro do TDF.

    Estamos utilizando o “consumer proxy /TMF/CO_R_11_REINF_BATCH_SEN”,  poderia informar se haverá uma nota de webservices como foi feito como e-social para ajustes no soamanager?

     

    Obrigado

     

     

    • Oi Jânio,

      Fico feliz que o post tenha ajudado.

      Quanto ao envio para produção restrita, qual erro o que a mensageiria está apresentando? Chegou a abrir algum incidente? Os webservices de REINF 1.1 para envio ao governo deveriam estar funcionando.

      Lembrando que o REINF não envia via SOAMANAGER , o REINF usa o PI para fazer essa comunicação.

      Esse post tem uma explicação sobre a configuração do PI:

      https://blogs.sap.com/2017/10/23/tdf-messaging-framework-integracao-com-o-governo/

      Caso tenha alguma dúvida, não hesite em nos perguntar.

      Att,

      Felipe Carvalho

  • Obrigado Felipe,

    Sim abrimos um chamado para este erro.

    Quando vai comunicar com a produção restrita e que temos o erro, inclusive tinhamos esta duvida, mas ate vimo o seu post, fizemos um teste dentro do /TMF/COCKPIT_REINF e monitoramos o mesmo chegou chegou a comunicar com o governo aceitando, mas por dentro do cockpit do reinf retorna erro 403 forbiden.

    Dentro do soamanager estamos consumido o serviço /TMF/CO_R_11_REINF11_BATCH_SEN

     

  • Olã Felipe

    Desculpe a pergunta mas no nosso caso o que realmente esta faltando no projeto e somente esta comunicação com o governo

    O soamanger seria no nosso entender somente para a configuração do serviços (webservices) correto ? sendo esta comunicação toda via Webservices. Como não tinhamos os WSDL do reinf, utilizamos no transporting settings via URL, onde esta indo na RFB mas o servidor esta negando o consumo, emitindo erro o 403 – Forbiden.

     

    Obrigado.

     

     

     

    • Oi Jânio,

      Eu usei o exemplo de SOAMANAGER nesse post apenas para achar o caminho para o arquivo WSDL(pode ser achado diretamente nos objetos do sistema também), a configuração do webservice é toda pelo PI. Tanto é que é possível usar outras ferramentas de SOAP(não exclusivamente o SOAMANAGER) para trabalhar com os webservices.

      Para achar o WSDL do REINF vá até o objeto “/TMF/CO_R_11_REINF11_BATCH_SEN” no sistema e selecione a aba “WSDL”.

      E para esse erro eu realmente aconselho esperar alguma resposta no incidente criado, pois está um tanto genérico.

       

      Att,

       

      Felipe Prates Carvalho

  • Olá Felipe, excelentes as suas explicações e conseguimos fazer a comunicação com a RFB para o Reinf  (layout 1.1). Entretanto apos a aplicação da nota 2556637 para o layout 1.2 não esta mais comunicando com a RFB. Após algumas pesquisa porque o erro de lote, constatamos que a mensageiria somente esta prevista para o layout 1.1

    Tem alguma previsão para a mensageiria para o layout 1.2 para o XI/PI/PO ?

    Acredito que talvez deva ter um novo “proxy consumer” para o layout 1.2 ?

     

    Obrigado.

    • Oi Jânio,

      Obrigado pelo feedback.

      Sobre a nota 2556637. O REINF 1.2 ainda não é suportado pelo governo, portanto a comunicação não vai funcionar. Por isso o Messaging Framework dá a opção de poder trabalhar tanto com a  versão 1.1 e 1.2.

      Att,

      Felipe Prates Carvalho

  • Oi Felipe,

    Quando comentei o REINF 1.2 foi para a versão do layout. Apos a aplicação da nota referida começaram os erros de Versão do lote invalida. Deve ser utilizada a versão 1.02.00, analisando o xml gerado esta com a nova versão http://www.reinf.esocial.gov.br/schemas/evtInfoContribuinte/V1_02_00

    e dentro do PI/PO não localizamos nota que altera para este novo schema.

    Obrigado

     

    Ps.: Desculpe – me ficar lhe perguntando o que pode ser básico mas infelizmente um erro que já tinha solucionado voltou.

     

     

    • Oi Jânio,

      Não peça desculpas, todas as dúvidas são sempre bem vindas.

      Sim, esse nova versão será disponibilizada apenas quando o governo estiver aceitando a versão 1.2. Até lá não temos previsão para atualização.

      Att,

      Felipe

        • Oi Rodrigo,

          Em breve uma nota da SAP estará disponível para comunicação com o 1.2, ainda não há uma data prevista para o lançamento mas o desenvolvimento já está adiantado e não deve demorar.

          Att,

          Felipe

           

        • Oi Rodrigo,

          As seguintes notas foram disponibilizadas para atualizar o PI:

          2573769 – [TDF SP10] MF – Implementation of PI Objects for SAP Note 2572427

          2572700 – [TDF SP10] MF – Automatic Implementation of Data Dictionary Objects for SAP Note 2572427

          2572427 – [TDF SP10] MF – Corrections for EFD-Reinf Layout 1.2 and Webservice

           

          Espero que ajude.

           

          Att,

           

          Felipe

  • Bom dia Felipe,

     

    Estamos tentando utilizar este WebServer para importar no TDF os eventos de medicina e saúde que são gerados pelo nosso sistema legado. Fizemos todas as configurações apontadas referentes ao SOAMANAGER e PI, mas, quando tentamos importar um XML do evento 2230 por exemplo, é retornado um XML no nosso PI (que é quem esta disponibilizando o XML) com o texto: “No Import configuration found for event evtAfastTemp”.

    Atualmente estamos gerando via ECC este evento (2230), e enviando via TDF normalmente, mas, precisamos que a geração deste evento seja no nosso sistema de medicina, e o TDF importe o XML e faça todo o processo de mensageiria até o governo.

    Você saberia me dizer o que poderia estar acontecendo ?

     

    Desde já agradeço a ajuda,

    Ilton M. Oliveira Junior

    Consultor HCM.