Como criar funcionários pela API?

O módulo de Recursos Humanos do ERP PRIMAVERA inclui várias funcionalidades que permitem gerir os processos de recursos humanos da organização com maior rapidez e eficiência, como por exemplo, o processamento salarial, a integração com a segurança social ou a gestão de pagamentos e recibos.

Neste artigo, exploramos a API da V10 através de um exemplo de criação de um funcionário. Esta operação vai permitir à sua organização criar ou atualizar os dados de funcionários através de aplicações externas.

Fichas de funcionários

Entre todas as opções disponíveis, a entidade central aos Recursos Humanos é a tabela de funcionários, que permite aceder às fichas dos funcionários. Esta tabela é utilizada em muitos dos processos existentes e é aqui se que se efetuam as configurações que serão utilizadas em grande parte do módulo.

Exemplo de criação de um funcionário:

Nota: Para esta demonstração, utilizamos o projeto disponível no GitHub.

Passo 1 - Adicionar a referência ao módulo de Recursos Humanos 

Criar um projeto em Visual Studio e adicionar as referências para a API de Recursos Humanos:

• RhpBE100;
• IRhpBS100.

Passo 2 - Utilizar o namespace "RhpBE100"

Para facilitar a leitura do código, adicionar o namespace relativo à API de RH.

using RhpBE100;

Passo 3 - Criar o objeto funcionário com a informação necessária

Utilizar o método de criação do objeto “funcionário” e definir os campos necessários.

RhpBEFuncionario employee = new RhpBEFuncionario
{
    Funcionario = txtID.Text,
    Nome = txtName.Text,
    DataAdmissao = dtHireDate.Value,
    Situacao = txtSituation.Text,
    Instrumento = txtWorkPolicy.Text,
    Estabelecimento = txtWorkLocation.Text,
    SegurancaSocial = txtSocialSec.Text,
};

Passo 4 - Verificar se é um novo registo

Utilizar a propriedade "EmModoEdicao" para definir o tipo de registo a efetuar. Se este valor for “true”, a tabela de funcionários vai receber um “Update”. Caso contrário, a operação será um “Insert”.

Para preencher esta propriedade, é necessário validar se o funcionário já existe através da API de Recursos Humanos, utilizando o código de funcionário introduzido em “txtID.Text”.

Employee.EmModoEdicao = PriEngine.Engine.RecursosHumanos.Funcionarios.Existe(txtID.Text)

Passo 5 - Registar o funcionário

Utilizar o método “Atualiza” para efetuar as alterações na base de dados e criar/atualizar o funcionário, de acordo com o valor definido na propriedade “EmModoEdicao”.

PriEngine.Engine.RecursosHumanos.Funcionarios.Actualiza(employee);