DELETERemover faixa de preço
Remove uma faixa de preço por quantidade de um produto do seller.
Uma faixa de preço (em inglês, price tier) é um preço especial que vale a partir de uma quantidade: "de 10 unidades, R$ 45,00 cada" ou "de 50 unidades, 20% de desconto". É a forma de vender no atacado dentro da mesma loja. Cada faixa tem seu próprio id (UUID). Use esta rota para apagar uma faixa que não vale mais. A remoção é definitiva: não há desfazer e o registro some.
O seller só pode remover faixas de produtos dele: a plataforma descobre de qual produto é a faixa e confere o dono antes de apagar. Para conhecer o id de uma faixa, leia as faixas do produto pelas rotas de catálogo do seller.
Remover uma faixa
/api/v1/vendor/price-tiers/{id}SellerRemove uma faixa de preço por quantidade
Exige um privilégio de catálogo do seller (vendor_catalog, vendor_view_catalog ou vendor_manage_products, entre outros).
Parâmetros de caminho
iduuidobrigatórioExemplo de requisição
curl -X DELETE "$BASE_URL/api/v1/vendor/price-tiers/9c2b7e10-4f5a-4d61-8a3b-77e0c1d2f401" \
-H "Authorization: Bearer $TOKEN"Resposta
{ "message": "price tier deleted" }Erros
| Status | Quando | Corpo de exemplo |
|---|---|---|
| 401 | Token ausente ou inválido. | {"error":"missing authorization header"} |
| 403 | O token não é de um usuário seller, ou ele não tem privilégio de catálogo. | {"error":"insufficient vendor privileges","privilege_required_any":["vendor_catalog", "..."]} |
| 403 | O usuário não está ligado a nenhum seller. | {"error":"no vendor account associated with this user"} |
| 403 | A faixa é de um produto de outro seller (ou da loja). | {"error":"you do not have access to this price tier"} |
| 404 | A faixa não existe, ou o produto dela não existe mais. | {"error":"price tier not found"} |
| 500 | Falha ao ler a faixa ou o produto. Um id que não é UUID cai aqui. | {"error":"failed to resolve tier owner","detail":"..."} |