(POST) Crear una orden de trabajo

Con esta API se crea puede crear una orden de trabajo:

  • Mediante la creación de una tarea No planificada, cuya información se descarga desde una tarea por evento.
  • ó con las tareas se encuentran en tareas pendientes.

Este servicio web hace parte del add-on APIS AVANZADAS

Notas:

Para la creación de OTs con las tareas que se encuentran en tareas pendientes, tener en cuenta:

Para la creación de OTs mediante la creación de una tarea no planificada lanzada por evento, tener en cuenta:

  • El evento del 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://ayuda.fracttal.com/articulos/get-consultar-informacion-detallada-de-planes-de-tareas/

EndPoint
https://app.fracttal.com/api/work_orders

Método POST

Parámetros Entrada en el Body para la creación de una OT con tareas desde Tareas Pendientes:

Parámetro Tipo de campo Requerido Descripción
type Número Tipo de creación de ot, para este caso es 1
responsible_code Texto Código del recurso humano que será el responsable de la OT
account_code Text Código de la cuenta de usuario que se registrará como el creador de la OT
tasks_todo Array de json Array con la información de las tareas pendientes.

Cada json, debe contener el parámetro tasks_todo_id que corresponde al id de la tarea en tareas pendientes

Parámetros Entrada en el Body para la creación de una OT con una tarea no planificada lanzada por evento

Parámetro Tipo de campo Requerido Descripción
type Número Tipo de creación de ot, para este caso es 3
item_code Text Código del activo al que se le realizará la OT
responsible_code Texto Código del recurso humano que será el responsable de la OT
account_code Text Código de la cuenta de usuario que se registrará como el creador de la OT
requested_by Texto Solicitado por
id_task Número Id de la tarea de la cual se obtendrá la información para crear la OT
tasks_triggers_id Número Id del evento
id_group_task Número Id del plan de tareas donde se encuentra la tarea de la cual se obtendrá la información
task_descripcion Texto Opcional Descripción de la tarea (Por defecto es el nombre de la tarea del id_task)
task_type_main Texto Opcional Tipo de tarea (Por defecto es de la tarea del id_task)
task_type_description Texto Opcional Clasificación 1 de tarea (Por defecto es de la tarea del id_task)
task_type_2_description Texto Opcional Clasificación 2 de tarea (Por defecto es de la tarea del id_task)

Enviar los campos obligatorios y los parámetros con los valores adicionales que se desea insertar.

Parámetros de salida

Parámetro Tipo de campo Descripción
wo_folio Texto Id de la OT que se acaba de crear
id_status_work_order Text Estado de la OT:

1: En proceso
2: En revisión
3: Finalizado
4: Cancelada
responsible Text Nombre del responsable de la OT
responsible_code Text Código del responsable de la OT
date_created Fecha Fecha de creación de la OT
created_by Texto Nombre del usuario que se regristó como creador de la OT

Ejemplo tareas desde tareas pendientes:
Petición: (POST) https://app.fracttal.com/api/work_orders

Body

{
"type":1,
"responsible_code": "7809097-2",
"account_code": "7845123",
"tasks_todo":[
{
"tasks_todo_id":1600093
},
{
"tasks_todo_id":1087
}
]
}

Ejemplo Respuesta:

{
"success": true,
"message": "200",
"data": {
"id": 1130348,
"id_company": 69,
"id_status_work_order": 1,
"wo_folio": "OT-1731",
"creation_date": "2021-07-27T14:43:38.330737+00:00",
"duration": 1200,
"id_assigned_user": null,
"initial_date": null,
"final_date": null,
"completed_percentage": 0,
"id_created_by": 40,
"created_by": "Alejandra Arango",
"signature": null,
"note": null,
"details_signature": null,
"id_validated_by": null,
"first_date_task": null,
"id_personnel_log": 10073,
"id_contacts_log": null,
"id_parent": null,
"is_offline": null,
"id_account_offline": null,
"code_created_by": "7845123",
"rating": null,
"enable_budget": false,
"id_work_orders_status_custom": null,
"review_date": null,
"id_accounts_log_validated_by": null,
"id_public": null,
"statistics": null,
"type_user": "HUMAN_RESOURCES",
"id_responsible": 60,
"id_account_responsible": null,
"description": "OT-1731"
}

Ejemplo creación de OTs desde la creación de una tarea no planificada con información de un evento:

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

Body

{
"type": 3,
"item_code": "118",
"responsible_code": "32322",
"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"
}

Ejemplo Respuesta:

{
"success": true,
"message": "200",
"data": {
"wo_folio": "OT-1694",
"id_status_work_order": 1,
"responsible": "FRACTTAL SPA",
"responsible_code": "32322",
"date_created": "2021-05-11T14:54:45.294203+00:00",
"created_by": "Laura Marcela Peña Jaramillo"
},
"total": 1
}