Fracttal →

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:

  1. 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

  2. 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ámetrosTipoRequeridoDescripción
typeNúmero Tipo de creación de ot, para este caso es 1
responsible_codeTexto Es opcional si se envía la información del terceroCódigo del recurso humano que será el responsable de la OT
third_party_codeTexto Es opcional si se envía la información del recurso humanoCódigo del tercero donde se encuentra el contacto que será el responsable de la OT
third_party_contactTexto Es opcional si se envía la información del recurso humanoNombre del contacto que será el responsable de la OT
account_codeTexto Código de la cuenta de usuario que se registrará como el creador de la OT
tasks_todoArray 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 para la creación de una OT con una tarea no planificada lanzada por evento

ParámetroTipoRequeridoDescripción
type Número Tipo de creación de ot, para este caso es 3
item_code TextoCódigo del activo al que se le realizará la OT
responsible_code TextoEs opcional si se envía la información del terceroCódigo del recurso humano que será el responsable de la OT
third_party_code TextoEs opcional si se envía la información del recurso humanoCódigo del tercero donde se encuentra el contacto que será el responsable de la OT
third_party_contact TextoEs opcional si se envía la información del recurso humanoNombre del contacto que será el responsable de la OT
account_code TextoCódigo de la cuenta de usuario que se registrará como el creador de la OT
requested_by TextoSolicitado por
id_task NúmeroId de la tarea de la cual se obtendrá la información para crear la OT
tasks_triggers_id NúmeroId del evento
id_group_task NúmeroId del plan de tareas donde se encuentra la tarea de la cual se obtendrá la información
task_descripcion TextoOpcionalDescripción de la tarea (Por defecto es el nombre de la tarea del id_task)
task_type_main TextoOpcionalTipo de tarea (Por defecto es de la tarea del id_task)
task_type_description TextoOpcionalClasificación 1 de tarea (Por defecto es de la tarea del id_task)
task_type_2_description TextoOpcionalClasificación 2 de tarea (Por defecto es de la tarea del id_task)
date_maintenanceTextoOpcionalFecha 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ámetroTipoDescripción
wo_folio TextoId de la OT que se acaba de crear
id_status_work_order TextoEstado de la OT:

1: En proceso
2: En revisión
3: Finalizado
4: Cancelada
responsible TextoNombre del responsable de la OT
responsible_code TextoCódigo del responsable de la OT
date_created FechaFecha de creación de la OT
created_by TextoNombre 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

Language