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"
}
]
}
]Consideraciones
|
A diferencia de la lista compleja, aquí la validación se hace en bloque: si cualquier elemento de la lista falla su validación, no se importa ninguno, no solo el elemento inválido. |
Un cuerpo [] (lista vacía) es válido y no hace nada, devolviendo 200 OK.
|
Si la categoría de empleado ( |
Códigos de error
|
Al validarse en bloque, si algún elemento de la lista incurre en cualquiera de los códigos de esta tabla, la respuesta completa es |
Además de los errores comunes, este endpoint puede devolver los siguientes códigos:
| Código | Mensaje | Descripción |
|---|---|---|
|
- |
El cuerpo de la petición no es un JSON válido o no puede ser leído. |
Time frame patter not found |
El identificador del patrón de turno ( |
|
Calendar disponibility type is not enabled for business |
Se envía el tipo de disponibilidad |
|
ContractType not found in business |
El identificador de tipo de contrato ( |
|
|
- |
Falta un campo marcado como obligatorio dentro de un objeto presente en la petición ( |
- |
Un campo numérico recibe un valor negativo. |
|
- |
En un contrato o una asociación a servicio, la fecha de inicio ( |
|
- |
El valor de un campo enumerado no corresponde a ninguno de los valores definidos. |
|
- |
La lista enviada supera el límite de 30 elementos permitido. Se recomienda dividir la petición en lotes más pequeños. |
|
El objeto |
|
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. |
Enlaces de interés
¿Qué es un empleado?
¿Qué es una asociación a servicio?
¿Qué es un contrato? ¿Y un tipo de contrato?