INTEGRAÇÃO

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, por isso para que os processos administrativos e judiciais pertinentes aos autônomos ou produtores rurais que foram cadastrados em sistema externono EMS, precisam ser enviados para o eSocial de forma transparente para o usuário. 

Frente a esta necessidade, foi criada uma interface que possibilite automatizar o cadastro de processo, através de uma interface de integração. 

Sistemas Envolvidos

• Datasul HCM (módulo Recrutamento e Seleção): responsável por controlar os processos de Recrutamento e Seleção, auxiliando desde o cadastramento do currículo do candidato até a contratação do funcionário na empresa, vinculado a uma vaga específica.

  Gupy (sistema de Recrutamento e Seleção): O sistema de recrutamento e seleção com inteligência artificial que ajuda a empresa a estruturar um processo digital engajante e acertar nas contratações

  Folha de Pagamento): O módulo Folha de Pagamento visa efetuar os cálculos da folha de pagamento para os funcionários, mantendo o controle sobre os valores referentes aos eventos relativos a estes funcionários.

• EMS (módulo Recebimento): O módulo Recebimento visa agilizar e assegurar o recebimento dos materiais da empresa, possibilitando todos os controles necessários dos materiais.

Integração

O objetivo desta integração é permitir que a área do RH ou área responsável pelo Recrutamento e Seleção do Datasul, recebam os dados básicos de currículo dos candidatos de processos administrativos e judiciais de outros sistemas especializados na área, reduzindo assim o trabalho de inclusão manual de todas as informações dentro do sistema;

• Arquitetura (Tecnologia)
  
  • Toda integração entre o Datasul e o Sistema Esta integração é 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.

Escopo

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

• Ao ser contratado na Gupy, é acionada a integração com o Datasul que cria o Candidato Externo (RS0027), como situação Admitido, já vinculado a uma Requisição de Pessoal (RS0765) e também com situação de Admitido. Esta requisição por sua vez é criada e finalizada, não necessitando nenhuma ação do usuário no Datasul em relação à seleção desta vaga, uma vez que este processo já foi todo feito no Sistema da Gupy. 
• A partir deste Candidato Externo é também gerada na integração uma Pessoa Física (FP1440), ficando o candidato pronto para ser admitido no RS0278 Candidatos para Admissão que demonstra os candidatos que foram aprovados no processo de seleção e estão disponíveis para serem cadastrados no FP1500 Manutenção de Funcionários. 
• Ao acionar o botão Admitir do RS0278, é aberto o FP1500 que já sugere as seguintes informações:
  • Estabelecimento (escolhido no site da Gupy para a vaga)
  • Pessoa Física (gerada com as informações preenchidas pelo candidato no site da Gupy) 
  • Carteira de Trabalho (preenchida pelo candidato no site da Gupy) 
  • Lotação (escolhida no site da Gupy para a vaga)
  • Cargo (escolhido no site da Gupy para a vaga)
• cadastrado ou alterado o processo no Recebimento (CD2021), é possível enviar o mesmo para o RH por meio do programa CD2014, centralizando as informações que serão disponibilizadas para o eSocial. 
• Este processo e suas informações de suspensão serão cadastradas no FP0030.
• A partir do momento que estiver cadastrado no FP0030, será gerada ou atualizada mensagem S-1070 correspondente. 

Abaixo demonstramos um desenho como esta integração se dará:

Image Modified

Fora do escopo

• Automatização de consultas de currículos ou candidatosEliminação de processos via integração.
• Importação de base cadastral, para que os cadastros que são base para o cadastro de currículo.
• Informações do candidato que não se enquadram dentro da tabela de Currículo.
• Atualização de currículo já cadastrado no Datasul.Alteração de processos previamente cadastrados no HCM. Processos cadastrados no HCM, devem ser mantidos no HCM. 

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

• Versões mínima do TOTVS/Datasul: 12.1.2627
• Estrutura de rede estável, para que haja trafego de dados sem interrupção.
• Datasul devidamente configurado e serviço Rest habilitado em seu server, com acesso à internet. .
• Parâmetros de conexão devem estar cadastrados corretamente no CD0387: URL, Porta, Usuário e Senha, além de estar marcado para integrar com Middleware.

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 currículo no Datasul, caso processos no HCM. Caso tenha êxito na geração do registro, será retornado a mesma estrutura de Json confirmando sua gravação, caso contrário enviará as informações de inconsistências 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á registro individual de cada currículo de candidatoprocesso.
• A integração não contemplará exclusão de registros no DatasulHCM, para isso o usuário deverá acessar o ERP HCM e excluir manualmente o mesmo e seus devidos relacionamentos. 

Como realizar a chamada da API REST

Para realizar a integração com o parceiro TOTVS , é necessário as informações básicas para cadastramento do candidatoprocesso.

• Preenchimento do EndPoint da API candidates administrativeJudicialProceedings;
• Utilizar a chamada do método Post e do Serviço candidates administrativeJudicialProceedings;
• Preenchimento dos parâmetros obrigatórios da API;

Parâmetros de Entrada:

Parâmetros e Chamada do Método:

Autenticação do tipo básica. 

Método POST.

{protocolo}://{host}/api/rh/v2v1/candidatesadministrativeJudicialProceedings

Request da API: Exemplo:

Image Removed

Image Added

Dados utilizados da API

Por ser uma estrutura única para todos os produtos, há dados que existem em um produto (RM) e não existe no Protheus, desta forma cada produto utilizará os campos pertinentes aos seus ambientes.

Situações de Erros Tratados

O envio de dados inesperados nos parâmetros de entrada da API REST pode ocasionar alguns erros. Desta forma, foram criados alguns tratamentos de erros, listados abaixo, cada um com sua respectiva mensagem e solução.

Tratamento de erros de integração Datasul HCM:

Mensagens de Pré-Validação

{
   "errorCode": 1,
   "errorMessage": "Já existe candidato externo com o CPF informado."
}

{
   			"

message": 

"Processo (nrProc) deve ser 

{
   "errorCode": 158,
  "errorMessage": "País/UF Nascimento Inválido para CPF "
}

informado(a).\n",
    		"code": "265",
    		"type": "error"
}

{
   			"

message":

"

{
   "errorCode": 158,
  "errorMessage": "Funcionário Responsável não foi informado nos Parâmetros Recrutamento e Seleção (RS0006) para a empresa informada."
}

Informe um(a) Tipo Processo (tpProc) válido(a). Valores Válidos: 1 ou 2 ou 3.\n",
    		"code": "158",
            "type": "error"
}

{
   			"

message":

 "Processo cadastrado(a) no HCM deve ser mantido neste produto. Verifique o FP0030.\n",
    		"

code": "56650"

,
 

"type": "error"
}

{
   			"

message":

 "Empresa não relacionada com Nenhum Empregador",
    		"

code": 

"7137",
            "type": "error"
}

{
   			"

message": 

"Dado Registro infoSusp (codSusp: 1) incorreto - indSusp (50).",
    		"code": "53817",
            "type": "error"
}

OBS: Estas mensagens de validações serão retornadas sempre que algum campo passado que seja obrigatório ou que algum campo enviado tenha sua origem de dados em outra tabela e não seja localizado na mesma , vale ou não estejam de acordo com o leiaute do eSocial. Vale lembrar que são apenas exemplos de mensagens de erros e podendo variar o nome da propriedade enviada.

Checklist de suporte da aplicação

Itens a serem verificados durante o atendimento:

• Verificar se os pré-requisitos foram atendidos para a chamada da API;
• Verificar se na chamada da API o EndPoint, o nome do serviço e todos os campos obrigatórios foram informados;
• Verificar se o retorno da API apresenta algum erro tratado (códigos e mensagens de erro citados neste documento) e consultar a solução na mesma tabela que descreve o erro;
• Em caso de Erro não tratado, verificar se possui alguma informação de banco de dados, conexão com o servidor, clientlog, log do appServer ou algo que possa identificar a origem do problema.

EMS2:

• Verificar se os parâmetros de conexão foram cadastrados corretamente no CD0387: URL, Porta, Usuário e Senha.
• Verificar se estão cadastrados corretamente os processos no CD2021 dentro do período selecionado no CD2014.
• Verificar se o processo (CD2021) está relacionado ao estabelecimento (CD2021A).