INTEGRAÇÃO HCM X TSA

Atenção: Nova integração disponível a partir da versão 12.1.10 do TOTVS Linha Datasul HCM.

Contexto de negócio (Introdução)

O objetivo é integrar os módulos de Folha de Pagamento e Controle de Frequência do produto TOTVS Linha Datasul HCM ao TOTVS Segurança e Acesso (TSA), para permitir controlar o acesso dos funcionários por meio do horário de trabalho, horas extras, troca de turno e situações de afastamento. Também receber as marcações feitas em dispositivos de ponto adaptados à Portaria 1510 e dispositivos de refeição.

A importância dessa integração é que, conforme determinação da Portaria 1510, os dispositivos de ponto não podem mais impedir a entrada do funcionário por qualquer razão, então o controle será realizado pelo acesso.

Sistemas Envolvidos

Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).

• TOTVS Datasul HCM - Módulos Folha de Pagamento e Controle de Frequência.
• TSA (TOTVS Controle de Acesso).
  
  

Integração

A integração viabiliza a comunicação de dados entre o HCM e o Controle de Acesso TOTVS (TSA) por intermédio de Webservice. Ela é necessária quando são utilizados os módulos Folha de Pagamento e Controle de Frequência do HCM e for adquirido o Controle de Acesso da TOTVS (TSA). Este novo modelo foi proposto para substituir a que utiliza as camadas EAI e ESB. Seguem abaixo as melhorias a que se propõem:

• Simplificação do processo de implantação:
  • Não utiliza mais as camadas EAI e ESB.
  • Utilização agendamento RPW (ferramenta padrão do Datasul).
• Melhoria no Monitoramento:
  • Ferramentas que auxiliam na identificação e resolução de problemas ocorridos na integração.
• Melhoria na performance:
  • Não necessita de controle de dependência.
  • Integra somente informações que impactam no TSA.

Arquitetura (Tecnologia):

Premissas:

• Para realizar o processo de integração entre os produtos, é necessário primeiramente realizar o processo de carga de informações para popular a base de dados do TSA com informações iniciais.
• Processo de integração ocorre:
  • Carga: Síncrono (Online)/Assíncrono (Batch).
  • Movimentação: Assíncrono (Batch).
  • Integração Marcações do TSA para Datasul HCM: Assíncrono (Batch).
• Deve ser configurado um servidor RPW para a realização de processos Assíncronos.
• Deverá ser realizado monitoramento da integração para resolução de possíveis erros.

Escopo

O escopo deste documento é o detalhamento da integração parte produto TOTVS Datasul HCM. Para maiores detalhes sobre o TSA, consulte o Guia de Instalação da release mais recente no link http://fluig.totvs.com/portal/p/10097/socialdocs/tsa-community

Responsabilidade dos Produtos:

• TOTVS linha Datasul HCM: integrar as movimentações realizadas na folha de pagamento e controle de frequência e importar marcações integradas pelo TSA para o sistema Controle de Frequência.
• TOTVS Segurança e Acesso (TSA): controlar acesso por meio de informações integradas e integrar as marcações de ponto para o TOTVS linha Datasul HCM.

Fluxo da integração para o processo de Carga:

Fluxo da Integração para o processo de Movimentação:

Fluxo da Integração para o Processo do Integrador de Movimentos (agendamento RPW):

No fluxo, o "Realizar Movimentação" ocorre no dia-a-dia por meio dos processos normais de folha de pagamento e controle de frequência. A seguir o quadro com a relação de programas executados na linha Datasul HCM que geram movimentos para integração com TSA: 

Pré-requisitos instalação/implantação/utilização

1. Instalação e configuração do TSA: necessário que o TSA esteja instalado e o serviço iniciado para que possa configurar e iniciar a integração.
2. Configuração de servidor RPW para Integração das Marcações: configurar um servidor RPW para Integração das Marcações provenientes do TSA para o HCM e Agendamento do programa PE7100 - Integração de Marcações TSA. Para realização desta configuração, acessar a documentação do programa btb012aa no menu do produto TOTVS.
3. Configuração de servidor RPW para Integração dos Movimentos do HCM para o TSA: configurar um servidor RPW para Integração de Movimentos gerados para o TSA e agendamento do FP8876 - Integrador TSA. Para realização desta configuração acessar a documentação do programa btb012aa no menu do produto TOTVS.

4. Validação de informações para a Carga: o processo de validação de informações tem como objetivo verificar inconsistências na base de dados do cliente. É necessário que estas inconsistências sejam resolvidas para que o processo de carga possa ser realizado. Para executar o processo de validação, deve-se acessar o programa FP8875 - Carga TSA e pressionar o botão “Dispara Validação Informações”. Ao final do processo, este programa emitirá um relatório contendo as inconsistências encontradas. Para maiores detalhes das ações a serem tomadas, acessar o manual de referência do programa FP8875.

5. Atualização do campo Crachá TSA (FP1500/FP1510): para que ocorra a integração do crachá do funcionário com o TSA, é necessário que o campo Crachá TSA localizado nos programas Manutenção de Funcionário (FP1500) e Manutenção Funcionário Contrato Especial (FP1510), pasta Lotação, seja atualizado. Este procedimento deverá ser realizado antes do processo de carga/movimentação. Para a realização deste processo, é necessário acessar o programa FP8875 - Carga TSA. Para maiores detalhes sobre esse procedimento, acessar o manual de referência do programa FP8875. O processo de atualização carga e integração de crachá somente é possível para funcionários. Para prestadores pessoa física, o crachá deverá ser informado no TSA.

6. Atualização Data de Fim de Validade do Prestador de Serviço: com o objetivo de enviar somente os prestadores ativos na carga de prestador de serviço no processo de implantação, é necessário que seja informado o campo Data Fim Validade na Manutenção Prestador e Serviço (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 informação esteja sendo realizada do dia 25/03/2013 e a data fim de validade esteja cadastrada com o 25/03/2013 ou menor, o sistema não realizada a carga deste prestador para o TSA. 
7. Atualização de Turnos para Inativos: no TSA, os turnos são utilizados para controlar o acesso de funcionários considerando os períodos de suas jornadas, assim como, é possível restringir acesso a turnos específicos em feriados determinados. Na maioria das empresas, muitos turnos são criados e deixados de utilizar com o passar do tempo ocasionando a carga de informação desnecessária e baixa desempenho no processo de carga de feriados. Para que seja realizada a carga de somente turnos “Ativos” para o TSA, é necessário inativar o Turno pelo programa de Manutenção 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 inativação for igual ou inferior ao dia atual e não possuir funcionário relacionado a esse turno. O excesso de intervalos que não são utilizados relacionados as jornadas x turnos que também acarretam em problemas de performance que podem dificultar a integração. Neste caso é necessário criar um novo turno com somente os intervalos mínimos necessários para as jornadas, realizar o processo de transferência dos funcionários para esse novo turno e inativar o turno anterior.
8. Parametrização de Funcionários Exceção REP: essa funcionalidade permite que funcionários sem vínculo empregatício com a empresa e do tipo contrato especial não sejam enviados para os equipamentos REP. Pelo programa Manutenção Regras para Exceção REP (PE7120), é possível parametrizar os funcionários que serão considerados como Exceção REP no TSA. No momento em que é realizada a carga de informação ou atualização de um funcionário, o sistema verifica se este se encaixa nas regras cadastradas e envia um código que indica que o funcionário é do tipo “Exceção REP”, caso contrário, envia um código que indica que o funcionário é do tipo “Funcionário”. Caso a parametrização seja feita posteriormente a implantação a cada alteração da parametrização são enviadas mensagens para atualização de todos os funcionários das empresas que integram com o TSA.
9. Ajuste da Imagem da Pessoa Física: é possível integrar a imagem da pessoa física com o TSA pelo programa de carga e do cadastro de pessoa física (FP1440). No entanto, é necessário o ajuste do arquivo de imagem de pessoas físicas cujo tamanho do arquivo seja maior que 500KB. O programa FP8875 - Carga TSA permite tanto realizar a carga quanto emitir um relatório das imagens que serão integradas com TSA. Neste relatório é possível visualizar as pessoas físicas cujo arquivo de imagem está acima de 500 KB. O processo de carga de imagem não impede a carga de informações para o TSA, entretanto, as imagens que não foram ajustadas para o tamanho de 500KB não serão integradas.

Atenção:

• A integração está disponível na versão 12.1.10 no produto TOTVS linha Datasul HCM.
• O TSA deverá estar pelo menos na versão 12.1.9.
• Caso servidor seja Linux, este não poderá ser configurado com Quantidade de Execuções acima de 1 no programa btb012aa – Manutenção de Servidor de Execução.
• Não recomendamos executar o RPW configurado por empresa, pois isso acarretará em erros de sincronização de informações no TSA. 
• Atentar para o formato do campo Crachá TSA tanto na atualização do campo Crachá TSA via programa de carga quanto pela admissão do funcionário. Sempre informar o crachá com o formato que ele é utilizado no TSA, por exemplo, se o formato é 8 dígitos, deve ser informado 00000523.

Instalação/Atualização

Primeiramente realizar a Configuração da Integração, por meio do acesso ao programa FP8870 - Monitor TSA, botão configuração. Para maiores detalhes, acessar o manual de referência deste programa.

Depois do processo de configuração, pressione o botão "Verificar Conexão TSA e RPW" e verificar o status na tela do Monitor. O Status do TSA e do RPW devem estar como ativos para iniciar a integração com TSA. O quadro a seguir demonstra os possíveis Status e suas soluções:

Depois da verificação da ativação da integração, é necessário realizar o processo de carga para a atualização inicial das informações na base de dados do TSA.

Acessar o programa FP8875 - Carga TSA por meio do botão Carga do programa FP8870 - Monitor TSA ou pelo menu do produto. Para maiores detalhes sobre o funcionamento do programa, acessar ao Manual de Referência do programa. 

Para verificar se o programa PE7100 - Importação de Marcações TSA está importando as marcações corretamente, verificar o log do programa no diretório temporário do usuário.

Atenção:

Para clientes que já utilizam a integração com TSA via EAI/ESB, não é necessário realizar o processo de carga, somente selecionar a opção "Realizando Movimentação" no programa de configuração. Depois de verificar que as informações estão sendo geradas na fila do Monitor, deverá ser parado o Serviço do ESB. 

Controle de Versão

O grupo TOTVS, representado por suas marcas, administrará as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Observação: Este modelo de suporte está sendo revisado pela TOTVS.

Fluxo das Informações

Manutenção Regras de Exceção de REP (PE7120):

• Incluir registro: se a empresa da regra está parametrizada para integrar com TSA (FP8870 - Botão configuração), serão enviadas mensagens contendo todos os funcionários que se encaixam nas regras informadas com o papel “Exceção REP”.
• Alterar registro: se a empresa da regra está parametrizada para integrar com TSA (FP8870 - Botão configuração), serão enviadas mensagens contendo todos os funcionários que se encaixam nas regras informadas com o papel “Exceção REP”.
• Excluir registro: se a empresa da regra está parametrizada para integrar com TSA (FP8870 - Botão configuração), serão enviadas mensagens contendo todos os funcionários que se encaixam nas regras eliminadas informadas com o papel “Funcionário”.

Manutenção Estabelecimentos (FP0560):

• Incluir registro: se a empresa do estabelecimento está integrada ao TSA (FP8870 - Botão configuração), o TSA atualizará a unidade por meio da chave externa "empresa;estabelecimento". Também será enviada uma mensagem com a lista das situações de afastamento cujo significado seja “Afastado” e “Férias” atualizará todas as situações de afastamento para este estabelecimento.
• Alterar registro: se a empresa do estabelecimento integrada com TSA (FP8870 - Botão configuração), será atualizada a unidade por meio da chave externa "empresa;estabelecimento".
• Excluir registro: se a empresa está integrada TSA (FP8870 - Botão configuração), o registro da unidade será eliminado por meio da chave "empresa + estabelecimento". Também será enviada uma mensagem com a lista das situações de afastamento que estão marcadas para serem integradas com o Controle de Acesso para o estabelecimento e o TSA eliminará todas as situações de afastamento deste estabelecimento.

Manutenção Centros de Custo (FP0660):

• Incluir registro: se a empresa do centro de custo está integrada ao TSA (FP8870 - Botão configuração), será atualizado o centro de custo por meio da chave externa "código empresa;código de centro de custo".
• Alterar registro: se a empresa do centro de custo está integrada ao TSA (FP8870 - Botão configuração), será atualizado o centro de custo por meio da chave externa "código empresa;centro de custo".
• Excluir registro: se a empresa do centro de custo está integrada ao TSA (FP8870 - Botão configuração), será eliminado o registro do centro de custo por meio da chave "empresa;centro de custo".

Manutenção Plano de Lotação (FP0800):

• Relacionar uma lotação em um plano de lotação: o TSA atualizará a unidade de lotação por meio da chave externa "código de plano de lotação;código de unidade de lotação".
• Eliminar relacionamento de unidade de lotação com plano: o TSA eliminará o registro de unidade de lotação por meio da chave "código plano;unidade de lotação".

Manutenção Unidade de Lotação (FP0780):

• Alterar descrição da unidade de lotação existente: o TSA atualizará todas as lotações que tiverem como chave externa "código do plano;lotação da lista".

Manutenção Cargo (FP0720):

• Incluir registro: o TSA atualizará o cargo por meio da chave externa "código de cargo;nível".
• Alterar registro: o TSA atualizará o cargo por meio da chave externa "código de cargo;nível".
• Excluir registro: o TSA eliminará o registro do cargo por meio da chave externa "código de cargo;nível".

Manutenção Pessoa Jurídica (FP1420):

• Incluir registro: o TSA atualizará a pessoa jurídica por meio da chave externa "código pessoa jurídica".
• Alterar registro: o TSA atualizará a pessoa jurídica por meio da chave externa "código pessoa jurídica".
• Excluir registro: o TSA eliminará registro da pessoa jurídica por meio da chave externa "código de cargo + nível".

Manutenção de Pessoa Física (FP1440):

• Incluir registro: o TSA atualizará a pessoa física por meio da chave externa "código pessoa física".
• Alterar registro: o TSA atualizará a pessoa física por meio da chave externa "código pessoa física".
• Excluir registro: o TSA eliminará o registro da pessoa física por meio da chave externa "código da pessoa física".

Manutenção Prestador de Serviço (FP0840):

• Incluir registro: se a empresa integra com TSA (FP8870 - Botão configuração), será atualizado o usuário por meio da chave externa "código empresa; prestador de serviço". Também recebe uma mensagem de relacionamento do usuário (prestador) a uma unidade (empresa + estabelecimento). Como o prestador somente 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 a empresa integra com TSA (FP8870 - Botão configuração), será atualizado o usuário por meio da chave externa "código empresa + prestador de serviço". Também recebe uma mensagem de relacionamento do usuário (prestador) a uma unidade (empresa + estabelecimento). Como o prestador somente 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 a empresa integra com TSA (FP8870 - Botão configuração), será atualizado a data de fim do papel deste usuário por meio da chave externa "empresa + prestador com a data atual". Observação: Somente são integrados Prestadores Pessoa Física com o TSA. O campo Data de Validade TSA tem como objetivo a integração ou não do prestador de serviço com o TSA no processo de carga ou a finalização do papel do prestador para que não seja mais gerada permissão para este prestador. No cadastro, caso esta data esteja informada, o TSA encerrará o papel do prestador no TSA.

Manutenção Situações (FP0060)

• Incluir registro: é integrada com o TSA a situação que estiver com significado “Afastado” ou “Férias”. Para cada situação é integrada uma lista de unidades (empresa;estabelecimentos) que serão relacionados à situação e serão marcadas para bloquear acesso. Caso necessário, pode ser parametrizada no TSA a quantidade de dias de início do bloqueio da situação.
• Alterar registro: é integrada com o TSA a situação que estiver com significado “Afastado” ou “Férias”.
• Excluir registro: o TSA eliminará o registro da situação de afastamento e as unidades que estão relacionadas a esta situação.

Manutenção Localidade (FP1930):

• Incluir registro: o TSA atualizará a localidade por meio da chave externa "código do país;localidade".

• Alterar registro: o TSA atualizará a localidade por meio da chave externa "código do país;localidade".

• Excluir registro: o TSA eliminará o registro da localidade por meio da chave externa do "país;localidade".

Manutenção Turno de Trabalho (FP1400):

• Botão Atualizar e FP1404: O movimento para integração do Turno somente é gerado através do botão atualizar da pasta Turma do FP1400 - Manutenção de Turno ou pelo programa FP1404 - Atualização da Matriz Acesso TSA, pois é necessário que o turno esteja todo parametrizado para que possa ser integrado. Além do movimento de, o HCM envia movimento de feriado por localidade se o campo "Utiliza Calendário de Feriado por Localidade" estiver assinalado e feriados nacionais se o campo "Feriado Nacional" estiver preenchido. O turno deverá ser atualizado quando ocorrem os seguintes processos:
  • Quando ocorrer uma Inclusão de Turno, após a conclusão do cadastro das informações dependentes.
  • Alteração de Escala do Turno.
  • Inclusão de uma Turno nova.
  • Inclusão de Intervalo na Jornada.
    
    
  Quando a atualização é feita automática:
  
  
  • Alterar os campos "Descrição", "Mês/Ano Início" e "Dia Escala" da turma: a matriz não é gerada novamente. 
  • Marcar o campo "Utiliza Calendário de Feriados de Localidade": o TSA atualizará os "Dias não Trabalhados" com a relação de todos os dias cadastrados como feriado de localidades. Dentro de cada dia atualizará o turno alterado e todas as localidades (país e localidade) que estão cadastradas na função Manutenção Localidade (FP1930) para o dia em questão.
  • Desmarcar o campo "Utiliza Calendário de Feriados de Localidade": o TSA eliminará o turno/localidades dos "Dias não Trabalhados" do turno para o qual foi desmarcado esse campo.
  • Informar um novo calendário nacional no cadastro de turno: será gerado movimento para atualização de todos os feriados que utilizam esse turno para ajustar os feriados x turnos alterados.
  • 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 função Manutenção de Localidade (FP1930) e dos feriados nacionais informados no turno.

Feriados por Localidade (FP1930B):

• Incluir registro: se o feriado é referente a uma data futura, o TSA atualizará os "Dias não Trabalhados" por meio da chave externa "dia do feriado". Como relacionamento ao dia não trabalhado atualizará os turnos (que estão com o campo "Utiliza Feriado por Localidade assinalado) e as localidades (todas as localidades que têm essa data cadastrada).
• Alterar registro: se o feriado é referente a uma data futura, o TSA atualizará os "Dias não Trabalhados" por meio da chave externa "dia do feriado". Atualizará os turnos (que estão com o campo "Utiliza Feriado por Localidade assinalado)/localidades (todas as localidades que têm 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.
  
  

Manutenção Feriados Nacionais (FP1200):

• Incluir feriado: se o feriado é referente a uma data futura, o TSA atualizará os "Dias não Trabalhados" por meio da chave externa "código do dia (feriado)". Atualizará também a lista de turnos que estão relacionados a este calendário (Manutenção de Turno de Trabalho - FP1400) e todas as localidades da função Manutenção de Localidade (FP1930).
• Alterar registro: se o feriado é referente a uma data futura, o TSA atualizará os "Dias não Trabalhados" por meio da chave externa "código do dia (feriado)". Atualizará também a lista de turnos que estão relacionados a este calendário (Manutenção de Turno de Trabalho - FP1400) e todas as localidades da função Manutenção de Localidade (FP1930).
• Excluir feriado: se o feriado é referente a uma data futura, o TSA eliminará o registro de "Dias não Trabalhados" por meio da chave externa "dia (feriado)" e seus relacionamentos (turno e localidade).
• Botão Raio: esse processo cria feriados para os próximos anos, até o ano final informado, para os feriados que estão com o campo "Gerar Feriados Próximos Anos" assinalado. O TSA atualizará os "Dias não Trabalhados" com os dias de feriados que foram gerados com seus respectivos turnos e localidades.

Manutenção Funcionários (FP1500) e Manutenção Funcionários Contratos Especiais (FP1510):

• Incluir registro: se a empresa integra com TSA (FP8870 - Botão configuração), será atualizado o usuário por meio da chave externa "código da Empresa;código do estabelecimento;matrícula". Atualizará também o histórico de turno, cargo, centro de custo, localidade e unidade de lotação considerando como data inicial o dia em que está sendo efetuada a inclusão do funcionário. Também atualizará a unidade-papel do usuário (cria um papel para o usuário como “Funcionário” considerando a data atual como início e 31/12/9999 como data fim) e a partir da 11.5.7 atualizará também o crachá informado no campo Crachá TSA. Caso o turno/localidade tenham alteração de calendário (FP1940 campo Situação como Alterado Usuário), é enviada uma mensagem de Alteração de Calendário que será atualizada como uma exceção no TSA.
• Alterar registro: se a empresa integra com TSA (FP8870 - Botão configuração), o TSA atualizará o usuário por meio da chave externa "código da empresa + código do estabelecimento + matrícula". Essa atualização será efetuada quando os campos data de admissão, PIS, número da pessoa física ou Crachá TSA forem alterados.
• Excluir registro: se a empresa integra com TSA (FP8870 - Botão configuração), o TSA atualizará a data final do papel deste usuário com a data atual. Será feito da mesma forma com o histórico deste usuário (turno, centro de custo, cargo, localidade e unidade de lotação).

Alteração Individual de Lotação (FP1350) (Unidade de Lotação, Centro de Custo, Turno e Localidade).
Unidade de Lotação (FP1300).
Centro de Custo (FP1310).
Turno (FP1360).
Localidade (FP1390):

• Incluir registro: se a empresa integra com TSA (FP8870 - Botão configuração) e se a data atual está compreendida entre data de início e fim da lotação, o TSA atualizará o histórico por meio da chave externa "código empresa;código estabelecimento;matrícula + chave do histórico a ser atualizada". A data de início da situação será atualizada com a data atual.
• Excluir registro: se a empresa integra com TSA (FP8870 - Botão configuração) e se a data atual está compreendida entre data de início e fim da lotação, o TSA atualizará a data final dos históricos com a data corrente criando um novo registro para considerar o histórico anterior como atual.

Histórico Situação de Afastamento (FP1600).
Manutenção Salários – Individual (FP1620):

• Incluir registro: se a empresa integra com TSA (FP8870 - Botão configuração) e se a data atual está compreendida entre data de início e fim da lotação, o TSA atualizará o histórico (situação de afastamento ou cargo/salário) por meio da chave externa "código empresa;código estabelecimento;matrícula;chave do histórico a ser atualizada". A data de início da situação será atualizada com a data atual.
• Excluir registro: se a empresa integra com TSA (FP8870 - Botão configuração) e se a data atual está compreendida entre data de início e fim da lotação, o TSA atualizará a data final do histórico (situação de afastamento ou cargo/salário) com a data atual criando um novo registro para considerar o histórico anterior como atual.

Transferência de Funcionário (FP1840).
Transferência Coletiva de Funcionário (FP1850):

• Ao efetuar uma transferência de funcionário (individual ou coletiva), se a empresa integra com TSA (FP8870 - Botão configuração), para cada funcionário o TSA atualizará a data final com a data atual, tanto do papel do usuário quanto dos históricos de centro de custo, cargo, lotação e localidade. Depois, criará um novo registro de papel e históricos a partir da data corrente.
• Não será atualizado o campo crachá TSA para o funcionário destino. Para que o crachá seja atualizado no TSA, é necessário atualizar o campo no cadastro de funcionário.

Elimina Alterações Salariais do Período (FP8340):

• Ao efetuar a eliminação de alterações salariais do período, se a empresa integra com TSA (FP8870 - Botão configuração), o TSA atualiza a data final do histórico de cargo com a data atual e cria um novo registro com o histórico anterior atualizando a data inicial com a data corrente.

Manutenção Calendário Localidade (FP1940):

• Se a data da alteração é referente a uma data futura, ao efetuar uma alteração no calendário de localidade para um feriado, o TSA criará uma exceção restrição para cada funcionário relacionado à localidade do calendário alterado, se a empresa integra com TSA (FP8870 - Botão configuração).
• Se a data da alteração é referente a uma data futura, ao efetuar uma alteração no calendário de localidade para um dia trabalhado, o TSA criará uma exceção de permissão para cada funcionário relacionado à localidade do calendário alterado, se a empresa integra com TSA (FP8870 - Botão configuração).

Manutenção Autorizações (PE3000).
Geração Coletiva de Autorizações (PE3040).
Importa Autorização Horas (PE3030):

•  Se a empresa integra com TSA (FP8870 - Botão configuração), ao incluir uma autorização para um funcionário (individual ou coletiva) ou efetuar o processo de importação de autorizações, o TSA criará uma exceção de permissão para o usuário com a chave externa "empresa + estabelecimento + matrícula + data início + origem".
•  Se a empresa integra com TSA (FP8870 - Botão configuração), ao alterar uma autorização para um funcionário (individual ou coletiva), o TSA sobrepõe exceção de permissão para o usuário com a chave externa "empresa + estabelecimento + matrícula + data início + origem".

•  Se a empresa integra com TSA (FP8870 - Botão configuração), ao eliminar uma autorização (individual ou coletiva), o TSA atualiza a data final da autorização para a data atual.

Eliminação Coletiva de Autorizações (PE3050):

•  Se a empresa integra com TSA (FP8870 - Botão configuração), ao eliminar uma autorização, o TSA atualizará a data final da autorização para a data atual.

Altera Jornada Trabalho (PE3100).
Alteração Coletiva Jornada Trabalho (PE3120):

• Se a empresa integra com TSA (FP8870 - Botão configuração), ao incluir uma alteração de jornada para o funcionário, o TSA cria uma exceção de permissão para cada usuário com a chave externa "empresa + estabelecimento + matrícula + data início + origem (alteração de jornada)".
• Se a empresa integra com TSA (FP8870 - Botão configuração), ao modificar uma alteração de jornada para o funcionário, o TSA sobrepõe exceção de permissão para o usuário com a chave externa "empresa + estabelecimento + matrícula + data início + origem (alteração de jornada).Se o campo "Integra com Controle de Acesso" estiver assinalado para a empresa do funcionário (FP0500), ao eliminar uma alteração de jornada para o usuário, o TSA atualiza a data final com a data atual da exceção de permissão com a chave externa "empresa + estabelecimento + matrícula + data início+ origem (alteração de jornada).

Eliminação Alteração Coletiva Jornada Trabalho (PE3140):

• Se a empresa integra com TSA (FP8870 - Botão configuração), ao executar o processo de eliminação de alteração de jornada, para cada usuário o TSA atualiza a data final com a data atual da exceção de permissão com a chave externa "empresa + estabelecimento + matrícula + data início + origem (alteração de jornada)".

PE3900 – Empréstimo Turno/Turma/Intervalo.
PE3910 – Empréstimo Coletivo Turno/Turma/Intervalo:

• Se a empresa integra com TSA (FP8870 - Botão configuração), ao incluir um empréstimo de turno (individual ou coletivo), para cada usuário 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 início do novo turno com a data atual.
• Se a empresa integra com TSA (FP8870 - Botão configuração), ao alterar empréstimo de turno (individual ou coletivo), para cada usuário o TSA atualiza a data final do turno atual.
• Se a empresa integra com TSA (FP8870 - Botão configuração), ao eliminar empréstimo de turno, para o usuário o TSA atualizará a data final do último registro com a data atual.

Eliminação Empréstimo Coletivo Turno/Turma/Intervalo (PE3930):

• Se a empresa integra com TSA (FP8870 - Botão configuração), ao eliminar empréstimo de turno, para cada usuário o TSA atualizará a data final do último registro com a data atual.

Manutenção Calendário Funcionário (PE1940).
Calendário Funcionário via Acerto de Divergências (PE3130J):

• Se a empresa integra com TSA (FP8870 - Botão configuração) e se a data da alteração for maior que a data atual, ao modificar o tipo de dia para trabalhado o TSA criará um registro de exceção do tipo permissão de acesso para o usuário contemplando os períodos relacionados à jornada informada para este dia.
• Se a empresa integra com TSA (FP8870 - Botão configuração) e se a data da alteração for maior que a data atual, ao modificar o tipo de dia para não trabalhado o TSA criará uma exceção do tipo restrição de acesso para o usuário.
• Se a empresa integra com TSA (FP8870 - Botão configuração) e se a data da alteração for maior que a data atual, ao modificar a jornada o TSA criará uma exceção de permissão de acesso para o usuário contemplando os períodos relacionados à jornada informada para este dia.

Cálculo Individual de Rescisão (FR5020).

Gera Programação de Rescisão (FR5030).
Manutenção de Programação de Rescisão (FR5040):

• Ao confirmar a inclusão ou geração de uma programação de rescisão, o TSA atualiza a data final com a data da rescisão do funcionário, do papel do usuário, centro de custo, cargo, unidade de lotação, localidade e turno.
• Ao confirmar a eliminação da programação de rescisão, o TSA cria um novo registro de papel, centro de custo, cargo, unidade de lotação, localidade e turno para o usuário.

Manutenção de Programação de Férias (FR0040).

Cálculo Individual de Férias (FR0080).

Geração de Programação de Férias Coletivas (FR0340):

• Ao confirmar a inclusão ou geração de uma programação de férias, o TSA cria uma situação de afastamento com a data do início das férias do usuário, se for data futura ou data atual se for data retroativa. Atualiza a data final da situação com a data das férias do usuário. Se a data final for retroativa o registro não é atualizado no TSA.
• Ao confirmar a alteração da programação de férias do usuário, o TSA atualiza a data de fim da situação de férias para a data alterada. Caso o período de férias seja menor que a data atual, então o registro não será atualizado no TSA.
• Ao confirmar a eliminação da programação de férias do usuário, o TSA atualiza a data de fim da situação de férias para a data atual. Se o período de férias que está sendo eliminado for menor que a data atual, o registro não será eliminado no TSA.

Importação de Marcações do TSA (PE7100): 

Por intermédio do programa PE7100, é possível a integração de marcações do TSA para o HCM. Para isso, é necessário realizar a configuração deste programa via RPW, conforme descritos nos procedimentos de pré-requisitos de implantação ou o usuário poderá executar o programa de tempos em tempos.

• O Log pode ser consultado para verificar se as marcações foram atualizadas com sucesso. Este se encontra no diretório de spool do servidor RPW quando parametrizado, ou, no diretório spool configurado para o usuário quando o programa executado pelo usuário.
• O log demonstra uma lista de marcações que foram processadas. O Retorno do processamento pode ser:
  • 1 - Indica que o processamento foi realizado com sucesso e as marcações encontram-se no PE3700.
  • 13 - Indica que o processamento das marcações de refeitório foi realizado com sucesso e encontram-se no PE3080.
  • 9 - Indica que o processamento das marcações foi realizado, no entanto, foi identificada inconsistência. Neste caso as marcações estarão disponíveis pelo programa PE3500. Depois da correção das informações elas podem ser reprocessadas pelo PE3500. A importação não deve ser eliminada pelo programa PE2222, elas devem ser corrigidas ou desconsideradas somente pelo PE3500.

Limitações / Restrições Gerais

Processo de Carga:

• A execução da carga deve ser realizada seguindo a ordem de informação relacionada no browse do programa de carga.

• O processo de carga de informações deverá ser realizado uma a uma; cada carga de informação deve ser iniciada e finalizada antes de iniciar a próxima.
• E antes de iniciar a próxima carga é necessária a conferência da quantidade de informação integrada com o TSA.
• Este processo de conferência é realizado comparando a quantidade de registros integrados do relatório de carga da informação com a quantidade de registros atualizados da informação no TSA, acessando o Monitor de Sistema Externo.
• No caso de Feriados X Dias Não Trabalhados, é necessária uma conferência mais detalhada de informações.

Turno:

• A integração de turno é a única que não é automática, a cada alteração de turno/jornada e intervalos é necessário realizar a integração de turno através do botão Atualizar na pasta Turma do programa FP1400 - Manutenção de turnos ou através do programa FP1404 - Atualização do Turno Controle de Acesso.

Prestador de Serviço:

• Somente são integrados Prestadores Pessoa Física com o TSA. O campo Data de Validade TSA tem como objetivo a integração ou não do prestador de serviço com o TSA no processo de carga ou a finalização do papel do prestador para que não seja mais gerada permissão para este prestador. No cadastro, caso esta data esteja informada, o TSA encerrará o papel do prestador no TSA

Feriados:

• Não gerar feriados para mais de um ano, pois isso poderá ocasionar problemas de performance e inconsistências no TSA.

Funcionário

• A cada atualização do funcionário será verificado se este funcionário se encaixa em alguma regra informada no programa Manutenção Regra para Exceção REP (PE7120). Caso o funcionário não se encaixe em nenhuma regra, é enviado um código 0 no campo profile que indica que o funcionário irá para o REP. Caso contrário, será enviado o código 1 que indica que o funcionário é do tipo “Exceção REP” e ele não será enviado para o REP. A atualização do campo Crachá TSA ocasiona uma atualização do crachá no TSA. Quando é realizada uma atualização de informação no cadastro de funcionário, o sistema emite mensagem de pergunta se deseja atualizar o crachá no TSA. Caso não seja necessária essa atualização, deve ser selecionado “Não”. Atentar para o formato do campo Crachá TSA tanto na atualização do campo Crachá TSA via programa de carga quanto pela admissão do funcionário. Sempre informar o crachá com o formato que ele é utilizado no TSA, por exemplo, se o formato é 8 dígitos, deve ser informado 00000523.