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ámetro Parámetro Requerido Descripción

folio *Texto* Opcional Id de la OT. Se puede consultar en este mismo endpoint. (campo *wo_folio*)

ot_status *Texto* Opcional Estado de la Ot. 1: Proceso, 2: Revisión, 3: Finalizada, 4: Cancelada

code_asset *Texto* Opcional Código del activo que tiene asociada la tarea (El activo puede ser una ubicación, equipo o herramienta). [Se puede consultar aquí.](https://api.fracttal.com/reference/consultar-un-activo) (campo *code*)

since *Texto* Opcional Fecha 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.

until *Texto* Opcional Fecha 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_date

*Texto*

Opcional

Tipo de fecha para hacer la consulta. puede ser:

Valor	Descripción
creation_date	Fecha de creación de la OT (Valor por defecto)
date_maintenance	Fecha de mantenimiento de la tarea
cal_date_maintenance	Fecha calculada de mantenimiento de la tarea
initial_date	Fecha inicial de la tarea
final_date	Fecha de finalización de la tarea
review_date	Fecha de envío de la OT a revisión
wo_final_date	Fecha de finalización de la OT

code_location *Texto* Opcional Código de la ubicación. [Se puede consultar aquí.](https://api.fracttal.com/reference/consultar-un-activo) (campo *code*)

id_work_order_task *Entero* Opcional Id de la tarea en la orden de trabajo. Se puede consultar en este mismo endpoint. (campo *id_work_order_tasks*)

start *Entero* Opcional Nú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.

limit *Entero* Opcional Cantidad de registros que mostrará la petición. El valor por defecto es 100.

id_items_availability *Entero* Opcional Id de fuera de servicio

task_note *Texto* Opcional Notas de la tarea

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

Parámetros de salida

Parámetro Tipo Descripción

id_work_order *Texto* Id de la OT

wo_folio *Texto* Folio de la OT

creation_date *Texto* Fecha de creación de la OT

initial_date *Texto* Fecha de Inicio de la OT

duration *Entero* Duración de la orden de trabajo

id_works_ordes_task *Entero* Id de la tarea en la OT

id_task *Entero* Id de la tarea

id_item *Entero* Id del Item

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

signature *Texto* Firma

personnel_description *Texto* Descripción personal

personnel_path_image *Texto* Ruta de la imagen

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

resources_services *Texto* Recursos de tipo servicio 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

responsible_path_signature *Texto* Ruta de la firma del responsable

validator_path_signature *Texto* Ruta de la firma del validador

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

task_note *Texto* Notas de la tarea

id_parent_wo *Texto* ID padre de la OT

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

is_offline *Texto* Desconectado

tasks_log_types_description *Texto* Clasificación 1 de la Tarea

tasks_log_types_2_description *Texto* Clasificación 2 de la Tarea

code_create_by *Texto* Código creador por

event_date *Texto* Fecha del evento

rating *Texto* Calificación de la OT

enable_budget *Texto* Presupuesto habilitado

code_responsible *Texto* Código del responsable de la Ot

id_parent *Entero* Id padre

id_failure_type *Entero* Id tipo de fallo

work_orders_status_custom_description *Texto* Motivo de cancelación

review_date *Texto* Fecha de revisión

types_description *Texto* Tipo de falla

id_failure_cause *Entero* Id causa de falla

causes_description *Texto* Causa de la falla

id_failure_detection_method *Entero* Id método de detención de la falla

detection_method_description *Texto* Método de detección de la falla

id_failure_severity *Entero* Id severidad de la falla

severiry_description *Texto* Severidad de la falla

id_damage_type *Entero* Id tipo de daño

damages_types_description *Texto* Tipo de daño causado

caused_damage *Texto* Causa del daño causado

id_group_task *Entero* Id tarea de grupo

id_items_availability *Entero* Id disponibilidad de artículos

validated_by_description *Texto* Descripción validada por

id_personnel_log *Entero* Id registro de personal

id_contacts_log *Entero* Id registro de contactos

annotations *Texto* Anotaciones

id_priorities *Entero* Id de la prioridad de la tarea

priorities_description *Texto* Descripción de la prioridad de la tarea

id_personnel *Entero* Id del recurso humano

id_contact *Entero* Id del contacto

id_status_work_order_task *Entero* Id de estado de la tarea 0 - Sin iniciar 1 - En progreso 2 - Pausada 3 - Finalizada

task_status *Texto* Descripción del estado de la tarea

children *Array de texto* Folios de las órdenes de trabajo secundarias (hijas), en caso de que existan.

labels

*Array de Json*

Parámetro	Tipo	Descripción
`color`	Texto	Código HTML del color de la etiqueta
`enabled`	Booleano	Indica si la etiqueta está activa o no. Valores: true o false.
`assigned_by`	Entero	Id del usuario que asignó la etiqueta a la OT
`description`	Texto	Nombre de la etiqueta
`assigned_date`	Fecha	Fecha en que se asignó la etiqueta a la OT

id_company *Entero* Id compañía

Ejemplo:

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

{
    "success": true,
    "message": "200",
    "data": [
        {
            "id_work_order": 26379866,
            "id_work_orders_tasks": 41747676,
            "id_task": 15537608,
            "id_item": 3,
            "id_status_work_order": 1,
            "wo_folio": "OT-29050",
            "creation_date": "2025-08-21T13:09:27.058237+00:00",
            "duration": 600,
            "initial_date": null,
            "id_priorities": 3,
            "priorities_description": "MEDIUM",
            "final_date": null,
            "completed_percentage": 0,
            "created_by": "Adri Z",
            "signature": null,
            "personnel_description": "Adri Z ",
            "personnel_path_image": "classic/resources/images/background-img.png",
            "code": "",
            "items_log_description": "TERCEROS VARIOS CABA  CABA ARGENTINA",
            "done": false,
            "description": "Prueba rrhh",
            "id_request": null,
            "stop_assets": false,
            "stop_assets_sec": null,
            "tasks_log_task_type_main": "MANT. CORRECTIVO",
            "parent_description": "// VEOLIA ARGENTINA/ Servicios Publicos/ Aesa Buenos Aires/ BASE INFRAESTRUCTURA/ ",
            "trigger_description": "NO_SCHEDULE_TASK",
            "resources_hours": 14,
            "resources_inventory": null,
            "resources_human_resources": "David  Basualdo; Jorge Omar Muñoz",
            "resources_services": null,
            "cal_date_maintenance": "2025-08-21T13:17:54.732+00:00",
            "real_duration": null,
            "date_maintenance": "2025-08-21T13:17:54.732+00:00",
            "user_assigned": "Adri Z ",
            "note": null,
            "details_signature": null,
            "responsible_path_signature": "classic/resources/images/background-img.png",
            "validator_path_signature": null,
            "first_date_task": "2025-08-21T13:17:54.732+00:00",
            "costs_center_description": "E38400C00033 (  )",
            "tasks_duration": 600,
            "total_cost_task": 33179.3,
            "requested_by": "Adri Z ",
            "groups_description": "INMUEBLE",
            "groups_1_description": null,
            "groups_2_description": null,
            "task_note": null,
            "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": "2025-08-21T13:07:54.732+00:00",
            "rating": null,
            "enable_budget": false,
            "work_orders_status_custom_description": null,
            "review_date": null,
            "code_responsible": null,
            "id_parent": 1,
            "id_failure_type": null,
            "types_description": null,
            "id_failure_cause": null,
            "causes_description": null,
            "id_failure_detection_method": null,
            "detection_method_description": null,
            "id_failure_severity": null,
            "severiry_description": null,
            "id_damage_type": null,
            "damages_types_description": null,
            "caused_damage": null,
            "id_group_task": null,
            "id_items_availability": null,
            "validated_by_description": null,
            "id_personnel_log": 232256,
            "id_contacts_log": null,
            "annotations": null,
            "id_personnel": 655428,
            "id_contact": null,
            "task_status": "NO_STARTED",
            "id_status_work_order_task": 0,
            "labels": [
                {
                    "id": 23,
                    "color": "203df7",
                    "enabled": true,
                    "assigned_by": 5,
                    "description": "REQUIERE APROBACIÓN ADMINISTRATIVA",
                    "assigned_date": "2025-08-21T15:37:15.233337+00:00"
                }
            ],
            "id_company": 1190
        }
    ],
    "total": 1
}