01. VISÃO GERAL
Esta documentação tem como objetivo demonstrar quais são os campos do ERP RM que são utilizados para a integração das informações com o Clockin.
Segue pré-requisitos de versão para o RM:
- RM 12.1.23 - Release oficial
- RM 12.1.22 - Patch de liberação 12.1.22.267
02. CAMPOS INTEGRADOS COM CLOCKIN
Abaixo estão os Data Models do Clockin onde recebem informações que são demonstradas no Backoffice:
- Data Model Company (Empresa):
- psecao_consolidado_gfilial: staging que compõe o DM Company (Empresa) que é a Empresa do Clockin. Esta staging é uma junção da staging gfilial (Filial) e psecao (Centro de Custo) para trazer os campos da matriz e da filial para o Clockin. Segue os campos que são traduzidos e suas regras:
| Desçrição | campo staging | campo Clockin | Regra |
|---|---|---|---|
| Código da Empresa | codcoligada_gfilial | Company Code (String) | |
| CNPJ | cgc_psecao_consolidado | Tax ID (String) | |
| Nome | nome | Name (String) | |
| Inscrição municipal | inscrmun | City Tax ID (String) | |
| Inscrição Estadual | inscricaoestadual | State Tax ID (String) | |
| Nome Fantasia | nomefantasia | Doing Business As (String) | |
| Empresa ativa | codigo | Is Active (Boolean) | sempre true |
| CEI | cei | CEI Code (String) | |
| CNPJ + CEI | cgc_psecao_consolidado + cei | Primary Key Id (String) | concatenação dos campos CNPJ + CEI é a chave do registro |
A "Staging Table" gcoligada foi descontinuada da integração com RM. Deve ser desabilita no 2C e devem habilitar a integração das "stagings tables" gfilial e psecao. Caso esteja integrando filiais que não estão usando o Clockin verificar com cliente para realizar um filtro de inicialização no 2C. Para maiores informações sobre esses processos relativos ao 2C clicar aqui e acessar o item 8, sub item Condition for initialization.
- Data Model Employee (Funcionário)
- ppessoafunc_final: staging table que compõe o Data Model Employee (Funcionário). Essa staging é a junção das stagings ppessoa (pessoa física), pfunc (funcionário), ptpdemissao (tipo de demissão). Segue os campos que são traduzidos e suas regras:
| Descrição | campo staging | campo Clockin | Regra | Justificativa da Coleta |
|---|---|---|---|---|
| emailpessoal, email | Email Address (String) | Se o emailpessoal estiver preenchido considera o emailpessoal. Caso não esteja preenchido considerar o email | Login no Aplicativo Mobile, Backoffice e Aplicativo Clockin Web Legislação - Portaria 671 (envio de comprovante) | |
| Código Pessoa | codpessoa | Person Code (String) | Necessidade Técnica para encontrar os informações da tabela ppessoa | |
| Motivo de Demissão | tipodemissao | Terminate Reason (String) | Tipos de Demissão | Cumprimento de Obrigação Legal - Portaria 671 |
| Está Demitido? | codsituacao, tipodemissao, datademissao | isTerminated (Boolean) | Regra para considerar desligado (true): Se o codigo situacao é D (Desligado) Se o codigo situacao é A Se o tipo de emissão é 5 Se o código da situação é A e se a tem data demissão e se o tipo = 5 | Cumprimento de Obrigação Legal - Portaria 671 |
| Tipo de Demissão | tipodemissao | Termition Type (String) | Cumprimento de Obrigação Legal - Portaria 671 | |
| Data de Demissão | datademissao | Termination Date (Date) | Cumprimento de Obrigação Legal - Portaria 671 | |
| Nome | nome_ppessoa_ recmidifiedon_pfunc, nome_pfunc, recmodifiedon_ppessoa | Name (String) | se a data de modificação do pfunc é maior ou igual a data de modificação da ppessoa então busca o nome da tabela pfunc, senão atualiza o nome da ppessoa | Cumprimento de Obrigação Legal - Portaria 671 |
| PIS | pispasep | PIS Code (String) | Cumprimento de Obrigação Legal - Portaria 671 | |
| Categoria do Funcionário | codcategoria | Situation Code (String) | Cumprimento de Obrigação Legal - Portaria 671 | |
| Tipo do endereço | ajudacusto | Type (String) | Funcionalidade Controle da Geofence - para indicar se o funcionário está dentro ou fora do perímetro do endereço do trabalho | |
| Rua | rua | Address 1 (String) | Funcionalidade Controle da Geofence - para indicar se o funcionário está dentro ou fora do perímetro do endereço do trabalho | |
| Bairro | bairro | Address 2 (String) | Funcionalidade Controle da Geofence - para indicar se o funcionário está dentro ou fora do perímetro do endereço do trabalho | |
| Complemento | complemento | Address 3 (String) | Funcionalidade Controle da Geofence - para indicar se o funcionário está dentro ou fora do perímetro do endereço do trabalho | |
| Cidade | cidade | City (String) | Funcionalidade Controle da Geofence - para indicar se o funcionário está dentro ou fora do perímetro do endereço do trabalho | |
| Estado (UF) | estado | State (String) | Funcionalidade Controle da Geofence - para indicar se o funcionário está dentro ou fora do perímetro do endereço do trabalho | |
| País | pais | Country (String) | Funcionalidade Controle da Geofence - para indicar se o funcionário está dentro ou fora do perímetro do endereço do trabalho | |
| CEP | cep | Zip Code (String) | Funcionalidade Controle da Geofence - para indicar se o funcionário está dentro ou fora do perímetro do endereço do trabalho | |
| CNPJ da Empresa do funcionário | codcoligada | Tax ID (String) | Cumprimento de Obrigação Legal - Portaria 671 | |
| Código da Imagem | codcoligada, cpf chapa | Image Code (String) | Atualiza o código da imagem que foi utilizada para integração da imagem com o Clockin. Este campo é usado para o relacionamento com o DM Imagem | Reconhecimento Facial e validação de fraude na marcação |
| Tipo de Telefone | codpessoa | Se o telefone informado foi o 1 então o campo é preenchido com "Telefone 1", senão "Telefone 2" | Realizar o login por SMS Envio de Comprovante de Marcação (Legislação - Portaria 671) | |
| Número de Telefone | codpessoa | Se o tipo de telefone for igual a "Telefone1" então o campo é preenchido com o Telefone 1, senão é preenchido com o Telefone 2 | Realizar o login por SMS Envio de Comprovante de Marcação (Legislação - Portaria 671) | |
| CPF | cpf | Person ID (String) | Cumprimento de Obrigação Legal - Portaria 671 | |
Registro Geral | cartidentidade | Employee Code (String) | Efetuar Consulta do Funcionário | |
| Data de Admissão | dataadmissao | Data Admissão (Date) | Cumprimento de Obrigação Legal - Portaria 671 | |
| Código da Função | codfuncao | Function Code (String) | Realizar segmentação de dados para apresentação - Segurança da Informação | |
| Descrição da Função | codfunção, codcoligada | Function Description (String) | atualiza o a descrição relativa ao código da função da tabela pfuncao verificando a coligada do funcionário | Realizar segmentação de dados para apresentação - Segurança da Informação |
| Classe do Funcionário | codgrpquiosque | Employee Class (String) | Realizar segmentação de dados para apresentação - Segurança da Informação | |
| Pais | pais | Country (String) | Realizar segmentação de dados para apresentação - Segurança da Informação | |
Tipo de Evento | codfuncao | Clock In Event Type Group Name (String) | Cumprimento de Obrigação Legal - Portaria 671 | |
| Centro de Custo | codcoligada, codsecao | Cost Center Code (String) | Realizar segmentação de dados para apresentação - Segurança da Informação | |
| Descrição do Centro de custo | codcoligada, codsecao | Cost Center Description (String) | atualiza a descrição relativa ao código do centro de custo da tabela psecao verificando a coligada do funcionário em relação a coligada do centro de custo | Realizar segmentação de dados para apresentação - Segurança da Informação |
| Código de Seção | codsecao | Section Code (String) | Realizar segmentação de dados para apresentação - Segurança da Informação | |
| Estado (UF) | estado | State (String) | Realizar segmentação de dados para apresentação - Segurança da Informação | |
| Grupo de Seção | codsecao | Grouped Section Code (String) | Caso o campo "Mascara Código Seção Agrupado" do Settings estiver em branco traz o código da seção nesse campo. Caso o campo esteja preenchido, atualiza a informação considerando a marcara | Realizar segmentação de dados para apresentação - Segurança da Informação |
NO 2C deverá ser configurado um filtro para não trazer os funcionários desligados anteriores a implementação na inicialização da integração. Para maiores informações sobre esses processos relativos ao 2C clicar aqui e acessar o item 8, sub item Condition for initialization.
Data Model Image (Imagem)
- gimagem (Imagens): staging table que compõe o Data Model Image (Imagens). Essa staging possui as imagens que são integrada pela tabela gimagem (Imagens)
| Descrição | campo satging | campo Clockin | Regra | Justificativa da Coleta |
|---|---|---|---|---|
| Imagem do funcionário | imagem | Image (Base 64) | Este campo é a foto do funcionário | Utilizado para o reconhecimento facial para marcação de ponto |
| Código da Imagem do Funcionário | id | Image Code (String) | Se o funcionário não tem imagem ainda no Clockin atualiza o CPF do funcionário para identificar a imagem. Caso já tenha imagem no Clockin considera o código já existente (aqui pode ser um código sequencial utilizado anteriormente ao CPF) | Utilizado para o reconhecimento facial para marcação de ponto |
| Sequencia da Imagem | id | Image Sequence (Long) | A cada imagem adicionada soma mais 1 na sequencia | Utilizado para o reconhecimento facial para marcação de ponto |
| Data de integração da imagem | image | atualiza a data atual | Utilizado para o reconhecimento facial para marcação de ponto |
Toda a comunicação entre ERP, Carol Connect e Clockin utiliza protocolo de comunicação HTTPS (Hypertext Transfer Protocol Secure) com certificado SSL, garantindo assim que a comunicação seja protegida e os pacotes sejam entendidos apenas pelos determinados receptores. Para maiores informações do Carol Connect clique aqui.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas