Bem vindos ao mundo TOTVS. Aqui você via encontrar todas as informações para ativar e configurar as integrações nativas. Basta escolher a linha e seguir as orientações.



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ção

Para 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)


  • Arquitetura (Tecnologia)

Neste processo utilizamos APIs Rest Internas e o integrador 2.0 para a comunicação e orquestração de alguns fluxos. 


Escopo




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

  • Na primeira integração, deve-se seguir a seguinte ordem de ações:


  1. Verificar e ajustar no DataSul, o campo "Elegibilidade do Ponto";
  2. Ajuste do cadastro de funcionários (Matrícula);
  3. Cadastramento ou ajustes dos códigos de Centros de Custo;
  4. Cadastramento ou ajustes dos códigos de Escalas;
  5. Cadastramento ou ajustes dos códigos de Motivos de Afastamentos;
  6. Realizar a Carga Sindicatos (Integração de Sindicatos);
  7. Realizar as configurações necessárias relativas aos Sindicatos;
  8. Realizar o cadastramento das horas adicionais e criação dos "sheets" no PontoWeb;
  9. Realizar a Carga de Códigos Contábeis/Rubricas;
  10. Realizar a Carga de Dados de Funcionários (Integração de Funcionários);
  11. Realizar a Carga de Afastamentos (Integração de Afastamentos);
  12. Realizar o envio de Resultados Apurados (Integração de Resultados Apurados).


Configuração e Informações Adicionais



Ativação e Configuração dos Fluxos

Para 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 x Ahgora PontoWeb - TOTVS RH Linha Ahgora Integrador - TDN


INTEGRAÇÃO Ahgora PontoWeb X RM Labore (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 RM Labore 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

  • RM Labore - Folha de Pagamento
  • Ahgora PontoWeb - Gestão e apuração de registros de marcação de ponto.



Integração

Para 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 RM Labore estar atualizado.
    • No PontoWeb, quando o cliente já utiliza, precisa ajustar alguns cadastros:
      • Matrícula: Concatenar (Coligada + Matrícula)
      • Escala: Concatenar (Coligada + Escala)
      • Centro de Custo: Concatenar (Coligada + Centro de Custo)
      • Motivo de Afastamentos: (Coligada + Código do Motivo de Afastamento)


  • Arquitetura (Tecnologia)

Neste processo utilizamos APIs Rest Internas e o integrador 2.0 para a comunicação e orquestração de alguns fluxos. 


Escopo




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 RM Labore 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


RM Labore

  • 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: Coligada (001) + Escala (111) → 001111

    • Centro de Custo: Os códigos de centro de custo devem ser concatenados:

      Exemplo: Coligada (001) + Centro de Custo (022) → 001022

    • Motivos de Afastamento: Os códigos de motivos de afastamentos, devem ser cadastrados no PontoWeb concatenando a coligada:

      Exemplo: Coligada (001) + Motivo (100) → 001100


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: Coligada  (001) + Matrícula (12345) → 00112345

      • Transferência de CNPJ: Para transferência, o sistema esta preparado para realizar a troca de matrícula. No RM Labore, deve-se realizar um desligamento com o motivo de "Transferência". Realize o procedimento no RM Labore que a troca ocorrerá automaticamente.

Geral

  • Na primeira integração, deve-se seguir a seguinte ordem de ações:


  1. Verificar e ajustar no RM Labore, o campo "Elegibilidade do Ponto";
  2. Ajuste do cadastro de funcionários (Matrícula);
  3. Cadastramento ou ajustes dos códigos de Centros de Custo;
  4. Cadastramento ou ajustes dos códigos de Escalas;
  5. Cadastramento ou ajustes dos códigos de Motivos de Afastamentos;
  6. Realizar a Carga Sindicatos (Integração de Sindicatos);
  7. Realizar as configurações necessárias relativas aos Sindicatos;
  8. Realizar o cadastramento das horas adicionais e criação dos "sheets" no PontoWeb;
  9. Realizar a Carga de Códigos Contábeis/Rubricas;
  10. Realizar a Carga de Dados de Funcionários (Integração de Funcionários);
  11. Realizar a Carga de Afastamentos (Integração de Afastamentos);
  12. Realizar o envio de Resultados Apurados (Integração de Resultados Apurados).


Configuração e Informações Adicionais




Ativação e Configuração dos Fluxos

Para 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 RM Labore Nativa x Ahgora PontoWeb - TOTVS RH Linha Ahgora Integrador - TDN

INTEGRAÇÃO Ahgora PontoWeb X Protheus (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 Protheus 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

  • Protheus - Folha de Pagamento
  • Ahgora PontoWeb - Gestão e apuração de registros de marcação de ponto.


Integração

Para 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 Protheus estar atualizado.
    • No PontoWeb, quando o cliente já utiliza, precisa ajustar alguns cadastros:

      • Matrícula: Concatenar (Empresa + Filial + Matrícula)

(informação) Deve ser identificado o tipo de tabela utilizada no Protheus, podendo ser “Compartilhada” ou “Exclusiva”, para realizar a concatenação da forma correta



Compartilhada:

      • Escala: Concatenar (Empresa + Escala)
      • Centro de Custo: Concatenar (Empresa + Centro de Custo)
      • Motivo de Afastamentos: (Empresa + Código do Motivo de Afastamento)


Exclusiva:

      • Escala: Concatenar (Empresa + Filial + Escala)
      • Centro de Custo: Concatenar (Empresa + Filial + Centro de Custo)
      • Motivo de Afastamentos: (Empresa + Filial + Código do Motivo de Afastamento)


  • Arquitetura (Tecnologia)

Neste processo utilizamos APIs Rest Internas e o integrador 2.0 para a comunicação e orquestração de alguns fluxos. 


Escopo




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 Protheus 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


Protheus

  • Deve estar em um dos patches:


  • Elegibilidade de Ponto: Ajustar os cadastros dos Funcionários no Protheus para "Ponto Livre" ou "Ponto Obrigatório)" antes de realizar a integração dos funcionários.

    Ponto Livre: Não registra ponto;
    Ponto Obrigatório: É obrigado a registrar o ponto.


PontoWeb Novo

  • Para bases novas do PontoWeb, os dados abaixo devem ser cadastrados conformo modelos. Lembrando que os valores são apenas exemplos. Para o Protheus, existem dois cenários de dados "Tabela Compartilhada" e "Tabela Exclusiva":

    (ideia)Tabela Compartilhada, significa que as tabelas de escalas, centros de custo e motivos de afastamentos são compartilhadas por todas as empresas do Protheus. Já a Exclusiva, cada empresas possui uma tabela diferente.

    • Matricula: 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) + Filial (10) + Matrícula (12345) -> 011012345

      • Transferência de CNPJ: Para transferência, o sistema esta preparado para realizar a troca de matrícula. No Protheus, realize o processo de transferência de CNPJ, que a troca ocorrerá automaticamente no PontoWeb.


Compartilhada:

    • Escalas: As escalas no PontoWeb devem ser ajustadas para que os códigos sejam concatenados. Assim, será possível integrar a escapa 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


Exclusiva:

    • Escalas: As escalas no PontoWeb devem ser ajustadas para que os códigos sejam concatenados. Assim, será possível integrar a escapa padrão do funcionário:

      Exemplo: Empresa (01) + Filial (10) + Escala (111) → 0110111

    • Centro de Custo: Os códigos de centro de custo devem ser concatenados:

      Exemplo: Empresa (01) + Filial (10) + Centro de Custo (022) → 0110022

    • Motivos de Afastamento: Os códigos de motivos de afastamentos, devem ser cadastrados no PontoWeb concatenando a coligada:

      Exemplo: Empresa (01) + Filial (10) + Motivo (100) → 0110100



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":

    • Matricula: 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) + Filial (10) + Matrícula (12345) → 011012345

      • Transferência de CNPJ: Para transferência, o sistema esta preparado para realizar a troca de matrícula. No Protheus, realize o processo de transferência de CNPJ, que a troca ocorrerá automaticamente no PontoWeb.

Compartilhada:

    • Escalas: As escalas no PontoWeb devem ser ajustadas para que os códigos sejam concatenados. Assim, será possível integrar a escapa 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


Exclusiva:

    • Escalas: As escalas no PontoWeb devem ser ajustadas para que os códigos sejam concatenados. Assim, será possível integrar a escapa padrão do funcionário:

      Exemplo: Empresa (01) + Filial (10) + Escala (111) → 0110111

    • Centro de Custo: Os códigos de centro de custo devem ser concatenados:

      Exemplo: Empresa (01) + Filial (10) + Centro de Custo (022) → 0110022

    • Motivos de Afastamento: Os códigos de motivos de afastamentos, devem ser cadastrados no PontoWeb concatenando a coligada:

      Exemplo: Empresa (01) + Filial (10) + Motivo (100) → 0110100


Geral

  • Na primeira integração, deve-se seguir a seguinte ordem de ações:


  1. Verificar e ajustar no Protheus, o campo "Elegibilidade do Ponto";
  2. Ajuste do cadastro de funcionários (Matrícula);
  3. Cadastramento ou ajustes dos códigos de Centros de Custo;
  4. Cadastramento ou ajustes dos códigos de Escalas;
  5. Cadastramento ou ajustes dos códigos de Motivos de Afastamentos;
  6. Realizar a Carga Sindicatos (Integração de Sindicatos);
  7. Realizar as configurações necessárias relativas aos Sindicatos;
  8. Realizar o cadastramento das horas adicionais e criação dos "sheets" no PontoWeb;
  9. Realizar a Carga de Códigos Contábeis/Rubricas;
  10. Realizar a Carga de Dados de Funcionários (Integração de Funcionários);
  11. Realizar a Carga de Afastamentos (Integração de Afastamentos);
  12. Realizar o envio de Resultados Apurados (Integração de Resultados Apurados).


Configuração e Informações Adicionais



Ativação e Configuração dos Fluxos

Para 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 Protheus Nativa x Ahgora PontoWeb - TOTVS RH Linha Ahgora Integrador - TDN

deck.tab.inactive.background = #fffffff
deck.tab.active.background = #b3a5ef