Eliminar una tarea pendiente no planificada

delete

https://app.fracttal.com/api/tasks_nonscheduled/

Elimina una tarea pendiente no planificada (trigger_description = 'NO_SCHEDULE_TASK') por su id_task_todo, reutilizando la lógica de borrado en cascada existente.

Add-on requerido
La empresa debe tener habilitado el add-on API Advanced. Sin él, el endpoint responde 403.

DELETE https://app.fracttal.com/api/tasks_nonscheduled

Autenticación
Este endpoint no lleva objeto auth en el body. La autenticación es solo Authorization: Bearer <token>; el gateway resuelve id_company internamente.

Parámetros de entrada — Requeridos

Se envían en el body de la petición.

Parámetro	Tipo	Requerido	Descripción
`id_task_todo`	entero	Sí	PK de `tasks.tasks_todo` (la ocurrencia de la tarea, no el `id_task` de la tarea maestra).
`user_code`	texto	Sí	Código de empleado con cuenta activa y permiso `remove` sobre Tareas Pendientes (módulo 5, submódulo 3).

Parámetros de entrada — Opcionales

Ninguno.

Parámetros de salida

Parámetro	Tipo	Descripción
`success`	booleano	`true` si la eliminación fue exitosa.
`message`	texto	`"200"` en éxito; código/mensaje de error en caso contrario.
`total`	entero	Cantidad de registros eliminados (`1` en éxito).
`data`	objeto	`{ id_task_todo, id_task, description }` de la tarea eliminada (o `{ ERROR: "..." }` en fallo).

Errores

Código	Causa
`400`	`id_task_todo is required` — no se envió o no es un entero válido.
`400`	`id_task_todo was not found` — no existe para esa empresa. También ocurre al reintentar sobre un id ya eliminado (comportamiento idempotente).
`400`	`Only unscheduled tasks can be deleted` — el `trigger_description` es distinto de `NO_SCHEDULE_TASK`.
`400`	`TASK_NO_DELETE_BY_WO_PENDING` — la tarea tiene una OT activa con `id_status_work_order < 3`.
`400`	`user_code does not have permission to delete pending tasks`.
`401`	Token inválido o ausente (`INVALID_TOKEN`).
`403`	La empresa no tiene habilitado el add-on API Advanced.
`500`	Error interno no controlado.

Idempotencia
Reintentar el DELETE sobre un id_task_todo ya eliminado responde 400 con "id_task_todo was not found" — el mismo error que un ID inexistente. Es el comportamiento esperado, no un fallo.

Ejemplo

Request body

{
  "id_task_todo": 48408311,
  "user_code": "RH-001"
}

Response `200`

{
  "success": true,
  "message": "200",
  "data": {
    "id_task_todo": 48408311,
    "id_task": 20456,
    "description": "PRUEBA ALEJANDRO DE ESTABILIDAD"
  },
  "total": "1"
}

Response — error, tarea planificada (`400`)

{
  "success": false,
  "message": "400",
  "data": { "ERROR": "Only unscheduled tasks can be deleted" },
  "total": 0
}

Response — reintento sobre id ya eliminado (`400`, idempotencia)

{
  "success": false,
  "message": "400",
  "data": { "ERROR": "id_task_todo was not found" },
  "total": 0
}

Response

200

Language

Loading…