Atualizar dados de um SKU de uma promoção
PUT/seller/v1/promotions/:promotion_id/skus/:sku_id
Inclui ou atualiza um SKU específico em 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 inclua ou atualize 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
- Inclusão ou atualização como alteração pendente: a inclusão ou atualização não é efetivada de imediato — o SKU passa a ser retornado com
status = pendingno endpoint de consulta de SKUs, aguardando consolidação. Isso permite que o seller realize múltiplas inclusões ou atualizaçõ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_atpreenchido): após a inclusão ou atualização, o status da promoção continua ativo, porém a aplicação definitiva da alteração só ocorre após a confirmação viaPOST /promotions/{promotion_id}/apply. Enquanto não confirmada, o SKU permanece comstatus = pending. - Promoção em que o seller ainda não participa (
subscribed_atnulo): quando o seller ainda não aderiu à promoção, a inclusão ou atualização do SKU não exige confirmação adicional — a aplicação definitiva ocorre naturalmente no fluxo de adesão.
Request
Responses
- 200
- 400
- 403
- 404
- 409
- 422
- 500
Sucesso
Requisição inválida
- Erro de validação
Proibido
- O seller '%{id_tenant}', de contexto '%{id_channel}', não foi encontrado ou está inativo no sistema.
Não encontrado
- Promoção ou SKU não encontrado.
Conflito
- Erro de conflito
Entidade não processável
- Entidade não processável
Erro interno do servidor
- Internal server error