Con esta API se 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 o 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 obtener los IDs de las tareas pendientes que se desean llevar a OT se debe consultar la API Consultar tareas pendientes
-
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 Consultar información detallada de planes de tareas
Parámetros Entrada para la creación de una OT con tareas desde Tareas Pendientes
Parámetros | Tipo | Requerido | Descripción |
---|---|---|---|
type | Número | Sí | Tipo de creación de ot, para este caso es 1 |
responsible_code | Texto | Es opcional si se envía la información del tercero | Código del recurso humano que será el responsable de la OT |
third_party_code | Texto | Es opcional si se envía la información del recurso humano | Código del tercero donde se encuentra el contacto que será el responsable de la OT |
third_party_contact | Texto | Es opcional si se envía la información del recurso humano | Nombre del contacto que será el responsable de la OT |
account_code | Texto | Sí | Código de la cuenta de usuario que se registrará como el creador de la OT |
tasks_todo | Array de json | Sí | 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 para la creación de una OT con una tarea no planificada lanzada por evento
Parámetro | Tipo | Requerido | Descripción |
---|---|---|---|
type | Número | Sí | Tipo de creación de ot, para este caso es 3 |
item_code | Texto | Sí | Código del activo al que se le realizará la OT |
responsible_code | Texto | Es opcional si se envía la información del tercero | Código del recurso humano que será el responsable de la OT |
third_party_code | Texto | Es opcional si se envía la información del recurso humano | Código del tercero donde se encuentra el contacto que será el responsable de la OT |
third_party_contact | Texto | Es opcional si se envía la información del recurso humano | Nombre del contacto que será el responsable de la OT |
account_code | Texto | Sí | Código de la cuenta de usuario que se registrará como el creador de la OT |
requested_by | Texto | Sí | Solicitado por |
id_task | Número | Sí | Id de la tarea de la cual se obtendrá la información para crear la OT |
tasks_triggers_id | Número | Sí | Id del evento |
id_group_task | Número | Sí | 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) |
date_maintenance | Texto | Opcional | Fecha de programación de la OT. Formato: ‘YYYY-MM-DDTHH:MM:SS-UTC’ Ejemplo:’2016-07-12T20:00:00-03′. |
Parámetros de salida
Parámetro | Tipo | Descripción |
---|---|---|
wo_folio | Texto | Id de la OT que se acaba de crear |
id_status_work_order | Texto | Estado de la OT: 1: En proceso 2: En revisión 3: Finalizado 4: Cancelada |
responsible | Texto | Nombre del responsable de la OT |
responsible_code | Texto | 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
{
"type":1,
"responsible_code": "7809097-2",
"account_code": "7845123",
"tasks_todo":[
{
"tasks_todo_id":1600093
},
{
"tasks_todo_id":1087
}
]
}
{
"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"
}
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
{
"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"
}
{
"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
}
PROBAR CONEXION