Configuração de tabelas de preços

Uma tabela de preços é um registro de configuração da loja: ela tem nome, modo, posição e status. O cadastro não contém os preços dos produtos. Depois de criar a tabela, use o guia Gerenciamento de preços para gravar as faixas de cada SKU.

Antes de começar

A loja precisa ter a feature sales_force habilitada. As rotas aceitam token de integração sk_* com:

store_products_read para consultar settings e tabelas;
store_products_write para criar, alterar e excluir tabelas.

O sistema de tabelas também possui o estado price_lists_enabled. Ele pode ser consultado e alterado pela API. Desligá-lo preserva os registros e os preços já gravados; para voltar a operar preços por SKU, ligue-o novamente.

Ativar o sistema de tabelas

GET/api/seller/price-lists/settings PUT/api/seller/price-lists/settings

curl -X PUT 'https://api.unisupri.com/api/seller/price-lists/settings' \
  -H 'Authorization: Bearer {{INTEGRATION_TOKEN}}' \
  -H 'Content-Type: application/json' \
  -d '{"price_lists_enabled":true}'

O corpo recebe price_lists_enabled, obrigatório e booleano.

Cadastrar e consultar

GET/api/seller/price-lists POST/api/seller/price-lists

O corpo de criação é curto e não contém tiers:

curl -X POST 'https://api.unisupri.com/api/seller/price-lists' \
  -H 'Authorization: Bearer {{INTEGRATION_TOKEN}}' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Revenda","mode":"manual"}'

Campo	Regra
`name`	Obrigatório na criação, texto com até 120 caracteres.
`mode`	Obrigatório na criação: `manual` ou `auto`. Define como os preços do SKU serão informados depois.
`position`	Ordem de exibição. Inteiro ≥ 0, atribuído automaticamente na criação.
`is_active`	Status da tabela. Nasce `true`. Tabelas inativas não aparecem na operação de preços do SKU.

A resposta 201 traz o id da tabela. Guarde-o: ele será usado ao atualizar a tabela e ao gravar preços dos SKUs.

Alterar ou desativar

PUT/api/seller/price-lists/{id}DELETE/api/seller/price-lists/{id}

O PUT é parcial. Envie somente os campos que deseja alterar:

curl -X PUT 'https://api.unisupri.com/api/seller/price-lists/{{PRICE_LIST_ID}}' \
  -H 'Authorization: Bearer {{INTEGRATION_TOKEN}}' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Revenda Sul","is_active":true,"position":0}'

Para retirar uma tabela da operação sem perder os preços vinculados, prefira is_active: false. Excluir a tabela remove também, em cascata, os preços dos SKUs associados a ela.

Trocar mode de uma tabela que já possui preços é permitido, mas os preços devem ser gravados novamente de acordo com o novo modo. Consulte Gerenciamento de preços para o payload de cada SKU.

Próximo passo

Com a tabela criada e ativa, use Gerenciamento de preços para consultar e substituir as faixas de preço de cada SKU.