Crear una orden de trabajo

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′.
`note`	Texto	Opcional	Nota de la tarea que se asocia a la OT

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