Integracao Hcmxtsa

Manual de Integrao
HCM X TSA
Manual de Integrao

2 Manual de Integrao HCM X TSA

Sumrio

1 Introduo ................................................................................................................................... 3
2 Integrao HCM X TSA ................................................................................................................. 5
3 Pr-Requisitos ............................................................................................................................. 6
4 Processos de Integrao .............................................................................................................. 29
5 Tratamento de Erros ................................................................................................................... 44

Manual de Integrao

3
Manual de Integrao HCM X TSA
1 Introduo
DATASUL - Manual de Integraes
Introduo Integrao HCM x Controle de Acesso
TOTVS (TSA)

Viso Geral
Essa integrao viabiliza a comunicao de dados entre o HCM e o Controle de Acesso TOTVS (TSA) por intermdio
de mensagens XML.
O aplicativo que publicar e receber essas mensagens o Datasul EAI (Enterprise Application Integration ou
Integrao de Aplicaes Corporativas).

Transaes
Os mapas de integrao das transaes abaixo se encontram liberados no Datasul EAI.

Folha de Pagamento:
Transao Tipo Objeto
AbsenceStatus Sender Situaes de Afastamento
AbsenceStatusofSite Sender Estabelecimento x Situaes Afastamento
AccessControlShift Sender Transao Turno/Escala
AllocationUnitPlan Sender Transao Unidade de Lotao Plano
CompanyCitizen Sender Transao Pessoa Jurdica
CostCenterHCM Sender Transao Centro Custo
CostCenterHistory Sender Histrico Centro de Custo
Employee Sender Transao Funcionrio
EmployeeOfAbsenceStatus Sender Situaes de Afastamento x Funcionrios
EmployeesRole Sender Papel do Funcionrio
HistoricAllocationUnit Sender Histrico de Turnos
HistPosition Sender Histrico de Cargos
Holiday Sender Feriados
HolidayShiftworkLocation Sender Transao Feriados Turno Localidade
JobContractor Sender Prestador de Servio
Location Sender Transao Localidade
LocationHistory Sender Histrico Localidade
Position Sender Transao Cargo
PrivateCitizen Sender Transao Pessoa Fsica
SiteEmployee Sender Transao Funcionrio x Estabelecimento
SiteHCM Sender Transao Estabelecimento
ShiftHistory Sender Transao Histrico Turno
SiteofAbsenceStatus Sender Situaes de Afastamento x Estabelecimento
StructureAllocationPlan Sender Transao Estrutura de Lotao

Manual de Integrao

Controle de Frequncia:
Transao Tipo Objeto
Authorization Sender Autorizaes
DayworkModification Sender Alterao Jornada
EmployeeCalendar Sender Alterao Calendrio Funcionrio
WorkShiftLoan Sender Emprstimo Turno

Monitor de Integrao EAI
Permite a manuteno da fila de mensagens XML utilizadas na integrao assncrona do EAI. As mensagens
assncronas so mensagens utilizadas para transportar informaes entre produtos integrados. Levam esse nome
pois no so simultneas e no possuem ritmo regular e definido.
As mensagens visualizadas no Monitor so filtradas de acordo com seu destino, estado de processamento, tipo,
transao s quais esto associadas e a data em que foram geradas.
So necessrios os seguintes procedimentos para visualizar as mensagens do Monitor de Integrao:
1 - Acessar "Opes" no menu de qualquer mdulo do ERP 2;
2 - Selecionar a opo "Monitor de Integrao;

3 - apresentada a janela da funo Monitor de Integrao (EAI9999), onde possvel selecionar o estado
de processamento da mensagem desejada. Para seleo, so apresentadas as seguintes opes:
No processada: quando selecionada, somente so apresentadas as mensagens no manipuladas
no sistema de destino.
Erro: quando selecionada, somente so apresentadas mensagens que o sistema de destino
encontrou algum problema ao recuper-las da fila.
Processada: quando selecionada, somente so apresentadas as mensagens processadas com
sucesso no sistema de destino.
Nota
Para mais detalhes relacionados aos procedimentos do aplicativo Datasul EAI, acessar o Manual de Referncia do
EAI, em especial a funo Monitor de Integrao.

Manual de Integrao

5
2 Integrao HCM X TSA
iDATASUL - Manual de Integraes
Integrao HCM x Controle de Acesso TOTVS (TSA)

FP/PE
Folha de Pagamento /
Controle de Frequncia

TSA
Controle de
Acesso TOTVS

Viso Geral

O objetivo integrar os mdulos de Folha de Pagamento e Controle de Frequncia do produto HCM ao TOTVS
Segurana e Acesso (TSA), para permitir controlar o acesso dos funcionrios por meio do horrio de trabalho, horas
extras, troca de turno e situaes de afastamento. Tambm receber as marcaes feitas em dispositivos de ponto
adaptados Portaria 1510 e dispositivos de refeio.
Essa integrao necessria quando so utilizados os mdulos de Folha de Pagamento e Controle de Frequncia do
HCM e for adquirido o Controle de Acesso da TOTVS (TSA).
A importncia dessa integrao que, conforme determinao da Portaria 1510, os dispositivos de ponto no podem
mais impedir a entrada do funcionrio por qualquer razo, ento o controle ser realizado pelo acesso.
A integrao poder ser efetuada executando os processos normais de folha como, por exemplo, cadastro de
funcionrio, transferncia, alterao de histrico etc. A partir desse momento, as informaes so atualizadas no
TSA on-line.

Manual de Integrao


3 Pr-Requisitos
Pr-Requisitos para a Integrao HCM x TSA

Validando Informaes para a Carga
O processo de validao de informaes tem como objetivo verificar inconsistncias na base de dados do cliente.
necessrio que estas inconsistncias sejam resolvidas para que o processo de carga possa ser realizado. As
validaes realizadas pelo sistema so as seguintes:
CPF e RG da pessoa fsica no informada. Pelo menos uma das informaes deve estar informada.
Funcionrio sem histrico relacionado (Unid Lotac, CC, Turno, Localid ou Cargo).
Funcionrio est lotado em um Centro de Custo Inativo.
Existe calendrio de feriados (fp1200) a partir do ano corrente + 1 informados.
As empresas que integraro com o TSA devem estar parametrizadas, pelo programa Manuteno Parmetros
Empresa RH (FP0500), para que o programa faa a validao de funcionrios.
Para executar o processo de validao, deve-se acessar o programa de carga da integrao (crtl+alt+x
prghur/spp/carga_inf_control_aces.r) e pressionar o boto Dispara Validao Informaes. Ao final do processo,
este programa emitir um relatrio contendo as inconsistncias encontradas. A seguir as providncias que devem
ser tomadas para a resoluo destas inconsistncias:
CPF ou RG no informado: caso tenham ocorrido validaes de CPF ou RG no informados para as
pessoas fsicas que foram emitidas no relatrio esta situao deve ser regularizada; deve ser informado o
CPF ou o RG da pessoa fsica para que seja possvel realizar a integrao de informaes com o TSA.
Funcionrio sem histrico relacionado: esta validao ocorre quando existem funcionrios sem pelo
menos um histrico relacionado (unidade de lotao, centro de custo, localidade, turno ou cargo). A situao
para os funcionrios emitidos no relatrio dever ser ajustada para que a carga de informaes possa ser
realizada. O ajuste poder ser feito pelo programa prghur/spp/verif_hist_lotac.r. Para maiores detalhes
sobre este programa de acerto, contatar suporte.
Funcionrio lotado em Centro de Custo inativo: caso tenha ocorrido esta validao, necessrio ajustar
os centros de custo dos funcionrios emitidos no relatrio para efetuar a carga.
Calendrio de Feriados a partir de um ano mais um gerado: caso tenha ocorrido validao da
existncia de feriados de calendrio a partir do ano corrente + 1, possvel eliminar, o sistema no
permitir que a integrao com TSA seja realizada enquanto os feriados acima do perodo limite no sejam
eliminados. O boto Elimina Feriados Futuros do programa de carga da integrao tem a funo de eliminar
esses feriados fora do limite permitido para integrao.

Manual de Integrao

7
Atualizando campo Crach TSA
A partir da verso 11.5.7, para que ocorra a integrao do crach do funcionrio com o TSA, necessrio que o
campo Crach TSA localizado nos programas Manuteno de Funcionrio (FP1500) e Manuteno Funcionrio
Contrato Especial (FP1510), pasta Lotao, seja atualizado. Antes de realizar este procedimento devem ser
observados os seguintes itens:
Este processo dever ser realizado antes do processo de instalao do TSA e ESB e configurao da
integrao.
As empresas que integraro com o TSA devero ser parametrizadas pelo programa Manuteno Parmetros
Empresa (FP0500).
Para a realizao deste processo, necessrio acessar o programa de carga de informaes para o Controle de
Acesso (prghur/spp/carga_inf_control_aces.r). Acessar o boto Filtro e no campo Atualizao campo Crach TSA
selecionar qual a origem do nmero do crach do funcionrio:
Importao Arquivo para Atualizao Campo Crach: caso esta opo seja selecionada, no momento
que o boto Atualizao Campo Crach for executado, crachs podero ser importados de um arquivo
texto informados na tela de parmetros do programa.
Nmero Carto Ponto: caso esta opo seja selecionada, no momento que o boto Atualizao Campo
Crach for executado, o campo Crach TSA ser atualizado com o cdigo do nmero do carto ponto
informado nos programas FP1500 e FP1510.
Crach MSA: caso esta opo seja selecionada, no momento que o boto Atualizao Campo Crach for
executado, o campo Crach TSA ser atualizado com o cdigo do crach que est atualizado no programa
Usurio Controle de Acesso (SA1500) do mdulo de Controle de Acesso.
Depois de selecionar a origem do crach, deve-se pressionar o Boto Atualizao campo Crach TSA a tela de
parmetros dever ser informada conforme a seguir:
Formato caso tenha sido selecionado importao de arquivo texto, se este campo for informado, o
sistema importar o carto ponto como formato que foi informado neste campo. Caso seja informado 0, o
sistema importar o crach com o formato do arquivo texto.
Arquivo Entrada caso tenha sido selecionado importao de arquivo texto, dever ser informado o arquivo
texto para importao dos crachs.
O sistema emitir relatrio com informando os funcionrios que foi possvel atualizao do crach e caso a opo
seja arquivo de importao os erros que ocorreram na atualizao do crach. necessrio corrigir o arquivo de
importao e nova importao do arquivo para a atualizao do crach.
Importante:
Atentar para o formato do campo Crach TSA tanto na atualizao do campo Crach TSA via programa de
carga quanto pela admisso do funcionrio. Sempre informar o crach com o formato que ele utilizado no
TSA, por exemplo, se o formato 8 dgitos, deve ser informado 00000523.
O processo de atualizao carga e integrao de crach somente possvel para funcionrios. Para
prestadores pessoa fsica, o crach dever ser informado no TSA. Para clientes que utilizam o mdulo MSA,
possvel exportar os crachs de prestador de servio pelo programa de carga
(prghur/spp/carga_inf_control_aces.r), boto Exportar crach MSA. O arquivo de exportao conter tanto
os crachs de funcionrio quando os crachs de prestador de servio. Caso j tenha sido realizada a carga
de funcionrios com os seus devidos crachs pelo processo de integrao, ao importar os crachs
novamente pelo processo de importao do TSA, se os crachs de funcionrios do arquivo de importao
forem iguais aos da carga este sero desconsiderados.

Manual de Integrao

Atualizando Data de Fim de Validade no Prestador Pessoa Fsica
Com o objetivo de enviar somente os prestadores ativos na carga de prestador de servio no processo de
implantao, necessrio que seja informada o campo Data Fim Validade na Manuteno Prestador e Servio
(FP0840), pasta Cadastrais. O processo de carga considera Inativo o prestador que estiver com a data de fim de
validade igual ou menor que a data do dia. Exemplo: caso a carga de informao esteja sendo realizada do dia
25/03/2013 e a data fim de validade de esteja cadastrada com o 25/03/2013 ou menor, o sistema no realizada a
carga deste prestador para o TSA. Este processo dever ser realizado antes do processo de instalao do TSA e ESB
e configurao da integrao. Esta funcionalidade somente estar disponvel para a verso 11.5.7 do TOTVS 11.
Atualizando Turnos como Inativos
No TSA, os turnos so utilizados para controlar o acesso de funcionrios considerando os perodos de suas jornadas.
Alm disso, possvel restringir acesso a turnos especficos em feriados determinados. Na maioria das empresas,
muitos turnos so criados e deixados de utilizar com o passar do tempo ocasionando a carga de informao
desnecessria e baixa desempenho no processo de carga de feriados.
Para que seja realizada a carga de somente turnos Ativos para o TSA, necessrio inativar o Turno pelo programa
de Manuteno de Turno Trabalho (FP1400), pasta Gerais, campo Inativo. O processo de carga considera um turno
Inativo quando este estiver com o campo Inativo marcado, a data da inativao for igual ou inferior ao dia atual e
no possuir funcionrio relacionado a esse turno. Este processo dever ser realizado antes do processo de instalao
do TSA e ESB e configurao da integrao.
Parametrizando Funcionrios que sero considerados Exceo para o REP
Essa funcionalidade permite que funcionrios sem vnculo empregatcio com a empresa e do tipo contrato especial
no sejam enviados para os equipamentos REP. Pelo programa Manuteno Regras para Exceo REP (PE7120)
possvel parametrizar os funcionrios que sero considerados como Exceo REP no TSA. No momento que
realizada a carga de informao ou atualizao de um funcionrio, o sistema verifica se este se encaixa nas regras
cadastradas e envia um cdigo que indica que o funcionrio do tipo Exceo REP, caso contrrio, envia um
cdigo que indica que o funcionrio do tipo Funcionrio. Essa funcionalidade estar disponvel somente a partir
da 11.5.7 no TOTVS 11. indicado realizar o processo de parametrizao antes do processo de instalao do TSA e
ESB e configurao da integrao, pois no momento da carga os funcionrios sero ajustados com as devidas
situaes. Caso a parametrizao seja feita posteriormente a implantao a cada alterao da parametrizao so
enviadas mensagens para atualizao de todos os funcionrios das empresas que integram com o TSA.
Ajustando Imagem da Pessoa Fsica
A partir do TOTVS 11.5.7 possvel integrar imagem da pessoa fsica com o TSA pelo programa de carga e do
cadastro de pessoa fsica (FP1440). No entanto, necessrio o ajuste do arquivo de imagem de pessoas fsicas cujo
tamanho do arquivo seja maior que 500KB. O programa de carga de informaes para o TSA
(prghur/spp/carga_inf_control_aces.r) permite tanto realizar a carga quanto emitir um relatrio das imagens que
sero integradas com TSA. Neste relatrio possvel visualizar as pessoas fsicas cujo arquivo de imagem est acima
de 500 KB. O processo de carga de imagem no impede a carga de informaes para o TSA, entretanto, as imagens
que no foram ajustadas para o tamanho de 500KB no sero integradas.
Instalando e configurando o TSA
A instalao e inicializao do TSA devem ter sido realizadas. O instalador do TSA est disponvel no portal do
suporte (http://suporte.totvs.com).

Manual de Integrao

9
Configurando o EAI
1. Para que o EAI publique as mensagens, necessria a configurao destas transaes no Monitor do EAI.
2. Para acessar o Monitor EAI, no Datasul 11, pode-se executar CTRL+ALT+X e informar queue_monitor.
3. No Monitor EAI acessar o cone Configurao, localizado no canto superior esquerdo.

4. Importante: Para os ambientes que no possuem integraes via EAI, dever ser executado um wizard para a
configurao do EAI. Caso o EAI j esteja configurado para integraes com outros produtos necessrio
desconsiderar dos passos 5 a 16 e seguir os demais.
5. Para configurar o ambiente ao acessar a tela abaixo pressione OK na mensagem.

Manual de Integrao

6. No assistente de criao de configurao do EAI, pressione "Avanar".

7. Informar o caminho e o arquivo ini do ambiente Datasul. Pelo boto pesquisa, o arquivo poder ser selecionado o
arquivo.

Manual de Integrao

11
8. Dica: para verificar qual o diretrio que est o arquivo ini consulte o propath do ambiente e acesse a pasta
\\servidor\ERP. Dentro desta pasta ter uma pasta de scripts que conter o arquivo ini. Abaixo exemplo de diretrio
onde se encontra o arquivo.

9. Informar o nome do produto a ser configurado. No caso desta integrao hr.

Manual de Integrao

10. Informar o diretrio de destino do arquivo de configurao EAI. O diretrio poder ser definido pelo cliente.
Abaixo est um exemplo. A pasta definida dever estar criada no ambiente do cliente. Aps informar o diretrio
pressionar o boto Avanar.

11. Ser demonstrada a mensagem abaixo. Dever ser pressionada a opo Sim para continuar o processo de
configurao.

Manual de Integrao

13
12. Aps seguir estes passos o assistente finaliza e necessrio reiniciar a sesso conforme mensagem mais abaixo.

13. Conforme demonstrado nas telas abaixo criado o arquivo eai-config.xml e esta pasta includa no propath do
ambiente.

Manual de Integrao


14. Acessar novamente o programa queue_monitor (CTRL+ALT+X) e selecionar a opo Configurao. Conforme
demonstrado abaixo o produto hr foi criado. O prximo passo criar uma aplicao.

Manual de Integrao

15
15. Para criar uma aplicao necessrio pressionar o boto direito do mouse e selecionar nova aplicao. Informar
o nome da aplicao como assinc. Selecionar Verbose para o campo Nvel de Log e confirmar o registro
pressionando o boto Confirmar.

16. Para incluir as transaes selecionar a aplicao assinc, pressionar o boto direito e selecionar Nova Transao.

Manual de Integrao

17. Os campos da tela a direita do browse sero habilitados para o cadastramento. No campo Transao dever ser
selecionada a transao a ser includa, depois de confirmada incluso atravs do boto Confirmar (canto inferior
direito). As demais informaes ficam padres.

18. Todas as transaes do quadro abaixo devero ser includas na aplicao assinc, abaixo do produto hr.
Transao Tipo Objeto
AbsenceStatus Sender Situaes de Afastamento
AbsenceStatusofSite Sender Estabelecimento x Situaes Afastamento
AccessControlShift Sender Transao Turno/Escala
AllocationUnitPlan Sender Transao Unidade de Lotao Plano
Authorization Sender Autorizaes
CompanyCitizen Sender Transao Pessoa Jurdica
CostCenterHCM Sender Transao Centro Custo
CostCenterHistory Sender Histrico Centro de Custo
DayworkModification Sender Alterao Jornada
Employee Sender Transao Funcionrio
EmployeeCalendar Sender Alterao Calendrio Funcionrio
EmployeeOfAbsenceStatus Sender Situaes de Afastamento x Funcionrios
EmployeesRole Sender Papel do Funcionrio
HistoricAllocationUnit Sender Histrico de Turnos
HistPosition Sender Histrico de Cargos
Holiday Sender Feriados
HolidayShiftworkLocation Sender Transao Feriados Turno Localidade
JobContractor Sender Prestador de Servio
Location Sender Transao Localidade
LocationHistory Sender Histrico Localidade
Position Sender Transao Cargo
PrivateCitizen Sender Transao Pessoa Fsica
Manual de Integrao

17
SiteEmployee Sender Transao Funcionrio x Estabelecimento
SiteHCM Sender Transao Estabelecimento
ShiftHistory Sender Transao Histrico Turno
SiteofAbsenceStatus Sender Situaes de Afastamento x Estabelecimento
StructureAllocationPlan Sender Transao Estrutura de Lotao
WorkShiftLoan Sender Emprstimo Turno
19. Dica: Caso as transaes no apaream no campo para selecionar necessrio abrir um chamado para suporte
solicitando liberao especial do arquivo transaction.xml (release 11.5.4) e ento substituir o arquivo transaction.xml
no diretrio do produto (binrios) pasta eai\xmlinc.
20. Aps todas as transaes serem cadastradas a configurao do EAI estar concluda. Pressionar o boto fechar
para sair do programa de Configurao.
Instalando e Configurando do ESB
O ESB o mecanismo utilizado para a integrao entre o HCM e o TSA. O ESB consome as mensagens do banco EAI,
transforma as mensagens e entrega ao TSA. A seguir so apresentadas as etapas para instalao e configurao.
1. Realizar o download do instalador do ESB na verso 12.3.0 do portal do suporte (http://suporte.totvs.com) e
realizar a instalao conforme o consultar Guia de Instalao do ESB (diretrio de instalao docs\Configuracao de
Ambiente\pt).
2. Para que seja possvel configurar a integrao do HCM X TSA no ESB o aplicativo TOTVS Developer Studio deve
estar instalado. O TDS uma ferramenta que possibilita realizar tarefas diferenciadas de administrao e
desenvolvimento com auxlio de plugins especficos para cada finalidade. O plugin TOTVS | ESB responsvel pela
configurao e diagramao do servidor TOTVS | ESB. As instrues para realizar o download e instalao do TDS se
encontram no link http://ds.totvs.com/. Para a instalao dos plugins seguir as instrues do Manual de Implantao
do TOTVS ESB. Antes de baixar o plugin do ESB verificar se os plugins bsicos da ferramenta como por exemplo o
Fundao foram atualizados, caso contrrio, executar a instalao. O TDS dever ser instalado no ambiente de
rede do cliente, pois dever estar disponvel para futuras atualizaes do diagrama ESB. Ao acessar o TDS, caso
sejam solicitados usurio e senha no ambiente de cliente, dever ser utilizado o usurio e a senha utilizados para
acesso ao Suporte TOTVS.
3. A partir da verso 12.3.0 do ESB e 11.5.5 do TOTVS 11 no mais necessria a configurao de License Server
para a utilizao da integrao HCM X TSA.
4. O Diagrama ESB um mecanismo utilizado pelo ESB para transformar e enviar as mensagens ao TSA.
composto de componentes interligados entre si que iro determinar a origem (no caso desta integrao a
configurao do banco EAI), as regras de transformao e rota de envio das mensagens (no caso desta integrao a
configurao dos webservices TSA) para o sistema destino. A TOTVS disponibiliza um diagrama padro que possui
todos os componentes necessrios para essa integrao, exceto a configurao do banco EAI e o caminho do
Webservice do TSA. Portanto, no momento da importao do digrama para o ESB necessria a configurao da
origem e destino das mensagens. Este diagrama encontra-se compactado no diretrio dos binrios de hcm
(prghur\fpp\integr-tsa\hcm_tsa.zip).
5. Necessrio descompactar o arquivo hcm_tsa.zip e copiar a pasta hcm_tsa na workspace definida para o TDS.
Abaixo um exemplo do diretrio de workspace:
Manual de Integrao


6. Importante: Caso a verso do Datasul seja 11.5.4 a configurao do diagrama ESB ser da seguinte maneira.
a) Criar um projeto no TDS pressionando o boto direito do mouse na aba ESB Navigator, selecione New e logo
depois do Project.

Manual de Integrao

19
b) Na tela abaixo selecionar Project e pressionar o boto Next

c) No campo Project Name informar o hcm_tsa e pressionar o boto Finish.

Manual de Integrao

7. Importante: Caso a verso do Datasul seja 11.5.5 ou superior a configurao do diagrama ESB ser realizada
importando o diagrama ESB que foi descompactado na Workspace do TDS. O passo a passo para a importao de
diagramas ESB encontra-se no "TOTVS ESB - Manual de Importao e Exportao de Diagramas.pdf" no diretrio de
documentao do produto.
8. A partir deste momento o projeto demonstrado na Aba ESB Navigator. Para acessar o diagrama da integrao,
necessrio clicar duas vezes em DatasulReceiver.esb.

Manual de Integrao

21
9. O componente DatasulReceiver contm a configurao do banco EAI que a origem do consumo das
mensagens EAI pelo ESB. Selecionar este componente e na aba Properties informar no campo Database o banco
EAI. Nos campos Host, informar o servidor e a porta onde se encontra o banco EAI.

10. Caso o banco EAI no esteja configurado com username e password sysprogress seguir os seguintes passos:
a. Abrir um editor progress conectado no banco EAI.
b. Acessar a opo Tools, Data Administration
c. Na tela de Data Administration, selecione Admin, Security, Edit User List.
d. Na tela Edit User List, clique em Add para adicionar um usurio para o banco de dados.
e. Na tela Add User, deve ser criado o usurio sysprogress. Informar uma senha para este usurio. Aps preencher
os campos clique em OK.
f. Na tela Password Verification, digite novamente a senha do usurio sysprogress e clique em OK.
g. Na tela Edit User List, clique em OK para finalizar a criao do usurio.
11. Verifique se o banco EAI est carregado no ambiente e teste a conexo atravs do botoTest Connection.

Manual de Integrao

12. Depois desse processo, necessrio alterar a URL dos componentes TOTVSSender que so responsveis pelo
envio das mensagens para o TSA. Para isso, clicar com o boto direito do mouse no diagrama DatasulMenssage.esb
(aba ESB Navigator) e selecionar a opo Open with e aps Text Editor conforme demonstrado abaixo.

13. Posicionar no incio do texto da aba DatasulReceiver.esb (centro da janela) e pressionar Crtl + F. Informar a URL
padro do diagrama.

Manual de Integrao

23
14. Dica: para saber a URL dos Webservices do TSA disponibilizado como padro pela TOTVS acessar um dos
componentes TOTVSSender e copiar a URL que est no campo WSDL path sem copiar o nome do WebService
conforme demonstrado na tela abaixo. Aps copiar essa URL no campo FIND do FindReplace.

Manual de Integrao

15. Dica: para saber qual o endereo dos Webservices do TSA que necessrio parametrizar nos componentes
seguir os seguintes passos:
a) Acessar o link do TSA sem o tsa-web para acessar o Jboss. Aps isso, selecionar o link JBoss Web Services
Console.

b) Na tela do JbossWs acessar o link View a list of deployed services para acessar a lista de webservices
disponveis.

c) O endereo que ir ser atualizado nos componentes TOTVSSender do ESB o que se encontra no campo
EndPoint Address conforme demonstrado abaixo no quadro vermelho.

Manual de Integrao

25
16. Finalizando essa etapa necessrio executar o deploy desta nova configurao para o ESB clicando com o boto
direito no diagrama DatasulReceiver.esc (aba ESB Navigator) e selecionando Deploy to ESB Server. Na prxima tela
selecionar o Server e pressionar o boto Finish. Atentar para o campo Diagram desta tela, para o caso de possuir
outra integrao que utiliza ESB. Caso utilize somente a integrao com o produto TSA utilizar a opo Delete all
diagrams..., caso contrrio verificar se necessrio utilizar Add this diagram in the server.

Manual de Integrao

17. Para voltar novamente ao Diagrama selecionar com boto direito DatasulReceiver.esb. Selecionar a opo Open
With e aps, ESB Diagram Editing.

18. Aps concludos todos os passos anteriores reinicializar o banco ESB (atalho no desktop ou servio) e o servio
do TOTVS ESB (pode ser atravs do atalho no desktop ou no services.msc no menu iniciar).
Importante: Consideraes sobre o ESB:
A verso do Progress utilizada para o TOTVS 11 dever estar com o ltimo patch aplicado, para no ocorrer
o erro a seguir no log do ESB no momento da conexo do banco do EAI:

Manual de Integrao

27
Depois da realizao de um deploy do diagrama ESB criado o arquivo config-esb que ser utilizado como
arquivo de configurao pelo ESB para a realizao da integrao. Para um melhor sincronismo de dados
para essa integrao necessrio alterar a quantidade de motores que esto sendo utilizados pelo ESB para
o processamento de mensagens. Esta alterao realizada editando o arquivo config-esb.xml atravs de um
editor XML. Conforme print a seguir, na linha que encontra-se em evidncia alterar de 8 para 1. Salvar o
arquivo e fechar o editor. Aps esse processo deve-se reiniciar o servio do ESB.

Caso seja necessria a correo do diagrama ESB por parte da TOTVS, o mesmo ser disponibilizado
compactado no diretrio padro do produto Datasul (prghur/fpp/integr-tsa/config-esb) e ser informado
atravs do Release Notes que ser necessrio que os clientes efetuem uma atualizao do diagrama de
integrao novamente. Para a atualizao deste mapa obrigatrio a realizao da configurao do banco
EAI e atualizao dos caminhos do TOTVSSender atravs dos passos 5 em diante, at o final do item
Instalao e Configurao do ESB deste manual.
Caso seja feita atualizao de verso do TSA (exemplo: da 11.6.4 para 11.6.5) necessrio realizar
alterao das URL dos Webservices do TSA. Para isso necessrio realizar o passo 17 deste manual (search
replace dos caminhos) para que o ESB envie a mensagem para a nova verso do TSA.
Verificar no diagrama atravs da ferramenta TDS se o campo Synchronous est marcado conforme print
abaixo (est configurao encontra-se no componente DatasulReceiver).

Verificar atravs da ferramenta TDS, se as propriedades da customizao custom-tsa.properties esto com
informaes enable e delay atualizadas conforme imagem a seguir, para que no ocorram problemas de
sincronizao nas mensagens. Para acessar estas propriedades deve-se clicar acessar hcm_tsa > pasta lib >
pasta custom > custom-tsa.properties.

Manual de Integrao


Configurando Integrao de Marcaes de Ponto do TSA
A integrao de marcaes de ponto do Controle de Acesso TOTVS (TSA) com o mdulo Controle de Frequncia do
produto HCM realizada pela funo Integrao de Marcaes TSA (PE7100). Essa funo pode ser parametrizada
para executar via RPW em um intervalo de cinco (5) minutos para efetuar o processamento de marcaes. Para que
a funo possa ser executada via RPW necessrio realizar as seguintes parametrizaes:
1. Configurao do Servidor de Execuo acessar o programa Manuteno Servidor de Execuo (BTB012AA) e
efetuar a configurao do servidor de execuo.
2. Configurao do Agendamento executar o programa Agenda Automtica (CD8600) e incluir novo registro com
os seguintes dados:
a. Programa: PE7100;
b. Empresa: empresa em que sero executados os programas;
c. Agendamentos: 0;
d. Data Limite: branco;
e. Situao/Ativo: marcado;
f. Situao/Permite Execuo Paralela: marcado;
g. Calendrio: semanal.
3. Neste programa, acessar Programar Horrios (imagem de uma agenda), acionar Faixa e incluir os seguintes
dados:
Nota: Ao confirmar os agendamentos, o processo criar registros para todos os horrios e demandar um tempo at
que todo o processo seja concludo.
a. Tipo Ocorrncia: hora;
b. Frequncia: 5 (minutos);
c. Intervalo Dia: DOM DOM.

Manual de Integrao

29
4. Ativao do Servidor de Execuo:
a. Executar o programa Tarefas Ativao Servidor de Execuo (Ativao Servidor RPW).
b. Selecionar o servidor no campo "Servidor".
c. Acionar Ativar.
5. O relatrio de log do programa ser gerado no diretrio de spool do servidor de execuo RPW configurado.
Para clientes que possuem integrao com o mdulo Controle de Acesso HCM e esto migrando para o Controle de
Acesso TOTVS (TSA), todos os erros de importao provenientes do Controle de Acesso devem estar corrigidos
(reimportados)/desconsiderados para ocorrer o processo de migrao.
Depois de configurar a integrao de marcaes, este programa ser executado via RPW de tempos em tempos.
A funo desse programa ler as marcaes de dispositivos REP e dispositivos de refeitrio, process-las e, se no
ocorrer nenhuma inconsistncia nas marcaes, elas sero atualizadas no mdulo Controle de Frequncia.

4 Processos de Integrao
Processos de Integrao

Parametrizando a Integrao das Informaes
Aps realizar os pr-requisitos de implantao necessrio parametrizar a integrao atravs dos programas
FP0003 e FP0500:
FP0003 Dever ser marcado o campo Integrao EAI na pasta mdulos.
FP0500 Dever ser marcado o campo Integra Controle de Acesso na Pasta 1 para as empresas que sero
integradas com controle de acesso.

OBS: de vital importncia que a base no esteja sendo utilizada para o processo de implantao para a
correta conferncia de carga.

Executando a Carga das Informaes
Para executar a carga das informaes, necessrio acessar o programa prghur/spp/carga_inf_control_aces.r por
intermdio de executar programa (crtl+alt+x). O programa possui as seguintes informaes e funcionalidades:
Boto Filtro: este boto tem por objetivo parametrizar o filtro para a realizao do processo de carga e tambm
efetuar configuraes para importao de crachs. Ao pressionar o boto demonstrada uma tela onde possvel
parametrizar as seguintes informaes:
Exibir Informaes com Carga: permite realizar o filtro das informaes demonstradas no programa de
carga. Caso seja selecionada a opo No Executada, sero demonstradas todas as informaes cujo
campo Carga Exec seja igual a No. Caso seja selecionado Executada, sero demonstradas todas as
informaes cujo campo Carga Exec est como Sim. Caso seja selecionado Ambos, sero demonstradas
as informaes cujo campo Carga Exec est como Sim e No.
Manual de Integrao

Empresa: caso seja selecionado Todas Marcadas, sero integradas informaes de todas as empresas
cujo campo Integra Controle de Acesso est marcado no programa FP0500 Parmetros Empresa RH
(recomendado na primeira implantao). Caso contrrio, sero integradas informaes somente da empresa
que est logada.
Tipo de Processo: caso seja selecionado Relatrio, ser emitido somente um relatrio contendo o total
de registros que sero integrados e o total de mensagens que sero enviadas. Caso seja selecionado
Carga, sero enviadas as mensagens XML para integrao com o TSA e ao final ser emitido um relatrio
contendo o total de registros integrados e o total de XML enviados.
Boto Raio: tem a funo de emitir o relatrio de informaes de integrao ou realizar a carga das informaes
selecionadas do lado direito do browse (conforme seleo no boto filtro). Observar os seguintes itens:
recomendado que a carga de informaes seja executada uma a cada vez, pois necessrio um
acompanhamento no log do TSA para verificar a ocorrncia de algum problema na integrao.
Para executar a carga, necessrio selecionar uma informao e pressionar a seta para a direita. Caso a
carga j tenha sido realizada, o sistema questiona se deseja realiz-la novamente. Depois de confirmar a
execuo da carga, necessrio pressionar o boto Raio. O sistema acessar o programa
carga_inf_control_aces_a, sendo necessrio apenas pressionar Executar.
Ao confirmar a carga de cada informao, o sistema exibe uma mensagem de acompanhamento na qual
possvel verificar quantos registros esto sendo integrados e quantas mensagens esto sendo geradas para
esta carga. Por exemplo: para a integrao de Pessoa Fsica esto cada XML, criado com 500 pessoas
fsicas.
Depois da concluso da gerao das mensagens, emitido um relatrio no qual possvel ver quantos
registros foram integrados e quantos XML foram gerados para cada carga.
Para realizar outra carga, necessrio fechar o programa carga_inf_control_aces_a, selecionar outra
informao a ser integrada e realizar este processo.
Boto Exporta Crach do MSA (Mdulo Controle de Acesso do HCM): este boto tem a funo de gerar um
arquivo de exportao (.csv) dos crachs de mdulo de Segurana e Acesso do Datasul (MSA). Este arquivo conter
a chave externa do usurio separado por ponto e vrgula, lembrando que o usurio para o TSA o funcionrio
(chave externa empresa; estabelecimento; matrcula) e prestador de servio pessoa fsica (chave externa empresa +
nmero prestador). Este processo somente dever ser executado caso no seja feita a atualizao do campo Crach
TSA (processo descrito item Atualizando campo Crach TSA).
Empresa: o campo empresa no programa demonstra a empresa logada no momento da execuo da carga.
Informao: o campo informao do browse da esquerda consiste na relao de informaes a serem integradas.
Carga Exec (Sim/No): tem por objetivo demonstrar se j foi realizada a carga de informaes ou no. Quando
ainda no foi realizada a carga de nenhuma informao, o campo Carga Exec fica como No. A cada carga de
informaes executada o campo Carga Exec alterado para Sim.
Nvel Carga: existem informaes que so nvel de banco de dados e empresa. As informaes em nvel de banco
de dados so aquelas que no dependem de empresa. As informaes em nvel de empresa so aquelas se a
empresas esto com o parmetro Integra Controle de Acesso marcado (FP0500), as informaes relativas a esta
empresa so integradas.
A execuo da carga deve ser realizada seguindo a ordem de informao relacionada no browse do
programa de carga.

Manual de Integrao

31
Conferindo a Carga de Informaes no TSA
O processo de carga de informaes dever ser realizado uma a uma; cada carga de informao deve ser iniciada e
finalizada antes de iniciar a prxima. E antes de iniciar a prxima carga necessria a conferncia da quantidade de
informao integrada com o TSA. Este processo de conferncia realizado comparando a quantidade de registros
integrados do relatrio de carga da informao com a quantidade de registros atualizados da informao no TSA,
acessando o Monitor de Informaes do Sistema aba Dados da Integrao. Na tela a seguir, demonstrado o
Monitor de Informao com a quantidade de registro referente a Unidade de lotao que foram integradas com
sucesso. E a mais adiante um exemplo do relatrio de carga com a quantidade de registros enviados para o TSA. A
quantidade dever ser a mesma. Caso contrrio o arquivo log do TSA dever ser consultado para verificar os erros
ocorridos. As demais informaes esto na linha Validaes Dados do TSA deve-se proceder da mesma forma
para conferir as quantidades.

No caso de Feriados X Dias No Trabalhados, necessria uma conferncia mais detalhada de informaes. Abaixo
demonstrada a tela do Monitor de Consulta com as informaes de Dias no trabalhados integrados por dia e com a
somatria de localidades e turnos relacionados ao dia. Mais abaixo demonstrado um exemplo de relatrio de
feriados integrados. As quantidades do relatrio x monitor dever ser a mesma. Caso no seja, consultar o arquivo
log do TSA para verificar os erros que ocorreram nesta integrao.

Manual de Integrao

Executando Processos para Integrao das Informaes
Os processos listados a seguir so os que realizam integrao com o TSA. Nestes esto descritos quais so as aes
executadas para integrar uma informao com TSA.
Manuteno Regras de Exceo de REP (PE7120)
Incluir registro: se a empresa da regra est parametrizada para integrar com Controle de Acesso
(FP0500), sero enviadas mensagens contendo todos os funcionrios que se encaixam nas regras
informadas com o papel Exceo REP.
Alterar registro: se a empresa da regra est parametrizada para integrar com Controle de Acesso
informadas com o papel Exceo REP.
Excluir registro: se a empresa da regra est parametrizada para integrar com Controle de Acesso
eliminadas informadas com o papel Funcionrio.

Manuteno Estabelecimentos (FP0560)
Incluir registro: se a empresa do estabelecimento est integrada ao Controle de Acesso (FP0500), o TSA
atualizar a unidade por meio da chave externa "empresa;estabelecimento". Tambm ser enviada uma
mensagem com a lista das situaes de afastamento cujo significado seja Afastado e Frias atualizar
todas as situaes de afastamento para este estabelecimento.
Alterar registro: se a empresa do estabelecimento est integrada ao Controle de Acesso, o TSA atualizar
a unidade por meio da chave externa "empres;estabelecimento".
Excluir registro: se a empresa est integrada ao Controle de Acesso, o TSA eliminar o registro da unidade
por meio da chave "empresa + estabelecimento". Tambm ser enviada uma mensagem com a lista das
situaes de afastamento que esto marcadas para serem integradas com o Controle de Acesso para o
estabelecimento e o TSA eliminar todas as situaes de afastamento deste estabelecimento.

Manuteno Centros de Custo (FP0660)
Incluir registro: se a empresa do centro de custo est integrada ao Controle de Acesso, o TSA atualizar o
centro de custo por meio da chave externa "cdigo empresa;cdigo de centro de custo".
Alterar registro: se a empresa do centro de custo est integrada ao Controle de Acesso, o TSA atualizar o
centro de custo por meio da chave externa "cdigo empresa;centro de custo".
Excluir registro: se a empresa do centro de custo est integrada ao Controle de Acesso, o TSA eliminar o
registro do centro de custo por meio da chave "empresa;centro de custo".

Manuteno Plano de Lotao (FP0800)
Relacionar uma lotao em um plano de lotao: o TSA atualizar a unidade de lotao por meio da
chave externa "cdigo de plano de lotao;cdigo de unidade de lotao".
Eliminar relacionamento de unidade de lotao com plano: o TSA eliminar o registro de unidade de
lotao por meio da chave "cdigo plano;unidade de lotao".

Manuteno Unidade de Lotao (FP0780)
Alterar descrio da unidade de lotao existente: o TSA atualizar todas as lotaes que tiverem
como chave externa "cdigo do plano;lotao da lista".

Manual de Integrao

33
Manuteno Cargo (FP0720)
Incluir registro: o TSA atualizar o cargo por meio da chave externa "cdigo de cargo;nvel".
Alterar registro: o TSA atualizar o cargo por meio da chave externa "cdigo de cargo;nvel".
Excluir registro: o TSA eliminar o registro do cargo por meio da chave externa "cdigo de cargo;nvel".

Manuteno Pessoa Jurdica (FP1420)
Incluir registro: o TSA atualizar a pessoa jurdica por meio da chave externa "cdigo pessoa jurdica".
Alterar registro: o TSA atualizar a pessoa jurdica por meio da chave externa "cdigo pessoa jurdica".
Excluir registro: o TSA eliminar registro da pessoa jurdica por meio da chave externa "cdigo de cargo +
nvel".

Manuteno de Pessoa Fsica (FP1440)
Incluir registro: o TSA atualizar a pessoa fsica por meio da chave externa "cdigo pessoa fsica".
Alterar registro: o TSA atualizar a pessoa fsica por meio da chave externa "cdigo pessoa fsica".
Excluir registro: o TSA eliminar o registro da pessoa fsica por meio da chave externa "cdigo da pessoa
fsica".

Manuteno Prestador de Servio (FP0840)
Incluir registro: se o campo "Integra com Controle de Acesso" estiver assinalado para a empresa do
prestador (FP0500), o TSA atualizar o usurio por meio da chave externa "cdigo empresa; prestador de
servio". Tambm recebe uma mensagem de relacionamento do usurio (prestador) a uma unidade
(empresa;estabelecimento). Como o prestador s est relacionado empresa para que possa ter uma
unidade relacionada no controle de acesso, o sistema atribui ao prestador o primeiro estabelecimento da
empresa a qual ele pertence.
Alterar registro: se o campo "Integra com Controle de Acesso" estiver assinalado para a empresa do
prestador, o TSA atualizar o usurio por meio da chave externa "cdigo empresa + prestador de servio".
Tambm recebe uma mensagem de relacionamento do usurio (prestador) a uma unidade (empresa +
estabelecimento). Como o prestador s est relacionado empresa para que possa ter uma unidade
relacionada no controle de acesso, o sistema atribui ao prestador o primeiro estabelecimento da empresa a
qual ele pertence.
Excluir registro: se o campo "Integra com Controle de Acesso" estiver assinalado para a empresa do
prestador, o TSA atualizar a data de fim do papel deste usurio por meio da chave externa "empresa +
prestador com a data atual".
Observao:
Somente so integrados Prestadores Pessoa Fsica com o TSA.
O campo Data de Validade TSA tem como objetivo a integrao ou no do prestador de servio com o TSA no
processo de carga ou a finalizao do papel do prestador para que no seja mais gerada permisso para este
prestador. No cadastro, caso esta data esteja informada, o TSA encerrar o papel do prestador no TSA.

Manual de Integrao

Manuteno Situaes (FP0060)
Incluir registro: integrada com o TSA a situao que estiver com significado Afastado ou Frias. Para
cada situao integrada uma lista de unidades (empresa;estabelecimentos) que sero relacionados
situao e sero marcadas para bloquear acesso. Caso necessrio, pode ser parametrizada no TSA a
quantidade de dias de incio do bloqueio da situao.
Alterar registro: integrada com o TSA a situao que estiver com significado Afastado ou Frias.
Excluir registro: o TSA eliminar o registro da situao de afastamento e as unidades que esto
relacionadas a esta situao.

Manuteno Localidade (FP1930)
Incluir registro: o TSA atualizar a localidade por meio da chave externa "cdigo do pas;localidade".
Alterar registro: o TSA atualizar a localidade por meio da chave externa "cdigo do pas;localidade".
Excluir registro: o TSA eliminar o registro da localidade por meio da chave externa do "pas;localidade".

Manuteno Turno de Trabalho (FP1400)
Incluir registro de turno: a mensagem de atualizao de turno somente ser enviada se a matriz do turno
for atualizada, ou seja, necessrio incluir turno, turma e a escala dever estar completa (conforme o
nmero de dias informados na funo Manuteno de Turno de Trabalho - FP1400), para possibilitar
atualizar a matriz do turno. Alm da mensagem de turno, o HCM envia mensagem de feriado por localidade
se o campo "Utiliza Calendrio de Feriado por Localidade" estiver assinalado e feriados nacionais se o campo
"Feriado Nacional" estiver preenchido.
Turno: o TSA atualizar a entidade turno por meio da chave externa "turno + sequncia do turno". Essa sequncia
definida pela matriz de turno acesso que gerada quando o cadastro do turno/escala est completo. Alm do turno
e da sequncia, ser enviada tambm a lista de escala pertencente ao turno.
Feriado Localidade: o TSA atualizar os "Dias no Trabalhados" com a relao de todos os dias cadastrados como
feriado de localidades. Dentro de cada dia, atualizar o turno includo e todas as localidades (pas e localidade) que
esto cadastradas na funo Manuteno de Localidade (FP1930) para o dia em questo.
Feriado Nacional: o TSA atualizar todos os dias cadastrados nesse cdigo de feriado. Dentro de cada dia
atualizar o turno includo para todas as localidades cadastradas na funo Manuteno de Localidade (FP1930).
Alterar registro:
Incluso de uma turma: a matriz deve ser gerada novamente e nesse momento enviada uma mensagem do
turno e sua respectiva escala com base na matriz gerada. O TSA atualiza o turno e suas respectivas escalas
conforme o que foi enviado pelo HCM.
Alterao da escala: a matriz deve ser gerada novamente e nesse momento enviada uma mensagem do turno e
sua respectiva escala com base na matriz gerada. O TSA atualiza o turno e suas respectivas escalas conforme o que
foi enviado pelo HCM.
Alterar os campos "Descrio", "Ms/Ano Incio" e "Dia Escala" da turma: a matriz no gerada
novamente. A mensagem de turno e escala enviada. O TSA atualiza o turno e suas respectivas escalas conforme o
que foi enviado pelo HCM.
Marcar o campo "Utiliza Calendrio de Feriados de Localidade": o TSA atualizar os "Dias no Trabalhados"
com a relao de todos os dias cadastrados como feriado de localidades. Dentro de cada dia atualizar o turno
alterado e todas as localidades (pas e localidade) que esto cadastradas na funo Manuteno Localidade (FP1930)
para o dia em questo.
Desmarcar o campo "Utiliza Calendrio de Feriados de Localidade": o TSA eliminar o turno/localidades dos
"Dias no Trabalhados" do turno para o qual foi desmarcado esse campo.
Excluir registro: o TSA eliminar o turno e suas escalas do controle de acesso conforme a matriz de turno
acesso. Eliminar o turno das localidades da funo Manuteno de Localidade (FP1930) e dos feriados
nacionais informados no turno.
Manual de Integrao

35
Feriados por Localidade (FP1930B)
Incluir registro: se o feriado referente a uma data futura, o TSA atualizar os "Dias no Trabalhados"
por meio da chave externa "dia do feriado". Como relacionamento ao dia no trabalhado atualizar os turnos
(que esto com o campo "Utiliza Feriado por Localidade assinalado) e as localidades (todas as localidades
que tm essa data cadastrada).
Alterar registro: se o feriado referente a uma data futura, o TSA atualizar os "Dias no Trabalhados"
por meio da chave externa "dia do feriado". Atualizar os turnos (que esto com o campo "Utiliza Feriado
por Localidade assinalado)/localidades (todas as localidades que tm essa data cadastrada) relacionados ao
dia informado.
Excluir registro: se o feriado referente a uma data futura, o TSA eliminar o dia do feriado alterando os
turnos e as localidades relacionadas.

Manuteno Feriados Nacionais (FP1200)
Incluir feriado: se o feriado referente a uma data futura, o TSA atualizar os "Dias no Trabalhados" por
meio da chave externa "cdigo do dia (feriado)". Atualizar tambm a lista de turnos que esto relacionados
a este calendrio (Manuteno de Turno de Trabalho - FP1400) e todas as localidades da funo Manuteno
de Localidade (FP1930).
Alterar registro: se o feriado referente a uma data futura, o TSA atualizar os "Dias no Trabalhados"
por meio da chave externa "cdigo do dia (feriado)". Atualizar tambm a lista de turnos que esto
relacionados a este calendrio (Manuteno de Turno de Trabalho - FP1400) e todas as localidades da
funo Manuteno de Localidade (FP1930).
Excluir feriado: se o feriado referente a uma data futura, o TSA eliminar o registro de "Dias no
Trabalhados" por meio da chave externa "dia (feriado)" e seus relacionamentos (turno e localidade).
Boto Raio: esse processo cria feriados para os prximos anos, at o ano final informado, para os feriados
que esto com o campo "Gerar Feriados Prximos Anos" assinalado. O TSA atualizar os "Dias no
Trabalhados" com os dias de feriados que foram gerados com seus respectivos turnos e localidades.

Importante:
No gerar feriados para mais de um ano pois isso poder ocasionar problemas de performance e inconsistncias no
TSA.

Manuteno Funcionrios (FP1500)
Manuteno Funcionrios Contratos Especiais (FP1510)
funcionrio (FP0500), o TSA atualizar o usurio por meio da chave externa "cdigo da empresa;cdigo do
estabelecimento;matrcula". Atualizar tambm o histrico de turno, cargo, centro de custo, localidade e
unidade de lotao considerando como data inicial o dia em que est sendo efetuada a incluso do
funcionrio. Tambm atualizar a unidade-papel do usurio (cria um papel para o usurio como
Funcionrio considerando a data atual como incio e 31/12/9999 como data fim) e a partir da 11.5.7
atualizar tambm o crach informado no campo Crach TSA. Caso o turno/localidade tenham alterao de
calendrio (FP1940 campo Situao como Alterado Usurio), enviada uma mensagem de Alterao de
Calendrio que ser atualizada como uma exceo no TSA.
Alterar registro: se o campo "Integra com Controle de Acesso" estiver assinalado para a empresa do
funcionrio, o TSA atualizar o usurio por meio da chave externa "cdigo da empresa + cdigo do
estabelecimento + matrcula". Essa atualizao ser efetuada quando os campos data de admisso, PIS,
nmero da pessoa fsica ou Crach TSA (11.5.7) forem alterados.
funcionrio, o TSA atualizar a data final do papel deste usurio com a data atual. Ser feito da mesma
forma com o histrico deste usurio (turno, centro de custo, cargo, localidade e unidade de lotao).
Manual de Integrao


Importante:
A cada atualizao do funcionrio ser verificado se este funcionrio se encaixa em alguma regra informada no
programa Manuteno Regra para Exceo REP (PE7120). Caso o funcionrio no se encaixe em nenhuma regra,
enviado um cdigo 0 no campo profile que indica que o funcionrio ir para o REP. Caso contrrio, ser
enviado o cdigo 1 que indica que o funcionrio do tipo Exceo REP e ele no ser enviado para o REP.
A atualizao do campo Crach TSA ocasiona uma atualizao do crach no TSA. Quando realizada uma
atualizao de informao no cadastro de funcionrio, o sistema emite mensagem de pergunta se deseja
atualizar o crach no TSA. Caso no seja necessria essa atualizao, deve ser selecionado No.
Atentar para o formato do campo Crach TSA tanto na atualizao do campo Crach TSA via programa de carga
quanto pela admisso do funcionrio. Sempre informar o crach com o formato que ele utilizado no TSA, por
exemplo, se o formato 8 dgitos, deve ser informado 00000523.

Alterao Individual de Lotao (FP1350) (Unidade de Lotao, Centro de Custo, Turno e Localidade)
Unidade de Lotao (FP1300)
Centro de Custo (FP1310)
Turno (FP1360)
Localidade (FP1390)
funcionrio (FP0500) e se a data atual est compreendida entre data de incio e fim da lotao, o TSA
atualizar o histrico por meio da chave externa "cdigo empresa;cdigo estabelecimento;matrcula + chave
do histrico a ser atualizada". A data de incio da situao ser atualizada com a data atual.
funcionrio e se a data atual est compreendida entre data de incio e fim da lotao, o TSA atualizar a
data final dos histricos com a data corrente criando um novo registro para considerar o histrico anterior
como atual.

Histrico Situao de Afastamento (FP1600)
Manuteno Salrios Individual (FP1620)
atualizar o histrico (situao de afastamento ou cargo/salrio) por meio da chave externa "cdigo
empresa;cdigo estabelecimento;matrcula;chave do histrico a ser atualizada". A data de incio da situao
ser atualizada com a data atual.
atualizar a data final do histrico (situao de afastamento ou cargo/salrio) com a data atual criando um
novo registro para considerar o histrico anterior como atual.

Transferncia de Funcionrio (FP1840)
Transferncia Coletiva de Funcionrio (FP1850)
Ao efetuar uma transferncia de funcionrio (individual ou coletiva), se o campo "Integra com Controle de
Acesso" estiver assinalado para a empresa do funcionrio (FP0500), para cada funcionrio o TSA atualizar a
data final com a data atual, tanto do papel do usurio quanto dos histricos de centro de custo, cargo,
lotao e localidade. Depois, criar um novo registro de papel e histricos a partir da data corrente.
No ser atualizado o campo crach TSA para o funcionrio destino. Para que o crach seja atualizado no
TSA, necessrio atualizar o campo no cadastro de funcionrio.
Manual de Integrao

37
Identificao de Funcionrio (FP1720)
Ao efetuar uma identificao de funcionrio, se foi alterada a informao de empresa, estabelecimento,
matrcula e se o campo "Integra com Controle de Acesso" estiver assinalado para a empresa do funcionrio
(FP0500), o TSA atualizar a data final com a data atual do papel do usurio. Caso tenha sido alterada a
informao de histrico (centro de custo, cargo, lotao ou localidade), atualizar a data final do histrico
que foi alterado.
No ser atualizado o campo crach TSA para o funcionrio destino. Para que o crach seja atualizado no
TSA, necessrio atualizar o campo no cadastro de funcionrio.

Elimina Alteraes Salariais do Perodo (FP8340)
Ao efetuar a eliminao de alteraes salariais do perodo, se o campo "Integra com Controle de Acesso"
estiver assinalado para a empresa do funcionrio (FP0500), o TSA atualiza a data final do histrico de cargo
com a data atual e cria um novo registro com o histrico anterior atualizando a data inicial com a data
corrente.

Manuteno Calendrio Localidade (FP1940)
Se a data da alterao referente a uma data futura, ao efetuar uma alterao no calendrio de localidade
para um feriado, o TSA criar uma exceo restrio para cada funcionrio relacionado localidade do
calendrio alterado, se o campo "Integra com Controle de Acesso" estiver assinalado para a empresa do
funcionrio (FP0500).
Se a data da alterao referente a uma data futura, ao efetuar uma alterao no calendrio de localidade
para um dia trabalhado, o TSA criar uma exceo de permisso para cada funcionrio relacionado
localidade do calendrio alterado, se o campo "Integra com Controle de Acesso" estiver assinalado para a
empresa do funcionrio (FP0500).

Manuteno Autorizaes (PE3000)
Gerao Coletiva de Autorizaes (PE3040)
Importa Autorizao Horas (PE3030)
Se o campo "Integra com Controle de Acesso" estiver assinalado para a empresa do funcionrio (FP0500),
ao incluir uma autorizao para um funcionrio (individual ou coletiva) ou efetuar o processo de importao
de autorizaes, o TSA criar uma exceo de permisso para o usurio com a chave externa "empresa +
estabelecimento + matrcula + data incio + origem".
ao alterar uma autorizao para um funcionrio (individual ou coletiva), o TSA sobrepe exceo de
permisso para o usurio com a chave externa "empresa + estabelecimento + matrcula + data incio +
origem".
ao eliminar uma autorizao (individual ou coletiva), o TSA atualiza a data final da autorizao para a data
atual.

Eliminao Coletiva de Autorizaes (PE3050)
ao eliminar uma autorizao, o TSA atualizar a data final da autorizao para a data atual.

Manual de Integrao

Altera Jornada Trabalho (PE3100)
Alterao Coletiva Jornada Trabalho (PE3120)
ao incluir uma alterao de jornada para o funcionrio, o TSA cria uma exceo de permisso para cada
usurio com a chave externa "empresa + estabelecimento + matrcula + data incio + origem (alterao de
jornada)".
ao modificar uma alterao de jornada para o funcionrio, o TSA sobrepe exceo de permisso para o
usurio com a chave externa "empresa + estabelecimento + matrcula + data incio + origem (alterao de
jornada).
ao eliminar uma alterao de jornada para o usurio, o TSA atualiza a data final com a data atual da
exceo de permisso com a chave externa "empresa + estabelecimento + matrcula + data incio+ origem
(alterao de jornada).

Eliminao Alterao Coletiva Jornada Trabalho (PE3140)
ao executar o processo de eliminao de alterao de jornada, para cada usurio o TSA atualiza a data final
com a data atual da exceo de permisso com a chave externa "empresa + estabelecimento + matrcula +
data incio + origem (alterao de jornada)".

PE3900 Emprstimo Turno/Turma/Intervalo
PE3910 Emprstimo Coletivo Turno/Turma/Intervalo
ao incluir um emprstimo de turno (individual ou coletivo), para cada usurio o TSA atualiza a data final do
turno atual e cria um novo registro com o novo turno informado. Se a data inicial deste novo turno for
menor que a data atual, o TSA atualizar tanto a data final do turno atual como a data de incio do novo
turno com a data atual.
ao alterar emprstimo de turno (individual ou coletivo), para cada usurio o TSA atualiza a data final do
turno atual.
ao eliminar emprstimo de turno, para o usurio o TSA atualizar a data final do ltimo registro com a data
atual.

Eliminao Emprstimo Coletivo Turno/Turma/Intervalo (PE3930)
ao eliminar emprstimo de turno, para cada usurio o TSA atualizar a data final do ltimo registro com a
data atual.

Manual de Integrao

39
Manuteno Calendrio Funcionrio (PE1940)
Calendrio Funcionrio via Acerto de Divergncias (PE3130J)
Se o campo "Integra com Controle de Acesso" estiver assinalado para a empresa do funcionrio (FP0500) e
se a data da alterao for maior que a data atual, ao modificar o tipo de dia para trabalhado o TSA criar um
registro de exceo do tipo permisso de acesso para o usurio contemplando os perodos relacionados
jornada informada para este dia.
se a data da alterao for maior que a data atual, ao modificar o tipo de dia para no trabalhado o TSA
criar uma exceo do tipo restrio de acesso para o usurio.
se a data da alterao for maior que a data atual, ao modificar a jornada o TSA criar uma exceo de
permisso de acesso para o usurio contemplando os perodos relacionados jornada informada para este
dia.

Clculo Individual de Resciso (FR5020)
Gera Programao de Resciso (FR5030)
Manuteno de Programao de Resciso (FR5040)
Ao confirmar a incluso ou gerao de uma programao de resciso, o TSA atualiza a data final com a data
da resciso do funcionrio, do papel do usurio, centro de custo, cargo, unidade de lotao, localidade e
turno.
Ao confirmar a eliminao da programao de resciso, o TSA cria um novo registro de papel, centro de
custo, cargo, unidade de lotao, localidade e turno para o usurio.

Manuteno de Programao de Frias (FR0040)
Clculo Individual de Frias (FR0080)
Gerao de Programao de Frias Coletivas (FR0340)
Ao confirmar a incluso ou gerao de uma programao de frias, o TSA cria uma situao de afastamento
com a data do incio das frias do usurio, se for data futura ou data atual se for data retroativa. Atualiza a
data final da situao com a data das frias do usurio. Se a data final for retroativa o registro no
atualizado no TSA.
Ao confirmar a alterao da programao de frias do usurio, o TSA atualiza a data de fim da situao de
frias para a data alterada. Caso o perodo de frias seja menor que a data atual, ento o registro no ser
atualizado no TSA.
Ao confirmar a eliminao da programao de frias do usurio, o TSA atualiza a data de fim da situao de
frias para a data atual. Se o perodo de frias que est sendo eliminado for menor que a data atual, o
registro no ser eliminado no TSA.

Integrao para Recebimento de Marcaes do Dispositivo Ponto (REP) e de Refeio (PE7100)
Por intermdio do programa PE7100, possvel a integrao de marcaes do TSA para o HCM. Para isso,
necessrio realizar a configurao deste programa via RPW, conforme descritos nos procedimentos de pr-
requisitos de implantao ou o usurio poder executar o programa de tempos em tempos.
O Log pode ser consultado para verificar se as marcaes foram atualizadas com sucesso. Este se encontra
no diretrio de spool do servidor RPW quando parametrizado, ou, no diretrio spool configurado para o
usurio quando o programa executado pelo usurio.
O log demonstra uma lista de marcaes que foram processadas. O Retorno do processamento pode ser:
1 - Indica que o processamento foi realizado com sucesso e as marcaes encontram-se no PE3700.
Manual de Integrao


13 - Indica que o processamento das marcaes de refeitrio foi realizado com sucesso e encontram-se no
PE3080.
9 - Indica que o processamento das marcaes foi realizado, no entanto, foi identificada inconsistncia.
Neste caso as marcaes estaro disponveis pelo programa PE3500. Depois da correo das informaes
elas podem ser reprocessadas pelo PE3500. A importao no deve ser eliminada pelo programa PE2222,
elas devem ser corrigidas ou desconsideradas somente pelo PE3500.

Tambm para a consulta destas marcaes pode-se acessar o programa PE7110 - Relatrio de Integrao
de Marcaes Controle de Acesso (TSA). Este programa gera um arquivo em formato csv com todas as
informaes que foram importadas para o ponto ou no, conforme o que foi parametrizado na tela. Dentro
deste arquivo esto todas as informaes que o TSA atualiza no momento que vai integrar as marcaes
com o HCM, como, por exemplo, funcionrio, data de batida, hora da batida, relgio que a marcao dever
ser considerada, entre outros. Alm destas informaes, para cada registro demonstrada uma coluna para
indicar o status da importao (1, 13 ou 9), e tambm outra coluna que indica qual o erro no ponto quando
o status da marcao est como 9. Segue procedimentos para a atualizao das marcaes:
1 Marcaes integradas com sucesso. Consultar PE3700.
13 Indica que o processamento das marcaes de refeitrio foi realizado com sucesso e encontram-se no
PE3080.
9 Indica que o processamento das marcaes foi realizado, no entanto, foi identificada inconsistncia.
Neste caso as marcaes estaro disponveis pelo programa PE3500. Depois da correo das informaes
elas podem ser reprocessadas pelo PE3500.

Elimina Importao de Batidas (PE2222)
possvel eliminar as marcaes importadas do TSA pelo programa PE2222. Indica-se a eliminao da
importao de um dia especfico ou perodo de dias, devido ao fato da importao gerar vrios arquivos e
no possvel determinar o contedo de cada arquivo. Ao eliminar esta importao destas marcaes, elas
ficaro como pendentes de importao. necessrio executar o programa PE7110 para que estas marcaes
sejam novamente importadas.

Manual de Integrao

41
Rastreando a Integrao das Informaes no EAI X ESB X TSA

O Fluxo de rastreamento da informao segue os seguintes passos:
1. Mensagem demonstrada no Monitor EAI como processada (TOTVS Linha Datasul >> crtl + alt + x
queue_monitor).
2. Mensagem demonstrada no Monitor do ESB como processada (Acessar Monitor ESB pelo link http://<servidor e
porta ESB >/monitores).
3. Mensagem demonstrada como Registro salvo com sucesso no LOG no TSA.

Processo HCM Programas
Transao Monitor
EAI
Webservice
log TSA
Mensagem Atualizao com Sucesso no
LOG do TSA
Turno FP1400/FP1404 AccessControlShift shiftwork
###WS###:00501:100;1;5:Registro salvo com
sucesso.
Unidade de
Lotao
FP0800/FP0780 AllocationUnitPlan allocationunit
###WS###:00401:200;00010:Registro salvo
com sucesso.
Cargo FP0660 Position positionlevel
###WS###:00901:1369;0:Registro salvo com
sucesso.
Localidade FP1930 Location Location
###WS###:00801:BRA;12:Registro salvo com
sucesso
Pessoa Fsica FP1440 PrivateCitizen naturalperson
###WS###:00701:8924:Registro salvo com
sucesso.
Pessoa Jurdica FP1420 CompanyCitizen legalperson
sucesso.
Feriados FP1200/FP1930 Holiday daynotworking
###WS###:01210:locationExternalKey: BRA;2,
dayNotWorkedExternalKey: 2006-02-11,
shiftWorkExternalKey: 437;1;1:Registro salvo com
sucesso.
Estabelecimento FP0560 SiteHCM unit
###WS###:00201:18;105:Unidade salva com
sucesso.
Centro de Custo FP0720 CostCenterHCM costcenter
sucesso.
Prestador de
Servio
FP0840 JobContrator user
sucesso.
###WS###:01322:externalKeyUser: 3;342,
externalProviderUnit: null,
externalKeyTakerUnit3;1:Registro salvo com
sucesso.
Situao de
Afastamento
FP0060
AbsenceStatus
SiteofAbsenceStatus
absencereason
sucesso.
###WS###:01010:unitExternalKey: 3;998,
absenceReasonExternalKey: 35:Registro salvo
com sucesso.
Funcionario FP1500/FP1510 Employee user
###WS###:01301:3;1;10592:Registro salvo
com sucesso.
###WS###:01322:externalKeyUser: 3;1;10592,
externalKeyShiftWork: 501;1;1:Registro salvo
com sucesso.
externalKeyCostCenter: 3;10107:Registro salvo
com sucesso.
externalKeyPositionLevel: 315;0:Registro salvo
com sucesso.
externalKeyAllocationUnit: 2;202010301:Registro
salvo com sucesso.
Manual de Integrao

externalKeyLocation: BRA;2:Registro salvo com
sucesso.
Histrico de
Lotao do
Funcionrio
FP1350/FP1300 HistoricAllocationUnit user
###WS###:01322:externalKeyUser:
50;1;1000050, externalKeyAllocationUnit:
100;011113:Registro salvo com sucesso.
Histrico Turno FP1350/FP1360 ShiftHistory user
50;1;1000050, externalKeyShiftWork:
103;1;1:Registro salvo com sucesso.
Histrico
Localidade
FP1350/FP1390 LocationHistory user
50;1;1000050, externalKeyLocation:
BRA;2:Registro salvo com sucesso.
Histrico Centro
Custo
FP1350/P1310 CostCenterHistory user
50;1;1000050, externalKeyCostCenter:
Papel Funcionrio FP1350/P1310 EmployeesRole user ###WS###:01322:externalKeyUser: 3;1;8604,
externalProviderUnit: null,
externalKeyTakerUnit3;1:Registro salvo com
sucesso.
Alterao Salarial FP1620 HIstPosition user
50;1;1000050, externalKeyPositionLevel:
Eliminao
Alterao Salarial
FP8340 HIstPosition user
50;1;1000050, externalKeyPositionLevel:
7;0:Registro excludo com sucesso.
Histrico de
Afastamento
FP1600 EmployeeofAbsenceStatus absenceReason
###WS###:01010:unitExternalKey:
50;1;1000050, absenceReasonExternalKey:
10:Registro salvo com sucesso.
Transferncia
Funcionrio
FP1840/FP1850 Employee user
com sucesso.
com sucesso.
com sucesso.
com sucesso.
salvo com sucesso.
sucesso.
Identificao de
Funcionrio
FP1720 Employee user
com sucesso.
com sucesso.
com sucesso.
com sucesso.
salvo com sucesso.
Manual de Integrao

43
sucesso.
Emprstimo de
Turno
PE3900/PE3910/PE3930 WorkShiftLoan user
50;1;1000050, externalKeyShiftWork:
103;1;1:Registro salvo com sucesso.
Autorizaes PE3000/PE3040/PE3030 Authorization exception
###WS###:01101:50;1;1000049;2013-02-
27;18:00;1:Registro salvo com sucesso.
Alterao de
Jornada
PE3100/PE3120/PE3140 DayWorkModification exception
###WS###:01101:50;1;1000049;2013-02-
Calendrio
Localidade
FP1940/FP1920 EmployeeCalendar exception
###WS###:01101:50;1;1000047;2013-02-
Calendrio
Funcionrio
PE1940/PE1920/PE3130J EmployeeCalendar exception
###WS###:01101:50;1;1000047;2013-02-
Frias FR0040/FR0080/FR0340 Employee user
com sucesso.
com sucesso.
com sucesso.
com sucesso.
salvo com sucesso.
sucesso.
Resciso FR5020/FR5030/FR5040 Employee user
com sucesso.
com sucesso.
com sucesso.
com sucesso.
salvo com sucesso.
sucesso.

Manual de Integrao

5 Tratamento de Erros
Erros e Problemas Encontrados

Mensagem no est sendo demonstrada como Processada ou No Processada no
EAI:
Quando a mensagem no demonstrada no Monitor EAI, nem como no processada nem como processada, significa
que a mensagem no foi gerada pelo EAI. Verifique as seguintes situaes
Os passos descritos neste manual foram seguidos corretamente.
As parametrizaes nos programas FP0003 e FP0500 foram realizadas.
A transao relativa a mensagem est configurada na tela de configurao do EAI. Para configurar a
transao, verificar o Item 2. Pr-Requisitos de Implantao, subitem 2.2 Configurao do EAI deste
documento.
A mensagem deveria mesmo ser gerada atravs das regras descritas no item 3. Processo de Integrao,
subitem 3.2. Executando Processos para integrao das informaes.

Mensagem no est sendo demonstrada no ESB e est sendo demonstrada como No
Processada no EAI:
Quando a mensagem demonstrada no Monitor EAI como No Processada indica que o ESB no consumiu a
mensagem. Verifique as seguintes situaes:
A mensagem no faz parte da Integrao HCM X TSA: no Item 2. Pr-Requisitos de Implantao, subitem
2.2 Configurao do EAI deste documento, passo 18 demonstrado um quadro com todas as transaes
que dizem respeito a integrao, caso no esteja descrita neste quadro a transao no faz parte da
integrao.
O produto ESB no est ativo: verificar qual o problema ocorrido com o ESB (log do produto) e reinici-lo.
A transao no est informada no campo Document Type da Aba Message do componente DatasulMessage.
Contatar suporte, pois o diagrama do ESB pode estar desatualizado.

Mensagem no est sendo demonstrada no ESB e est como processada no EAI:
Quando a mensagem no est sendo demonstrada no ESB e est como processada no EAI indica que o ESB
consumiu a mensagem. Verifique a seguinte situao:
Existe alguma outra instalao do ESB que pode esta consumindo as mensagens. Caso tenha contate
suporte e informe a situao.

Mensagem est sendo demonstrada no ESB como Erro ou Processada e a no est
sendo demonstrada no LOG do TSA:
Quando a mensagem est sendo demonstrada no ESB com status ERRO ou processada e no est sendo
demonstrado no LOG do TSA significa que no foi possvel enviar a mensagem para o TSA Verifique as seguintes
situaes:
O servio do TSA est ativo. Caso no esteja, inicialize o servio e reprocesse as mensagens no ESB.
Existe bloqueio ou firewall impedindo a entrega de mensagens para o TSA devido a no visualizar o servio
JBOSS do TSA. Aps a resoluo deste problema as mensagens devem ser reprocessadas no ESB.
Manual de Integrao

45
Caso a mensagem tenha sido reprocessada no ESB e a informao no tenha sido atualizada no TSA,
contate suporte e reporte o ocorrido.

Mensagem est sendo demonstrada no LOG do TSA com erro (###WWS###):
Quando a mensagem est sendo demonstrada no LOG do TSA como ###WWS### significa que o TSA no
atualizou a informao devido a alguma validao interna. Entre em contato com suporte reportando o erro ocorrido.

Integracao Hcmxtsa

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Integracao Hcmxtsa

Enviado por

Direitos autorais:

Formatos disponíveis

Manual de Integrao

Você também pode gostar