Agendar un parte o una tarea
https://api.afer.pro/api/v1/work-orders/{id}/schedule
POST /api/v1/tasks/{id}/schedule
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.
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.
tipostringopcional | parte o tarea. En las rutas REST lo fija la ruta. |
documentoIdstringobligatorio | El parteId o el tareaId. En la ruta, {id}. |
fechastringobligatorio | El día (YYYY-MM-DD). |
hora_iniciostringopcional | HH:MM. Sin hora queda para ese día, sin hora. |
hora_finstringopcional | HH:MM. O duracion_minutos; sin ninguno, 30 minutos. |
duracion_minutosintegeropcional | Cuánto dura. |
fecha_finstringopcional | El último día, si dura varios. |
asignadosarrayopcional | Personas que se añaden (las que ya estaban siguen). |
forzarbooleanopcional | Guardar aunque haya choques. |
desplanificarbooleanopcional | 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
{
"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
| Caso | Resultado |
|---|---|
| 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. |
Admite X-IDEMPOTENCY-KEY. Por MCP es agendar.