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

Agendar un parte o una tarea

POST https://api.afer.pro/api/v1/work-orders/{id}/schedule
También disponible en: POST /api/v1/tasks/{id}/schedule
Alias en castellano (v0, sigue operativo): POST https://api.afer.pro/api/v1/work-orders/{id}/schedule

Pone o cambia fecha, hora y duración de un parte o tarea, comprueba choques y lo pasa a la agenda de cada persona.

Rutas: POST /work-orders/{id}/schedule (parte) y POST /tasks/{id}/schedule (tarea de proyecto); con el alias POST /agendar, el tipo va en tipo.

Antes de guardar mira, para cada persona que lo tiene, si ese día no trabaja o si ya tiene algo a esa hora. Si hay choques no guarda: responde ok: false con los choques. Con forzar: true guarda igualmente. Caer fuera de la jornada es solo un aviso.

Al guardar, queda en la agenda de cada persona igual que al planificar desde el panel y, con hora, sube a su Google Calendar si lo tiene conectado (lo recoge el cron en unos minutos). desplanificar: true le quita la fecha.

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.

tipostring
opcional
parte o tarea. En las rutas REST lo fija la ruta.
documentoIdstring
obligatorio
El parteId o el tareaId. En la ruta, {id}.
fechastring
obligatorio
El día (YYYY-MM-DD).
hora_iniciostring
opcional
HH:MM. Sin hora queda para ese día, sin hora.
hora_finstring
opcional
HH:MM. O duracion_minutos; sin ninguno, 30 minutos.
duracion_minutosinteger
opcional
Cuánto dura.
fecha_finstring
opcional
El último día, si dura varios.
asignadosarray
opcional
Personas que se añaden (las que ya estaban siguen).
forzarboolean
opcional
Guardar aunque haya choques.
desplanificarboolean
opcional
Quitarle la fecha.

Ejemplo de petición

curl -X POST 'https://api.afer.pro/api/v1/work-orders/aBc123XyZ/schedule' \
  -H 'X-API-KEY: afer_tk_TU_TOKEN' \
  -H 'X-API-SECRET: afer_sk_TU_SECRET' \
  -H 'Content-Type: application/json' \
  -d '{
    "fecha": "2026-11-09",
    "hora_inicio": "15:00",
    "duracion_minutos": 90,
    "asignados": [
        "toni@empresa.es"
    ]
}'
<?php

$data = [
  'fecha' => '2026-11-09',
  'hora_inicio' => '15:00',
  'duracion_minutos' => 90,
  'asignados' => [
    0 => 'toni@empresa.es',
  ],
];

$ch = curl_init('https://api.afer.pro/api/v1/work-orders/aBc123XyZ/schedule');
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/work-orders/aBc123XyZ/schedule', {
  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": "2026-11-09",
      "hora_inicio": "15:00",
      "duracion_minutos": 90,
      "asignados": [
          "toni@empresa.es"
      ]
  })
});

const resultado = await respuesta.json();

Respuesta

200 · application/json
{
    "errorCode": 200,
    "errorMsg": "",
    "data": {
        "ok": true,
        "parteId": "gHi…",
        "titulo": "Revisión caldera",
        "fecha": "2026-11-09",
        "fecha_fin": "2026-11-09",
        "hora_inicio": "15:00",
        "hora_fin": "16:30",
        "asignados": [
            {
                "empleadoId": "aBc…",
                "nombre": "Pere Mas"
            },
            {
                "empleadoId": "dEf…",
                "nombre": "Toni Vich"
            }
        ],
        "forzado": false,
        "choques": [],
        "avisos": [],
        "mensaje": "Agendado: sale en la agenda de 2 personas y, quien tenga Google conectado, lo verá allí en unos minutos."
    }
}

Errores

CasoResultado
Sin credenciales errorCode 401.
Fecha u horas mal escritas, o fin antes del inicio errorCode 400.
El parte o la tarea no es de tu cuenta errorCode 404.
Notas

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