INTEGRAÇÃO Meu Controle Mão Obra Rural (MBCS_COLCAM)

X   TOTVS RH Clock-in

Contexto de negócio (Introdução)

Realização dos apontamentos de marcações de ponto via Clock In por reconhecimento facial, cracha, cpf/id do colaboradores , enviando as informações ao colcam que posteriormente são enviadas ao PIMS

Sistemas Envolvidos

Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).

• Meu controle de Mão de Obra Rural (MBCS_COLCAM), usado para realizar os apontamentos de marcações de colaboradores em áreas urbana ou rural.
• PIMS Bioenergia , utilizado como origem de dados para o MBCS_COLCAM, com parâmetros, funcionários, regras de marcações, etc...
• Clock in - BackOffice, utilizado para cadastro  do colaborador com informações como, e-mail, telefone, cpf/id, e fotos para reconhecimento facial.
• Clock in App - utilizado para realizar a marcação do colaborador

Integração

Foi criado a integração entre os aplicativos devido a necessidade de maior segurança na apuração de marcação da jornada de trabalho do colaborador, trazendo uma maior agilidade e segurança aos dado registrados.

• Arquitetura (Tecnologia)
• Android Nativo
• DeepLink

Escopo

A integração tem como objetivo  o controle de jornada dos colaboradores, envolvendo apontamentos e marcações.

Defina exatamente o que a integração FAZ, o que ela NÃO FAZ e a sua finalidade.

O COLCAM realiza login ao Clock in para que no mesmo seja feito o apontamento das marcações, que são retornadas e gravadas ao COLCAM  e gravadas no aplicativo, para que sejam enviadas ao 

Os aplicativos se integram via Deeplink a onde são efetuado  as integrações entre os aplicativos, o envido dos dados/marcações .

Citar a responsabilidade de cada produto.

COLCAM -  realizar o login no clockin abrindo o aplicativo, receber os dados do clock in e gravar as marcações.

CLOCK IN - Realiza o apontamento via  identificação facial, cracha, cpf, retornar os dados ao colcam

Descrever com mais detalhes sobre o que será integrado (mas não ser especialista nas entidades/processos, pois suas particularidades serão descritas posteriormente) incluindo diagramas, prints, imagens, etc o que for interessante para auxiliar o entendimento.

O fluxo das integração segue o diagrama de sequencia a baixo.

Pré-requisitos instalação/implantação/utilização

Para o funcionamento correto da integração deve se ter a versão 12.1.24060002  ou superior do ClockIn.

Para o funcionamento correto do COLCAM com o ClockIn deve se ter a versão 12.1.2406.001 ou superior.

Plataforma Android 14 ou superior. Ambientes Homologados → verifique a orientação para o aplicativo MBCS_COLCAM.

Portal mobilidade, com ambiente configurado ao bioenergia e com serviços configurados corretamente.

Realizado as configurações de parâmetros no PIMS Bioenergia contida no doc Horário do Rural item 6.

Forma de simular as integrações via adb.

Efetuar login no clockin via adb

adb shell am start -a android.intent.action.VIEW -d "clockin://login/oauth2?organization=totvsclockin&environment=totvsrm&tenant=totvsrm&email=murilo.rsilva%40totvs.com.br&password=39691&appScheme=colcam&appName=Meu%20controle%20de%20m%C3%A3o%20de%20obra%20rural&appIdentifier=agro.totvs.meucontrolemaoobrarural"

Exemplos retorno clockin:

colcam://clockin?colcamData=[{"name":"clockins","data":{"clockinCoordinates":"-22.9865897,-49.8549622","clockinDatetimeStr":"2024-07-04T14:56:00.000-03:00","employeePersonId":"11122233343"}}]

adb shell am start -a android.intent.action.VIEW -d 'colcam://clockin?colcamData=%5B%7B%22name%22%3A%22clockins%22%2C%22data%22%3A%7B%22clockinCoordinates%22%3A%22-22.9865897%2C-49.8549622%22%2C%22clockinDatetimeStr%22%3A%222024-07-04T14%3A56%3A00.000-03%3A00%22%2C%22employeePersonId%22%3A%2211122233343%22%7D%7D%5D'

Fluxo das Informações

Os dados esperados  e estrutura vindo pelo deep link no seguinte formato.

colcam://clockin?colcamData=[{"name":"clockins","data":{}]

Como fazer (opcional)

Como fazer no ambiente dev.

Utilizando adb para Logins no Clockin via DeepLink

Emulando recebimento de apontamentos Clockin → Colcam

Anexos