Crear o modificar lista de empleados (simplificado)
Este endpoint es una simplificación de Crear o modificar lista de empleados (complejo). Permite crear o modificar la lista de empleados incluyendo solo información acerca de la persona, sus asociaciones a servicio y sus contratos.
PUT /api/v1/businesses/{businessId}/import/simple/employeesA continuación, se expone una explicación detallada de cada uno de los campos que pueden conformar el cuerpo de la petición, siendo algunos de ellos obligatorios para que esta se realice de manera exitosa.
|
Los campos obligatorios están marcados con un asterisco (*). |
Cuerpo de la petición
Objeto person* Incluye los datos personales del empleado identificado a través de su employeeId. |
Detalles
|
Objeto serviceAssociations Incluye la información relativa a las asociaciones a servicio establecidas para el empleado. |
Detalles
|
Objeto contracts Incluye la información relativa a los contratos que se aplican al empleado, en términos de horas trabajadas, limitaciones laborales, etc. |
Detalles
|
Ejemplo de la petición
Una vez realizado el análisis de los distintos campos, se muestra un ejemplo del cuerpo de la petición:
[
{
"person": {
"name": "Brian",
"surname": "Cohen",
"group": "01",
"email": "brian@orquest.com",
"birthday": "1987-12-01",
"employeeId": "021298521",
"seniority": "2021-12-01",
"aptitudes": [
{
"productId": "C14",
"aptitudes": [
{
"locationId": "101",
"level": 3
},
{
"locationId": "102",
"level": 2
}
]
}
]
},
"serviceAssociations": [
{
"ownerProduct": "C14",
"product": "C14",
"from": "2024-04-11",
"to": null,
"splitPresence": true,
"unplannable": false,
"disponibility": [
{
"from": "2024-04-11",
"to": null,
"ranges": [
{
"dayType": "ALL",
"startMinuteDay": 600,
"duration": 300
}
]
}
],
"id": "asb1415"
}
],
"contracts": [
{
"from": "2024-04-11",
"to": "2027-04-11",
"regularMinutes": 2400,
"countingDays": "MONDAY_SUNDAY",
"additionalMinutes": 360,
"regularControlPeriod": "WEEKLY",
"additionalControlPeriod": "WEEKLY",
"calendarDaysOff": true,
"numberOfHolidays": 25,
"numberOfPublicHolidays": 7,
"weeklyDaysInvolved": "MONDAY_SUNDAY",
"metadata": {
"full": true,
"days": 215,
"taxProfit": "none"
},
"costPerHour": 200.34,
"personCategory": "DE125",
"id": "321abc654def",
"contractTypeId": "07H"
}
]
}
]Aspectos que tener en cuenta
Cada entidad de la lista tiene su propio estado, es decir, cada elemento de la lista tiene su propio conjunto de atributos o propiedades que se pueden actualizar de manera independiente. No se permiten más de 30 elementos en el cuerpo de la petición.
Cada entidad generará una operación atómica que se puede revertir de forma automática si hay errores: el error se mostrará en la respuesta de la petición.
Si se incluyen datos del objeto user, se valida la existencia de ese usuario en Orquest, de modo que se establecen los siguientes escenarios:
-
Si el usuario no existe, se crea y se vincula al empleado.
-
Si el usuario existe y ya está vinculado al empleado de la petición, se actualiza la información.
-
Si el usuario existe y está vinculado a otro empleado, la operación se cancela y devuelve
HTTP 409 - Conflict, señalando el conflicto con los detalles del error en el cuerpo de la respuesta.
|
Si la categoría de empleado ( |
Enlaces de interés
¿Qué es un empleado?
¿Qué es una asociación a servicio?
¿Qué es un contrato? ¿Y un tipo de contrato?