Criar uma ordem de serviço

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.

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.
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).
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
}