¿Cómo crear empleados a través de la API?

El módulo de Recursos Humanos del ERP PRIMAVERA incluye varias funcionalidades que permiten gestionar los procesos de recursos humanos de la organización de forma más rápida y eficaz, como, por ejemplo, el procesamiento de salarios, la integración con la seguridad social o la gestión de pagos y recibos.

En este artículo, exploraremos la API de la V10 a través de un ejemplo de creación de un empleado. Esta operación permitirá a su organización crear o actualizar datos de empleados a través de aplicaciones externas.

Fichas de empleados

De todas las opciones disponibles, la entidad central para Recursos Humanos es la tabla de empleados, que da acceso a las fichas de los empleados. Esta tabla se utiliza en muchos de los procesos existentes y es aquí donde se realizan los ajustes que se utilizarán en la mayor parte del módulo.

Ejemplo de creación de un empleado:

Nota: Para esta demostración, utilizaremos el proyecto disponible en GitHub.

Paso 1 - Añadir la referencia al módulo de Recursos Humanos 

Cree un proyecto en Visual Studio y añada las referencias a la API de Recursos Humanos:

• RhpBE100;
• IRhpBS100.

Paso 2 - Utilice el namespace "RhpBE100"

Para facilitar la lectura del código, añada el namespace relativo a la API de RR. HH.

using RhpBE100;

Paso 3 - Cree el objeto empleado con la información necesaria

Utilice el método de creación del objeto "empleado" y defina los campos necesarios.

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,
};

Paso 4 - Compruebe si se trata de un nuevo registro

Utilice la propiedad "EmModoEdicao" para definir el tipo de registro que se va a realizar. Si este valor es "true", la tabla de empleados recibirá un "Update". En caso contrario, la operación será un "Insert".

Para rellenar esta propiedad, debe validar que el empleado ya existe a través de la API de Recursos Humanos, utilizando el código de empleado introducido en “txtID.Text”.

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

Paso 5 - Registrar al empleado

Utilice el método "Atualiza" para realizar cambios en la base de datos y crear/actualizar el empleado, según el valor definido en la propiedad. "EmModoEdicao".

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