API Endpoints
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.
id_items_availabilityEnteroOpcionalId de fuera de servicio
task_noteTextoOpcionalNotas de la tarea

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

Parámetros de salida

ParámetroTipoDescripción
id_work_orderTextoId de la OT
wo_folioTextoFolio de la OT
creation_dateTextoFecha de creación de la OT
initial_dateTextoFecha de Inicio de la OT
durationEnteroDuración de la orden de trabajo
id_works_ordes_taskEnteroId de la tarea en la OT
id_taskEnteroId de la tarea
id_itemEnteroId del Item
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
signatureTextoFirma
personnel_descriptionTextoDescripción personal
personnel_path_imageTextoRuta de la imagen
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
resources_servicesTextoRecursos de tipo servicio 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
responsible_path_signatureTextoRuta de la firma del responsable
validator_path_signatureTextoRuta de la firma del validador
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
task_noteTextoNotas de la tarea
id_parent_woTextoID padre de la OT
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
is_offlineTextoDesconectado
tasks_log_types_descriptionTextoClasificación 1 de la Tarea
tasks_log_types_2_descriptionTextoClasificación 2 de la Tarea
code_create_byTextoCódigo creador por
event_dateTextoFecha del evento
ratingTextoCalificación de la OT
enable_budgetTextoPresupuesto habilitado
code_responsibleTextoCódigo del responsable de la Ot
id_parentEnteroId padre
id_failure_typeEnteroId tipo de fallo
work_orders_status_custom_descriptionTextoMotivo de cancelación
review_dateTextoFecha de revisión
types_descriptionTextoTipo de falla
id_failure_causeEnteroId causa de falla
causes_descriptionTextoCausa de la falla
id_failure_detection_methodEnteroId método de detención de la falla
detection_method_descriptionTextoMétodo de detección de la falla
id_failure_severityEnteroId severidad de la falla
severiry_descriptionTextoSeveridad de la falla
id_damage_typeEnteroId tipo de daño
damages_types_descriptionTextoTipo de daño causado
caused_damageTextoCausa del daño causado
id_group_taskEnteroId tarea de grupo
id_items_availabilityEnteroId disponibilidad de artículos
validated_by_descriptionTextoDescripción validada por
id_personnel_logEnteroId registro de personal
id_contacts_logEnteroId registro de contactos
annotationsTextoAnotaciones
id_prioritiesEnteroId de la prioridad de la tarea
priorities_descriptionTextoDescripción de la prioridad de la tarea
id_personnelEnteroId del recurso humano
id_contactEnteroId del contacto
id_companyEnteroId compañía

Ejemplo:

Petición: (GET) https://app.fracttal.com/api/work_orders/OT-1585

{
    "success": true,
    "message": "200",
    "data": [
        {
            "id_work_order": 17241262,
            "id_work_orders_tasks": 28667629,
            "id_task": 10424947,
            "id_item": 1,
            "id_status_work_order": 1,
            "wo_folio": "OT-1585",
            "creation_date": "2024-07-29T16:17:41.54975+00:00",
            "duration": 600,
            "initial_date": null,
            "id_priorities": 2,
            "priorities_description": "HIGH",
            "final_date": null,
            "completed_percentage": 0,
            "created_by": "MIR LONDOÑO",
            "signature": null,
            "personnel_description": "MIR LONDOÑO",
            "personnel_path_image": "classic/resources/images/background-img.png",
            "code": "",
            "items_log_description": "BASE INFRAESTRUCTURA     ARGENTINA",
            "done": false,
            "description": "OTRA VERIFICACIÓN DEL FDS DESDE PRD AL MISMO ACTIVO",
            "id_request": null,
            "stop_assets": false,
            "stop_assets_sec": null,
            "tasks_log_task_type_main": "PREVENTIVA",
            "parent_description": "// VEOLIA ARGENTINA/ Servicios Publicos/ Aesa Buenos Aires/ ",
            "trigger_description": "NO_SCHEDULE_TASK",
            "resources_hours": null,
            "resources_inventory": null,
            "resources_human_resources": null,
            "resources_services": null,
            "cal_date_maintenance": "2024-07-29T16:06:44.779+00:00",
            "real_duration": 0,
            "date_maintenance": "2024-07-29T16:06:44.779+00:00",
            "user_assigned": "MIR LONDOÑO",
            "note": null,
            "details_signature": null,
            "responsible_path_signature": "classic/resources/images/background-img.png",
            "validator_path_signature": null,
            "first_date_task": "2024-07-29T16:06:44.779+00:00",
            "costs_center_description": "E38400C00032 (  )",
            "tasks_duration": 600,
            "total_cost_task": null,
            "requested_by": "MIR LONDOÑO",
            "groups_description": null,
            "groups_1_description": null,
            "groups_2_description": null,
            "task_note": null,
            "id_parent_wo": null,
            "has_children": false,
            "real_stop_assets_sec": 0,
            "wo_final_date": null,
            "is_offline": null,
            "tasks_log_types_description": null,
            "tasks_log_types_2_description": null,
            "code_create_by": null,
            "event_date": "2024-07-29T16:16:44.779+00:00",
            "rating": null,
            "enable_budget": null,
            "work_orders_status_custom_description": null,
            "review_date": null,
            "code_responsible": null,
            "id_parent": 11481707,
            "id_failure_type": 3,
            "types_description": "Cabina / Interior ",
            "id_failure_cause": 27954,
            "causes_description": "Causa externa",
            "id_failure_detection_method": 909,
            "detection_method_description": "Catalogo Braunco",
            "id_failure_severity": 3,
            "severiry_description": "MEDIUM",
            "id_damage_type": 1,
            "damages_types_description": "NEITHER",
            "caused_damage": null,
            "id_group_task": null,
            "id_items_availability": 367701,
            "validated_by_description": null,
            "id_personnel_log": 161268,
            "id_contacts_log": null,
            "annotations": null,
            "id_personnel": 546991,
            "id_contact": null,
            "id_company": 1190
        }
    ],
    "total": 1
}

Probar conexión

Language