API Endpoints
Fracttal →

Consulta de Tarefas em OS's

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

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âmetrosTipoRequeridoDescrição
ot_statusTextoOpcionalStatus do OS.
1: Em processo,
2: Revisão,
3: Concluído,
4: Cancelado
code_assetTextoOpcionalCó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) (campo code)
sinceTextoOpcionalData 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.
untilTextoOpcionalData 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_dateTextoOpcionalTipo de data para fazer a consulta. Pode ser:

ValorDescrição
data_criaçãoData de criação da OT (Valor padrão)
data_manutençãoData de manutenção da tarefa
data_cal_manutençãoData calculada de manutenção da tarefa
initial_dateData de início da tarefa
final_dateData de término da tarefa
review_dateData de envio da OT para revisão
wo_final_dateData de conclusão da OT
.
code_locationTextoOpcionalCódigo de la ubicación. Ele está disponível aqui. (campo code)
id_work_order_taskInteiroOpcionalId da tarefa na ordem de serviço. Ele pode ser consultado nesse mesmo ponto de extremidade (campo id_work_order_tasks).
startInteiroOpcionalNú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.
limitInteiroOpcionalNú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âmetrosTipoDescrição
id_work_orderInteiroID da OS
wo_folioTextoFolio da OS
creation_dateTextoData de criação da OS
initial_dateTextoData inicial
durationInteiroDuração da ordem de serviço
id_works_ordes_taskInteiroID da tarefa
id_taskInteiroID_tarefa
id_itemInteiroID_item
id_status_work_orderInteiro1: OS em processo
2: OS em revisão
3: OS concluída
4: OS cancelada
final_dateTextoData de término da tarefa
completed_percentageTextoPorcentagem da ordem de serviço concluída
created_byTextoNome do gerador de ordens de serviço
signatureTextoAssinatura
personnel_descriptionTextoDescrição pessoal
personnel_path_imageTextoCaminho da imagem
codeTextoCódigo do ativo
items_log_descriptionTextoDescrição do ativo
doneTextoTrue (verdadeiro) se a tarefa já estiver concluída e False (falso) se a tarefa não estiver concluída.
descriptionTextoDescrição da tarefa
id_requestInteiroID da solicitação, se a tarefa for proveniente de uma solicitação
stop_assetsTextoTrue (verdadeiro) se o ativo estiver parado e False (falso) se o ativo NÃO estiver parado.
stop_assets_secInteiroTempo de desligamento do ativo (segundos)
tasks_log_task_type_mainTextoTipo de tarefa
parent_descriptionTextoLocalização do ativo
resources_hoursTextoSoma das horas de recursos humanos utilizados
trigger_descriptionTextoTipo de ativador
resources_inventoryTextoRecursos do tipo inventário na tarefa
resources_human_resourcesTextoRecursos humanos na Tarefa
resources_servicesTextoRecursos tipo serviços
cal_date_maintenanceTextoData estimada da tarefa
real_durationInteiroDuração real da tarefa
date_maintenanceTextoData de programação de tarefas
user_assignedTextoUsuário atribuído
noteTextoObservação da ordem de serviço
details_signatureTextoDetalhes da assinatura da ordem de serviço
responsible_path_signatureTextoCaminho do responsável da assinatura
validator_path_signatureTextoCaminho da assinatura do validador
first_date_taskTextoData de início da tarefa mais próxima da conclusão
costs_center_descriptionTextoCentro de custo de ativos
tasks_durationTextoDuração estimada da tarefa
total_cost_taskTextoCusto total da OS
requested_byTextoSolicitante de tarefa não programada
groups_descriptionTextoInformações sobre o “tipo” de ativo
groups_1_descriptionTextoClassificação 1 dos ativos
groups_2_descriptionTextoClassificação 2 dos ativos
task_noteTextoobservação da tarefa
id_parent_woInteiroID pai da OS
has_childrenTextoTrue se a ordem de serviço tiver ordens de serviço secundárias
real_stop_assets_secTextoTempo de inatividade real do ativo
wo_final_dateTextoData final da ordem de serviço
is_offlineTextoDesligado
tasks_log_types_descriptionTextoClassificação 1 da tarefa
tasks_log_types_2_descriptionTextoClassificação 2 da tarefa
code_create_byTextoCodigo criado por
event_dateTextoData do evento
ratingTextoQualificação para a OS
enable_budgetTextoDisponibilidade do orçamento
code_responsibleTextoCódigo da pessoa responsável pelo OS
id_parentInteiroID pai
id_failure_typeInteiroID tipo da falha
work_orders_status_custom_descriptionTextoMotivo do cancelamento
review_dateTextoData de análise
types_descriptionTextoTipo de falha
id_failure_causeInteiroID causa da falha
causes_descriptionTextoCausa da falha
id_failure_detection_methodInteiroID método de detenção da falha
detection_method_descriptionTextoMétodo de detecção de falhas
id_failure_severityInteiroID gravidade da falha
severiry_descriptionTextoSeveridade da falha
id_damage_typeInteiroID tipo
damages_types_descriptionTextoTipo de dano causado
caused_damageTextoCausa do dano causado
id_group_taskInteiroID grupo de tarefa
id_items_availabilityInteiroID Items disponívels
validated_by_descriptionTextoDescrição validada por
id_personnel_logInteiroID log pessoal
id_contacts_logInteiroID registro do contato
annotationsTextoAnotações
id_prioritiesInteiroID de prioridade da tarefa
priorities_descriptionTextoDescrição da prioridade da tarefa
id_personnelInteiroID do recurso humano
id_contactInteiroID do contato
id_companyInteiroID da empresa

Exemplo:

Requisição: (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": "Gisele Priscila Vignoli",
            "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
}

Conexão de teste

Language