Solicitação de Treinamento

Contexto de negócio (Introdução)

Cada vez mais o mercado exige que as operações complexas e manipulação de dados ainda mais ágeis e com custos reduzidos. Com o RH não é diferente, os processos cada vez mais complexos e com muitas variáveis a serem analisadas nos processos de segurança e medicina do trabalho, os profissionais de saúde precisam de agilidade na hora de controlar processos funcionais da empresa.

Com essa necessidade e a importância desta área dentro da empresa, softwares especialistas em medicina e segurança do trabalho estão cada vez mais presentes no mercado e foi neste contexto que surgiu a necessidade da criação de uma interface para que possibilitasse automatizar cadastros e rotinas de funcionais dentro do ERP através de uma interface de integração.

Dentro deste cenário, tornou-se importante controlar os registros de necessidade de treinamento do funcionário dentro de um contexto totalmente integrado.

Sistemas Envolvidos

• Protheus (módulo  Gestão de Pessoal): Módulo responsável pela gestão dos dados dos funcionários, folha de pagamento e dentre outros cadastros pertinentes aos colaboradores.

• NG

Integração

O objetivo desta integração é permitir que o RH ou área responsável pelo Gestão de Pessoal do Protheus, receba os dados da solicitação de treinamento dos funcionários de outros sistemas especializados, reduzindo assim o trabalho de inclusão/alteração/exclusão manual dessas informações dentro do sistema;

• Benefícios
  • Não terá um investimento alto de tempo para o cadastramento, pois os dados já serão enviados, editados ou excluídos através da integração a cada requisição do sistema especialista através da API de Solicitação de Treinamento.

• Arquitetura (Tecnologia)

Toda integração entre o Protheus e o Sistema é feita por intermédio de comunicação direta com os Web Services(que são fixos) REST(Representation State Transfer) utilizando o formato JSON(JavaScript  Object Notation) de serialização de dados, onde através da ativação do serviço do REST do Protheus esteja disponível para utilizar o serviço.

Escopo

Por intermédio desta integração será disponibilizada a seguinte funcionalidade:

• Cadastramento da solicitação de treinamento do funcionário no módulo SIGATRM;

Fora do escopo

• Automatização de consultas de solicitação de treinamento,
• Importação de base cadastral - dados do Funcionário,
• Informações da solicitação de treinamento que não se enquadram dentro da tabela de solicitação de treinamento

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

• Versões mínimas do Protheus: 12.1.30
• Possuir acesso à Internet, caso o sistema que venha a utilizar a integração com a aplicação Protheus.
• Estrutura de rede estável, para que haja tráfego de dados sem interrupção.
• Protheus devidamente configurado e serviço Rest habilitado em seu server.

Instalação/Atualização

Este tópico tem por objetivo orientar a instalação da integração, visando o seu funcionamento completo. Instalação de produtos ou ferramentas necessárias podem referenciar outros documentos existentes, desde que estejam disponíveis no repositório de documentação da TOTVS ou sejam enviados junto com o documento da integração em si.

As informações mínimas necessárias para este tópico são:

Ativação/Desativação da integração

Por padrão esta integração estará em repositório, porém demanda realizar a devida configuração conforme abaixo:

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.
• Módulo de Recrutamento e Seleção com suas entidades base, devidamente populadas por dados que no momento da integração serão utilizados na criação do registro de currículo.(Para melhor compreensão, analise o cadastro de currículo e verifique os campos que possuem consultas em outras tabelas se as mesmas estão com os seus dados devidamente cadastrados).

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade da linha MicroSiga Protheus, onde será analisada pela equipe de suporte da Totvs.

- trainingNecessity - INTEGRAÇÃO GPEA923API

Sistemas Envolvidos

• Protheus (módulo Treinamento): Módulo responsável pela gestão de cursos e treinamentos realizados pelos colaboradores.

• Quírons - NG

Integração

O objetivo desta integração é permitir que o RH ou área responsável pela Gestão de Treinamentos dos Colaboradores no Protheus, receba os dados do Controle de Solicitações de Treinamento dos funcionários de outros sistemas especializados, reduzindo assim o trabalho de inclusão/alteração/exclusão manual dessas informações dentro do sistema;

• Benefícios
  • Não terá um investimento alto de tempo para o cadastramento, pois os dados já serão enviados, editados ou excluídos através da integração a cada requisição do sistema especialista através da API de Solicitação de Treinamento.
  • A informação será atualizada de forma automática, facilitando que conferência e confiabilidade dos dados recebidos.

• Arquitetura (Tecnologia)

Toda integração entre o Protheus e o Sistema é feita por intermédio de comunicação direta com os Web Services(que são fixos) REST(Representation State Transfer) utilizando o formato JSON(JavaScript  Object Notation) de serialização de dados, onde através da ativação do serviço do REST do Protheus esteja disponível para utilizar o serviço.

Escopo

Por intermédio desta integração será disponibilizada a seguinte funcionalidade:

• Manutenção de solicitações de necessidade de treinamento do funcionário no módulo SIGATRM;

Fora do escopo

• Automatização de consultas de solicitação de treinamento,
• Importação de base cadastral - dados do Funcionário,
• Informações da solicitações de treinamento que não se enquadram dentro da tabela de solicitação de treinamento

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

• Versões mínimas do Protheus: 12.1.23
• Possuir acesso à Internet, caso o sistema que venha a utilizar a integração com a aplicação Protheus.
• Estrutura de rede estável, para que haja tráfego de dados sem interrupção.
• Protheus devidamente configurado e serviço Rest habilitado em seu server.

Instalação/Atualização

Este tópico tem por objetivo orientar a instalação da integração, visando o seu funcionamento completo.

Instalação de produtos ou ferramentas necessárias podem referenciar outros documentos existentes, desde que estejam disponíveis no repositório de documentação da TOTVS ou sejam enviados junto com o documento da integração em si.

As informações mínimas necessárias para este tópico são:

Ativação/Desativação da integração

Por padrão esta integração estará em repositório, porém demanda realizar a devida configuração conforme abaixo:

• Configuração de Webservice Rest no Protheus no formato apresentado na seguinte documentação (Exemplo de Configuração de Webservice REST)

Controle de Ambiente

Exige que os seguintes pontos sejam revisados:

• Protheus com sua arquitetura devidamente estruturada.
• Módulo de Treinamento (SIGATRM) com suas entidades base, devidamente populadas por dados que no momento da integração serão utilizados na criação do registro de solicitação de necessidade de treinamento. (Para melhor compreensão, analise o cadastro disponível dentro do sistema e verifique os campos que possuem consultas em outras tabelas se as mesmas estão com os seus dados devidamente cadastrados).

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade da linha Protheus, onde será analisada pela equipe de suporte da Totvs.

Fluxo das Informações

Esta integração traz a funcionalidade exclusivamente à área de Treinamento

Fluxo das Informações

Esta integração traz a funcionalidade exclusivamente à área de Gestão de Pessoal, no processo de cadastramento (inclusão/alteração/exclusão) de solicitação de Necessidade de treinamentoTreinamento.

Cadastro

Esta integração contempla apenas o cadastramento(inclusão/alteração/exclusão) da solicitação de necessidade de treinamento dentro do módulo SIGATRM SIGATRM.

Processos

O Sistema requisitante enviará as informações via json para a interface de integração, desta forma será gerado um novo registro na tabela de solicitação de treinamento de solicitações de necessidade de treinamentos no Protheus, caso tenha êxito na geração do registro, será retornado retornada a mesma estrutura de json confirmando sua gravação, caso contrário enviará as informações de inconsistências recebida, acompanhada de uma nova tag chamada id, que será uma chave única composta de informações da entidade dentro do sistema.  Desta forma será confirmada sua gravação, caso contrário enviará as informações de inconsistências que serão citadas nos próximos tópicos.

Limitações / Restrições Gerais

• Com o objetivo de manter a estrutura e a agilidade da estrutura Rest, o Web Service Rest receberá o registro individual de cada solicitação de treinamento.
• A integração não contemplará exclusão de registros no Protheus, para isso o usuário deverá acessar o ERP e excluir manualmente o mesmo.

Como realizar a chamada da API REST

Para realizar a integração com o parceiro TOTVS são necessárias

Como realizar a chamada da API REST

Para realizar a integração com o parceiro TOTVS é necessário as informações básicas de consulta para retorno dos funcionários desejadosdo funcionário desejado.

• Preenchimento do EndPoint da API GPEA923API TRMA010API;
• Utilizar a chamada do método Post, Put e Delete e do Serviço StabilityControl trainingNecessity;
• Preenchimento dos parâmetros obrigatórios da API.

{
 "companyId": "T1",
 "branchId": "D MG 01 ",
 "startDate": "2020-01-01T18:25:43",
 "stabilityCode": "123"
}

{
    "companyId": "T1",
    "branchId": "D MG 01 ",
    "trainingNecessityCode": "T1|D MG    |0001",
    "employeeId": "T1|D MG 01 |160001",
    "id": "T1;D MG 01 ;T1|D MG 01 |160001;T1|D MG    |0001"
}

{

    "code":

 400,

    "detailedMessage":

"

400

Erro na

 validacao do recebimento da

Verificar se as propriedades json companyId ou branchId estão preenchidas com conteúdo válido.

 mensagem",
    "helpUrl": "https://tdn.totvs.com/x/BJuMHw",
    "

message": "

Verifique 

o 

conteudo 

da 

TAG 

(trainingNecessityCode) pois nao foi possivel encontrar esta informacao no Protheus.\r\n"
}

{

   "

errorCode": 

500,

   "

errorMessage": "

Ocorreu 

uma 

falha 

no 

retorno da informação."
}