Crear o actualizar lista de empleados (simplificado)
Este endpoint es una simplificación de Crear o actualizar 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.
|
Los campos obligatorios están marcados con (*). Los valores admitidos para los campos de tipo |
Cuerpo de la petición
| Análisis del JSON |
|---|
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": "Jane",
"surname": "Santos",
"employeeId": "010203",
"seniority": "2018-03-01"
},
"serviceAssociations": [
{
"ownerProduct": "0001-G",
"product": "0001-G",
"from": "2024-01-01",
"to": null,
"disponibility": [
{
"from": "2026-01-01",
"ranges": [
{
"dayType": "ALL",
"startMinuteDay": 0,
"duration": 1440,
"available": false
}
],
"type": "SHIFT_PATTERN",
"timeFramePatternId": "d01e1e08-b2e4-48d1",
"weekStart": 1,
"blockedType": "NON_EXTENSIBLE_TIME"
}
]
}
],
"contracts": [
{
"from": "2026-01-01",
"to": null,
"regularMinutes": 0,
"additionalMinutes": 0,
"regularControlPeriod": "WEEKLY",
"additionalControlPeriod": "WEEKLY",
"calendarDaysOff": false,
"numberOfHolidays": 0,
"numberOfPublicHolidays": 0,
"weeklyDaysInvolved": "MONDAY_SUNDAY",
"personCategory": "AV",
"contractTypeId": "JC40"
}
]
}
]Aspectos que tener en cuenta
Si el cuerpo de la petición no es un JSON válido o no puede ser leído, la petición devolverá un error 400 Bad Request.
Si no se envía un campo marcado como obligatorio, la petición devolverá un error 406 Not Acceptable.
Si un campo numérico recibe un valor negativo, la petición devolverá un error 406 Not Acceptable.
En contratos y asociaciones a servicio, si la fecha de inicio (from) es posterior a la fecha de fin (to), la petición devolverá un error 406 Not Acceptable.
Si el valor de un campo de tipo enumerado no corresponde a ninguno de los valores definidos, la petición devolverá error.
|
Se recomienda revisar el cuerpo de la respuesta en caso de error, ya que incluye información relevante para su diagnóstico y depuración, como el campo inválido o el valor no reconocido. |
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.
|
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?