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.

select * from parametermodel where _section = 'MBCS_COLC'  and _entry in ('TENANT_CAROL','DOMINIO_AUT_CAROL','METODO_AUT_CAROL','ORGANIZACAO_CAROL', 'AMBIENTE_CAROL'  )
update parametermodel set _value = '@totvs.com.br' where  _section = 'MBCS_COLC'  and _entry = 'DOMINIO_AUT_CAROL';

update parametermodel set _value = 'totvsrm' where  _section = 'MBCS_COLC'  and _entry = 'AMBIENTE_CAROL';
update parametermodel set _value = 'totvsclockin' where  _section = 'MBCS_COLC'  and _entry = 'ORGANIZACAO_CAROL';
update parametermodel set _value = 'totvsrm' where  _section = 'MBCS_COLC'  and _entry = 'TENANT_CAROL';

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