Histórico da Página

...

1. Objetivo
2. Visão Geral
3. Exemplo de Utilização
   1. Parametrização
   2. Cadastro do Relógio Carol
   3. Schedule\Menu
   4. Detalhes do PONAPI01
4. Configuração SSL
5. Tela de Cadastro de Schedule
6. Tela de Cadastro de Menu
   
7. Mensagens de Integração
8. Tabelas utilizadas
9. Rotinas envolvidas
10. Anexos

...

04. CONFIGURAÇÃO SSL

Para realizar requisições para a Carol, será necessária a configuração do SSL no Appserver. Atualmente a Carol utiliza a versão SSL2 e por este motivo é necessária a configuração do SSL por parte do Protheus. Segue abaixo um exemplo da configuração:

Image Added

Para mais informações de como realizar a configuração do SSL no AppServer, no final da desta documentação, em anexos, estará disponível o link do passo a passo de como realizar a configuração.

05. TELA DE CADASTRO DE SCHEDULE  

Âncora
Schedule Schedule

Cadastro de Rotina

...

Gerenciamento da fila e execução dos agents.

...

06. TELA DE CADASTRO DE MENU

Âncora
CadMenu CadMenu

Tela de listagem de menus

...

Tela de configuração do menu escolhido

...

07. Mensagens de Integração 

Para possibilitar o acompanhamento  da integração do Protheus com a Carol, será apresentado algumas mensagens em tela caso o acionamento seja manual pelo menu ou no console.log, quando a rotina for acionada via Schedule.

• Caso o código NSR enviado por parâmetro e o mesmo seja abaixo de zero:
  • Verifique o Código NSR Informado, pois o mesmo somente aceita números positivos!
• Inconsistências nas datas:
  • Verifique as Datas informadas para acesso ao Clock In da Carol.
• Será apresentada a seguinte mensagem e a mensagem retornada da plataforma Carol.
  • Não foi possível acessar a API Clockin da Carol.
• Problemas com o preenchimento dos parâmetros:
  • Verifique o parâmetro MV_APICLO1 pois ele é responsável pelo cadastro da URL de EndPoint para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO2 pois ele é responsável pelo cadastro do path da API Token para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO3 pois ele é responsável pelo cadastro do Id Conector para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO4 pois ele é responsável pelo cadastro do User Name para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO5 pois ele é responsável pelo cadastro do Password para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO6 pois ele é responsável pelo cadastro do Domain Name para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO7 pois ele é responsável pelo cadastro do path da API DeviceList para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO8 pois ele é responsável pelo cadastro do path da API clockinrecordsList para a integração de Clock In da Carol.
  • Não foi possível acessar a API Clock In da Carol. Verifique os parametros MV_APICLO0, MV_APICLO1, MV_APICLO2, MV_APICLO3, MV_APICLO4, MV_APICLO5, MV_APICLO6,MV_APICLO7, MV_APICLO8 com as informações fornecidas.
  • Não foi possível acessar a API Clock In da Carol. Verifique os parametros MV_APICLO0, MV_APICLO1, MV_APICLO2, MV_APICLO3, MV_APICLO4, MV_APICLO5, MV_APICLO6,MV_APICLO7, MV_APICLO8, MV_APICLO9 com as informações fornecidas.
  • Não foi possível acessar a API Clock In da Carol. Verifique o parametro MV_APICLO8 pois ele é responsável pelo cadastro do path da api clockinrecordsList para a integração de Clockin da Carol.
  • O parâmetro MV_APICLO9 está vazio ou não foi criado e a Carol possui uma organização configurada. Por favor crie e preencha o MV_APICLO9 com o Nome da Organização.

...

08. TABELAS UTILIZADAS 

• SP0 -  Pré-Leitura\Relógio de Ponto;  
• RFE -  Relógio de Ponto;  
• SP8 - Movimento de Marcações;  
• MSA_CONTROL_MARCAC - Tabela criada na primeira carga de dados com a Carol, esta tabela também é utilizada no modelo de integração com o TSA e, a partir deste momento, será processado pelo sistema onde será gerado os registros na SP8.

...

09. Rotinas Envolvidas

• GPEA010: Cadastro de Funcionários;
• PONA030: Cadastro de Relógios;
• PONM010: Leitura e Apontamento.

...

10. Anexos

1. DRHGCH-13658 Alterar rotina PONA030 - Relógio (Detalhes para funcionamento na rotina PONA030)
   1. https://tdn.totvs.com/x/kum2Hg
2. DRHGCH-13255 - Integração Ponto X Carol - Batidas - API de acesso ao Token ( Detalhes sobre o funcionamento na rotina PONAPI01)
   1. https://tdn.totvs.com/x/34W2Hg
3. DRHGCH-13652 Integração Ponto X Carol - Batidas - API de acesso ao DeviceList
   
   1. https://tdn.totvs.com/x/frC2Hg
4. Seção [SSLConfigure]
   
   1. https://tdn.totvs.com/x/4Ypc
      

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

...