Crear una tarea planificada por evento

Este servicio web hace parte del add-on APIS AVANZADAS.
Para obtener la información relacionada con el disparador y la tarea, es necesario consultar el servicio web consultar-planes-de-tareas.

Parámetros de entrada

La siguiente información debe ser enviada en el body de la petición.

Parámetro	Tipo	Requerido	Descripción
`item_code`	Texto	Sí	Código del activo al que se le realizará la OT. El activo debe ser de tipo 1, 2 o 3. Se puede consultar aquí. (campo code)
`account_code`	Texto	Sí	Código del recurso humano o tercero con cuenta de usuario en Fracttal, que se registrará como el creador de la OT.
`tasks_triggers_id`	Entero	Sí	ID del activador de tipo evento (tipo 4) asociado al plan y la tarea. Se puede consultar aquí. (campo id)
`id_group_task`	Entero	Sí	ID del plan de mantenimiento al que pertenece la tarea. El activo debe estar vinculado a este plan. Se puede consultar aquí. (campo id)
`id_task`	Entero	Sí	ID de la tarea configurada (is_configured = TRUE) de la cual se obtendrá la información para crear la OT. Se puede consultar aquí. (campo id)
`date_maintenance`	Fecha	Opcional	Fecha en la que se debe realizar la tarea (Por defecto es la fecha actual). Formato: YYYY-MM-DDTHH:MM:SS-UTC. Ejemplo: 2026-12-01T08:00:00-05:00.

Parámetros de salida

Parámetro	Tipo	Descripción
`id_task_todo`	Entero	ID de la tarea en el módulo de tareas pendientes.
`id_task`	Entero	ID de la tarea creada.
`id_item`	Entero	ID interno del activo asociado.
`date_maintenance`	Fecha	Fecha planificada de mantenimiento resultante.
`trigger_description`	Texto	Descripción del disparador. Formato: EVENT$descripcion_evento.

Códigos de error

Código HTTP	Mensaje	Causa
401	Unauthorized access	El campo auth es nulo o inválido.
403	Your company does not have the Add-on: API Advanced	La empresa no tiene habilitado el add-on APIS AVANZADAS.
404	item_code is required	El campo item_code no fue enviado o está vacío.
404	account_code is required	El campo account_code no fue enviado o está vacío.
404	tasks_triggers_id, id_group_task and id_task are required	Uno o más campos requeridos de identificación no fueron enviados.
404	Item does not exist	El activo con el item_code indicado no existe o no es de tipo 1, 2 o 3.
404	Account with code [account_code] does not exist or does not have any account related	El personal con ese código no existe o no tiene cuenta de usuario en Fracttal.
404	User does not have a permission group assigned	El usuario no tiene un grupo de permisos asignado.
404	User does not have permission to add planned tasks	El usuario no tiene permiso add sobre tareas planificadas (módulo 5, submódulo 3).
404	Item is not linked to the maintenance plan	El activo no está vinculado al id_group_task indicado.
404	Event trigger does not exist or is not associated to the task	El tasks_triggers_id no es de tipo evento (tipo 4) o no está asociado al plan y tarea indicados.
404	Task does not exist	La tarea con el id_task indicado no existe.
404	Task is not configured yet	La tarea existe pero no está configurada (is_configured ≠ TRUE).
409	A pending task already exists for this asset and task	Ya existe una tarea pendiente activa para este activo y tarea. No se crean duplicados.

Ejemplo

Petición: (POST)https://app.fracttal.com/api_new/tasks_scheduled

{
    "item_code": "QFCP-001",
    "account_code": "25198772-2",
    "tasks_triggers_id": 27,
    "id_group_task": 1,
    "id_task": 86,
    "date_maintenance": "2026-12-01T08:00:00-05:00"
}

{
    "success": true,
    "message": "200",
    "data": {
        "id_task_todo": 1600093,
        "id_task": 264276,
        "id_item": 500,
        "date_maintenance": "2026-12-01T08:00:00-05:00",
        "trigger_description": "EVENT$COMPRESOR DAÑADO"
    },
    "total": 1
}