---
updatedAt: 2026-06-19T10:24:06.000Z
agentTools:
  projectIndex: https://api.fracttal.com/llms.txt
---

# Crear una tarea planificada por evento

Con esta API se puede crear una tarea planificada desde un evento configurado en un plan de mantenimiento activo.

* 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                                                                                                                                                                                                 |
| :------------------------------- | :------- | :-------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <code>item\_code</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í.](https://api.fracttal.com/reference/consultar-un-activo)  (campo *code*)                     |
| <code>account\_code</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.                                                                                          |
| <code>tasks\_triggers\_id</code> | *Entero* | Sí        | ID del activador de tipo evento (tipo 4) asociado al plan y la tarea. [Se puede consultar aquí.](https://api.fracttal.com/reference/consultar-activadores-de-las-tareas)  (campo *id*)                      |
| <code>id\_group\_task</code>     | *Entero* | Sí        | ID del plan de mantenimiento al que pertenece la tarea. El activo debe estar vinculado a este plan. [Se puede consultar aquí.](https://api.fracttal.com/reference/consultar-planes-de-tareas)  (campo *id*) |
| <code>id\_task</code>            | *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í.](https://api.fracttal.com/reference/consultar-tareas)  (campo *id*)    |
| <code>date\_maintenance</code>   | *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                                                     |
| :-------------------------------- | :------- | :-------------------------------------------------------------- |
| <code>id\_task\_todo</code>       | *Entero* | ID de la tarea en el módulo de tareas pendientes.               |
| <code>id\_task</code>             | *Entero* | ID de la tarea creada.                                          |
| <code>id\_item</code>             | *Entero* | ID interno del activo asociado.                                 |
| <code>date\_maintenance</code>    | *Fecha*  | Fecha planificada de mantenimiento resultante.                  |
| <code>trigger\_description</code> | *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>**

```json Body
{
    "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"
}

```
```json Response
{
    "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
}
```

<HTMLBlock>{`
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Maven+Pro&display=swap" rel="stylesheet">
<link href='https://fonts.googleapis.com/css?family=Heebo' rel='stylesheet'>
<style>
      table {
      border-collapse: collapse;
      border-radius: 1em;
      overflow: hidden;
    }
    
    th,
    td {
      border: 1px solid #E5E5E5;
      padding: 1em;
    }


    body {
      margin: 1.5em;
    }

    .font{
font-size: 14px;
font-weight: 700;
line-height: 17px;
letter-spacing: 0em;
text-align: left;
    color: #4687F1;
      font-style: uppercase;
  }
    table thead {
      background: rgba(70, 135, 241, 0.1) !important;
      color: #4687F1 !important;
      font-size: 13px !important;
      line-height: 17px !important;
    }
  .type-get {
      background-color: #6bbd5b;
      color: white;
      font-size: .7rem;
      padding: .2rem;
      border-radius: .2rem;
      text-transform: uppercase;
      font-weight: bold;
  }
  
  .frame-full {
      width: 100%;
      height: 1000px;
      border-width: 0;
  }

  h1, h2, h3, h4, h5, h6 {
  	font-family: 'Heebo', sans-serif;
  }
  
  code {
  	max-height: 40vh!important;
  }
  
  hr.rounded {
    border-top: 5px solid black;
    border-radius: 5px;
  }
  
  #ReferencePlayground {
  	display: none;
  }
  .Reference-section {
  	display: none;
  }
</style>
`}</HTMLBlock>

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "Crear una tarea planificada por evento"
  },
  "servers": [
    {
      "url": "https://app.fracttal.com/api/tasks_scheduled"
    }
  ],
  "paths": {
    "/": {
      "post": {
        "responses": {
          "200": {
            "description": ""
          }
        },
        "parameters": [],
        "summary": "Crear una tarea planificada por evento",
        "operationId": "post_",
        "description": "Con esta API se puede crear una tarea planificada desde un evento configurado en un plan de mantenimiento activo."
      }
    }
  },
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": true
  }
}
```