Referência da API · Prioridade de SKU

Atualizar Prioridade de Produto

Método: PUT
Rota: /searchSkuPriority
URL base: https://ws.autorei.net
Token: Exige token Bearer

Abre esta requisição na documentação pública da API, a fonte oficial da referência.

Descrição

Altera o nível de prioridade de um produto que já tem prioridade na sua loja. O produto é identificado no corpo, como na criação, não pelo id do registro.

Corpo da Requisição (JSON)

Campo	Tipo	Obrigatório	Descrição
`priorityLevel`	integer	Sim	Novo nível, de 1 a 5.
`partCode`	string	Sim	Código do produto no fabricante. Veja Como identificar o produto.
`brand`	string	Sim	Marca do produto.
`composition`	string	Sim	Composição do produto.

Como identificar o produto

Forma	Campos	Observação
Composição do produto	`partCode` + `brand` + `composition`	Os três juntos; nenhum sozinho identifica. `composition` aceita `UNITARY`, `PAIR`, `KIT`, `WARRANTY` e `SET`, sempre em maiúsculas.

Quando os três não vêm completos, ou quando o produto não é encontrado, a resposta é 404 com Sku não encontrado.

Resposta · 200

O registro atualizado, com lastUpdated novo e o mesmo id.

Campo	Tipo	Descrição
`id`	integer	Id da prioridade. É o que você usa para buscar por id e para remover.
`priorityLevel`	integer	Nível configurado, de 1 a 5.
`sku.id`	integer	Id do SKU na CWS.
`store.id`	integer	Id da sua loja.
`dateCreated`	datetime	Criação, em UTC.
`lastUpdated`	datetime	Última alteração, em UTC.

Erros

Código	Quando
400	`priorityLevel` ausente ou fora da faixa de 1 a 5. A mensagem cita o campo e o valor recusado.
404	Produto não encontrado: `{"status":"NOT_FOUND","message":"Sku não encontrado"}`.
404	O produto existe mas não tem prioridade nesta loja. O corpo não traz detalhe, use Definir Prioridade de Produto para criar.
401	Token ausente, malformado ou expirado.

Exemplo de requisição

curl --request PUT 'https://ws.autorei.net/searchSkuPriority' \
  --header 'Authorization: Bearer {{access_token}}' \
  --header 'Content-Type: application/json' \
  --data '{
  "priorityLevel": 3,
  "partCode": "FE-500101",
  "brand": "Fabricante Exemplo",
  "composition": "UNITARY"
}'

Respostas de exemplo

200Sucesso: nível alterado

{
  "id": 20601,
  "dateCreated": "2026-09-04T13:20:11Z",
  "lastUpdated": "2026-09-04T15:42:03Z",
  "priorityLevel": 3,
  "sku": {
    "id": 500101
  },
  "store": {
    "id": 4470
  }
}

Usado em

Casos de usoPortal B2B próprio: o caminho típico pela API

Endpoints relacionados

GET Buscar Prioridade por ID /searchSkuPriority/:id
POST Buscar Prioridade por Código do Produto /searchSkuPriority/find
POST Definir Prioridade de Produto /searchSkuPriority
DELETE Remover Prioridade de Produto /searchSkuPriority/:id

← Ver o grupo: Prioridade de SKU

Gerado a partir da coleção pública da API, publicada em 04/09/2026: api-docs.cws.digital.