INTEGRAÇÃO Ahgora PontoWeb X DataSul (Nativa)Contexto de negócio (Introdução)O Produto PontoWeb destina-se a realizar a apuração do ponto dos funcionários durante o período apuração. Ao final, temos o resultado para lançar na folha de pagamento. Para facilitar as rotinhas diárias, ganhar tempo e reduzir riscos operacionais, o PontoWeb e o DataSul pode ser integrados de forma nativa. Os dados como cadastro de funcionários, afastamentos, códigos contábeis e sindicatos são enviados ao PontoWeb, para que não seja necessário realizar o cadastro novamente. Já os Resultados Apurados no período de apuração, são integrados/lançados diretamente na Folha de Pagamento. Com estas integrações ativas, outras funcionalidades ocorrem como: - Aplicar escala padrão para a apuração
- Aplicar sindicato para aplicação de regras de apuração
- Uso de hierarquia por líder imediato
- Afastamento por diversos motivos
Sistemas Envolvidos- DataSul - Folha de Pagamento
- Ahgora PontoWeb - Gestão e apuração de registros de marcação de ponto.
IntegraçãoPara o processo de integração funcionar corretamente, é necessários que diversas informações estejam cadastradas de acordo com a folha de pagamento. Neste sentido, criamos este processo de integração.
- Premissas
- Patch do DataSul estar atualizado.
- No PontoWeb, quando o cliente já utiliza, precisa ajustar alguns cadastros:
- Matrícula: Concatenar (Empresa + Estabelecimento + Matrícula)
- Escala: Concatenar (Empresa + Escala)
- Centro de Custo: Concatenar (Empresa + Centro de Custo)
- Motivo de Afastamentos: (Empresa + Código do Motivo de Afastamento)
Neste processo utilizamos APIs Rest Internas e o integrador 2.0 para a comunicação e orquestração de alguns fluxos.
Escopo
 Image Added
1.Dados de Funcionários: Admissões, Movimentações e Demissões (carga e periódica) - Disparado pela Folha, que envia ao Integrador os dados de pessoas criadas, alteradas e demitidas na folha. O job é executado, conforme os gatilhos na folha. Para isso é necessário criar os agendamentos na folha.
- A hierarquia será disparada através do agendado no Integrador 2.0 do PontoWeb, que realiza a criação e manutenção da árvore de hierarquia de acordo com os dados no cadastro do funcionário, sem delta (roda todos). Este precisa ser parametrizado no PontoWeb para rodar pelo menos uma vez ao dia.
2.Dados de Afastamentos: Criação, Alteração e Remoção (carga e periódica) - Disparado pela Folha, que envia ao Integrador os dados de afastamentos incluídos, alterados ou deletados na folha. O job é executado conforme os gatilhos na folha. Para isso é necessário criar os agendamentos na folha.
3.Sindicatos: Criação e Manutenção (carga) 4.Códigos Contábeis/Rubricas (Eventos): Criação e Manutenção (carga) 5.Resultados Apurados: Lançamentos (carga) - Disparado pelo Integrador 2.0, sempre que um usuário executa a integração através da tela de disparo manual do fluxo. O usuário seleciona os filtros para os dados serem enviados ao DataSul através de API Totvs.
Não esta contemplado neste Escopo
- Retorno para a folha de registros de afastamentos lançados diretamente no PontoWeb;
- Não está prevista a utilização de VPN ou qualquer ferramenta de segurança que não esteja mapeada nesse documento;
- Fluxos não incluídos neste documento.
Pré-requisitos instalação/implantação/utilização
DataSul- Deve estar em um dos patches:
PontoWeb Novo- Para bases novas do PontoWeb, os dados abaixo devem ser cadastrados conformo modelos. Lembrando que os valores são apenas exemplos:
Escalas: As escalas no PontoWeb devem ser cadastradas com os códigos concatenados. Assim, será possível integrar a escala padrão do funcionário:
Exemplo: Empresa (01) + Escala (111) → 01111
Centro de Custo: Os códigos de centro de custo devem ser concatenados:
Exemplo: Empresa (01) + Centro de Custo (022) → 01022
Motivos de Afastamento: Os códigos de motivos de afastamentos, devem ser cadastrados no PontoWeb concatenando a coligada:
Exemplo: Empresa (01) + Motivo (100) → 01100
PontoWeb Já Em Uso- Para bases que já possuem dados cadastrados e estão em uso, alguns dados precisam ser ajustados para que seja possível realizar a integração. Os ajustes são os mesmos do "PontoWeb Novo", onde os códigos de Escala, Centros de Custo e Motivos de Afastamentos precisam ser ajustados. Além disso, precisa ajustar o campo "Matrícula":
- Matrícula: O campo matrícula deve ser único no PontoWeb, sendo necessária a concatenação de dados para garantir a unicidade desta chave.
Exemplo: Empresa (01) + Estabelecimento (10) + Matrícula (12345) → 011012345
- Transferência de CNPJ: Para transferência, o sistema esta preparado para realizar a troca de matrícula. No DataSul, deve-se realizar um desligamento com o motivo de "Transferência". Realize o procedimento no RM Labore que a troca ocorrerá automaticamente.
Geral
- Verificar e ajustar no DataSul, o campo "Elegibilidade do Ponto";
- Ajuste do cadastro de funcionários (Matrícula);
- Cadastramento ou ajustes dos códigos de Centros de Custo;
- Cadastramento ou ajustes dos códigos de Escalas;
- Cadastramento ou ajustes dos códigos de Motivos de Afastamentos;
- Realizar a Carga Sindicatos (Integração de Sindicatos);
- Realizar as configurações necessárias relativas aos Sindicatos;
- Realizar o cadastramento das horas adicionais e criação dos "sheets" no PontoWeb;
- Realizar a Carga de Códigos Contábeis/Rubricas;
- Realizar a Carga de Dados de Funcionários (Integração de Funcionários);
- Realizar a Carga de Afastamentos (Integração de Afastamentos);
- Realizar o envio de Resultados Apurados (Integração de Resultados Apurados).
Criação de Usuário/Credenciais no DataSulCadastro Elegibilidade do Ponto no DataSulRestrição de IPsCriação de Usuário M2MConfiguração dos fluxos de integraçãoCadastro de FuncionáriosCadastro de AfastamentosCadastro de Centros de CustosCadastro de EscalasCadastro de SindicatosCadastro de Eventos/Rubricas
Ativação e Configuração dos FluxosPara ativar o serviço na base do PontoWeb, entre em: Ativação Integração - TOTVS (Nativas) x PontoWeb
Layout de Campos
ITG2.0-TNXX Layout de campos DataSul Nativa ITG2.0-TN01 Nativa DataSul x Ahgora PontoWeb - TOTVS RH Linha Ahgora Integrador - TDN
| 