(POST) Criar uma ordem de serviço

Com esta API, você pode criar uma ordem de serviço:
  • Criando uma tarefa não programada, cujas informações são baixadas de uma tarefa por evento.
  • ou com as tarefas em que estão pendentes.

Esse serviço web faz parte do add-on APIS AVANÇADAS

Notas:

Para a criação de OSs com as tarefas que estão em tarefas pendentes, leve em consideração:

  • Para obter os IDs das tarefas pendentes que deseja levar a OS, se deve consultar a API https://ayuda.fracttal.com/articulos/get-consultar-tareas-pendientes/


Para a criação de OSs através da criação de uma tarefa não planejada lançada por evento, 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 ativador e à tarefa, é necessário consultar o serviço web https://ayuda.fracttal.com/articulos/get-consultar-informacion-detallada-de-planes-de-tareas/

EndPoint
https://app.fracttal.com/api/work_orders

Método POST

Parâmetros Entrada no Body para a criação de uma OS com tarefas desde Tarefas Pendentes:


Parâmetro Tipo de campo Requerido Descrição
type Número Sim Tipo de creação de OS, para este caso es 1
responsible_code Texto Sim Código do recurso humano que será o responsável da OS
account_code Text Sim Código da conta de usuário que se registrará como o criador da OS
tasks_todo Array de json Sim Array com a  informação das tarefas pendentes.

Cada json, deve conter o parâmetro tasks_todo_id que corresponde ao id da tarefa em tarefas pendentes

Parâmetros Entrada no Body para a criação de uma OS com uma tarefa não planejada lançada por evento

Parâmetro Tipo de campo Requerido Descrição
type Número Sim Tipo de criação de OS, para esse caso é 3
item_code Text Sim Código do ativo ao que se realizará a OS
responsible_code Text Sim Código do recurso humano que será o responsável da OS
account_code Text Sim Código da conta de usuario que se registrará como o criador da OS
requested_by Text Sim Solicitado por
id_task Número Sim Id da tarefa da qual se terá a informação para criar a OS
tasks_triggers_id Número Sim Id do evento
id_group_task Número Sim Id do plano de tarefas onde se encontra a tarefa da qual se terá a informação
task_descripcion Text Opcional Descrição da tarefa (Por padrão é o nome da tarefa do id_task)
task_type_main Text Opcional Tipo de tarefa (Por padrão é da tarefa do id_task)
task_type_description Text Opcional Classificação 1 de tarefa (Por padrão é da tarefa do id_task)
task_type_2_description Text Opcional Classificação 2 de tarefa (Por padrão é da tarefa do id_task)

Enviar os campos obrigatórios e os parâmetros com os valores adicionais que se deseja ingressar.

Parámetros de saída

Parâmetro Tipo de campo Descrição
wo_folio Texto Id da OS que foi criada
id_status_work_order Text Estado da OS:

1: Em andamento
2: En revisão
3: Finalizada
4: Cancelada
responsible Text Nome do responsável da OS
responsible_code Text Código do responsável da OS
date_created Data Data de creação da OS
created_by Texto Nome do usuário que se registrou como criador da OS

Exemplo tarefas a partir de tarefas pendentes:
Solicitação: (POST) https://app.fracttal.com/api/work_orders

Body

{
"type":1,
"responsible_code": "7809097-2",
"account_code": "7845123",
"tasks_todo":[
{
"tasks_todo_id":1600093
},
{
"tasks_todo_id":1087
}
]
}

Exemplo Resposta:

{
"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"
}

Exemplo criação de OSs a partir da criação de uma tarefa no planejada com informação de um evento:

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

Body

{
"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"
}

Exemplo Resposta:

{
"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
}