Consulta de Tarefas em OS's

Através desta API é possível consultar as informações das ordens de trabalho e as tarefas que estão associadas à ordem de trabalho.

Parâmetros de entrada

Pode ser consultado por um intervalo de datas específico.

Parâmetros Tipo Requerido Descrição

folio *Texto* Opcional ID do WO. Pode ser visualizado neste mesmo ponto de extremidade. (campo *wo_folio*)

ot_status *Texto* Opcional Status do OS. 1: Em processo, 2: Revisão, 3: Concluído, 4: Cancelado

code_asset *Texto* Opcional Código do ativo ao qual a tarefa está associada (o ativo pode ser um local, equipamento ou ferramenta). (Disponível aqui.)([https://api.fracttal.com/v3-pt/reference/consultar-um-ativo](https://api.fracttal.com/v3-pt/reference/consultar-um-ativo)) (campo *code*)

since *Texto* Opcional Data inicial da consulta. Formato: ‘YYYY-MM-DDTHH:MM:SS-UTC’ Ejemplo:’2016-07-12T20:00:00-03′. Por padrão, nenhum filtro de data é aplicado.

until *Texto* Opcional Data final da consulta. Formato: ‘YYYY-MM-DDTHH:MM:SS-UTC’ Ejemplo:’2016-07-12T20:00:00-03′. Por padrão, nenhum filtro de data é aplicado

type_date

*Texto*

Opcional

Tipo de data para fazer a consulta. Pode ser:

Valor	Descrição
	data_criação	Data de criação da OT (Valor padrão)
data_manutenção	Data de manutenção da tarefa
data_cal_manutenção	Data calculada de manutenção da tarefa
initial_date	Data de início da tarefa
final_date	Data de término da tarefa
review_date	Data de envio da OT para revisão
wo_final_date	Data de conclusão da OT

code_location *Texto* Opcional Código de la ubicación. [Ele está disponível aqui.](https://api.fracttal.com/v3-pt/reference/consultar-um-ativo) (campo *code*)

id_work_order_task *Inteiro* Opcional Id da tarefa na ordem de serviço. Ele pode ser consultado nesse mesmo ponto de extremidade (campo *id_work_order_tasks*).

start *Inteiro* Opcional Número do registro onde a consulta será iniciada. O padrão é 0. Todas as consultas são limitadas a 100 registros; quando houver mais do que essa quantidade, esse parâmetro deverá ser usado para paginação.

limit *Inteiro* Opcional Número de registros que a solicitação exibirá. O valor padrão é 100.

Observação: Todas as datas retornadas pelos serviços da Web da Fracttal estão em UTC-0.

Parâmetros de saída

Parâmetros Tipo Descrição

id_work_order *Inteiro* ID da OS

wo_folio *Texto* Folio da OS

creation_date *Texto* Data de criação da OS

initial_date *Texto* Data inicial

duration *Inteiro* Duração da ordem de serviço

id_works_ordes_task *Inteiro* ID da tarefa

id_task *Inteiro* ID_tarefa

id_item *Inteiro* ID_item

id_status_work_order *Inteiro* 1: OS em processo 2: OS em revisão 3: OS concluída 4: OS cancelada

final_date *Texto* Data de término da tarefa

completed_percentage *Texto* Porcentagem da ordem de serviço concluída

created_by *Texto* Nome do gerador de ordens de serviço

signature *Texto* Assinatura

personnel_description *Texto* Descrição pessoal

personnel_path_image *Texto* Caminho da imagem

code *Texto* Código do ativo

items_log_description *Texto* Descrição do ativo

done *Texto* True (verdadeiro) se a tarefa já estiver concluída e False (falso) se a tarefa não estiver concluída.

description *Texto* Descrição da tarefa

id_request *Inteiro* ID da solicitação, se a tarefa for proveniente de uma solicitação

stop_assets *Texto* True (verdadeiro) se o ativo estiver parado e False (falso) se o ativo NÃO estiver parado.

stop_assets_sec *Inteiro* Tempo de desligamento do ativo (segundos)

tasks_log_task_type_main *Texto* Tipo de tarefa

parent_description *Texto* Localização do ativo

resources_hours *Texto* Soma das horas de recursos humanos utilizados

trigger_description *Texto* Tipo de ativador

resources_inventory *Texto* Recursos do tipo inventário na tarefa

resources_human_resources *Texto* Recursos humanos na Tarefa

resources_services *Texto* Recursos tipo serviços

cal_date_maintenance *Texto* Data estimada da tarefa

real_duration *Inteiro* Duração real da tarefa

date_maintenance *Texto* Data de programação de tarefas

user_assigned *Texto* Usuário atribuído

note *Texto* Observação da ordem de serviço

details_signature *Texto* Detalhes da assinatura da ordem de serviço

responsible_path_signature *Texto* Caminho do responsável da assinatura

validator_path_signature *Texto* Caminho da assinatura do validador

first_date_task *Texto* Data de início da tarefa mais próxima da conclusão

costs_center_description *Texto* Centro de custo de ativos

tasks_duration *Texto* Duração estimada da tarefa

total_cost_task *Texto* Custo total da OS

requested_by *Texto* Solicitante de tarefa não programada

groups_description *Texto* Informações sobre o “tipo” de ativo

groups_1_description *Texto* Classificação 1 dos ativos

groups_2_description *Texto* Classificação 2 dos ativos

task_note *Texto* observação da tarefa

id_parent_wo *Inteiro* ID pai da OS

has_children *Texto* True se a ordem de serviço tiver ordens de serviço secundárias

real_stop_assets_sec *Texto* Tempo de inatividade real do ativo

wo_final_date *Texto* Data final da ordem de serviço

is_offline *Texto* Desligado

tasks_log_types_description *Texto* Classificação 1 da tarefa

tasks_log_types_2_description *Texto* Classificação 2 da tarefa

code_create_by *Texto* Codigo criado por

event_date *Texto* Data do evento

rating *Texto* Qualificação para a OS

enable_budget *Texto* Disponibilidade do orçamento

code_responsible *Texto* Código da pessoa responsável pelo OS

id_parent *Inteiro* ID pai

id_failure_type *Inteiro* ID tipo da falha

work_orders_status_custom_description *Texto* Motivo do cancelamento

review_date *Texto* Data de análise

types_description *Texto* Tipo de falha

id_failure_cause *Inteiro* ID causa da falha

causes_description *Texto* Causa da falha

id_failure_detection_method *Inteiro* ID método de detenção da falha

detection_method_description *Texto* Método de detecção de falhas

id_failure_severity *Inteiro* ID gravidade da falha

severiry_description *Texto* Severidade da falha

id_damage_type *Inteiro* ID tipo

damages_types_description *Texto* Tipo de dano causado

caused_damage *Texto* Causa do dano causado

id_group_task *Inteiro* ID grupo de tarefa

id_items_availability *Inteiro* ID Items disponívels

validated_by_description *Texto* Descrição validada por

id_personnel_log *Inteiro* ID log pessoal

id_contacts_log *Inteiro* ID registro do contato

annotations *Texto* Anotações

id_priorities *Inteiro* ID de prioridade da tarefa

priorities_description *Texto* Descrição da prioridade da tarefa

id_personnel *Inteiro* ID do recurso humano

id_contact *Inteiro* ID do contato

labels

*Matriz JSON*

Parâmetros	Tipo	Descrição
`color`	Texto	Código HTML para a cor do rótulo
`enabled`	Booleano	Indica se o rótulo está ativo ou não. Valores: verdadeiro ou falso.
`assigned_by`	Inteiro	ID do usuário que atribuiu o rótulo ao WO
`description`	Texto	Nome da etiqueta
`assigned_date`	Data	Data em que o rótulo foi atribuído ao AT

id_company *Inteiro* ID da empresa

Exemplo:

Requisição: (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
}