Replanificar tareas
https://api.afer.pro/api/v1/tasks/{id}/reschedule
POST https://api.afer.pro/api/v1/tasks/{id}/reschedule
Mueve una tarea con sus mismos días laborables y corre lo justo las que esperan a ella, en cadena. En dos pasos.
La tarea empieza en nueva_fecha_inicio (o desplazar_dias laborables más tarde; negativo adelanta) y conserva sus días laborables. Las que esperan a ella, y las que esperan a esas, se corren lo justo para empezar el laborable siguiente a que acabe la anterior; las que ya empezaban más tarde no se tocan. Laborable = lunes a viernes y no festivo de la empresa.
En dos pasos: sin confirmar devuelve el antes y el después y no cambia nada; con confirmar: true lo guarda y rehace su agenda.
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.
tareaIdstringobligatorio | La tarea. En la ruta, {id}. |
nueva_fecha_iniciostringopcional | El nuevo día de empezar. |
desplazar_diasintegeropcional | O cuántos laborables se mueve. |
mover_dependientesbooleanopcional | Correr las que esperan. Por defecto sí. |
confirmarbooleanopcional | Guardar los cambios propuestos. |
Ejemplo de petición
curl -X POST 'https://api.afer.pro/api/v1/tasks/aBc123XyZ/reschedule' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"desplazar_dias": 5
}'
<?php
$data = [
'desplazar_dias' => 5,
];
$ch = curl_init('https://api.afer.pro/api/v1/tasks/aBc123XyZ/reschedule');
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/tasks/aBc123XyZ/reschedule', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
},
body: JSON.stringify({
"desplazar_dias": 5
})
});
const resultado = await respuesta.json();
Respuesta
{
"errorCode": 200,
"errorMsg": "",
"data": {
"confirmado": false,
"cambios": [
{
"tareaId": "sTu…",
"titulo": "Estructura",
"antes": {
"inicio": "2026-11-09",
"fin": "2026-11-20"
},
"despues": {
"inicio": "2026-11-16",
"fin": "2026-11-27"
}
},
{
"tareaId": "vWx…",
"titulo": "Cubierta",
"antes": {
"inicio": "2026-11-23",
"fin": "2026-11-27"
},
"despues": {
"inicio": "2026-11-30",
"fin": "2026-12-04"
}
}
],
"avisos": [],
"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. |
| Sin nueva fecha ni desplazamiento | errorCode 400. |
| La tarea no es de tu cuenta | errorCode 404. |
Admite X-IDEMPOTENCY-KEY. Por MCP es replanificar_tareas.