Professional Documents
Culture Documents
'RBS» I
f \ nST ' n
IV
ONESOURCE eSOCIAL
DEFINIÇÃ O DOS SERVIÇOS WEB
DE INTEGRA ÇÃ O
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
SUMÁ RIO
INTRODUÇÃ O 4
PÚBLICO ALVO 4
PR É-REQUISITOS 4
WEB SERVICES DO MÓDULO ONESOURCE ESOCIAL 5
WEB SERVICES TR 6
1. SERVIÇO WEB DE ESTABELECIMENTOS / OBRAS 7
2. SERVIÇO WEB DE EMPREGADOR 7
3. SERVIÇO WEB DE PROCESSOS 7
4. SERVIÇO WEB DE RUBRICAS 8
5. SERVIÇO WEB DE CARGOS 8
6. SERVIÇO WEB DE FUNÇÕES 8
7. SERVIÇO WEB DE HOR Á RIOS E TURNOS 8
8. SERVIÇO WEB DE LOTAÇÕES 9
9. SERVIÇO WEB DE TRABALHADOR TEMPOR Á RIO - INÍCIO 9
10. SERVIÇO WEB DE REGISTRO PRELIMINAR 9
11. SERVIÇO WEB DE ALTERAÇÃO DE DADOS CADASTRAIS DO TRABALHADOR 9
12. SERVIÇO WEB DE TRABALHADOR SEM VINCULO 10
13. SERVIÇO WEB DE ALTERAÇÃO DE CONTRATO DE TRABALHO 10
14. SERVIÇO WEB DE REMUNERAÇÃO DO TRABALHADOR 10
15. SERVIÇO WEB DE FECHAMENTO DE PER ÍODO 10
16. SERVIÇO WEB DE REABERTURA DE PER ÍODO 11
17. SERVIÇO WEB DE PRODUTOS DE AQUISIÇÃO RURAL 11
18. SERVIÇO WEB DE PAGAMENTOS DE RENDIMENTOS DO TRABALHO 11
19. SERVIÇO WEB DE ALTERAÇÃO DE CONTRATO DE TRABALHO DO TRABALHADOR
TEMPOR ÁRIO 11
20. SERVIÇO WEB DE DESLIGAMENTO 12
21. SERVIÇO WEB DE REINTEGRAÇÃO 12
22. SERVIÇO WEB DE CONTRATA ÇÃ O DE TRABALHADORES AVULSOS NÃO PORTU Á RIOS 12
23. SERVIÇO WEB DE TRABALHADOR SEM VÍNCULO - TÉRMINO 12
24. SERVIÇO WEB DE AVISO PR ÉVIO 13
25. SERVIÇO WEB DE CONTRIBUIÇÃO SINDICAL PATRONAL 13
26. SERVIÇO WEB DE MONITORAMENTO DA SA ÚDE DO TRABALHADOR 13
Versã o: V 01.R103
2 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCE eSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Versã o: V 01.R103
Revisado em: 14 /11/ 2017
3
© THOMSON REUTERS
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
INTRODUÇÃ O
Este documento tem como objetivo principal descrever o funcionamento dos Web Services de integraçã o
utilizados no processo de importação / transformaçã o / envio de mensagens para os serviç os web do
módulo ONESOURCE eSOCIAL.
Existem dois formatos de integraçã o, um no formato Thomson Reuters (TR ) e outro no formato do
Governo (GOV). O fluxo de integraçã o de ambos, bem como o endereço dos webservices que fazem parte
deste fluxo ser ã o detalhados neste documento.
PÚBLICO ALVO
• Desenvolvedores de software
PR É - REQUISITOS
Versã o: V 01.R103
4 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Os Web Services na soluçã o ONESOURCE ESOCIAL, possuem dois formatos a serem consumidos. Estes
dois formatos sã o:
Web Services TR (layout Thomson Reuters): Todos os eventos disponibilizados no layout TR.
Para cada evento existe um Webservice de entrada. Para consulta do status do evento, existe um
webservice centralizado.
Web Services GOV (layout Governo): Web Service de envio e retorno disponibilizados no
mesmo padrã o do governo. Existe um webservice de entrada, que recebe os eventos em lote, e
outro webservice responsá vel por consultar o status do lote.
Versã o: V 01.R103
5 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
WEB SERVICES TR
Disponibilizamos no produto os seguintes serviços web para a intercomunicaçã o com sistemas externos
no formato TR:
Versã o: V 01.R103
6 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
ATENÇÃO: Os arquivos com as estruturas: ".wsdl" e ".xsd", estã o disponíveis em um arquivo (.zip), no
diretório "lnstalaçã o \ Aplicaçã o Web\ Web Services", no arquivo "wsdl-esocial.zip". Com estes arquivos é
possível iniciar uma implementaçã o, sem que o sistema esteja instalado e no ar.
Versã o: V 01.R103
7 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Versã o: V 01.R103
8 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
PROPRIEDADE VALOR
http:// [host ]:[port ] / taxbr -solution-
WSDL
webservices / services / WorkerChangeDataWebServicelmplPort ?wsdl
Namespace http:// workerchangedata.webservices.taxbr.ta.thomsonreuters.com /
ServiceName WorkerChangeDataWebServicelmplService
PortName WorkerChangeDataWebServicelmplPort
Versã o: V 01.R103
9 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
PROPRIEDADE VALOR
Versã o: V 01.R103
10 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Versã o: V 01.R103
11 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Versã o: V 01.R103
12 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Versã o: V 01.R103
13 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Versã o: V 01.R103
14 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Versã o: V 01.R103
15 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Após a confecçã o dos clientes de serviço web do ONESOURCE eSOCIAL, é necessá rio que um fluxo
lógico seja implementado possibilitando enviar e receber mensagens ao ONESOURCE eSOCIAL.
O diagrama abaixo apresenta o fluxo de integra çã o utilizado pelo Integrador TAXBR . É recomendado
que este fluxo seja utilizado como base para o desenvolvimento e customiza ções de rotinas de
integra çã o para a troca de mensagens com o ONESOURCE eSOCIAL.
Versã o: V 01.R103
16 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Fluxo principal: Envio com sucesso da mensagem ao ONESOURCE eSOCIAL, recebendo como retorno
mensagem contendo o nú mero do protocolo de consulta.
Fluxo principal: Receber XML de retorno do WebService do ONESOURCE eSOCIAL com o nú mero de
protocolo.
Fluxo principal: Enviar mensagem contendo o Nú mero de Protocolo para SERVIÇO WEB DE CONSULTA
DO STATUS DO PROCESSAMENTO. Caso o retorno do processamento de todas as mensagens enviadas
no lote seja " Integrado com sucesso" , a integraçã o ocorreu sem erros de processamento.
Versã o: V 01.R103
17 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Fluxo secundá rio 1: Tratar falhas de conectividade e autenticaçã o durante o envio da mensagem ao
Webservice. É recomendado confeccionar processo para geraçã o de relatórios de erros.
Fluxo secundá rio 2: Verificar se a mensagem de retorno contém o texto: "Protocolo nã o encontrado". Em
caso positivo, retornar ao "Passo 3", aguardando mais 15 segundos e efetuando novamente a consulta
do número de protocolo - "Passo 4".
Fluxo secundá rio 3: Verificar se a mensagem de retorno contém o texto: " Aguarde um momento. O
registro está sendo integradoEm caso positivo, retornar ao "Passo 3", aguardando mais 15 segundos e
efetuando novamente a consulta do número de protocolo - "Passo 4".
Fluxo secundá rio 4: Caso o retorno do processamento de "todas" as mensagens enviadas no lote nã o
sejam " Integrado com sucesso" , é recomendado confeccionar processo para geraçã o de relat órios de
erros.
Versã o: V 01.R103
18 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Os Webservices no formato do Governo (GOV), foram criados através dos arquivos ".wsdl" e ".xsd"
disponibilizados pelo próprio Governo, e seguem as mesmas regras que os webservices do governo.
Adicionalmente, o produto faz verificações de autenticaçã o sobre as requisições.
Disponibilizamos no produto os seguintes serviços web para a intercomunicaçã o com sistemas externos
no formato GOV:
Versã o: V 01.R103
19 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Após a confecçã o dos clientes de serviço web do ONESOURCE eSOCIAL, é necessário que um fluxo
lógico seja implementado possibilitando enviar e receber mensagens ao ONESOURCE eSOCIAL.
O diagrama abaixo apresenta o fluxo de integraçã o utilizado pelo Integrador TAXBR. É recomendado
que este fluxo seja utilizado como base para o desenvolvimento e customizações de rotinas de
integraçã o para a troca de mensagens com o ONESOURCE eSOCIAL.
•
CD
Versã o: V 01.R103
20 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Fluxo principal: Envio com sucesso da mensagem ao WEBSERVICE DE ENVIO DE LOTE DE EVENTOS,
recebendo como retorno mensagem contendo o nú mero do protocolo de consulta.
Obs.: Neste momento, será recebida uma mensagem que o lote foi recebido com sucesso, o que não
significa que os eventos foram. Os eventos a partir desse momento irã o ser avaliados, e podem gerar
erros tanto de layout, quanto de consistências.
Fluxo secundário: Tratar falhas de conectividade, autenticaçã o e layout do lote durante o envio e
verificaçã o da mensagem no WebService. É recomendado confeccionar processo para geraçã o de
relatórios de erros.
Fluxo principal: Receber XML de retorno do WEBSERVICE DE ENVIO DE LOTE DE EVENTOS com o
nú mero de protocolo.
Fluxo principal: Enviar mensagem contendo o Número de Protocolo para WEBSERVICE DE CONSULTA
Versã o: V 01.R103
21 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
DE LOTE DE EVENTOS. Caso o retorno do processamento seja um lote contendo todos os eventos dentro
dele com c ódigo (cdResposta) 201, a integraçã o ocorreu sem erros de processamento. Caso um ou mais
eventos possuam o código 202, a integração ocorreu com sucesso, porém com advertências.
Fluxo secundá rio 1: Tratar falhas de conectividade e autenticaçã o durante o envio da mensagem ao
Webservice. É recomendado confeccionar processo para geraçã o de relat órios de erros.
Fluxo secundá rio 2: Verificar se a mensagem de retorno contém código igual a 101. Em caso positivo,
retornar ao "Passo 3", aguardando mais 15 segundos e efetuando novamente a consulta do número de
Fluxo secundá rio 3: Verificar se a mensagem de retorno cont ém código diferente de 201 e / ou 202. Nesse
caso é necessá rio corrigir os dados no sistema origem e reiniciar o fluxo.
Versã o: V 01.R103
22 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
Para utilizar os Web Services, tanto TR quanto GOV do produto ONESOURCE eSOCIAL é preciso seguir
um fluxo bá sico para o envio de mensagens e recebimento do status do processamento.
É recomendado que a troca de mensagens seja realizada utilizando o Integrador TAXBR, que possui os
fluxos de integração pré-configurados. Para maiores informações sobre o Integrador TAXBR, consulte o
documento "Manual Integrador - Guia Usuá rio".
Para realizar a troca de mensagens com os serviços web do ONESOURCE eSOCIAL sem o Integrador
TAXBR, é necessá rio que sejam criados os clientes para os serviços web descritos no capítulo anterior
utilizando linguagem de programaçã o que suporte a criaçã o de serviços web com suporte a autenticaçã o
"Basic Authentication".
O tipo de autenticaçã o disponível nos serviç os web do ONESOURCE eSOCIAL é somente a "Basic
Authentication". Nã o é utilizado nenhum tipo de criptografia no WS- Security. É possível configurar para
que a requisiçã o seja feita via HTTPS, utilizando protocolo SSL ou TLS.
A configuraçã o de autenticaçã o nos serviços Web é feita na tela de Cadastro de Usuá rios (Módulo
Administração > Seguranç a > Usuário) onde podem ser cadastrados um ou mais usuários com o valor do
campo tipo do usuá rio definido como " Interface User" como demonstrado na imagem abaixo:
ONESOURCE
Administração
cx Cadastro
* ' * >
Q USUÁRIO
© Atributos
Senha nunca
Perfil de Seguran ç a
©‘ © ’Tipo do Usuário
OPERADOR - operador
Por padrã o, o usuário INTTAXBRPAD est á configurado no sistema com a senha INT001.
Versã o: V 01.R103
23 THOMSON REUTERS
Revisado em: 14 /11/ 2017
ONESOURCEeSOCIAL DEFINIÇÃ O DOS WEBSERVICES DE INTEGRAÇÃ O
SUPORTE TÉCNICO
Para dúvidas ou problemas, abra um chamado no Contact Center ou entre em contato com nossa equipe
de Suporte Técnico pelo telefone:
Versã o: V 01.R103
24 THOMSON REUTERS
Revisado em: 14 /11/ 2017