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.
|
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.
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 
.
Para mais informações sobre os campos Nome Organização e Nome Ambiente verifique o documento https://docs.carol.ai/docs Para mais informações sobre os campos Connector Id e Connector Token verifique o documento https://centraldeatendimento.totvs.com/hc/pt-br/articles/4408796105495-RH-Clock-In-by-Carol-Connector-Token |
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.
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.
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.
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 tela de parâmetros é possível escolher entre duas opções de Baixa de Marcações.
Ao finalizar a execução, o PE9696 gera um log das etapas do processo de baixa das marcações da Carol Clock-in para o Totvs Datasul, reportando o 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 resumida: Identifica de forma resumida a que se refere a mensagem.
Descrição completa: Traz 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:
| Código | Tipo | Mensagem Resumida | Descrição completa | Observação sobre o erro |
| 0 | Erro | Erro ao conectar no endereço informado | Erro no endereço informado, por favor, validar o endereço cadastrado no FP0540 | Valida se foi possível se comunicar com o Clock-in, este erro pode ser causado por digitação errada do endereço no FP0540, ou por problemas de rede/comunicação entre Totvs x Clock-in |
| 1 | Erro | Falha de Conexão | Favor verificar a parametrização de conexão com a Carol Clock-in no programa FP0540 | Valida se foi possível se comunicar com o Clock-In, este erro é apresentado quando um dos campo do FP0540 não estão preenchido como: Nome da Organização, Nome do Ambiente, Connector Id, Connector Token |
| 2 | Status | Conexão Carol Clock In | url: mostraenderecoconexao.carol.ai | Mostra a Url de conexão apenas para informação |
| 3 | Erro | Falha na requisição dos dispositivos | Clock-in Erro requisitar dispositivo: ... | Falha no momento em que o programa tenta acessar os dispositivos cadastrados na Carol Clock-in que contem as marcações. para baixar as informações |
| 4 | Erro | Erro Disp Carol Clock-in | Dispositivo não encontrado no PE0620: REP 12313 | Falha no momento em que o programa tenta acessar o dispositivo cadastrados na Carol Clock-in conforme cadastros de relógios no PE0620 |
| 5 | Erro | Falha ao registrar marcações | Falha ao registrar marcações nas tabelas do Totvs: | Falha ao tentar gravar as marcações baixadas na Carol Clock-in |
| 6 | Erro | Favor verificar a validade do Dispositivo | Data de validade do Relógio não contempla a da da marcação "reprelógio" | Falha ao tentar gravar as marcações baixadas na Carol Clock-in por erro de dados do cadastro do Relógio no PE0620 |
| 7 | Erro | Falha na requisição de marcações | Verifique na Carol Clock-in o conteúdo e o formato dos campos: nsrCode, eventdatestr e piscode | Falha ao tentar requisição para começar a baixar informações de marcações |
| 8 | Status | Termino de Processo | Total de dispositivos lidos: 5 | Términos de Processo, apenas informativo |
| 8.1 | Status | Termino de Processo | Termino processo requisição de marcações | Términos de Processo requisição de marcações das tabelas do Clock-in, onde os dados são preparados para serem gravados no Totvs Datasul, apenas informativo |
| 8.2 | Status | Termino de Processo | Termino da tentativa de gravação de marcações nas tabelas internas do Totvs | Términos de Processo de gravação nas tabelas internas do Totvs Datasul, apenas informativo, não garante que o processo foi feito com sucesso, depende se não ocorrer erros que serão reportados |
| 9 | Status | Buscando Marcações | Inicio da Busca de Marcação Código REP 123132 X NSR 1313 | Início de Processo |
| 10 | Erro | Dispositivo com código REP duplicado | Verificar na Carol Clock-in o cadastro do dispositivo, Devicecode | Erro reportado quando mais de um dispositivo estiver cadastrado com mesmo número de Rep na plataforma da Carol Clock-in |
| 500 | Status | Erro Interno do Servidor | Erro Interno do Servidor ao tentar conectar com dispositivos | Erro de comunicação com o servidor, o servidor foi encontrado mais a comunicação não é concluída |
Ao final da execução do PE9696 será gerado um relatório em arquivo Excel com todas as importações que foram geradas pelo PE9696, com isto é possível realizar uma analise de quais batidas foram importadas do Carol/Clock-in para o Datasul.
Exemplo do relatório gerado ao final do processamento:
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
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.
| Mensagem | Possível Origem |
|---|---|
| verify_fields: verifique parametro de conexao | Uma ou mais informações não estão preenchidas no FP0540. |
| get_device_list -> v_response_code | Código de retorno da requisição dos dispositivos, caso diferente de 200, está com algum erro de comunicação. |
| get_device_list -> v_response_status | Descrição detalhada do erro de comunicação. |
| get_device_list -> repcode: Este repcode: 99999 esta vindo com formato string. | O dispositivo está com o formato errado, consultar a Totvs Labs para possível soluções. |
| get_device_list -> devicecode | Número do dispositivo reconhecido. Esta mensagem pode ser utilizada para verificar se realmente todos os dispositivos listados pelo cliente estão sendo importados. |
| get_device_list -> repcode | Número do repcode reconhecido. Esta mensagem pode ser utilizada para verificar se realmente todos os dispositivos listados pelo cliente estão sendo importados. |
| get_records_list > p-nsrCode | Número do nsrCode utilizado para consultar as marcações no Clockin, ou seja, o valor retornado nesta mensagem o sistema irá requisitar as marcações a partir dele. |
| get_records_list > p-deviceCode | Número do dispositivo que foi realizada a requisição das marcações. |
| get_records_list > v_response_code | Código de retorno da requisição dos dispositivos, caso diferente de 200, está com algum erro de comunicação. |
| get_records_list > v_response_status | Descrição detalhada do erro de comunicação. |
| get_records_list > Falha na requisição Servido Clockin - Verifique se informado e o formato campos: nsrCode, eventdatestr e piscode | Esta mensagem é originada quando o retorno das marcações do clockin possui alguma inconsistência de formato ou não existência dos campos, neste caso deve-se verificar com o Totvs Labs. Caso aconteça alguma falha de comunicação com o servidor (falta de internet por exemplo) pode originar essa mensagem. Neste caso é importante também verificar os certificados de importação. |
| pi_records_msa_control_marcac > before-record | As marcações foram importadas corretamente e o próximo passo será a gravação na tabela msa_control_marcac. |
| pi_records_msa_control_marcac > validade dispositivo | O período de validade do dispositivo está fora da marcação, deve-se verificar o programa PE0620. |
| pi_records_msa_control_marcac > falha ao registrar marcacoes | No processo de gravação das marcações na tabela msa_control_marcac ocorreu algum problema. Um dos motivos pode ser o formato dos campos retornados na requisição. |
| get_device_list > Verificar na Carol ClockIn o cadastro do dispositivo, Devicecode: devicecode Rep: repcode | Erro reportado quando mais de um dispositivo estiver cadastrado com mesmo número de Rep na plataforma da Carol Clock-in |
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:
Essa funcionalidade foi criada pela TOTVS LABS. Qualquer dúvida em relação a esta funcionalidade entre em contato com o atendimento da Carol [email protected].
|
<!-- 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>
|
