Crear una orden de trabajo

Con esta API, puedes crear una orden de trabajo de las siguientes maneras:

Desde tareas pendientes.
Desde una tarea no planificada.
Desde una tarea no planificada lanzada por evento.
Desde una solicitud de trabajo.

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 desde una tarea no planificada, aquí existen las siguientes opciones:
1. OT no planificada, mediante está opción se deben enviar toda la información de la tarea al endpoint.
2. OT no planificada lanzada por evento, mediante esta opción la tarea tomará como base toda información contenida en evento del plan de tareas. Para esto 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
Para la creación de OTs con base en una solicitud de trabajo, la solicitud de trabajo debe estar activa y no puede estar asociada a otra OT. Se pueden consultar las solicitudes de trabajo acá

Parámetros Entrada para la creación de una OT desde Tareas Pendientes

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

Parámetros	Tipo	Requerido	Descripción
`type`	Entero	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. Se puede consultar aquí. (campo code)
`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. Se puede consultar aquí. (campo code)
`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 desde una tarea no planificada

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

Parámetro	Tipo	Requerido	Descripción
`type`	Entero	Sí	Tipo de creación de ot, para este caso es 3
`item_code`	Texto	Si	Es el código del activo asociado a la OT. Se puede consultar aquí. (campo code)
`responsible_code`	Texto	Si	Código del recurso humano o tercero asociado a la OT
`account_code`	Texto	Si	Código de la cuenta que realiza la OT
`requested_by`	Texto	Si	Solicitado por
`task_descripcion`	Texto	Si	Descripción de la tarea, la cual no debe superar 200 caracteres
`task_type_main`	Texto	Si	Tipo de tarea
`task_type_description`	Texto	Opcional	Clasificación 1 de tarea
`task_type_2_description`	Texto	Opcional	Clasificación 2 de tarea

Parámetros Entrada para la creación de una OT desde una tarea no planificada lanzada por evento

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

Parámetro	Tipo	Requerido	Descripción
`type`	Entero	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`	Entero	Sí	Id de la tarea de la cual se obtendrá la información para crear la OT
`tasks_triggers_id`	Entero	Sí	Id del evento
`id_group_task`	Entero	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), la cual no debe superar 200 caracteres
`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′.
`note`	Texto	Opcional	Nota de la tarea que se asocia a la OT

Parámetros Entrada para la creación de una OT desde una solicitud de trabajo

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

Parámetro	Tipo	Requerido	Descripción
`type`	Entero	Sí	Tipo de creación de ot, para este caso es 3
`item_code`	Texto	Si	Es el código del activo asociado a la OT. Se puede consultar aquí. (campo code)
`responsible_code`	Texto	Si	Código del recurso humano o tercero asociado a la OT
`account_code`	Texto	Si	Código de la cuenta que realiza la OT
`requested_by`	Texto	Si	Solicitado por
`task_descripcion`	Texto	Si	Descripción de la tarea, la cual no debe superar 200 caracteres
`task_type_main`	Texto	Si	Tipo de tarea
`id_request`	Entero	Si	Id de la solicitud de trabajo. Se puede consultar aquí. (campo id_code)

Parámetros de salida

Parámetro	Tipo	Descripción
`wo_folio`	Texto	Id de la OT
`creation_date`	Texto	Fecha de creación de la OT
`duration`	Entero	Duración de la orden de trabajo
`id_works_ordes_task`	Entero	Id de la tarea
`id_status_work_order`	Entero	1: OT en Proceso 2: OT en Revisión 3: OT Finalizada 4: OT cancelada
`final_date`	Texto	Fecha final de la tarea
`completed_percentage`	Texto	Porcentaje completado de la orden de trabajo
`created_by`	Texto	Nombre del Generador de la orden de trabajo
`code`	Texto	Código del activo
`items_log_description`	Texto	Descripción del activo
`done`	Texto	True si la tarea ya está finalizada y False en caso de que la tarea no esté finalizada
`description`	Texto	Descripción de la tarea
`id_request`	Texto	Id de la solicitud, si la tarea proviene de una solicitud
`stop_assets`	Texto	True si el activo está detenido y False en caso de que el activo NO está detenido
`stop_assets_sec`	Entero	Tiempo de paro del activo (segundos)
`tasks_log_task_type_main`	Texto	Tipo de tarea
`parent_description`	Texto	Localización del activo
`resources_hours`	Texto	Suma de horas de los recursos humanos utilizados
`trigger_description`	Texto	Tipo de Activador
`resources_inventory`	Texto	Recursos de tipo inventario en la tarea
`resources_human_resources`	Texto	Recursos Humanos en la tarea
`cal_date_maintenance`	Texto	Fecha calculada de la tarea
`real_duration`	Entero	Duración real de la tarea
`date_maintenance`	Texto	Fecha de programación de la tarea
`user_assigned`	Texto	Usuario Asignado
`note`	Texto	Nota de la orden de trabajo
`details_signature`	Texto	Detalles de la firma de la orden de trabajo
`first_date_task`	Texto	Fecha inicial de la tarea más próxima a realizarse
`costs_center_description`	Texto	Centro de costos del activo
`tasks_duration`	Texto	Duración estimada de la tarea
`total_cost_task`	Texto	Costo total de la OT
`requested_by`	Texto	Solicitante de una tarea no programada
`groups_description`	Texto	Información ‘Tipo’ de activo
`groups_1_description`	Texto	Clasificación 1 de activo
`groups_2_description`	Texto	Clasificación 2 de activo
`has_children`	Texto	True si la orden de trabajo tiene órdenes de trabajo hijas
`real_stop_assets_sec`	Texto	Tiempo real de parada del activo
`wo_final_date`	Texto	Fecha final de la orden de trabajo
`tasks_log_types_description`	Texto	Clasificación 1 de la Tarea
`tasks_log_types_2_description`	Texto	Clasificación 2 de la Tarea
`rating`	Texto	Calificación de la OT
`code_responsible`	Texto	Código del responsable de la Ot
`work_orders_status_custom_description`	Texto	Motivo de cancelación
`types_description`	Texto	Tipo de falla
`causes_description`	Texto	Causa de la falla
`detection_method_description`	Texto	Método de detección de la falla
`severiry_description`	Texto	Severidad de la falla
`damages_types_description`	Texto	Tipo de daño causado
`caused_damage`	Texto	Causa del daño causado
`id_priorities`	Texto	Id de la prioridad de la tarea
`priorities_description`	Texto	Descripción de la prioridad de la tarea

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 una tarea no plantificada:

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

{  
    "type": 2,
    "item_code": "EQM032",
    "responsible_code": "RH-002",
    "account_code": "RH-002",
    "requested_by": "Ruben Prieto",
    "task_descripcion": "Orden de trabajo de prueba",
    "task_type_main": "Correctiva"
}

{
    "success": true,
    "message": "200",
    "data": {
        "id_work_order": 11934394,
        "wo_folio": "OT-2420",
        "id_work_order_task": 20338615,
        "id_status_work_order": 1,
        "user_type": "HUMAN_RESOURCES",
        "responsible": "Pepito perez",
        "responsible_code": "RH-002",
        "date_created": "2023-11-10T20:44:59.479973+00:00",
        "created_by": "Pepito perez"
    },
    "total": 1
}

Creación de OTs desde 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
}

Creación de OTs desde una solicitud de trabajo:

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

{
    "type": 2,
    "item_code": "EQM032",
    "responsible_code": "RH-002",
    "account_code": "RH-002",
    "requested_by": "Ruben Prieto",
    "task_descripcion": "Orden de trabajo de prueba",
    "task_type_main": "Correctiva",
    "id_request": 1827
}

{
    "success": true,
    "message": "200",
    "data": {
        "id_work_order": 11934394,
        "wo_folio": "OT-2420",
        "id_work_order_task": 20338615,
        "id_status_work_order": 1,
        "user_type": "HUMAN_RESOURCES",
        "responsible": "Pepito perez",
        "responsible_code": "RH-002",
        "date_created": "2023-11-10T20:44:59.479973+00:00",
        "created_by": "Pepito perez"
    },
    "total": 1
}