Cambiar el turno de una persona
https://api.afer.pro/api/v1/employees/{id}/shifts
POST https://api.afer.pro/api/v1/employees/{id}/shifts
Otro turno o día libre en una o varias fechas, como en el cuadrante. Solo administradores, en dos pasos.
Reescribe la planificación de esa persona en esas fechas con los tramos que tiene el turno ese día de la semana, o día libre. Si el día venía de un patrón rotativo, conserva su patrón y su semana para que la rotación siga donde iba. Si después se regenera su planificación en esas fechas desde el panel, el cambio se pisa, igual que en el cuadrante.
En dos pasos: sin confirmar devuelve el antes y el después de cada día; con confirmar: true lo guarda. Solo un administrador de la empresa.
Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →
Este endpoint requiere autenticación (API key u OAuth). Escribe en tu cuenta.
Parámetros del cuerpo
El cuerpo de la petición es un objeto JSON con Content-Type: application/json.
empleadoIdstringobligatorio | La persona. En la ruta, {id}. |
fecha_iniciostringobligatorio | El día, o el primero. |
fecha_finstringopcional | El último, si son varios (hasta 62). |
turnoIdstringopcional | El turno (consultarTurnos). |
librebooleanopcional | Día libre en vez de turno. |
confirmarbooleanopcional | Guardar el cambio propuesto. |
Ejemplo de petición
curl -X POST 'https://api.afer.pro/api/v1/employees/aBc123XyZ/shifts' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"fecha_inicio": "2026-11-10",
"turnoId": "bCd…"
}'
<?php
$data = [
'fecha_inicio' => '2026-11-10',
'turnoId' => 'bCd…',
];
$ch = curl_init('https://api.afer.pro/api/v1/employees/aBc123XyZ/shifts');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-KEY: afer_tk_TU_TOKEN',
'X-API-SECRET: afer_sk_TU_SECRET',
'Content-Type: application/json',
]);
$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/employees/aBc123XyZ/shifts', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
},
body: JSON.stringify({
"fecha_inicio": "2026-11-10",
"turnoId": "bCd…"
})
});
const resultado = await respuesta.json();
Respuesta
{
"errorCode": 200,
"errorMsg": "",
"data": {
"confirmado": false,
"empleado": {
"empleadoId": "dEf…",
"nombre": "Toni Vich"
},
"cambios": [
{
"fecha": "2026-11-10",
"dia": "martes",
"antes": "Mañana · 09:00–14:00 y 15:00–17:00",
"despues": "Tarde · 14:00–22:00"
}
],
"mensaje": "No he cambiado nada. Léele al usuario cómo quedaría y, si dice que sí, vuelve a llamar igual con confirmar = true."
}
}
Errores
| Caso | Resultado |
|---|---|
| Sin credenciales | errorCode 401. |
| Quien llama no es administrador | errorCode 403. |
| El turno no es de tu cuenta | errorCode 404. |
Sin turno ni libre |
errorCode 400. |
Admite X-IDEMPOTENCY-KEY. Por MCP es cambiar_turno.