Referência da API · Prioridade de SKU

Definir Prioridade de Produto

Método: POST
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

Define o nível de prioridade de um produto nas buscas da sua loja. Cada produto tem uma prioridade por loja: para mudar o nível de um produto que já tem prioridade, use Atualizar Prioridade de Produto.

Corpo da Requisição (JSON)

Campo	Tipo	Obrigatório	Descrição
`priorityLevel`	integer	Sim	Nível de prioridade, de 1 a 5. Fora dessa faixa a requisição é recusada.
`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 · 201

O registro criado. O código é 201 Created, não 200.

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.
400	O produto já tem prioridade nesta loja: `{"status":"BAD_REQUEST","message":"Já existe um registro de prioridade para o sku informado"}`. Use a atualização.
404	Produto não encontrado, ou nenhuma identificação enviada: `{"status":"NOT_FOUND","message":"Sku não encontrado"}`.
401	Token ausente, malformado ou expirado.

Exemplo de requisição

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

Respostas de exemplo

201Sucesso: prioridade definida

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