API reference · SKU Priority

Update Product Priority

Method: PUT
Route: /searchSkuPriority
Base URL: https://ws.autorei.net
Token: Requires Bearer token

Opens this request in the public API documentation, the official source of the reference.

Description

Changes the priority level of a product that already has a priority in your store. The product is identified in the body, as in creation — not by the record id.

Request body (JSON)

Field	Type	Required	Description
`priorityLevel`	integer	Yes	New level, from 1 to 5.
`partCode`	string	Yes	Product code at the manufacturer. See How to identify the product.
`brand`	string	Yes	Product brand.
`composition`	string	Yes	Product composition.

How to identify the product

Form	Fields	Note
Product composition	`partCode` + `brand` + `composition`	All three together; none identifies the product alone. `composition` accepts `UNITARY`, `PAIR`, `KIT`, `WARRANTY` and `SET`, always in uppercase.

When all three are not provided, or when the product is not found, the response is 404 with Sku não encontrado.

Response · 200

The updated record, with a new lastUpdated and the same id.

Field	Type	Description
`id`	integer	Priority id. It is what you use to look up by id and to remove.
`priorityLevel`	integer	Configured level, from 1 to 5.
`sku.id`	integer	SKU id on CWS.
`store.id`	integer	Id of your store.
`dateCreated`	datetime	Creation, in UTC.
`lastUpdated`	datetime	Last change, in UTC.

Errors

Code	When
400	`priorityLevel` missing or outside the 1 to 5 range. The message cites the field and the rejected value.
404	Product not found: `{"status":"NOT_FOUND","message":"Sku não encontrado"}`.
404	The product exists but has no priority in this store. The body carries no detail — use Set Product Priority to create it.
401	Token missing, malformed or expired.

Example request

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"
}'

Example responses

200Success — level changed

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

Used in

Use casesB2B customer portal: the typical path through the API

GET Get Priority by ID /searchSkuPriority/:id
POST Get Priority by Product Code /searchSkuPriority/find
POST Set Product Priority /searchSkuPriority
DELETE Remove Product Priority /searchSkuPriority/:id

← See the group: SKU Priority

Generated from the public API collection, published on 2026-09-04: api-docs.cws.digital.