Criar uma tarefa agendada por evento

post

https://app.fracttal.com/api/tasks_scheduled/

Com esta API, você pode criar uma tarefa planejada a partir de um evento configurado em um plano de manutenção ativo.

Este serviço web faz parte do add-on APIS AVANÇADAS.
Para obter as informações relacionadas ao disparador e à tarefa, consulte o serviço web Consultar planos de tarefas.

Parâmetros de entrada

Envie as informações abaixo no body da requisição.

Parâmetro	Tipo	Requerido	Descrição
`item_code`	Texto	Sim	Código do ativo ao qual será realizada a OT. O ativo deve ser do tipo 1, 2 ou 3. Pode ser consultado no campo `code`.
`account_code`	Texto	Sim	Código do recurso humano ou terceiro com conta de usuário no Fracttal, que será registrado como o criador da OT.
`tasks_triggers_id`	Inteiro	Sim	ID do ativador do tipo evento (tipo 4) associado ao plano e à tarefa. Pode ser consultado no campo `id`.
`id_group_task`	Inteiro	Sim	ID do plano de manutenção ao qual a tarefa pertence. O ativo deve estar vinculado a este plano. Pode ser consultado no campo `id`.
`id_task`	Inteiro	Sim	ID da tarefa configurada (`is_configured = TRUE`) da qual serão obtidas as informações para criar a OT. Pode ser consultado no campo `id`.
`date_maintenance`	Data	Opcional	Data em que a tarefa deve ser realizada. Por padrão, usa a data atual. Formato: `YYYY-MM-DDTHH:MM:SS-UTC`. Exemplo: `2026-12-01T08:00:00-05:00`.

Parâmetros de saída

Parâmetro	Tipo	Descrição
`id_task_todo`	Inteiro	ID da tarefa no módulo de tarefas pendentes.
`id_task`	Inteiro	ID da tarefa criada.
`id_item`	Inteiro	ID interno do ativo associado.
`date_maintenance`	Data	Data planejada de manutenção resultante.
`trigger_description`	Texto	Descrição do disparador. Formato: `EVENT$descricao_evento`.

Códigos de erro

Código HTTP	Mensagem	Causa
`401`	`Unauthorized access`	O campo `auth` é nulo ou inválido.
`403`	`Your company does not have the Add-on: API Advanced`	A empresa não tem habilitado o add-on APIS AVANÇADAS.
`404`	`item_code is required`	O campo `item_code` não foi enviado ou está vazio.
`404`	`account_code is required`	O campo `account_code` não foi enviado ou está vazio.
`404`	`tasks_triggers_id, id_group_task and id_task are required`	Um ou mais campos requeridos de identificação não foram enviados.
`404`	`Item does not exist`	O ativo com o `item_code` indicado não existe ou não é do tipo 1, 2 ou 3.
`404`	`Account with code [account_code] does not exist or does not have any account related`	O pessoal com esse código não existe ou não tem conta de usuário no Fracttal.
`404`	`User does not have a permission group assigned`	O usuário não tem um grupo de permissões atribuído.
`404`	`User does not have permission to add planned tasks`	O usuário não tem permissão `add` sobre tarefas planejadas: módulo 5, submódulo 3.
`404`	`Item is not linked to the maintenance plan`	O ativo não está vinculado ao `id_group_task` indicado.
`404`	`Event trigger does not exist or is not associated to the task`	O `tasks_triggers_id` não é do tipo evento (tipo 4) ou não está associado ao plano e à tarefa indicados.
`404`	`Task does not exist`	A tarefa com o `id_task` indicado não existe.
`404`	`Task is not configured yet`	A tarefa existe, mas ainda não está configurada (`is_configured ≠ TRUE`).
`409`	`A pending task already exists for this asset and task`	Já existe uma tarefa pendente ativa para este ativo e tarefa. Não são criadas duplicatas.

Exemplo

Requisição: (POST)https://app.fracttal.com/api_new/tasks_scheduled

{
    "item_code": "QFCP-001",
    "account_code": "25198772-2",
    "tasks_triggers_id": 27,
    "id_group_task": 1,
    "id_task": 86,
    "date_maintenance": "2026-12-01T08:00:00-05:00"
}

{
    "success": true,
    "message": "200",
    "data": {
        "id_task_todo": 1600093,
        "id_task": 264276,
        "id_item": 500,
        "date_maintenance": "2026-12-01T08:00:00-05:00",
        "trigger_description": "EVENT$COMPRESOR DAÑADO"
    },
    "total": 1
}

Body Params

item_code

string

required

Código do ativo ao qual será realizada a OT. O ativo deve ser do tipo 1, 2 ou 3. Pode ser consultado no campo code.

account_code

string

required

Código do recurso humano ou terceiro com conta de usuário no Fracttal, que será registrado como o criador da OT.

tasks_triggers_id

integer

required

ID do ativador do tipo evento (tipo 4) associado ao plano e à tarefa. Pode ser consultado no campo id.

id_group_task

integer

required

ID do plano de manutenção ao qual a tarefa pertence. O ativo deve estar vinculado a este plano. Pode ser consultado no campo id.

id_task

integer

required

ID da tarefa configurada (is_configured = TRUE) da qual serão obtidas as informações para criar a OT. Pode ser consultado no campo id.

date_maintenance

date-time

Data em que a tarefa deve ser realizada. Por padrão, usa a data atual. Formato: YYYY-MM-DDTHH:MM:SS-UTC. Exemplo: 2026-12-01T08:00:00-05:00.

Responses

401

Unauthorized access — o campo auth é nulo ou inválido.

403

Your company does not have the Add-on: API Advanced — a empresa não tem habilitado o add-on APIS AVANÇADAS.

404

Possíveis causas: item_code não enviado ou vazio; account_code não enviado ou vazio; tasks_triggers_id, id_group_task ou id_task não enviados; ativo inexistente ou fora dos tipos 1, 2 ou 3; conta inexistente ou sem usuário relacionado; usuário sem grupo de permissões; usuário sem permissão para adicionar tarefas planejadas; ativo não vinculado ao plano de manutenção; ativador de evento inexistente ou não associado à tarefa; tarefa inexistente; tarefa ainda não configurada.

409

A pending task already exists for this asset and task — já existe uma tarefa pendente ativa para este ativo e tarefa. Não são criadas duplicatas.

Language

Loading…

Response

Choose an example:

application/json