Inscrever-se em uma promoção
POST/seller/v1/promotions/:promotion_id/subscriptions
Realiza a inscrição do seller em uma promoção específica, permitindo que seus SKUs elegíveis participem da campanha comercial.
Escopo da Operação
Este endpoint registra o consentimento e a participação do parceiro (seller) na promoção indicada pelo promotion_id.
Regras de Negócio Comerciais
ATENÇÃO: COPARTICIPAÇÃO FINANCEIRA
Ao se inscrever, o parceiro (seller) aceita automaticamente as taxas de comissão e as regras de coparticipação de descontos configuradas para a campanha.
- Inscrição Única: Um seller não pode se inscrever mais de uma vez na mesma promoção (retornará erro de conflito).
- Validação de Vigência: Não é possível se inscrever em promoções cujo período de adesão já tenha expirado.
Request
Responses
- 204
- 400
- 403
- 404
- 409
- 422
- 500
Sucesso sem conteúdo
Requisição inválida
- A quantidade total de cupons informada é inválida. O valor máximo permitido é '%{promotion_total_limit}'
- O canal '%{channel}' não está habilitado para ofertar mais desconto.
- Não foi possível entrar nessa promoção. Motivo: Promoção encerrada.
- Não foi possível entrar nessa promoção.
- A data atual não pode ultrapassar o período de adesão.
- Esta promoção possui skus sem preço definido.
- Esta promoção possui skus sem subsídio definido.
Proibido
- O seller '%{id_tenant}', de contexto '%{id_channel}', não foi encontrado ou está inativo no sistema.
Não encontrado
- Promoção '1234567890abcdef12345678' não encontrada para o seller com o id 'seller-123'
Conflito
- Este seller já está vinculado à promoção.
Entidade não processável
- Não foi possível lançar esta promoção. Motivo: Promoção possui importação em processamento.
- Promoção '%{id_promotion}' do canal '%{id_channel}' para o seller '%{id_seller}' possui importação em processamento.
- Não foi possível lançar esta promoção. Motivo: Existem sellers sem skus adicionados.
Erro interno do servidor
- Internal server error