Editar cadastro do produto na API v1 do SULTS

PUT

api

comercial

produto

{produtoId}

Editar cadastro do produto

curl --request PUT \
  --url https://api.sults.com.br/api/v1/comercial/produto/{produtoId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ativo": true,
  "nome": "Pão de queijo congelado 1 kg",
  "publicado": "2026-11-01T12:00:00Z",
  "categoriaId": 5,
  "fornecedorId": 5,
  "codigoBarras": 7891234567890,
  "codigoExterno": "ERP-4471",
  "descricaoCurta": "Café torrado e moído, pacote de 500 g",
  "descricaoHtml": "<p>Café torrado e moído, pacote de 500 g.</p>"
}
'

import requests

url = "https://api.sults.com.br/api/v1/comercial/produto/{produtoId}"

payload = {
    "ativo": True,
    "nome": "Pão de queijo congelado 1 kg",
    "publicado": "2026-11-01T12:00:00Z",
    "categoriaId": 5,
    "fornecedorId": 5,
    "codigoBarras": 7891234567890,
    "codigoExterno": "ERP-4471",
    "descricaoCurta": "Café torrado e moído, pacote de 500 g",
    "descricaoHtml": "<p>Café torrado e moído, pacote de 500 g.</p>"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    ativo: true,
    nome: 'Pão de queijo congelado 1 kg',
    publicado: '2026-11-01T12:00:00Z',
    categoriaId: 5,
    fornecedorId: 5,
    codigoBarras: 7891234567890,
    codigoExterno: 'ERP-4471',
    descricaoCurta: 'Café torrado e moído, pacote de 500 g',
    descricaoHtml: '<p>Café torrado e moído, pacote de 500 g.</p>'
  })
};

fetch('https://api.sults.com.br/api/v1/comercial/produto/{produtoId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sults.com.br/api/v1/comercial/produto/{produtoId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'ativo' => true,
    'nome' => 'Pão de queijo congelado 1 kg',
    'publicado' => '2026-11-01T12:00:00Z',
    'categoriaId' => 5,
    'fornecedorId' => 5,
    'codigoBarras' => 7891234567890,
    'codigoExterno' => 'ERP-4471',
    'descricaoCurta' => 'Café torrado e moído, pacote de 500 g',
    'descricaoHtml' => '<p>Café torrado e moído, pacote de 500 g.</p>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

using RestSharp;


var options = new RestClientOptions("https://api.sults.com.br/api/v1/comercial/produto/{produtoId}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
request.AddJsonBody("{\n  \"ativo\": true,\n  \"nome\": \"Pão de queijo congelado 1 kg\",\n  \"publicado\": \"2026-11-01T12:00:00Z\",\n  \"categoriaId\": 5,\n  \"fornecedorId\": 5,\n  \"codigoBarras\": 7891234567890,\n  \"codigoExterno\": \"ERP-4471\",\n  \"descricaoCurta\": \"Café torrado e moído, pacote de 500 g\",\n  \"descricaoHtml\": \"<p>Café torrado e moído, pacote de 500 g.</p>\"\n}", false);
var response = await client.PutAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "error": "Campo responsavel não pode ser vazio ou nulo."
}

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

{
  "error": "Campo responsavel não pode ser vazio ou nulo."
}

<string>

{
  "error": "Campo responsavel não pode ser vazio ou nulo."
}

Authorizations

Authorization

string

header

required

Token gerado através do sistema do SULTS. Deve ser enviado no cabeçalho Authorization de todas as requisições.

Path Parameters

produtoId

integer

required

Id do produto

Body

application/json

ativo

boolean

true: produto ativo. false: produto inativo.

Example:

true

nome

string

Nome do produto

Example:

"Pão de queijo congelado 1 kg"

publicado

string<date-time>

Data em que o produto estará disponível para compra (UTC ISO 8601)

Example:

"2026-11-01T12:00:00Z"

categoriaId

integer

Identificador da categoria do novo produto

Example:

5

fornecedorId

integer

Identificador do fornecedor do novo produto

Example:

5

codigoBarras

integer

Código de barras do produto

Example:

7891234567890

codigoExterno

string

Código externo do produto. Faz referência ao código do produto cadastrado em um sistema externo ao SULTS.

Example:

"ERP-4471"

descricaoCurta

string

Descrição curta do produto

Example:

"Café torrado e moído, pacote de 500 g"

descricaoHtml

string

Descrição completa do produto em formato HTML

Example:

"<p>Café torrado e moído, pacote de 500 g.</p>"

Response

Operação concluída com sucesso (status 200, sem corpo). Em caso de erro, são retornados detalhes sobre o erro.

Editar cadastro do produto

curl --request PUT \
  --url https://api.sults.com.br/api/v1/comercial/produto/{produtoId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ativo": true,
  "nome": "Pão de queijo congelado 1 kg",
  "publicado": "2026-11-01T12:00:00Z",
  "categoriaId": 5,
  "fornecedorId": 5,
  "codigoBarras": 7891234567890,
  "codigoExterno": "ERP-4471",
  "descricaoCurta": "Café torrado e moído, pacote de 500 g",
  "descricaoHtml": "<p>Café torrado e moído, pacote de 500 g.</p>"
}
'

import requests

url = "https://api.sults.com.br/api/v1/comercial/produto/{produtoId}"

payload = {
    "ativo": True,
    "nome": "Pão de queijo congelado 1 kg",
    "publicado": "2026-11-01T12:00:00Z",
    "categoriaId": 5,
    "fornecedorId": 5,
    "codigoBarras": 7891234567890,
    "codigoExterno": "ERP-4471",
    "descricaoCurta": "Café torrado e moído, pacote de 500 g",
    "descricaoHtml": "<p>Café torrado e moído, pacote de 500 g.</p>"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    ativo: true,
    nome: 'Pão de queijo congelado 1 kg',
    publicado: '2026-11-01T12:00:00Z',
    categoriaId: 5,
    fornecedorId: 5,
    codigoBarras: 7891234567890,
    codigoExterno: 'ERP-4471',
    descricaoCurta: 'Café torrado e moído, pacote de 500 g',
    descricaoHtml: '<p>Café torrado e moído, pacote de 500 g.</p>'
  })
};

fetch('https://api.sults.com.br/api/v1/comercial/produto/{produtoId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sults.com.br/api/v1/comercial/produto/{produtoId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'ativo' => true,
    'nome' => 'Pão de queijo congelado 1 kg',
    'publicado' => '2026-11-01T12:00:00Z',
    'categoriaId' => 5,
    'fornecedorId' => 5,
    'codigoBarras' => 7891234567890,
    'codigoExterno' => 'ERP-4471',
    'descricaoCurta' => 'Café torrado e moído, pacote de 500 g',
    'descricaoHtml' => '<p>Café torrado e moído, pacote de 500 g.</p>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

using RestSharp;


var options = new RestClientOptions("https://api.sults.com.br/api/v1/comercial/produto/{produtoId}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
request.AddJsonBody("{\n  \"ativo\": true,\n  \"nome\": \"Pão de queijo congelado 1 kg\",\n  \"publicado\": \"2026-11-01T12:00:00Z\",\n  \"categoriaId\": 5,\n  \"fornecedorId\": 5,\n  \"codigoBarras\": 7891234567890,\n  \"codigoExterno\": \"ERP-4471\",\n  \"descricaoCurta\": \"Café torrado e moído, pacote de 500 g\",\n  \"descricaoHtml\": \"<p>Café torrado e moído, pacote de 500 g.</p>\"\n}", false);
var response = await client.PutAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "error": "Campo responsavel não pode ser vazio ou nulo."
}

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

{
  "error": "Campo responsavel não pode ser vazio ou nulo."
}

<string>

{
  "error": "Campo responsavel não pode ser vazio ou nulo."
}