Manual da Integração Quírons x DATASUL
Contexto de Negócio
A
...
integração Quírons x RH DATASUL
...
entrega aos
...
clientes uma experiência diferenciada nos processos através da comunicação nativa dos sistemas, que enviam e recebem as informações.
Sistemas Envolvidos
Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).
- NG Quírons - Software de gestão de medicina e segurança do trabalho:
NG Quírons: SST - Saúde e Segurança do Trabalho.
TOTVS RH - Linha DATASUL através dos seguintes módulos:- Folha de Pagamento: Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros: Funcionário, Dependentes, Dependente, Tipos de EstabilidadePessoas Físicas, Históricos Funcionais, Informações Adicionais, Histórico Funcional, Pessoa Física, Realização Treinamento, Abono, Afastamento, Centro de CustoTipos de Estabilidade, Turnos de Trabalho, Abonos, Tipos de Abonos, Afastamentos, Tipos de Afastamentos, Turno Centros de TrabalhoCusto, Tipos de Abonos, Estabilidade, Unidade de Lotação, OcupaçãoUnidades de Lotação e Cargos.
- Administração de Treinamento: Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros: TreinamentoTreinamentos, Necessidade Necessidades de Treinamento e Treinamentos Realizados.Cargos e Salários: Cargo/Função, Cargo.
- NG Quírons: SST - Saúde e Segurança do Trabalho.
- TOTVS RH - Linha DATASUL através dos seguintes módulos:
Pré-Requisito
- Certificados do Servidor Quírons atualizado no client (requisições HTTPS).
- O servidor DATASUL possuir IP Externo liberado, para realizar a comunicação entre os produtos.
- Informar os parâmetros de conexão do Quírons no Datasul:
- URL, usuário, senha e tipo de ambiente (Homolog. / Produção).
- Fornecer ao Quírons os parâmetros de conexão do Datasul (REST):
Parametrização DATASUL / Carga Inicial / Sincronizador
Entidades da Integração
Enviados para o sistema Quírons:
Expandir |
---|
|
Realizar o acesso ao programa FP1440 Manutenção Pessoa Física e realizar o cadastro de uma nova pessoa: Image Added
Após cadastrar a Pessoal Física, realizar o acesso ao programa FP1500 Funcionários e realizar o cadastro de um novo registro de funcionário vinculando a pessoa física cadastrada anteriormente (Verifique que além de selecionarmos a pessoa física para este funcionário, também definimos para qual o estabelecimento se trata o cadastro): Image Added
Após realizar o cadastro de Pessoa Física e do Funcionário, o cadastro do Funcionário estará disponível para ser enviado para o Quírons podendo ser sincronizado via programa MT1100. No Quírons, o funcionário será disponibilizado no caminho 'Inicio > Outros > Pessoas': Image Added Verificamos que o funcionário somente estará sendo exibido para o estabelecimento selecionado no do programa FP1500 |
Expandir |
---|
|
Realizar o acesso ao programa RS0027 Candidato Externo e realizar o cadastro de um novo registro de Candidato: Image Added
Após cadastrar o candidato Externo, realizado o acesso ao programa RS0788 Manter Agenda Requisição e incluir na agenda o Candidato Externo cadastrado anteriormente: Image Added |
Expandir |
---|
|
Realizar acesso ao programa FP1760 Manutenção Dependentes e realizar a inclusão de um registro de dependente: Image Added |
Expandir |
---|
|
Realizar acesso ao programa FP0770 Manutenção Cargo Básico e inserido um novo registro, este registro deve ser utilizado na formulação do Cargo posteriormente: Image Added
Após ter inserido o Cargo Básico, realizado acesso ao programa FP0720 Manutenção Cargo e inserido um registro de Cargo selecionando o Cargo Básico inserido anteriormente: Image Added Ao realizar o cadastro do Cargo e Cargo Básico, após a sincronização dos dados para o Quírons, o Cargo estará disponibilizado no menu 'Inicio > Outros > Ocupação':
|
Expandir |
---|
|
Realizar o acesso ao programa FP1620 Manutenção Salários e realizar o cadastro de um novo cargo para o Funcionário em questão: Image Added
Após haver um registro de Cargo para o Funcionário, seja pelo próprio cadastro do Funcionário no programa FP1500 Funcionários ou o cargo inserido no programa FP1620 Manutenção Salários, ao realizar a sincronização no programa MT1100, a listagem do cargo do Funcionário poderá ser verificado no no caminho 'Inicio > Outros > Pessoas' na aba Histórico Funcional: Image Added |
Expandir |
---|
title | Histórico de Treinamento |
---|
|
Realizado acesso ao programa AT0031 Manutenção Funcionário para realizar a inclusão de um treinamento para o Funcionário: Image Added
Após realizar a sincronização de envio de dados, podemos verificar no Quírons o envio realizado do Histórico de Treinamento no menu 'Inicio > Outros > Pessoas' para o funcionário que foi realizado o registro de treinamento anteriormente: Image Added |
Expandir |
---|
|
Realizar o acesso ao programa FP0780 Manutenção Unidade Lotação e cadastrar uma unidade de lotação: Image Added
Após realizar o cadastro da Unidade de Lotação, acessado o programa FP0800 Manutenção Plano Lotação e vinculado a Unidade cadastrada anteriormente para um plano de lotação na aba Unidade conforme exemplo abaixo: Image Added
Após cadastrar a Unidade e realizar o vinculo em um Plano de Lotação, feito o acesso ao programa FP0570 Manutenção Complemento Estabelecimento e vinculado o Plano de Lotação em um estabelecimento, verifique que a Unidade Lotação só será exibida no Quírons para o estabelecimento utilizado nesse cadastro: Image Added
Somente após realizar o cadastro e os vínculos exibidos anteriormente, que o registro de Unidade Lotação (Departamento no Quírons) estará disponível para o envio via sincronização. Após a Sincronização realizada, a Unidade Lotação será disponibilizada no Quírons no menu 'Inicio > Outros > Departamento': Image Added |
- Buscados pelo o sistema Quírons:
Para poder realizar a busca de dados pelo Quírons, devemos realizar acesso ao menu da conta, disponível no canto superior direito e na aba Organização selecionar a opção de Integração no estabelecimento que está selecionado, na pop up de Integrações, selecione a opção Sincronizar para o cadastro desejado:
Image AddedImage Added
Os dados disponíveis para a busca pelo Quírons são os listados abaixo.
- Tipos de Afastamento
- Centro de Custo
- Turnos de Trabalho
- Tipos de Estabilidade
- Treinamentos
- Funções
- Tipos de abono
- Dados enviados para o DATASUL pelo o sistema Quírons:
Expandir |
---|
title | Necessidade de Treinamento |
---|
|
O cadastro de Necessidade de Treinamento pode ser feito acessando o programa no menu 'Inicio > Risco > Detalhes (Treinamento)' onde e um cadastro selecionamos o Funcionário em questão na seção de Caracterização do Risco e mais abaixo na seção Treinamentos podemos selecionar a Necessidade de treinamento para o funcionário selecionado : Image Added Image Added
Ao realizar o cadastro acima exibido, podemos verificar o cadastro da Necessidade de Treinamento no Datasul pelo Programa DS0081 Manutenção Necessidade Treinamento selecionando o funcionário selecionado no cadastro do Risco anteriormente: Image Added |
Expandir |
---|
|
O cadastro de Afastamentos no Quírons deve ser realizado no menu "Inicio > Prontuários Médicos" e selecionar o Funcionário desejado. Na tela de alteração do prontuário deste Funcionário, na seção Atestado Médico, selecionar a opção Novo Atestado Médico: Image Added
Na tela de inclusão do Atestado Médico do Funcionário, além das informações de Data de inicio e fim do atestado e informações médicas, devemos selecionar na opção Tipo o valor Atestado, desta forma será habilitada a seleção do Tipo de Ausência. Image Added
Ao confirmar a inclusão do Atestado acima, podemos verificar este Afastamento do Datasul via programa FP1600 Manutenção Histórico de Situações: Image Added |
Expandir |
---|
title | Condições Diferenciadas de Trabalho |
---|
|
Para o cadastro de Condições Diferenciadas de Trabalho, no Quírons vamos acessar o menu 'Inicio > Riscos' e em um cadastro de Risco, inserido as informações de cadastro como Agente, Fonte Geradora, etc.. E também inserido a Intensidade deste risco cadastrado. Logo mais abaixo do cadastro dos detalhes do Risco, selecionado na opção Pessoas o Funcionário cujo o cadastro será referenciado: Image Added Image Added
No Datasul, podemos verificar o cadastro da Condição Diferenciadas de Trabalho no programa FP1500 Funcionários: Image Added |
Expandir |
---|
|
O cadastro de Afastamentos no Quírons deve ser realizado no menu "Inicio > Prontuários Médicos" e selecionar o Funcionário desejado. Na tela de alteração do prontuário deste Funcionário, na seção Atestado Médico, selecionar a opção Novo Atestado Médico: Image Added
Na tela de inclusão do Atestado Médico do Funcionário, além das informações de Data de inicio e fim do atestado e informações médicas, devemos selecionar na opção Tipo o valor Declaração, desta forma será habilitada a seleção do Tipo de Abono Image Added
Ao confirmar a inclusão do Atestado acima, podemos verificar este Abono do Datasul via programa FP1600 Manutenção Histórico de Situações: Image Added |
Expandir |
---|
|
O cadastro de Estabilidade no Quírons deve ser realizado via o menu 'Início > Mandatos' onde será necessário acessar o Detalhes de um mandato em vigência e na seção Componente inserir um novo registro para o Funcionário desejado: Image Added
Após cadastrar o componente do mandato anterior, podemos verificar a Estabilidade no Datasul via Programa FP3821 Listagem Estabilidade do Funcionário via execução do relatório conforme imagem abaixo: Image Added |
Parametrização DATASUL / Carga Inicial / Sincronizador
Deck of Cards |
---|
|
Card |
---|
default | true |
---|
id | ConfiguraçãoDTS |
---|
label | Configuração |
---|
| Geração de token de acesso: Para geração do token de acesso é necessário criar o diretório “cfghur” dentro da pasta hcm. O programa "prghur/spp/gera_ativacao_integr_ng.p" deve ser executado pelo editor da base. Image Added
Deverá ser informado no campo BASE CNPJ/CPF os primeiros 8 dígitos do CNPJ de cada empresa que participará do processo de integração. Caso tenha dúvidas de onde localizar a informação, basta acessar o programa FP0500 – Parâmetros Empresa RH Após informar a base do CGC o programa gerará um novo arquivo contendo o token de acesso. O arquivo terá o nome "config_integr_ng.xml", e estará localizado na pasta C:\temp. Atenção: O arquivo config_integr_ng.xml deverá ser copiado para a pasta "cfghur" e este diretório deverá ser informado no propath da base do cliente. Image Added
Seguindo os procedimentos descritos acima, ao acessar o programa MT0004-Manutenção Parâmetros Medicina/Segurança, a aba “Integrações“ ficará visível: Atenção: O usuário deve ser o e-mail do usuário cadastrado no Quírons e a senha deve ser a mesma utilizada no Quírons. Este usuário deve ter acesso a todos os Estabelecimentos e Filiais que serão enviados ao Quírons, esta parametrização é realizada no Quírons. Image Added |
Card |
---|
id | Carga de Dados |
---|
label | Carga Inicial |
---|
| A carga inicial pode ser realizada via programa MT1000 selecionando na seção de Tipo de Processamento a opção Carga Inicial: Image Added Para a carga inicial deve ser obedecido uma ordem no envio, ou seja, as mensagens de Funcionário, Dependente, Histórico Funcional, Histórico de Treinamento, Unidade de Lotação e Cargos não podem ser enviadas na mesma execução. Este envio deve ser obedecida na seguinte ordem: - Primeiro Envio:
- Segundo Envio:
- Funcionário
- Depedente
- Histórico Funcional
- Histórico de Treinamento
|
|
Deck of Cards |
---|
|
Card |
---|
default | true |
---|
id | Configuração DATASUL |
---|
label | Configuração DATASUL |
---|
| Geração de token de acesso Para geração do token de acesso é necessário criar o diretório “CFGHUR”. O programa "gera_ativacao_integr_ng.p" deve ser executado pelo editor da base. Image Removed Deverá ser informado no campo BASE CNPJ/CPF os primeiros 8 dígitos do CNPJ de cada empresa que participará do processo de integração. Caso tenha dúvidas de onde localizar a informação, basta acessar o programa FP0500 – Parâmetros Empresa RH Após informar a base do CGC o programa gerará um novo arquivo contendo o token de acesso. O arquivo terá o nome "config_integr_ng.xml", e estará localizado na pasta C:\temp. Atenção: O arquivo config_integr_ng.xml deverá ser copiado para a pasta "cfghur" e este diretório deverá ser informado no propath da base do cliente. Image Removed Seguindo os procedimentos descritos acima, ao acessar o programa MT0004 Manutenção Paramentros Medicina/Segurança, a pasta “Integrações“ ficará visível. Parametrização de credenciais de acesso MT0004 Image Removed Card |
---|
|
id | Carga de Dados |
---|
label | Carga Inicial
Carga NG (Homologação x Produção) object/sopm/vwr/v09pm338.w Carga NG (Pessoa, Funcionários e Dependentes) Objetivo: Efetuar o processo de carga das pessoas, funcionários e dependentes para integração da NG. prghur/fpp/employeeDependentsLog.p prghur/fpp/employeeLog.p prghur/fpp/personLog.p prghur/mtp/mt1000.w prghur/mtp/mt1000rp.p prghur/mtp/mt1000tt.i Carga NG – (Lotação e Cargo) Objetivo: Permitir que o Datasul realize o processo de carga das unidades de lotação e cargo para a NG. prghur/mtp/mt1000.w prghur/mtp/mt1000rp.p prghur/mtp/mt1000tt.i |
Card |
---|
id | Sincronizador |
---|
label | Sincronizador |
---|
| Sincronizador NG Objetivo Permitir O programa MT1100 Sincronizador tem como objetivo permitir que as mensagens, Pendentes de envio ou com erro, relacionadas a Pessoas, Funcionários, Dependentes, Histórico Funcional e Realização de Treinamentos originadas a partir da Carga e/ou gatilho possam ser enviadas ao sistema da NG.: Image Added prghur/fpp/employee.p prghur/fpp/employeeHistoryPosition.p prghur/mtp/mt1100.w prghur/mtp/mt1100rp.p prghur/mtp/mt1100tt.i src/prghur/mtp/mt1000rp.p univdata/men_mmt.d
|
Card |
---|
id | Informações |
---|
label | Informações |
---|
| Alteração de informações com mensagem Pendente Objetivo: Automatizar os cancelamentos das mensagens Pendentes/Erro caso o registro que originou a mensagem seja alterado. rh/api/v1/generics/rh-integ.i Chave identificadora | Ajuste dos status | Ajuste dos Gatilhos database/tgpm/twp/twpm064.p database/tgpm/twp/twpm200.p database/tgpy/twp/twpy047.p database/tgpy/twp/twpy085.p database/tgpy/twp/twpy257.p prghur/fpp/apiAllowanceTypes.p database/inpy/i01py00840.i prghur/fpp/apiPayRollCostCenter.p prghur/fpp/apiLeaveOfAbsenceType.p prghur/fpp/apiWorkingShift.p prghur/fpp/apiPositions.p prghur/fpp/apiClasses.p prghur/fpp/apiStabilityType.p prghur/fpp/employee.p prghur/fpp/employeeDependents.p prghur/fpp/trainingHistory.p prghur/fpp/person.p prghur/fpp/employeeHistoryPosition.p Senha de validação - Integração NG Objetivo: Criar validação por arquivo com chave de acesso para tela de ativação e programa de geração da carga de integração NG. prghur/fpp/fpefd564.p prghur/mtp/mt0004.w gera-ativacao-integr-ng.p Tela de Parâmetros Objetivo: Disponibilizar ao usuário uma tela de configuração para integração com a NG que permite a configuração em base de Produção ou Ambiente de Homologação. object/sopm/vwr/v09pm338.w prghur/mtp/mt0004.w |
|
Informações Técnicas:
Expandir |
---|
title | Clique aqui para expandir |
---|
|
Relação APIs DATASUL Deck of Cards |
---|
| Card |
---|
default | true |
---|
id | API Treinamentos |
---|
label | API Treinamentos |
---|
| Integração NG - API Treinamentos Objetivo: integrar informações da tabela de treinamento do HCM com o sistema NG prghur/fpp/apiClasses.p prghur/fpp/apiClassesV1.i prghur/fpp/fpefd561.p rh/api/v1/Classes.p |
Card |
---|
id | API Tipos de Estabilidade |
---|
label | API Tipos de Estabilidade |
---|
| Integração NG - API Tipos de Estabilidade Objetivo: integrar informações da tabela de Tipos de Estabilidade do HCM com o sistema NG prghur/fpp/apiStabilityType.p prghur/fpp/apiStabilityTypeV1.i prghur/fpp/fpefd561.p rh/api/v1/StabilityType.p |
Card |
---|
id | API Informações Adicionais |
---|
label | API Informações Adicionais |
---|
| Integração NG - API Informações Adicionais Objetivo: integrar informações de Adicional da NG para integrar com as informações de funcionário para o sistema do HCM prghur/fpp/apiAdditional.p prghur/fpp/fpefd563b.p rh/api/v1/Additional.p |
Card |
---|
id | API Histórico Funcional |
---|
label | API Histórico Funcional |
---|
| Integração NG - API Histórico Funcional (Local de Trabalho, Função, Depto, Seção) Objetivo: integrar informações da tabela de Histórico Funcional do HCM com o sistema NG prghur/fpp/employeeHistoryPosition.p database/tgpy/twp/twpy085.p |
Card |
---|
id | API Funcionário |
---|
label | API Funcionário |
---|
| Integração NG - API Funcionário Objetivo: integrar informações da tabela de Funcionário do HCM com o sistema NG prghur/fpp/employee.p database/tgpy/twp/twpy085.p
Integração NG - API Funcionário – Complemento Objetivo: Integração do funcionário deve contemplar as informações de Cargo, Estado Civil, Grau de Instrução, CTPS, Nome da Mãe, Estado do endereço, Código da RAIS e Categoria eSocial afim de atender exigência de relatório legais no parceiro NG. src/prghur/fpp/employee.p |
Card |
---|
id | API Dependentes |
---|
label | API Dependentes |
---|
| Integração NG - API Dependentes Objetivo: integrar informações da tabela de Dependentes do HCM com o sistema NG database/inpy/i01py00838.i database/inpy/i01py00840.i database/inpy/i02py00838.i database/inpy/i02py00840.i database/tgpy/tcp/tcpy00838.p database/tgpy/tcp/tcpy00840.p database/tgpy/tdp/tdpy00838.p database/tgpy/tdp/tdpy00840.p database/tgpy/twp/twpy00838.p database/tgpy/twp/twpy00840.p prghur/fpp/employeeDependents.p rh/api/v1/generics/rh-integ.i database/tgpy/twp/twpy047.p |
Card |
---|
id | API Pessoa Física |
---|
label | API Pessoa Física |
---|
| Integração NG - API Pessoa Física Objetivo: integrar informações da tabela de Pessoa Física do HCM com o sistema NG database/tgpm/twp/twpm200.p database/tgpy/twp/twpy085.p database/tgpy/twp/twpy257.p prghur/fpp/person.p |
Card |
---|
id | API Realização Treinamento |
---|
label | API Realização Treinamento |
---|
| Integração NG - API Realização Treinamento Objetivo: integrar informações da tabela de Realização Treinamento do HCM com o sistema NG prghur/fpp/trainingHistory.p database/tgpm/twp/twpm064.p |
Card |
---|
id | API Abono |
---|
label | API Abono |
---|
| Integração NG - API Abono Objetivo: integrar informações de Abono do sistema NG com a tabela de abono do HCM. prghur/fpp/apiAllowanceControl.p prghur/fpp/fpefd563a.p rh/api/v1/AllowanceControl.p |
Card |
---|
id | API Afastamento |
---|
label | API Afastamento |
---|
| Integração NG - API Afastamento Objetivo: integrar informações de Afastamento do sistema NG com informações do Afastamento do HCM prghur/fpp/apiLeaveOfAbsenceControl.p rh/api/v1/LeaveOfAbsenceControl.p |
Card |
---|
id | API Centro Custo |
---|
label | API Centro Custo |
---|
| Integração NG - API Centro Custo Objetivo: Integrar informações da tabela de centro de custos do HCM com o sistema NG. prghur/fpp/apiPayRollCostCenter.p prghur/fpp/apiPayRollCostCenterV1.i prghur/fpp/fpefd561.i prghur/fpp/fpefd561.p rh/api/v1/PayRollCostCenter.p |
Card |
---|
id | API Cargo/Função |
---|
label | API Cargo/Função |
---|
| Integração NG - API Cargo/Função Objetivo: Integrar informações da tabela de cargo do HCM com o sistema NG. prghur/fpp/apiPositions.p prghur/fpp/apiPositionsV1.i rh/api/v1/Positions.p prghur/fpp/fpefd561.p |
Card |
---|
id | API Tipos de Afastamentos |
---|
label | API Tipos de Afastamentos |
---|
| Integração NG - API Tipos de Afastamentos Objetivo: Integrar informações da tabela de tipos de afastamentos do HCM com o sistema NG. prghur/fpp/apiLeaveOfAbsenceType.p prghur/fpp/apiLeaveOfAbsenceTypeV1.i rh/api/v1/LeaveOfAbsenceType.p |
Card |
---|
id | API Turno de Trabalho |
---|
label | API Turno de Trabalho |
---|
| Integração NG - API Turno de Trabalho Objetivo: Integrar informações da tabela de turnos de trabalhos do HCM com o sistema NG. prghur/fpp/apiWorkingShift.p prghur/fpp/apiWorkingShiftV1.i rh/api/v1/WorkingShift.p |
Card |
---|
id | API Tipos de Abono |
---|
label | API Tipos de Abono |
---|
| Integração NG - API Tipos de Abono Objetivo: Integrar informações da tabela de tipos de abonos do HCM com o sistema NG. prghur/fpp/apiWorkingShift.p prghur/fpp/apiWorkingShiftV1.i rh/api/v1/WorkingShift.p |
Card |
---|
id | API Necessidade de Treinamento |
---|
label | API Necessidade de Treinamento |
---|
| Integração NG - API Necessidade de Treinamento Objetivo: Integrar informações de Necessidade de Treinamento do sistema NG com o sistema HCM. prghur/fpp/apiTrainingNecessity.p prghur/fpp/fpefd563d.p rh/api/v1/TrainingNecessity.p |
Card |
---|
id | API Estabilidade |
---|
label | API Estabilidade |
---|
| Integração NG - API Estabilidade Objetivo: Integrar informações do sistema NG com as informações de "Estabilidade" do sistema HCM prghur/fpp/apiStabilityControl.p prghur/fpp/fpefd563c.p rh/api/v1/StabilityControl.p |
Card |
---|
id | API Unidade de Lotação |
---|
label | API Unidade de Lotação |
---|
| Integração NG - API Unidade de Lotação Objetivo: Permitir que o Datasul envie informações de unidades de lotação (departamento) para o sistema da NG. prghur/fpp/department.p database/inpy/i02py00840.i database/tgpy/tdp/tdpy286.p database/tgpy/twp/twpy286.p |
Card |
---|
id | API Cargo |
---|
label | API Cargo |
---|
| Integração NG - API Cargo Objetivo: Permitir que o Datasul envie informações de Cargo para o sistema da NG. prghur/fpp/position.p database/tgpy/tdp/tdpy026.p database/tgpy/twp/twpy026.p prghur/mtp/mt1100rp.p |
Card |
---|
id | API – Ocupação |
---|
label | API – Ocupação |
---|
| Integração NG - API – Ocupação Objetivo: Alterar a API Positions para considerar somente a informação do Cargo. A positions deve ser inativa e deve ser substituída por occupation prghur/fpp/apiOccupation.p prghur/fpp/apiOccupationV1.i rh/api/v1/Occupation.p prghur/fpp/fpefd561.p |
|
|