Consultar os tempos de execução das tarefas no OS

Veja informações detalhadas sobre uma lista de ativos ou sobre um ativo específico.

Mediante esta API é possível consultar o detalhe dos tempos utilizados para a execução de uma tarefa dentro de uma ordem de serviço.

Parâmetros de entrada

É possível filtrar as informações mediante os seguintes query_params:

ParâmetroTipoRequeridoDescrição
id_work_order_taskInteiroOpcionalId da tarefa na ordem de serviço. Pode ser consultado aqui. (campo id_work_orders_task)
id_work_orderInteiroOpcionalID da ordem de trabalho. Pode ser consultado aqui (o parâmetro é id_work_order):
startInteiroOpcionalNúmero do registro onde iniciará a consulta. Por padrão 0.
Todas as consultas estão limitadas a 100 registros, quando há mais que essa quantidade deve-se utilizar este parâmetro para a paginação.
limitInteiroOpcionalQuantidade de registros que mostrará a requisição. O valor por padrão é 100.

Parâmetros de saída

Nota: Todas as datas que retornam os serviços web do Fracttal estão em UTC-0

ParâmetroTipoDescrição
id_work_order_taskInteiroId da tarefa dentro da OS
initial_dateTextoData de início da execução da tarefa
final_dateTextoData de finalização da execução da tarefa
id_wo_tasks_execution_typesInteiroId do tipo de execução atribuído ao registro. Retorna null se nenhum tipo foi atribuído.
wo_tasks_execution_types_descriptionTextoDescrição do tipo de execução. Retorna null se nenhum tipo foi atribuído ou se a empresa não tem a categorização de tempos ativada.
noteTextoNota do registro de execução. Retorna null se nenhuma nota foi inserida.
nameTextoNome da pessoa que registrou o tempo
id_accountInteiroId da conta que registrou a execução da tarefa
id_personnelInteiroId do recurso humano (em caso que a conta esteja vinculada a um recurso humano)
personnel_codeTextoCódigo do recurso humano (em caso que a conta esteja vinculada a um recurso humano)
third_party_idInteiroId do terceiro (em caso que a conta esteja vinculada a um terceiro)
third_party_codeTextoCódigo do terceiro (em caso que a conta esteja vinculada a um terceiro)
third_party_contact_nameTextoNome do contato do terceiro (em caso que a conta esteja vinculada a um terceiro)
execution_eventsArrayArray cronológico de eventos do bloco de execução. Ver estrutura na tabela a seguir.

Estrutura de cada evento em execution_events:

ParâmetroTipoDescrição
idInteiroID do evento de execução
action_typeInteiroTipo de ação: 0 = PAUSED, 1 = IN_PROGRESS
action_type_descriptionTextoDescrição textual do tipo: "PAUSED" ou "IN_PROGRESS"
id_wo_tasks_execution_typesInteiroID do tipo de execução atribuído ao evento; null se não aplicável
paused_reason_descriptionTextoDescrição do motivo de pausa; null se não aplicável
initial_dateTextoData e hora de início do evento (UTC-0)
final_dateTextoData e hora de fim do evento (UTC-0)
noteTextoNota do evento; null se não inserida
duration_secondsInteiroDuração do evento em segundos

Exemplo:

Requisição: (GET)https://app.fracttal.com/api/wo_execution_times/3259375

{
    "success": true,
    "message": "200",
    "data": [
        {
            "id": 8271217,
            "id_company": 1190,
            "id_work_order_task": 13951616,
            "initial_date": "2023-03-27T16:43:14.296123+00:00",
            "final_date": "2023-03-27T16:48:32.809057+00:00",
            "id_wo_tasks_execution_types": 3,
            "wo_tasks_execution_types_description": "Busca de material",
            "note": "Nota do registro",
            "id_accounts_log": 58113,
            "id_account": 3,
            "name": "JOÃO SILVA",
            "id_personnel": 1539,
            "personnel_code": "RH-001",
            "third_party_id": null,
            "third_party_code": null,
            "third_party_contact_name": null,
            "execution_events": [
                {
                    "id": 100203,
                    "action_type": 1,
                    "action_type_description": "IN_PROGRESS",
                    "id_wo_tasks_execution_types": null,
                    "paused_reason_description": null,
                    "initial_date": "2023-03-27T16:46:30.000000+00:00",
                    "final_date": "2023-03-27T16:48:32.809057+00:00",
                    "note": null,
                    "duration_seconds": 122
                },
                {
                    "id": 100197,
                    "action_type": 0,
                    "action_type_description": "PAUSED",
                    "id_wo_tasks_execution_types": 3,
                    "paused_reason_description": "Busca de material",
                    "initial_date": "2023-03-27T16:45:00.000000+00:00",
                    "final_date": "2023-03-27T16:46:30.000000+00:00",
                    "note": "Falta de insumos",
                    "duration_seconds": 90
                },
                {
                    "id": 100184,
                    "action_type": 1,
                    "action_type_description": "IN_PROGRESS",
                    "id_wo_tasks_execution_types": null,
                    "paused_reason_description": null,
                    "initial_date": "2023-03-27T16:43:14.296123+00:00",
                    "final_date": "2023-03-27T16:45:00.000000+00:00",
                    "note": null,
                    "duration_seconds": 106
                }
            ]
        }
    ],
    "total": 1
}
Language
LoadingLoading…