Base URL https://api.afer.pro Referencia aferapp.com Reservar demo

Cambiar el turno de una persona

POST https://api.afer.pro/api/v1/employees/{id}/shifts
Alias en castellano (v0, sigue operativo): 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.

Autenticación

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.

empleadoIdstring
obligatorio
La persona. En la ruta, {id}.
fecha_iniciostring
obligatorio
El día, o el primero.
fecha_finstring
opcional
El último, si son varios (hasta 62).
turnoIdstring
opcional
El turno (consultarTurnos).
libreboolean
opcional
Día libre en vez de turno.
confirmarboolean
opcional
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

200 · application/json
{
    "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

CasoResultado
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.
Notas

Admite X-IDEMPOTENCY-KEY. Por MCP es cambiar_turno.