API reference · SKU Priority

Set Product Priority

Method: POST
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

Sets a product's priority level in your store's searches. Each product has one priority per store: to change the level of a product that already has a priority, use Update Product Priority.

Request Body (JSON)

Field	Type	Required	Description
`priorityLevel`	integer	Yes	Priority level, from 1 to 5. Outside that range the request is rejected.
`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 alone identifies. `composition` accepts `UNITARY`, `PAIR`, `KIT`, `WARRANTY` and `SET`, always in uppercase.

When the three do not come in full, or when the product is not found, the response is 404 with Sku não encontrado.

Response · 201

The created record. The code is 201 Created, not 200.

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

Errors

Code	When
400	`priorityLevel` missing or outside the range of 1 to 5. The message cites the field and the rejected value.
400	The product already has a priority in this store: `{"status":"BAD_REQUEST","message":"Já existe um registro de prioridade para o sku informado"}`. Use the update.
404	Product not found, or no identification sent: `{"status":"NOT_FOUND","message":"Sku não encontrado"}`.
401	Token missing, malformed, or expired.

Example request

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

Example responses

201Success — priority set

{
  "id": 20601,
  "dateCreated": "2026-09-04T13:20:11Z",
  "lastUpdated": "2026-09-04T13:20:11Z",
  "priorityLevel": 5,
  "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
PUT Update 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.