Criar uma ordem de serviço

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

Com essa API, você pode criar uma ordem de serviço das seguintes maneiras:

  • A partir de tarefas pendentes.
  • A partir de uma tarefa não planejada.
  • A partir de uma tarefa não planejada acionada por um evento.
  • A partir de uma solicitação de trabalho.

Esse serviço da Web faz parte do complemento APIS ADVANCED.

Notas: 1.

  1. para a criação de OS's com as tarefas que estão em tarefas pendentes, leve em consideração: Para obter os IDs das tarefas pendentes que você deseja levar para uma OS, você deve consultar a API de Consultar Tarefas Pendentes.

  2. Para a criação de OTs, criando-as a partir de uma tarefa não planejada, as seguintes opções estão disponíveis aqui:

    1. OS não planejada, por meio dessa opção, todas as informações da tarefa devem ser enviadas para o ponto de extremidade.
    2. OT não planejada iniciada por evento, por meio dessa opção a tarefa tomará como base todas as informações contidas no evento do plano de tarefa. Para isso, leve em consideração:
      O evento do qual os dados são obtidos não pode ter recursos associados.
      Para obter as informações relacionadas ao acionador e à tarefa, é necessário consultar o serviço da Web Consultar informações detalhadas de Planos de tarefas).
  3. Para a criação de OTs com base em uma solicitação de trabalho, a solicitação de trabalho deve estar ativa e não pode estar associada a outra OT. As solicitações de trabalho podem ser consultadas aqui

Parâmetros Entrada para a criação de uma OS com tarefas de Tarefas pendentes

As informações a seguir devem ser enviadas no corpo da solicitação.

Parâmetros

Tipo

Obrigatório

Descrição

type

Inteiro

Sim

Tipo de criação de ot, neste caso é 1

responsible_code

Texto

Opcional se forem enviadas informações de terceiros

Código do recurso humano que será responsável pela OS. ([Disponível aqui.]

third_party_code

Texto

É opcional se forem enviadas informações sobre recursos humanos.

Código do terceiro onde está localizado o contato que será responsável pela OS. Disponível aqui

third_party_contact

Texto

É opcional se forem enviadas informações sobre recursos humanos.

Nome da pessoa de contato que será responsável pela OS

account_code

Texto

Sim

Código da conta de usuário a ser registrada como o criador da OS

tasks_todo

Array de json

Sim

Array com informações sobre tarefas pendentes.

Cada json deve conter o parâmetro tasks_todo_id, que corresponde ao ID da tarefa nas tarefas a serem realizadas

Parâmetros de entrada para a criação de uma OS a partir de uma tarefa não programada

As seguintes informações devem ser enviadas no corpo da solicitação

Parâmetros

Tipo

Obrigatório

Descrição

type

Inteiro

Sim

Tipo de criação de ot, neste caso é 3

item_code

Texto

Sim

Esse é o código do ativo associado à OS. Pode consultar aqui

responsible_code

Texto

Sim

Código do recurso humano ou de terceiros associados à OS

account_code

Texto

Sim

Código da conta que executa a OS

requested_by

Texto

Sim

Solicitado por

task_descripcion

Texto

Sim

Descrição da tarefa, que não deve exceder 200 caracteres.

task_type_main

Texto

Sim

Tipo de tarefa

task_type_description

Texto

Opcional

Classificação 1 de tarefa

task_type_2_description

Texto

Opcional

Classificação 2 de tarefa

Parâmetros de entrada para a criação de uma OS a partir de uma tarefa não programada acionada por eventos.

As informações a seguir devem ser enviadas no corpo da solicitação.

Parâmetros

Tipo

Obrigatório

Descrição

type

Inteiro

Sim

Tipo de criação de ot, neste caso é 3

item_code

Texto

Sim

Código do ativo no qual a OS deve ser executada

responsible_code

Texto

Opcional se forem enviadas informações de terceiros

Código do recurso humano que será responsável pela OS

third_party_code

Texto

É opcional se forem enviadas informações sobre recursos humanos.

Código do terceiro onde está localizado o contato que será responsável pela OS.

third_party_contact

Texto

É opcional se forem enviadas informações sobre recursos humanos.

Nome da pessoa de contato que será responsável pela OS

account_code

Texto

Sim

Código da conta de usuário a ser registrada como o criador da OS

requested_by

Texto

Sim

Solicitado por

id_task

Inteiro

Sim

Id da tarefa da qual serão obtidas as informações para criar a OS.

tasks_triggers_id

Inteiro

Sim

ID do evento

id_group_task

Inteiro

Sim

Id da lista de tarefas onde está localizada a tarefa da qual as informações devem ser obtidas.

task_descripcion

Texto

Opcional

Descrição da tarefa (o padrão é o nome da tarefa de id_task), que não deve exceder 200 caracteres.

task_type_main

Texto

Opcional

Tipo de tarefa (o padrão é da tarefa id_task)

task_type_description

Texto

Opcional

Classificação 1 da tarefa (o padrão é da tarefa id_task)

task_type_2_description

Texto

Opcional

Classificação 2 da tarefa (o padrão é da tarefa id_task)

date_maintenance

Texto

Opcional

Data de programação da ordem de transferência. Formato: ‘YYYY-MM-DDTHH:MM:SS-UTC’ Ejemplo:’2016-07-12T20:00:00-03′.

note

Texto

Opcional

Nota da tarefa que está associada à OS


Parâmetros de entrada para a criação de uma OS a partir de uma solicitação de trabalho

As informações a seguir devem ser enviadas no corpo da solicitação.

Parâmetros

Tipo

Obrigatório

Descrição

type

Inteiro

Sim

Tipo de criação de OS, neste caso é 3

item_code

Texto

Sim

Esse é o código do ativo associado à OT. (Disponível aqui) (campo code)

responsible_code

Texto

Sim

Código do recurso humano ou de terceiros associados à OS

account_code

Texto

Sim

Código da conta que executa a OS

requested_by

Texto

Sim

Solicitado por

task_descripcion

Texto

Sim

Descrição da tarefa, que não deve exceder 200 caracteres.

task_type_main

Texto

Sim

Tipo de tarefa

id_request

Inteiro

Sim

Id da solicitação de serviço. (Disponível aqui.) (campo id_code)


Parâmetros de saída

Parâmetros

Tipo

Descrição

wo_folio

Texto

ID da OS

creation_date

Texto

Data de criação da OS

duration

Inteiro

Duração da ordem de serviço

id_works_ordes_task

Inteiro

ID da tarefa

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 final da tarefa

completed_percentage

Texto

Porcentagem da ordem de serviço concluída

created_by

Texto

Nome do gerador de ordens de serviço

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

Texto

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

cal_date_maintenance

Texto

Data calculada 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

Nota da ordem de serviço

details_signature

Texto

Detalhes da assinatura da ordem de serviço

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 entre os ativos

groups_2_description

Texto

Classificação 2 entre os ativos

has_children

Texto

True se a ordem de serviço tiver ordens de serviço filhas

real_stop_assets_sec

Texto

Tempo de inatividade real do ativo

wo_final_date

Texto

Data final da ordem de serviço

tasks_log_types_description

Texto

Classificação 1 da tarefa

tasks_log_types_2_description

Texto

Classificação 2 da tarefa

rating

Texto

Qualificação da OS

code_responsible

Texto

Código da pessoa responsável pelo OS

work_orders_status_custom_description

Texto

Motivo do cancelamento

types_description

Texto

Tipo de falha

causes_description

Texto

Causa da falha

detection_method_description

Texto

Método de detecção de falhas

severiry_description

Texto

Severidade da falha

damages_types_description

Texto

Tipo de danos causados

caused_damage

Texto

Causa do dano causado

id_priorities

Texto

ID de prioridade da tarefa

priorities_description

Texto

Descrição da prioridade da tarefa

Exemplo:

Tarefas de tarefas pendentes:

Solicitação: (POST) https://app.fracttal.com/api/work_orders**

{
    "type":1,
    "responsible_code": "7809097-2",
    "account_code": "7845123",   
    "tasks_todo":[
        {
            "tasks_todo_id":1600093
        },
        {
            "tasks_todo_id":1087
        }
    ]
}
{
    "success": true,
    "message": "200",
    "data": {
        "id": 1130348,
        "id_company": 69,
        "id_status_work_order": 1,
        "wo_folio": "OT-1731",
        "creation_date": "2021-07-27T14:43:38.330737+00:00",
        "duration": 1200,
        "id_assigned_user": null,
        "initial_date": null,
        "final_date": null,
        "completed_percentage": 0,
        "id_created_by": 40,
        "created_by": "Alejandra Arango",
        "signature": null,
        "note": null,
        "details_signature": null,
        "id_validated_by": null,
        "first_date_task": null,
        "id_personnel_log": 10073,
        "id_contacts_log": null,
        "id_parent": null,
        "is_offline": null,
        "id_account_offline": null,
        "code_created_by": "7845123",
        "rating": null,
        "enable_budget": false,
        "id_work_orders_status_custom": null,
        "review_date": null,
        "id_accounts_log_validated_by": null,
        "id_public": null,
        "statistics": null,
        "type_user": "HUMAN_RESOURCES",
        "id_responsible": 60,
        "id_account_responsible": null,
        "description": "OT-1731"
}

Criação de OS's a partir de uma tarefa não planejada

Solicitação: (POST) https://app.fracttal.com/api/work_orders**

{  
    "type": 2,
    "item_code": "EQM032",
    "responsible_code": "RH-002",
    "account_code": "RH-002",
    "requested_by": "Ruben Prieto",
    "task_descripcion": "Orden de trabajo de prueba",
    "task_type_main": "Correctiva"
}
{
    "success": true,
    "message": "200",
    "data": {
        "id_work_order": 11934394,
        "wo_folio": "OT-2420",
        "id_work_order_task": 20338615,
        "id_status_work_order": 1,
        "user_type": "HUMAN_RESOURCES",
        "responsible": "Pepito perez",
        "responsible_code": "RH-002",
        "date_created": "2023-11-10T20:44:59.479973+00:00",
        "created_by": "Pepito perez"
    },
    "total": 1
}

Criação de OTs a partir de uma tarefa não programada com informações de um evento:

Solicitação: (POST) https://app.fracttal.com/api/work_orders**

{
    "type": 3,
    "item_code": "118",
    "responsible_code": "32322",
    "account_code": "25198772-2",
    "requested_by": "Fracttal SPA",
    "id_task": 86,
    "task_descripcion": "Nueva tarea generada por API",
    "tasks_triggers_id": 27,
    "id_group_task": 1,
    "task_type_main": "Correctiva",
    "task_type_description": "MECÁNICA",
    "task_type_2_description": "REQUIERE PERMISO ALTURA"
}
{
    "success": true,
    "message": "200",
    "data": {
        "wo_folio": "OT-1694",
        "id_status_work_order": 1,
        "responsible": "FRACTTAL SPA",
        "responsible_code": "32322",
        "date_created": "2021-05-11T14:54:45.294203+00:00",
        "created_by": "Laura Marcela Peña Jaramillo"
    },
    "total": 1
}

Criação de OS's a partir de uma solicitação de trabalho:

Solicitação: (POST) https://app.fracttal.com/api/work_orders

{
    "type": 2,
    "item_code": "EQM032",
    "responsible_code": "RH-002",
    "account_code": "RH-002",
    "requested_by": "Ruben Prieto",
    "task_descripcion": "Orden de trabajo de prueba",
    "task_type_main": "Correctiva",
    "id_request": 1827
}
{
    "success": true,
    "message": "200",
    "data": {
        "id_work_order": 11934394,
        "wo_folio": "OT-2420",
        "id_work_order_task": 20338615,
        "id_status_work_order": 1,
        "user_type": "HUMAN_RESOURCES",
        "responsible": "Pepito perez",
        "responsible_code": "RH-002",
        "date_created": "2023-11-10T20:44:59.479973+00:00",
        "created_by": "Pepito perez"
    },
    "total": 1
}
Language