Fracttal →

Consulta de tareas en OTS

Mediante esta API se puede consultar la información de las órdenes de trabajo y de las tareas que están asociadas a la orden de trabajo.

Parámetros de entrada

Se puede filtrar la información mediante el siguiente query_params:

ParámetroParámetroRequeridoDescripción
folioTextoOpcionalId de la OT. Se puede consultar en este mismo endpoint. (campo wo_folio)
ot_statusTextoOpcionalEstado de la Ot. 1: Proceso, 2: Revisión, 3: Finalizada, 4: Cancelada
code_assetTextoOpcionalCódigo del activo que tiene asociada la tarea (El activo puede ser una ubicación, equipo o herramienta). Se puede consultar aquí. (campo code)
sinceTextoOpcionalFecha inicial de la consulta. Formato: ‘YYYY-MM-DDTHH:MM:SS-UTC’ Ejemplo:’2016-07-12T20:00:00-03′.
Por defecto, no se aplica filtro de fechas.
untilTextoOpcionalFecha final de la consulta. Formato: ‘YYYY-MM-DDTHH:MM:SS-UTC’ Ejemplo:’2016-07-12T20:00:00-03′.
Por defecto, no se aplica filtro de fechas
type_dateTextoOpcionalTipo de fecha para hacer la consulta. puede ser:

ValorDescripción
creation_dateFecha de creación de la OT (Valor por defecto)
date_maintenanceFecha de mantenimiento de la tarea
cal_date_maintenanceFecha calculada de mantenimiento de la tarea
initial_dateFecha inicial de la tarea
final_dateFecha de finalización de la tarea
review_dateFecha de envío de la OT a revisión
wo_final_dateFecha de finalización de la OT
code_locationTextoOpcionalCódigo de la ubicación. Se puede consultar aquí. (campo code)
id_work_order_taskEnteroOpcionalId de la tarea en la orden de trabajo. Se puede consultar en este mismo endpoint. (campo id_work_order_tasks)
startEnteroOpcionalNúmero de registro donde iniciará la consulta. Por defecto 0.
Todas las consultas están limitadas a 100 registros, cuando hay más de esa cantidad se debe utilizar este parámetro para la paginación.
limitEnteroOpcionalCantidad de registros que mostrará la petición. El valor por defecto es 100.

Nota: Todas las fechas que retornan los servicios web de Fracttal están en UTC-0

Parámetros de salida

ParámetroTipoDescripción
wo_folioTextoId de la OT
creation_dateTextoFecha de creación de la OT
durationEnteroDuración de la orden de trabajo
id_works_ordes_taskEnteroId de la tarea
id_status_work_orderEntero1: OT en Proceso
2: OT en Revisión
3: OT Finalizada
4: OT cancelada
final_dateTextoFecha final de la tarea
completed_percentageTextoPorcentaje completado de la orden de trabajo
created_byTextoNombre del Generador de la orden de trabajo
codeTextoCódigo del activo
items_log_descriptionTextoDescripción del activo
doneTextoTrue si la tarea ya está finalizada y False en caso de que la tarea no esté finalizada
descriptionTextoDescripción de la tarea
id_requestTextoId de la solicitud, si la tarea proviene de una solicitud
stop_assetsTextoTrue si el activo está detenido y False en caso de que el activo NO está detenido
stop_assets_secEnteroTiempo de paro del activo (segundos)
tasks_log_task_type_mainTextoTipo de tarea
parent_descriptionTextoLocalización del activo
resources_hoursTextoSuma de horas de los recursos humanos utilizados
trigger_descriptionTextoTipo de Activador
resources_inventoryTextoRecursos de tipo inventario en la tarea
resources_human_resourcesTextoRecursos Humanos en la tarea
cal_date_maintenanceTextoFecha calculada de la tarea
real_durationEnteroDuración real de la tarea
date_maintenanceTextoFecha de programación de la tarea
user_assignedTextoUsuario Asignado
noteTextoNota de la orden de trabajo
details_signatureTextoDetalles de la firma de la orden de trabajo
first_date_taskTextoFecha inicial de la tarea más próxima a realizarse
costs_center_descriptionTextoCentro de costos del activo
tasks_durationTextoDuración estimada de la tarea
total_cost_taskTextoCosto total de la OT
requested_byTextoSolicitante de una tarea no programada
groups_descriptionTextoInformación ‘Tipo’ de activo
groups_1_descriptionTextoClasificación 1 de activo
groups_2_descriptionTextoClasificación 2 de activo
has_childrenTextoTrue si la orden de trabajo tiene órdenes de trabajo hijas
real_stop_assets_secTextoTiempo real de parada del activo
wo_final_dateTextoFecha final de la orden de trabajo
tasks_log_types_descriptionTextoClasificación 1 de la Tarea
tasks_log_types_2_descriptionTextoClasificación 2 de la Tarea
ratingTextoCalificación de la OT
code_responsibleTextoCódigo del responsable de la Ot
work_orders_status_custom_descriptionTextoMotivo de cancelación
types_descriptionTextoTipo de falla
causes_descriptionTextoCausa de la falla
detection_method_descriptionTextoMétodo de detección de la falla
severiry_descriptionTextoSeveridad de la falla
damages_types_descriptionTextoTipo de daño causado
caused_damageTextoCausa del daño causado
id_prioritiesTextoId de la prioridad de la tarea
priorities_descriptionTextoDescripción de la prioridad de la tarea
id_personnelEnteroId del recurso humano
id_contactEnteroId del contacto

Ejemplo:

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

{
  "success": true,
  "message": "200",
  "data": [
{
            "id_work_order": 694,
            "id_work_orders_tasks": 1048,
            "id_status_work_order": 3,
            "wo_folio": "702",
            "creation_date": "2016-11-03T22:03:24.306526+00:00",
            "duration": 18600,
            "initial_date": "2016-11-03T16:54:15+00:00",
            "id_priorities": 1,
            "final_date": "2016-11-03T22:04:15+00:00",
            "completed_percentage": 100,
            "created_by": "Laura Marcela Peña Jaramillo",
            "signature": null,
            "personnel_description": "ADOLFO  BELTRAN",
  					"priorities_description": "VERY_HIGH",
            "personnel_path_image": ".images/dut7mtlgufidwpuk3locqivswh13l1mquwcjlu7tionurl8h.png",
            "code": null,
            "items_log_description": "GRUPO ELECTROGENO Nº01 ",
            "done": true,
            "description": "REPARACION DEL EQUIPO",
            "id_request": null,
            "stop_assets": true,
            "stop_assets_sec": null,
            "tasks_log_task_type_main": "CORRECTIVA",
            "parent_description": "// CCICSA/ ",
            "trigger_description": "NO_SCHEDULE_TASK",
            "resources_hours": 2,
            "resources_inventory": null,
            "resources_human_resources": "ADOLFO  BELTRAN",
            "resources_services": null,
            "cal_date_maintenance": "2016-11-03T03:00:00+00:00",
            "real_duration": 18600,
            "date_maintenance": "2016-11-03T03:00:00+00:00",
            "user_assigned": "ADOLFO  BELTRAN",
            "note": null,
            "details_signature": null,
            "responsible_path_signature": "classic/resources/images/background-img.png",
            "validator_path_signature": ".images/x2pe12213f740oee8567inxm81prwxsq63m1ak43xfvtph.png",
            "first_date_task": "2016-11-03T03:00:00+00:00",
            "costs_center_description": "",
            "tasks_duration": 18600,
            "total_cost_task": 8888,
            "requested_by": "MIGUEL",
            "groups_description": "GRUPOS ELECTROGENOS",
            "groups_1_description": "PLANTA",
            "groups_2_description": "SUBESTACION ELECTRICA GENERAL PLANTA",
            "id_parent_wo": null,
            "has_children": false,
            "real_stop_assets_sec": null,
            "wo_final_date": null,
            "is_offline": null,
            "tasks_log_types_description": null,
            "tasks_log_types_2_description": null,
            "code_create_by": null,
            "event_date": "2016-11-03T17:08:01+00:00",
            "rating": null,
            "enable_budget": null,
            "work_orders_status_custom_description": null,
            "review_date": null,
            "code_responsible": null,
            "id_parent": 24517,
            "id_failure_type": 2,
            "types_description": "PROBLEMA DE MEMORIA",
            "id_failure_cause": 9,
            "causes_description": "FALTA DE COMBUSTIBLE",
            "id_failure_detection_method": 1,
            "detection_method_description": "INSPECCION VISUAL",
            "id_failure_severity": 1,
            "severiry_description": "VERY_HIGH",
            "id_damage_type": 1,
            "damages_types_description": "NEITHER",
            "caused_damage": null,
            "id_group_task": null,
            "id_company": 133
        }
       ],
  "total": 1
}

Probar conexión

Language