API Endpoints
Fracttal →

Crear una tarea no planificada

Con esta API se crea puede crear una tarea no planificada, de dos formas diferentes:

  • Como tarea no planificada
  • Como tarea no planificada lanzada por evento

Notas:
-Para la tarea no planificada lanzada por evento, la tarea de la cual se traen los datos, no puede tener recursos asociados.
-Para obtener la información relacionada con el disparador y la tarea, es necesario consultar el servicio web https://api.fracttal.com/reference/consultar-planes-de-tareas

-Este servicio web hace parte del add-on APIS AVANZADAS


Parámetros de entrada para la creación como una tarea no planificada

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

ParámetroTipoRequeridoDescripción
typeTextoTipo de creación de la tarea, para este caso es 1
item_codeTextoCódigo del activo al que se le realizará la OT. Se puede consultar aquí. (campo code)
account_codeTextoCódigo del recurso humano o tercero con una cuenta de usuario en Fracttal, el cual se registrará como el creador de la OT.
requested_byTextoSolicitado por
task_descripcionTextoOpcionalDescripción de la tarea (Por defecto es el nombre de la tarea del id_task)
task_type_mainTextoTipo de tarea (Por defecto es de la tarea del id_task)
task_type_descriptionTextoOpcionalClasificación 1 de tarea (Por defecto es de la tarea del id_task)
task_type_2_descriptionTextoOpcionalClasificación 2 de tarea (Por defecto es de la tarea del id_task)
event_dateFechaOpcionalFecha en la que ocurrió el evento (Por defecto es la fecha actual).Formato: YYYY-MM-DDTHH:MM:SS-UTC Ejemplo: 2021-07-12T20:00:00-03.
date_maintenanceFechaOpcionalFecha en la que se debe realizar la tarea (Por defecto es la fecha actual). Formato: YYYY-MM-DDTHH:MM:SS-UTC Ejemplo: 2021-07-12T20:00:00-03.
asset_failureBooleanoOpcionalValor que indica si falló el activo. False por defecto
failure_typeTextoOpcionalDescripción de la falla
failure_causeTextoOpcionalDescripción de la causa de la falla
failure_detection_methodTextoOpcionalDescripción del método de detección de la falla
id_failure_severityEnteroOpcionalId de la severidad de falla
1: Muy Baja
2: Baja
3: Media
4: Alta
5: Muy Alta
id_damage_typeEnteroOpcionalTipo de daño causado:
1: Ninguno
2: Daño al medio ambiente
3: Daño a las instalaciones
4: Lesiones al personal interno
5: Lesiones a terceros
6: Otro
asset_out_of_serviceBooleanoOpcionalValor para indicar si la tarea tiene asociado un fuera de servicio. False por defecto
date_asset_out_of_serviceFechaOpcionalFecha de inciio del fuera de servicio

Parámetros de entrada para la creación como una tarea no planificada lanzada por evento

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

ParámetroTipoRequeridoDescripción
item_codeTextoCódigo del activo al que se le realizará la OT. Se puede consultar aquí. (campo code)
account_codeTextoCódigo del recurso humano o tercero con una cuenta de usuario en Fracttal, el cual se registrará como el creador de la OT.
requested_byTextoSolicitado por
id_taskEnteroId de la tarea de la cual se obtendrá la información para crear la OT. Se puede consultar aquí. (campo id)
tasks_triggers_idEnteroId del activador. Se puede consultar aquí. (campo id)
id_group_taskEnteroId del plan de tareas donde se encuentra la tarea de la cual se obtendrá la información. Se puede consultar aquí. (campo id)
task_descripcionTextoOpcionalDescripción de la tarea (Por defecto es el nombre de la tarea del id_task)
task_type_mainTextoTipo de tarea (Por defecto es de la tarea del id_task)
task_type_descriptionTextoOpcionalClasificación 1 de tarea (Por defecto es de la tarea del id_task)
task_type_2_descriptionTextoOpcionalClasificación 2 de tarea (Por defecto es de la tarea del id_task)
event_dateFechaOpcionalFecha en la que ocurrió el evento (Por defecto es la fecha actual).Formato: YYYY-MM-DDTHH:MM:SS-UTC Ejemplo: 2021-07-12T20:00:00-03.
date_maintenanceFechaOpcionalFecha en la que se debe realizar la tarea (Por defecto es la fecha actual). Formato: YYYY-MM-DDTHH:MM:SS-UTC Ejemplo: 2021-07-12T20:00:00-03.
asset_failureBooleanoOpcionalValor que indica si falló el activo. False por defecto
failure_typeTextoOpcionalDescripción de la falla
failure_causeTextoOpcionalDescripción de la causa de la falla
failure_detection_methodTextoOpcionalDescripción del método de detección de la falla
id_failure_severityEnteroOpcionalId de la severidad de falla
1: Muy Baja
2: Baja
3: Media
4: Alta
5: Muy Alta
id_damage_typeEnteroOpcionalTipo de daño causado:
1: Ninguno
2: Daño al medio ambiente
3: Daño a las instalaciones
4: Lesiones al personal interno
5: Lesiones a terceros
6: Otro
asset_out_of_serviceBooleanoOpcionalValor para indicar si la tarea tiene asociado un fuera de servicio. False por defecto
date_asset_out_of_serviceFechaOpcionalFecha de inciio del fuera de servicio

Parámetros de salida

ParámetroTipoDescripción
id_todoEnteroId de la tarea en el módulo de tareas pendientes
id_taskEnteroId de la tarea
date_createdFechaFecha de creación de la OT
date_maintenanceTextoFecha planificada de la tarea


Ejemplo de creación de tarea no planificada

Petición: (POST) https://app.fracttal.com/api/tasks_nonscheduled

{
    "type": "1",
    "item_code": "QFCP-001",
    "account_code": "25198772-2",
    "requested_by": "FRACTTAL SPA",  
    "task_descripcion": "Nueva tarea generada por API",    
    "task_type_main": "tipotemp1",
    "task_type_description": "clas1temp1",
    "task_type_2_description": "clas2temp1"    
}

{
    "success": true,
    "message": "200",
    "data": {
        "id_todo": 22025273,
        "id_task": 8623662,
        "date_maintenance": "2024-04-12T21:11:41.615485+00:00",
        "date_created": "2024-04-12T21:11:41.615485+00:00"
    },
    "total": 0
}

Ejemplo de creación de tarea no planificada lanzada por evento:

Petición: (POST) https://app.fracttal.com/api/tasks_nonscheduled

{
    "item_code": "118",
    "account_code": "25198772-2",
    "requested_by": "FRACTTAL SPA",
    "id_task": 86,
    "task_descripcion": "Nueva tarea generada por API",
    "tasks_triggers_id": 27,
    "id_group_task": 1,
    "task_type_main": "CORRECTIVA",
    "task_type_description": "MECÁNICA",
    "task_type_2_description": "REQUIERE PERMISO ALTURA",
    "date_maintenance": "2021-09-30T21:16:29.870548+00:00",
    "asset_failure": "true",
    "failure_type":"COMPRESOR DAÑADO",
    "failure_cause":"CIRCUITO CORTADO",
    "failure_detection_method":"INSPECCIÓN VISUAL",
    "id_failure_severity": 3,
    "id_damage_type":1,
    "asset_out_of_service": "true"
}
{
    "success": true,
    "message": "200",
    "data": {
        "id_todo": 1600093,
        "id_task": 455912,
        "date_maintenance": "2021-05-28T21:16:29.870548+00:00",
        "date_created": "2021-05-27T23:06:34.525633+00:00"
    },
    "total": 1
}
Language