VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API atual/Referência completa/Regras de preço B2B

DELETEExcluir faixa de preço

Exclui uma faixa de preço por quantidade de um produto.

Uma faixa de preço (price tier) é um degrau da escada de preço de um produto: a partir de lower_limit unidades o preço unitário cai para um valor fixo (centavos) ou um percentual de desconto, para todos os clientes ou para um grupo. Esta rota remove uma faixa pelo id dela (UUID). O efeito é imediato: o preço calculado na vitrine e no carrinho deixa de usar o degrau. Exige o privilégio manage_catalog.

Excluir a faixa

DELETE/api/v1/admin/price-tiers/{id}Admin

Exclui uma faixa de preço por quantidade

Parâmetros de caminho

iduuidobrigatório
Id da faixa (campo id de cada faixa na leitura de faixas do produto).

Exemplo de requisição: excluir

bash
curl -X DELETE "$BASE_URL/api/v1/admin/price-tiers/5d8e2c47-1a9b-4f63-8c0d-7e4b2a6f9d15" \
  -H "Authorization: Bearer $TOKEN"

Resposta: excluir

200Faixa excluída
json
{
  "message": "price tier deleted"
}

Erros: excluir

StatusQuandoCorpo de exemplo
401Token ausente ou inválido.{"error":"authentication required"}
403Falta o privilégio manage_catalog.{"error":"insufficient privileges","required":"manage_catalog"}
404Não existe faixa com esse id.{"error":"price tier not found"}
500O id não é um UUID válido.{"error":"failed to delete price tier","detail":"..."}
Exclusão definitiva

A faixa é apagada de vez. Para trocar o valor de um degrau, é mais seguro reescrever as faixas do produto do que excluir e recriar uma a uma, para não deixar o produto sem escada de preço entre as duas chamadas.

Veja também

  • Regras de preço B2B: visão geral
  • Criar, alterar e excluir regra
Anterior
Criar, alterar e excluir regra de preço B2B
Próxima
Promoções do seller
Nesta página
  • Excluir a faixa
  • Exemplo de requisição: excluir
  • Resposta: excluir
  • Erros: excluir
  • Veja também