Atenção: Nova integração disponível a partir da versão 12.1.10 do TOTVS Linha Datasul HCM.
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.
Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na 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:
Arquitetura (Tecnologia):
Premissas:
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:
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:
Programa | Descrição do Programa | Movimentos Tipo de Informação Gerados |
PE7120 | Manutenção Regras para Exceção Funcionário (REP) | 24 - Exceção REP |
FP0560 | Manutenção Estabelecimento | 9 - Estabelecimento |
FP0660 | Manutenção Centros de Custo | 7 - Centro de Custo |
FP0800 | Manutenção Plano de Lotação | 1 - Unidade de Lotação |
FP0780 | Manutenção Unidade de Lotação | 1 - Unidade de Lotação |
FP0720 | Manutenção Cargo | 2 - Cargo/Nível |
FP1420 | Manutenção Pessoa Jurídica | 5 - Pessoa Jurídica |
FP1440 | Manutenção de Pessoa Física | 2 - Pessoa Física 23 - Imagem Pessoa Física |
FP0840 | Manutenção Prestador de Serviço | 10 - Prestador de Serviço |
FP0060 | Manutenção Situações | 11 - Situação de Afastamento |
FP1930 | Manutenção Localidade | 3 - Localidade |
FP1400 | Manutenção Turno de Trabalho | 6 - Turno Escala |
FP1930B | Feriados por Localidade | 8 - Feriados |
FP1200 | Manutenção Feriados Nacionais | 8 - Feriados |
FP1500 | Manutenção Funcionários | 12 - Funcionário |
FP1510 | Manutenção Funcionários Contratos Especiais | 12 - Funcionário |
FP1350 | Alteração Individual de Lotação (Unidade de Lotação, Centro de Custo, Turno e Localidade) | 13 - Histórico Lotação |
FP1300 | Altera Unidade de Lotação coletiva | 13 - Histórico Lotação |
FP1310 | Altera lotação Centro de Custo coletiva | 17 - Histórico Centro de Custo |
FP1360 | Alteração de Lotação/Turno | 16 - Histórico Turno |
FP1390 | Alteração de Localidade coletiva | 15 - Histórico Localidade |
FP1600 | Histórico Situação de Afastamento | 18 - Histórico Afastamento |
FP1620 | Manutenção Salários – Individual | 14 - Histórico Cargo |
FP1840 | Transferência de Funcionário de estabelecimento e empresa | 12 - Funcionário |
FP1850 | Transferência Coletiva de Funcionário | 12 - Funcionário |
FP8340 | Elimina Alterações Salariais do Período | 14 - Histórico Cargo |
FP1920 | Eliminação Coletiva Calendário | 21 - Exceção - Calendário Func/Localidade |
FP1940 | Manutenção Calendário Localidade | 21 - Exceção - Calendário Func/Localidade |
PE3000 | Manutenção Autorizações | 19 - Exceção - Autorização |
PE3040 | Geração Coletiva de Autorizações | 19 - Exceção - Autorização |
PE3030 | Importa Autorização Horas | 19 - Exceção - Autorização |
PE3050 | Eliminação Coletiva de Autorizações | 19 - Exceção - Autorização |
PE3100 | Altera Jornada de Trabalho | 20 - Exceção - Alteração Jornada |
PE3120 | Alteração Coletiva Jornada Trabalho | 20 - Exceção - Alteração Jornada |
PE3140 | Eliminação Alteração Coletiva Jornada Trabalho | 20 - Exceção - Alteração Jornada |
PE3900 | Empréstimo Turno/Turma/Intervalo | 25 - Empréstimo de Turno |
PE3910 | Empréstimo Coletivo Turno/Turma/Intervalo | 25 - Empréstimo de Turno |
PE3930 | Eliminação empréstimo coletiva Turno | 25 - Empréstimo de Turno |
PE1940 | Manutenção Calendário Funcionário | 21 - Exceção - Calendário Func/Localidade |
PE1920 | Eliminação calendário funcionário | 21 - Exceção - Calendário Func/Localidade |
PE3130J | Calendário Funcionário via Acerto de Divergências | 21 - Exceção - Calendário Func/Localidade |
FR5030 | Gera Programação Rescisão | 12 - Funcionário |
FR5040 | Manutenção de Programação de Rescisão | 12 - Funcionário |
FR0040 | Manutenção de Programação de Férias | 18 - Histórico Afastamento |
FR0340(FR0300) | Geração de Programação de Férias Coletivas | 18 - Histórico Afastamento |
RS0745(RS0027) | Gerar pessoa física | 4 - Pessoa Física |
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.
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.
Atençã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:
Conexão | Status | Consequência | Solução |
TSA | Não Configurado | Movimentos com situação "Retorno com Erro" e o tipo de erro Conexão. | Configurar a URL Webservice no programa de configuração. |
TSA | Erro Conexão | Movimentos com situação "Retorno com Erro" e o tipo de erro Conexão. | Verificar se o serviço do TSA está ativo ou se a URL foi informada corretamente. |
TSA | Erro HTTPSYS | Movimentos são integrados com o TSA, no entanto, o Status do TSA fica com essa informação. | Significa que a instalação do PROGRESS está com algum problema. Necessário realizá-la novamente. |
RPW | Não Configurado | Carga: não é afetada, pois a carga é online. | Selecionar o Servidor RPW no programa de configuração. |
RPW | Desativado | Carga: não é afetada pois a carga é online. | Indica que o RPW encontra-se desativado. Necessário ativar para que a integração possa ocorrer com TSA. |
RPW | Ativo - Sem Agendamento | Carga: não é afetada pois a carga é online. | Criar agendamento ou para o RPW, pois não foi encontrado. |
RPW | Ativo - Empresa | Somente movimentos da empresa configurada são integrados. | Significa que uma empresa foi informada na configuração do RPW. A empresa não deve ser informada no cadastro do RPW. |
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.
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.
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.
Manutenção Regras de Exceção de REP (PE7120):
Manutenção Estabelecimentos (FP0560):
Manutenção Centros de Custo (FP0660):
Manutenção Plano de Lotação (FP0800):
Manutenção Unidade de Lotação (FP0780):
Manutenção Cargo (FP0720):
Manutenção Pessoa Jurídica (FP1420):
Manutenção de Pessoa Física (FP1440):
Manutenção Prestador de Serviço (FP0840):
Manutenção Situações (FP0060)
Manutenção Localidade (FP1930):
Manutenção Turno de Trabalho (FP1400):
Feriados por Localidade (FP1930B):
Manutenção Feriados Nacionais (FP1200):
Manutenção Funcionários (FP1500) e Manutenção Funcionários Contratos Especiais (FP1510):
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):
Histórico Situação de Afastamento (FP1600).
Manutenção Salários – Individual (FP1620):
Transferência de Funcionário (FP1840).
Transferência Coletiva de Funcionário (FP1850):
Elimina Alterações Salariais do Período (FP8340):
Manutenção Calendário Localidade (FP1940):
Manutenção Autorizações (PE3000).
Geração Coletiva de Autorizações (PE3040).
Importa Autorização Horas (PE3030):
Eliminação Coletiva de Autorizações (PE3050):
Altera Jornada Trabalho (PE3100).
Alteração Coletiva Jornada Trabalho (PE3120):
Eliminação Alteração Coletiva Jornada Trabalho (PE3140):
PE3900 – Empréstimo Turno/Turma/Intervalo.
PE3910 – Empréstimo Coletivo Turno/Turma/Intervalo:
Eliminação Empréstimo Coletivo Turno/Turma/Intervalo (PE3930):
Manutenção Calendário Funcionário (PE1940).
Calendário Funcionário via Acerto de Divergências (PE3130J):
Cálculo Individual de Rescisão (FR5020).
Gera Programação de Rescisão (FR5030).
Manutenção de Programação de Rescisão (FR5040):
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):
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.
Processo de Carga:
A execução da carga deve ser realizada seguindo a ordem de informação relacionada no browse do programa de carga.
Turno:
Prestador de Serviço:
Feriados:
Funcionário