Pular para o conteúdo principal

Remover SKU de uma promoção

DELETE 
/seller/v1/promotions/:promotion_id/skus/:sku_id

Remove um SKU específico de uma promoção em que o seller participa ou que ainda não confirmou a participação.

Escopo da Operação​

Este endpoint permite que o seller remova um SKU vinculado a uma promoção da qual já participa ou antes de confirmar a participação, informando o promotion_id (UUID público da promoção) e o sku_id (código do SKU do seller).

Regras de Negócio Comerciais​

  • Remoção como alteração pendente: a remoção não é efetivada de imediato — o SKU passa a ser retornado com status = pending no endpoint de consulta de SKUs, aguardando consolidação. Isso permite que o seller realize múltiplas remoções em sequência, na mesma promoção, sem aguardar o processamento assíncrono entre uma chamada e outra.
  • Promoção em que o seller já participa (subscribed_at preenchido): após a remoção, o status da promoção continua ativo, porém a aplicação definitiva da remoção só ocorre após a confirmação via POST /promotions/{promotion_id}/apply. Enquanto não confirmada, o SKU permanece com status = pending.
  • Promoção em que o seller ainda não participa (subscribed_at nulo): quando o seller ainda não aderiu à promoção, a remoção do SKU não exige confirmação adicional — a aplicação definitiva ocorre naturalmente no fluxo de adesão.

Respostas​

  • 204 No Content: remoção aplicada com sucesso (sem corpo de resposta).
  • 404 Not Found: o promotion_id não pertence ao seller ou o sku_id não está vinculado à promoção informada.
  • 422 Unprocessable Entity: a promoção está em um estado que impede a remoção do SKU no momento (ex.: regra sendo reprocessada, promoção suspensa ou com import ativo).

Request​

Responses​

Sucesso sem conteúdo