Excluir uma tarefa pendente não planejada

delete

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

Exclui uma tarefa pendente não planejada (trigger_description = 'NO_SCHEDULE_TASK') pelo seu id_task_todo, reutilizando a lógica de exclusão em cascata existente.

Add-on necessário
A empresa deve ter o add-on API Advanced habilitado. Sem ele, o endpoint retorna 403.

DELETE https://app.fracttal.com/api/tasks_nonscheduled

Autenticação
Este endpoint não possui objeto auth no body. A autenticação é apenas Authorization: Bearer <token>; o gateway resolve o id_company internamente.

Parâmetros de entrada — Obrigatórios

Enviados no body da requisição.

Parâmetro	Tipo	Obrigatório	Descrição
`id_task_todo`	inteiro	Sim	PK de `tasks.tasks_todo` (a ocorrência da tarefa, não o `id_task` da tarefa mestre).
`user_code`	texto	Sim	Código do funcionário com conta ativa e permissão `remove` sobre Tarefas Pendentes (módulo 5, submódulo 3).

Parâmetros de entrada — Opcionais

Nenhum.

Parâmetros de saída

Parâmetro	Tipo	Descrição
`success`	booleano	`true` se a exclusão foi bem-sucedida.
`message`	texto	`"200"` em sucesso; código/mensagem de erro caso contrário.
`total`	inteiro	Quantidade de registros excluídos (`1` em sucesso).
`data`	objeto	`{ id_task_todo, id_task, description }` da tarefa excluída (ou `{ ERROR: "..." }` em falha).

Erros

Código	Causa
`400`	`id_task_todo is required` — não foi enviado ou não é um inteiro válido.
`400`	`id_task_todo was not found` — não existe para essa empresa. Também ocorre ao tentar excluir novamente um id já excluído (comportamento idempotente).
`400`	`Only unscheduled tasks can be deleted` — o `trigger_description` é diferente de `NO_SCHEDULE_TASK`.
`400`	`TASK_NO_DELETE_BY_WO_PENDING` — a tarefa possui uma OT ativa com `id_status_work_order < 3`.
`400`	`user_code does not have permission to delete pending tasks`.
`401`	Token inválido ou ausente (`INVALID_TOKEN`).
`403`	A empresa não possui o add-on API Advanced habilitado.
`500`	Erro interno não tratado.

Idempotência
Tentar novamente o DELETE sobre um id_task_todo já excluído retorna 400 com "id_task_todo was not found" — o mesmo erro de um ID inexistente. Esse é o comportamento esperado, não uma falha.

Exemplo

Request body

{
  "id_task_todo": 48408311,
  "user_code": "RH-001"
}

Response `200`

{
  "success": true,
  "message": "200",
  "data": {
    "id_task_todo": 48408311,
    "id_task": 20456,
    "description": "TESTE ALEJANDRO DE ESTABILIDADE"
  },
  "total": "1"
}

Response — erro, tarefa planejada (`400`)

{
  "success": false,
  "message": "400",
  "data": { "ERROR": "Only unscheduled tasks can be deleted" },
  "total": 0
}

Response — nova tentativa sobre id já excluído (`400`, idempotência)

{
  "success": false,
  "message": "400",
  "data": { "ERROR": "id_task_todo was not found" },
  "total": 0
}

Response

200

Language

Loading…