TDF – Messaging Framework: Como criar eventos usando planilhas de Excel

[karlareis]

Olá pessoal,

Neste post, vou falar sobre a funcionalidade disponível no Messaging Framework, ferramenta do Tax Declaration Framework (TDF), que permite criar eventos para o eSocial.

Essa ferramenta fornece uma planilha de Excel na qual os dados de entrada podem ser cadastrados manualmente e depois importados como eventos para o sistema.

Geração da planilha de Excel para entrada de dados

1. Acesse a transação /TMF/SHEET_GEN_ESO, que pode ser encontrada no caminho abaixo:

2. Selecione a versão do leiaute para qual você precisa gerar os eventos.



3. Selecione os tipos de eventos para os quais você precisa criar as entradas.

O sistema exibe apenas os eventos para o leiaute que você selecionou. Aqui você tem a opção de selecionar apenas um tipo de evento ou vários dentro de uma série de tipos. Se você selecionar mais de um tipo de evento, o programa criará um arquivo Excel com uma planilha para cada tipo de evento presente na seleção.



4. Selecione o nome do arquivo e o local em que deseja salvá-lo.

5. Execute o programa.

Preenchimento da planilha de Excel

O preenchimento da planilha é uma parte importante do processo, pois os campos devem estar inteiramente preenchidos, com as informações corretas e de acordo com os guias do governo.

O arquivo apresenta algumas dicas logo acima dos campos a serem preenchidos, nas linhas marcadas como “==>HINTS”. Essas dicas possuem informações como formato de data e entradas possíveis de um campo, entre outras.

Exemplo de arquivo:



Não entrarei em detalhes sobre o preenchimento da planilha, pois pode variar de acordo com o evento.

Upload das informações para o sistema

Após ter todas as entradas prontas, você deve enviar o arquivo para o sistema.

Para efetuar o envio do arquivo, siga os passos abaixo:

1. Acesse a transação /TMF/IMPEXL, que pode ser encontrada no caminho abaixo:

2. Clique em Browse para selecionar o arquivo que você criou e preencheu.

3. Selecione o cliente (mandante) para o qual os dados são válidos.

4. Selecione a opção “Running in test mode”(Rodar em modo de teste), pois o serviço faz uma validação rápida dos dados no arquivo.



Se houver erros, o sistema abre um o log com a descrição de cada erro encontrado.



Se não houver erros, o sistema retorna a mensagem abaixo:

5. Desmarque a opção “Running in test mode” e execute o programa novamente.

6. O sistema executa mais algumas verificações e, se todos os dados estiverem corretos, faz o upload das informações para o sistema no mandante selecionado.



7. As informações então estarão disponíveis no cockpit do eSocial.



8. Verifique se todas as informações importadas estão corretas.

Note que esta não é a única maneira de fazer a integração de dados com o sistema. Também é possível usar a transação /TMF/MF_METADATA que é o gerador de templates e visualizador de metadados dos eventos. Além disso, existem Web Services para importação de XML (/TMF/SI_ImportingXML e /TMF/TMFbatchServiceCtRSyncln). Mas isso é assunto para um outro post.

Você encontra mais informações sobre o Messaging Framework e também sobre o eSocial em:

• http://help.sap.com/tdf_br_10 -> Application Help -> Messaging Framework -> Customizings for Messaging Framework.


• http://help.sap.com/tdf_br_10 -> Application Help -> Messaging Framework -> Customizings for eSocial.

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

Espero ter ajudado e até a próxima!

Karla Reis

Time de Desenvolvimento do TDF