Pular para o conteúdo principal

Aplicar alterações pendentes de uma promoção

POST 
/seller/v1/promotions/:promotion_id/apply

Confirma e aplica todas as alterações pendentes de uma promoção do seller.

Escopo da Operação​

Este endpoint permite que o seller efetive, de forma explícita e atômica, todas as modificações pendentes de uma promoção — inclusões, edições ou remoções de SKUs — consolidando-as como definitivas.

Regras de Negócio Comerciais​

  • Promoção em que o seller já aderiu e possui SKUs com alterações pendentes: quando a promoção retorna subscribed_at preenchido (seller já participa) e existem SKUs com status = pending no endpoint de consulta de SKUs, o /apply processa as alterações, notifica o canal promocional e os SKUs são efetivados.
  • Promoção em que o seller já aderiu, sem alterações pendentes: quando subscribed_at está preenchido e não há SKUs com status = pending, a operação é idempotente — apenas reenfileira a sincronização/notificação quando necessário.
  • Promoção em que o seller ainda não aderiu: quando subscribed_at é null no endpoint de consulta de promoções, a confirmação via /apply exige adesão prévia, retornando erro 400 Bad Request.

Respostas​

  • 204 No Content: alterações aplicadas com sucesso (sem corpo de resposta).
  • 400 Bad Request: promoção sem adesão prévia do seller (subscribed_at nulo) ou erro de validação.
  • 404 Not Found: o promotion_id não pertence ao seller.
  • 422 Unprocessable Entity: a promoção está em um estado que impede a aplicação no momento (ex.: regra sendo reprocessada).

Request​

Responses​

Sucesso sem conteúdo