CONTEÚDO

01. OBJETIVO

Apresentar ao usuário final que faça uso da plataforma Carol para marcações de ponto dos colaboradores, como configurar o Datasul para habilitar a integração automática de marcações.

02. VISÃO GERAL

A configuração da integração entre o produto Datasul e Carol se baseia na parametrização do FP0540 e na execução do programa PE9696 que aciona as API's para importação das batidas. Posteriormente a execução do programa PE7100 para cadastro das batidas no ambiente Datasul.

A informação do PIS code pode ser consultada na plataforma da Carol, https://dominioCliente.carol.ai/totvsdatasul/carol-ui/explore/employee/search, selecionar o funcionário e consultar o campo PIS code.

03. PRÉ-REQUISITOS

• A criação destes parâmetros está disponível a partir da 12.1.29.3 (versão mínima Progress 11.7.5). 
• Necessária a utilização do módulo de Controle de Frequência do sistema Datasul.

04. PARAMETRIZAÇÃO DATASUL

a. Descentralização RH

A página de parâmetros da função FP0540 - Descentralização RH, permite a configuração das informações de integração com o Clock In/Carol.

Essas informações são necessárias para permitir a comunicação entre Datasul e Carol, sendo fornecidas na contratação e criação do ambiente na Carol.

Após o preenchimento dos dados é possível testar a comunicação com a Carol Clock In clicando no botão .

 A partir desta configuração, é ativada a função FP9696 permitindo que seja possível selecionar e definir quais funcionários tem perfil de coordenador.

b. Coordenadores Clock In/Carol

A função FP9696 - Coordenadores Clock In/Carol permite a identificação dos funcionários com papel de coordenador que utilizarão o aplicativo Clock In para realizar as marcações de seus funcionários.

Basta relacionar os funcionários (coordenadores) para que os dados destes sejam enviados para o ambiente da Carol.

Através do botão "Formar" será possível relacionar os coordenadores.

Será apresentada a seguinte tela:

Na coluna/browser da esquerda serão apresentados os funcionários da empresa corrente, e na coluna/browser da direita os coordenadores que já foram relacionados.

Caso o usuário queira relacionar funcionários de outras empresas, será necessário clicar no botão "Filtrar". Através desta tela é possível filtrar, além da empresa, por estabelecimento e matrícula. Caso contrário basta deixar os campos com o valor "0"(zero) para que sejam apresentados todos os estabelecimentos e matrículas da empresa informada:

Outra funcionalidade disponível nesta tela é a busca de funcionários pelo nome.

Basta informar no campo "Nome" e clicar no botão check verde.

Para os coordenadores que já estão relacionados, também é possível filtrar os funcionários que estão ativos, desligados ou ambos. 

Para salvar os registros, utilizar o botão central para movimentar da coluna esquerda para direita, em seguida clicar no botão "OK".

 A inclusão/exclusão de coordenadores nesta função efetua o envio dos dados destes para atualização do ambiente na Carol.

c. Manutenção Relógio Ponto

Para implementação do cadastro de relógio ponto, deve-se definir um código e sua respectiva descrição, informando o local onde o mesmo está relacionado e o tipo de batida que o mesmo aceita. Para maiores esclarecimentos acessar Manutenção do Relógio Ponto - PE0620.

• O número do REP cadastrado no PE0620 deve ser o mesmo informado no campo REP CODE no cadastro dos dispositivos na Carol Clock-in. É uma informação obrigatória e necessariamente deve ser diferente de 0 (zero).
• O cadastro do REP CODE no ambiente Carol/Clockin pode ser realizado pelo seguinte link: https://dominioCliente.carol.ai/totvsdatasul/apps/clockinapp/3.1.0-b/#/devices.
• Para cadastrar um dispositivo é premissa ter o cadastro de empresa e localização já efetuados o Cadastro de código de dispositivo sem máscara.

05. IMPORTAÇÃO DAS MARCAÇÕES PONTO

Para realizar a importação das marcações é necessário utilizar o programa PE9696 -  Importação de Marcações Clock In/Carol que, através da conexão com o ambiente da Carol, fará a importação das marcações de ponto a partir do último NSR lido por dispositivo ativo.

Na aba Parâmetros é possível escolher entre duas opções de Baixa de Marcações:

• Um Dispositivo por Vez - faz a baixa de marcações de um dispositivo por vez. Apresenta o limite de 200 registros por requisição/resposta.
  • Esta forma de baixar marcações apresenta vantagem quando há um número menor de dispositivos cadastrados e um melhor detalhamento do processo impresso no log.
• Por Lote de Dispositivos - faz a baixa de marcações de vários dispositivos em uma única requisição a Carol Clock In. Apresenta o limite de 1000 registros por requisição, obtendo as marcações de diversos dispositivos por resposta.
  • Esta forma de baixar marcações apresenta melhor performance, executando de forma mais rápida, principalmente quando existe um número maior de dispositivos.     

a. Log de Execução

Ao finalizar a execução, o PE9696 gera um log de execução das etapas do processo de baixa das marcações da Carol Clock-in para o Totvs Datasul, reportando os status e erros, caso ocorram. 

O Log de execução é composto por 4 colunas:

Código: Organiza e identifica as mensagens.

Tipo: Identifica a informação como Erro ou Status do processo feito pelo programa.

Descrição:  Identifica de forma resumida à que se refere a mensagem.

Detalhe/Observação: Traz mais detalhes sobre a mensagem conforme o ponto do processamento.

A tabela abaixo mostra todas as mensagens, e sua correlação de uso, situações de erro ou reporte, dentro do programa:

b. Relatório Excel com as Marcações Importadas

Ao final da execução do PE9696 será gerado um arquivo com extensão '.csv' com todas as marcações baixadas e, que ainda não foram processadas pelo PE7100.

Ex:

  Após a realização da importação das batidas da Carol, é necessário executar o programa PE7100, para realizar as importações das batidas no sistema, que poderão ser visualizadas junto das funções PE3700 (Batidas Ponto) ou PE3500 (Erros Importação Batidas).

Importante destacar que a Carol também disponibiliza uma função para a exportação dos arquivos de marcação no formato AFD (http://www.trtsp.jus.br/geral/tribunal2/ORGAOS/MTE/Portaria/P1510_09.html). Essa função é uma outra alternativa manual que o usuário pode utilizar para fazer a importação das batidas do funcionário para a base Datasul. Para maiores detalhes em como efetuar a exportação do arquivo AFD, consulte a documentação: Download das marcações usando layout AFD

06. CLIENTLOG

Também foram implementados alguns logs para auxiliar o atendimento na identificação de algum eventual problema na integração. Para consultar os log da integração pode-se buscar por #clockin no clientlog.

Segue uma tabela com as mensagens que podem estar no clientlog e alguns motivos da origem destas mensagens.

07. INTEGRANDO COM TOTVS CAROL

Para conhecer os principais serviços e saber como construir uma integração para envio e consumo de dados da Carol, acesse a página Integrando com TOTVS Carol.  

Os subtópicos podem ser acessados através da árvore da página conforme exemplo abaixo:

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