Cancelar inscrição em uma promoção
DELETE/seller/v1/promotions/:promotion_id/subscriptions
Cancela a inscrição do seller em uma promoção específica.
Escopo da Operação
Remove o vínculo do seller com a promoção, suspendendo a aplicação dos descontos e regras da campanha para os SKUs vinculados.
Regras de Negócio Comerciais
IMPACTO IMEDIATO
Ao cancelar a inscrição, todos os SKUs associados perdem o benefício da promoção imediatamente e retornam ao preço regular de venda ou às regras de precificação padrão.
- Regra de Cancelamento: O cancelamento pode ser restrito ou indisponível caso a promoção já esteja em andamento ou dependendo das políticas comerciais específicas da campanha.
Motivo do cancelamento (opcional)
O body é opcional. Quando informado, registra o motivo pelo qual o seller está saindo da promoção:
{"reason": {"code": "low_margin"}}
reason.code(opcional, até 50 caracteres): código do motivo. Os códigos aceitos são definidos pelo canal; os códigos disponíveis são:
code | Descrição registrada |
|---|---|
low_margin | Margem insuficiente |
out_of_stock | Sem estoque |
price_conflict | Conflito com política de preço |
not_interested | Não tem interesse na promoção |
wrong_products | Produtos elegíveis não condizem com o catálogo |
other | Texto enviado em reason.description (obrigatório) |
reason.description(opcional, até 500 caracteres): texto livre do motivo. Só é registrado quando ocodeforotherou não for informado; para os demais códigos, é registrada a descrição da tabela acima.- Motivo inválido: um
codenão aceito pelo canal, ouothersemreason.description, retorna400 Bad Requeste a inscrição não é cancelada.
Request
Responses
- 204
- 400
- 403
- 404
- 422
- 500
Sucesso sem conteúdo
Requisição inválida
- Esta operação não é permitida pelas regras da promoção.
- Não é possível realizar esta operação para uma promoção já finalizada.
- O código de motivo 'not_a_valid_code' não é válido para este canal.
- O código de motivo 'other' exige uma descrição.
Proibido
- O seller '%{id_tenant}', de contexto '%{id_channel}', não foi encontrado ou está inativo no sistema.
Não encontrado
- Promoção não encontrada.
Entidade não processável
- Não é possível realizar esta operação pois a promoção não está publicada.
- Não é possível realizar esta operação pois a promoção está suspensa.
- Não é possível realizar esta operação pois a promoção não terminou de ser editada.
Erro interno do servidor
- Internal server error