Criar plano de ação - SULTS Developers

POST

api

checklist

action-plan

add

cURL

curl --request POST \
  --url https://api.sults.com.br/api/v2/checklist/action-plan/add \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "assessmentAnswerId": 1212,
  "createdByUserId": 108,
  "what": "Trocar a vedação da câmara fria",
  "justification": "Temperatura acima do limite na inspeção",
  "why": "Evitar perda de produtos refrigerados",
  "whenStartDate": "2026-11-05",
  "whenDueDate": "2026-11-20",
  "how": "Acionar a assistência técnica do fornecedor",
  "howMuch": 450.9,
  "whoUserId": 55,
  "whoName": "Assistência técnica Frio Sul",
  "note": "Agendar fora do horário de pico"
}'

import requests

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

payload = {
    "assessmentAnswerId": 1212,
    "createdByUserId": 108,
    "what": "Trocar a vedação da câmara fria",
    "justification": "Temperatura acima do limite na inspeção",
    "why": "Evitar perda de produtos refrigerados",
    "whenStartDate": "2026-11-05",
    "whenDueDate": "2026-11-20",
    "how": "Acionar a assistência técnica do fornecedor",
    "howMuch": 450.9,
    "whoUserId": 55,
    "whoName": "Assistência técnica Frio Sul",
    "note": "Agendar fora do horário de pico"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json",
}

resposta = requests.post(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/add", {
  method: "POST",
  headers: {
    Authorization: "<api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "assessmentAnswerId": 1212,
    "createdByUserId": 108,
    "what": "Trocar a vedação da câmara fria",
    "justification": "Temperatura acima do limite na inspeção",
    "why": "Evitar perda de produtos refrigerados",
    "whenStartDate": "2026-11-05",
    "whenDueDate": "2026-11-20",
    "how": "Acionar a assistência técnica do fornecedor",
    "howMuch": 450.9,
    "whoUserId": 55,
    "whoName": "Assistência técnica Frio Sul",
    "note": "Agendar fora do horário de pico"
  }),
});

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

<?php
$corpo = <<<'JSON'
{
  "assessmentAnswerId": 1212,
  "createdByUserId": 108,
  "what": "Trocar a vedação da câmara fria",
  "justification": "Temperatura acima do limite na inspeção",
  "why": "Evitar perda de produtos refrigerados",
  "whenStartDate": "2026-11-05",
  "whenDueDate": "2026-11-20",
  "how": "Acionar a assistência técnica do fornecedor",
  "howMuch": 450.9,
  "whoUserId": 55,
  "whoName": "Assistência técnica Frio Sul",
  "note": "Agendar fora do horário de pico"
}
JSON;

$ch = curl_init("https://api.sults.com.br/api/v2/checklist/action-plan/add");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
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 = """
    {
      "assessmentAnswerId": 1212,
      "createdByUserId": 108,
      "what": "Trocar a vedação da câmara fria",
      "justification": "Temperatura acima do limite na inspeção",
      "why": "Evitar perda de produtos refrigerados",
      "whenStartDate": "2026-11-05",
      "whenDueDate": "2026-11-20",
      "how": "Acionar a assistência técnica do fornecedor",
      "howMuch": 450.9,
      "whoUserId": 55,
      "whoName": "Assistência técnica Frio Sul",
      "note": "Agendar fora do horário de pico"
    }
    """;

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

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

{
  "id": 131
}

{
  "error": "At least one of the following fields must be provided: 'whoName' or 'whoUserId'.",
  "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

Plano de ação a criar. Informe whoUserId ou whoName (pelo menos um). Campo opcional enviado como null é tratado como ausente.

assessmentAnswerId

integer

required

Id da resposta de avaliação que gera o plano (o id de GET /api/v2/checklist/assessment/answer/list).

Example:

1212

createdByUserId

integer

required

Id do usuário que cria o plano.

Example:

108

what

string

required

O que será feito.

Example:

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

whenDueDate

string<date>

required

Prazo. Formato exato yyyy-MM-dd.

Example:

"2026-11-20"

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"

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 criado.

integer

Id do registro criado.

Example:

1

cURL

curl --request POST \
  --url https://api.sults.com.br/api/v2/checklist/action-plan/add \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "assessmentAnswerId": 1212,
  "createdByUserId": 108,
  "what": "Trocar a vedação da câmara fria",
  "justification": "Temperatura acima do limite na inspeção",
  "why": "Evitar perda de produtos refrigerados",
  "whenStartDate": "2026-11-05",
  "whenDueDate": "2026-11-20",
  "how": "Acionar a assistência técnica do fornecedor",
  "howMuch": 450.9,
  "whoUserId": 55,
  "whoName": "Assistência técnica Frio Sul",
  "note": "Agendar fora do horário de pico"
}'

import requests

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

payload = {
    "assessmentAnswerId": 1212,
    "createdByUserId": 108,
    "what": "Trocar a vedação da câmara fria",
    "justification": "Temperatura acima do limite na inspeção",
    "why": "Evitar perda de produtos refrigerados",
    "whenStartDate": "2026-11-05",
    "whenDueDate": "2026-11-20",
    "how": "Acionar a assistência técnica do fornecedor",
    "howMuch": 450.9,
    "whoUserId": 55,
    "whoName": "Assistência técnica Frio Sul",
    "note": "Agendar fora do horário de pico"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json",
}

resposta = requests.post(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/add", {
  method: "POST",
  headers: {
    Authorization: "<api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "assessmentAnswerId": 1212,
    "createdByUserId": 108,
    "what": "Trocar a vedação da câmara fria",
    "justification": "Temperatura acima do limite na inspeção",
    "why": "Evitar perda de produtos refrigerados",
    "whenStartDate": "2026-11-05",
    "whenDueDate": "2026-11-20",
    "how": "Acionar a assistência técnica do fornecedor",
    "howMuch": 450.9,
    "whoUserId": 55,
    "whoName": "Assistência técnica Frio Sul",
    "note": "Agendar fora do horário de pico"
  }),
});

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

<?php
$corpo = <<<'JSON'
{
  "assessmentAnswerId": 1212,
  "createdByUserId": 108,
  "what": "Trocar a vedação da câmara fria",
  "justification": "Temperatura acima do limite na inspeção",
  "why": "Evitar perda de produtos refrigerados",
  "whenStartDate": "2026-11-05",
  "whenDueDate": "2026-11-20",
  "how": "Acionar a assistência técnica do fornecedor",
  "howMuch": 450.9,
  "whoUserId": 55,
  "whoName": "Assistência técnica Frio Sul",
  "note": "Agendar fora do horário de pico"
}
JSON;

$ch = curl_init("https://api.sults.com.br/api/v2/checklist/action-plan/add");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
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 = """
    {
      "assessmentAnswerId": 1212,
      "createdByUserId": 108,
      "what": "Trocar a vedação da câmara fria",
      "justification": "Temperatura acima do limite na inspeção",
      "why": "Evitar perda de produtos refrigerados",
      "whenStartDate": "2026-11-05",
      "whenDueDate": "2026-11-20",
      "how": "Acionar a assistência técnica do fornecedor",
      "howMuch": 450.9,
      "whoUserId": 55,
      "whoName": "Assistência técnica Frio Sul",
      "note": "Agendar fora do horário de pico"
    }
    """;

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

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

{
  "id": 131
}

{
  "error": "At least one of the following fields must be provided: 'whoName' or 'whoUserId'.",
  "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"
}