Editar plano de ação - SULTS Developers

PUT

api

checklist

action-plan

edit

cURL

curl --request PUT \
  --url https://api.sults.com.br/api/v2/checklist/action-plan/edit \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 119,
  "actionUserId": 55,
  "what": "Trocar a vedação e o termostato da câmara fria",
  "justification": "A vedação nova não resolveu a variação de temperatura",
  "why": "Manter a câmara fria dentro do limite de temperatura",
  "whenStartDate": "2026-11-06",
  "whenDueDate": "2026-11-27",
  "how": "Substituir o termostato com a assistência técnica do fornecedor",
  "howMuch": 780.5,
  "whoUserId": 55,
  "whoName": "Assistência técnica Frio Sul",
  "note": "Prazo estendido a pedido da unidade"
}'

import requests

url = "https://api.sults.com.br/api/v2/checklist/action-plan/edit"

payload = {
    "id": 119,
    "actionUserId": 55,
    "what": "Trocar a vedação e o termostato da câmara fria",
    "justification": "A vedação nova não resolveu a variação de temperatura",
    "why": "Manter a câmara fria dentro do limite de temperatura",
    "whenStartDate": "2026-11-06",
    "whenDueDate": "2026-11-27",
    "how": "Substituir o termostato com a assistência técnica do fornecedor",
    "howMuch": 780.5,
    "whoUserId": 55,
    "whoName": "Assistência técnica Frio Sul",
    "note": "Prazo estendido a pedido da unidade"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json",
}

resposta = requests.put(url, json=payload, headers=headers)

print(resposta.status_code)
print(resposta.text)

const resposta = await fetch("https://api.sults.com.br/api/v2/checklist/action-plan/edit", {
  method: "PUT",
  headers: {
    Authorization: "<api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "id": 119,
    "actionUserId": 55,
    "what": "Trocar a vedação e o termostato da câmara fria",
    "justification": "A vedação nova não resolveu a variação de temperatura",
    "why": "Manter a câmara fria dentro do limite de temperatura",
    "whenStartDate": "2026-11-06",
    "whenDueDate": "2026-11-27",
    "how": "Substituir o termostato com a assistência técnica do fornecedor",
    "howMuch": 780.5,
    "whoUserId": 55,
    "whoName": "Assistência técnica Frio Sul",
    "note": "Prazo estendido a pedido da unidade"
  }),
});

console.log(resposta.status, await resposta.text());

<?php
$corpo = <<<'JSON'
{
  "id": 119,
  "actionUserId": 55,
  "what": "Trocar a vedação e o termostato da câmara fria",
  "justification": "A vedação nova não resolveu a variação de temperatura",
  "why": "Manter a câmara fria dentro do limite de temperatura",
  "whenStartDate": "2026-11-06",
  "whenDueDate": "2026-11-27",
  "how": "Substituir o termostato com a assistência técnica do fornecedor",
  "howMuch": 780.5,
  "whoUserId": 55,
  "whoName": "Assistência técnica Frio Sul",
  "note": "Prazo estendido a pedido da unidade"
}
JSON;

$ch = curl_init("https://api.sults.com.br/api/v2/checklist/action-plan/edit");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $corpo);
$resposta = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $status . PHP_EOL . $resposta . PHP_EOL;

using System.Net.Http;
using System.Text;

var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "<api-key>");

var corpo = """
    {
      "id": 119,
      "actionUserId": 55,
      "what": "Trocar a vedação e o termostato da câmara fria",
      "justification": "A vedação nova não resolveu a variação de temperatura",
      "why": "Manter a câmara fria dentro do limite de temperatura",
      "whenStartDate": "2026-11-06",
      "whenDueDate": "2026-11-27",
      "how": "Substituir o termostato com a assistência técnica do fornecedor",
      "howMuch": 780.5,
      "whoUserId": 55,
      "whoName": "Assistência técnica Frio Sul",
      "note": "Prazo estendido a pedido da unidade"
    }
    """;

var resposta = await http.PutAsync(
    "https://api.sults.com.br/api/v2/checklist/action-plan/edit",
    new StringContent(corpo, Encoding.UTF8, "application/json"));

Console.WriteLine((int)resposta.StatusCode);
Console.WriteLine(await resposta.Content.ReadAsStringAsync());

No body

{
  "error": "The 'actionUserId' field cannot be null or empty.",
  "dateTime": "2026-11-03T14:20:00Z"
}

{
  "error": "Acesso não autorizado."
}

{
  "error": "Unauthorized",
  "dateTime": "2026-11-03T14:20:00Z"
}

{
  "error": "'assessmentId' is required.",
  "dateTime": "2026-11-03T14:20:00Z"
}

<string>

{
  "error": "Internal Server Error",
  "dateTime": "2026-11-03T14:20:00Z"
}

Authorizations

Authorization

string

header

required

Token gerado na Gestão de Tokens v2 do SULTS. Deve ser enviado no cabeçalho Authorization de todas as requisições.

Body

application/json

Campos do plano de ação a alterar. Só os campos enviados mudam; null é tratado como ausente, então um campo não pode ser limpo com null.

integer

required

Id do plano de ação.

Example:

119

actionUserId

integer

required

Id do usuário que edita o plano.

Example:

55

what

string

O que será feito. Opcional.

Example:

"Trocar a vedação da câmara fria"

justification

string

Justificativa do plano de ação. Opcional.

Example:

"Temperatura acima do limite na inspeção"

why

string

Por que será feito. Opcional.

Example:

"Evitar perda de produtos refrigerados"

whenStartDate

string<date>

Data de início. Formato exato yyyy-MM-dd. Opcional.

Example:

"2026-11-05"

whenDueDate

string<date>

Prazo. Formato exato yyyy-MM-dd. Opcional.

Example:

"2026-11-20"

how

string

Como será feito. Opcional.

Example:

"Acionar a assistência técnica do fornecedor"

howMuch

number

Quanto custará. Opcional. Até 2 casas decimais.

Example:

450.9

whoUserId

integer

Id do usuário que fará o plano. Quando enviado, não pode ser null nem vazio.

Example:

55

whoName

string

Quem fará, como texto livre.

Example:

"Equipe de manutenção"

note

string

Observação. Opcional.

Example:

"Agendar fora do horário de pico"

Response

Plano de ação alterado, sem corpo adicional.

A resposta não tem corpo.

cURL

curl --request PUT \
  --url https://api.sults.com.br/api/v2/checklist/action-plan/edit \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 119,
  "actionUserId": 55,
  "what": "Trocar a vedação e o termostato da câmara fria",
  "justification": "A vedação nova não resolveu a variação de temperatura",
  "why": "Manter a câmara fria dentro do limite de temperatura",
  "whenStartDate": "2026-11-06",
  "whenDueDate": "2026-11-27",
  "how": "Substituir o termostato com a assistência técnica do fornecedor",
  "howMuch": 780.5,
  "whoUserId": 55,
  "whoName": "Assistência técnica Frio Sul",
  "note": "Prazo estendido a pedido da unidade"
}'

import requests

url = "https://api.sults.com.br/api/v2/checklist/action-plan/edit"

payload = {
    "id": 119,
    "actionUserId": 55,
    "what": "Trocar a vedação e o termostato da câmara fria",
    "justification": "A vedação nova não resolveu a variação de temperatura",
    "why": "Manter a câmara fria dentro do limite de temperatura",
    "whenStartDate": "2026-11-06",
    "whenDueDate": "2026-11-27",
    "how": "Substituir o termostato com a assistência técnica do fornecedor",
    "howMuch": 780.5,
    "whoUserId": 55,
    "whoName": "Assistência técnica Frio Sul",
    "note": "Prazo estendido a pedido da unidade"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json",
}

resposta = requests.put(url, json=payload, headers=headers)

print(resposta.status_code)
print(resposta.text)

const resposta = await fetch("https://api.sults.com.br/api/v2/checklist/action-plan/edit", {
  method: "PUT",
  headers: {
    Authorization: "<api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "id": 119,
    "actionUserId": 55,
    "what": "Trocar a vedação e o termostato da câmara fria",
    "justification": "A vedação nova não resolveu a variação de temperatura",
    "why": "Manter a câmara fria dentro do limite de temperatura",
    "whenStartDate": "2026-11-06",
    "whenDueDate": "2026-11-27",
    "how": "Substituir o termostato com a assistência técnica do fornecedor",
    "howMuch": 780.5,
    "whoUserId": 55,
    "whoName": "Assistência técnica Frio Sul",
    "note": "Prazo estendido a pedido da unidade"
  }),
});

console.log(resposta.status, await resposta.text());

<?php
$corpo = <<<'JSON'
{
  "id": 119,
  "actionUserId": 55,
  "what": "Trocar a vedação e o termostato da câmara fria",
  "justification": "A vedação nova não resolveu a variação de temperatura",
  "why": "Manter a câmara fria dentro do limite de temperatura",
  "whenStartDate": "2026-11-06",
  "whenDueDate": "2026-11-27",
  "how": "Substituir o termostato com a assistência técnica do fornecedor",
  "howMuch": 780.5,
  "whoUserId": 55,
  "whoName": "Assistência técnica Frio Sul",
  "note": "Prazo estendido a pedido da unidade"
}
JSON;

$ch = curl_init("https://api.sults.com.br/api/v2/checklist/action-plan/edit");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $corpo);
$resposta = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $status . PHP_EOL . $resposta . PHP_EOL;

using System.Net.Http;
using System.Text;

var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "<api-key>");

var corpo = """
    {
      "id": 119,
      "actionUserId": 55,
      "what": "Trocar a vedação e o termostato da câmara fria",
      "justification": "A vedação nova não resolveu a variação de temperatura",
      "why": "Manter a câmara fria dentro do limite de temperatura",
      "whenStartDate": "2026-11-06",
      "whenDueDate": "2026-11-27",
      "how": "Substituir o termostato com a assistência técnica do fornecedor",
      "howMuch": 780.5,
      "whoUserId": 55,
      "whoName": "Assistência técnica Frio Sul",
      "note": "Prazo estendido a pedido da unidade"
    }
    """;

var resposta = await http.PutAsync(
    "https://api.sults.com.br/api/v2/checklist/action-plan/edit",
    new StringContent(corpo, Encoding.UTF8, "application/json"));

Console.WriteLine((int)resposta.StatusCode);
Console.WriteLine(await resposta.Content.ReadAsStringAsync());

No body

{
  "error": "The 'actionUserId' field cannot be null or empty.",
  "dateTime": "2026-11-03T14:20:00Z"
}

{
  "error": "Acesso não autorizado."
}

{
  "error": "Unauthorized",
  "dateTime": "2026-11-03T14:20:00Z"
}

{
  "error": "'assessmentId' is required.",
  "dateTime": "2026-11-03T14:20:00Z"
}

<string>

{
  "error": "Internal Server Error",
  "dateTime": "2026-11-03T14:20:00Z"
}