Pular para o conteúdo principal

Criar promoção para o seller

POST 
/seller/v1/promotions

Cria uma promoção de autosserviço para o seller em um canal de vendas.

Escopo da Operação​

Este endpoint permite que o seller crie suas próprias campanhas promocionais, informando nome, descrição, período de vigência, canal, tipo de benefício, escopo de SKUs, benefícios e regras aplicáveis.

Tipos de Promoção Suportados​

  • percentage_discount — Desconto à Vista
  • absolute_discount — Preço Promocional
  • coupon_discount — Cupom de Desconto
  • fidelity_discount — Cliente Ouro

Regras de Negócio Comerciais​

  • Escopo da promoção: a promoção pode ser criada com scope = full_catalog (todo o catálogo do seller) ou scope = seller_choice (seleção de SKUs). Para absolute_discount, apenas seller_choice é permitido.
  • Benefícios: o campo benefits é obrigatório para todos os tipos, exceto absolute_discount. A estrutura aceita varia conforme o tipo informado em type.id.
  • Cupom de Desconto (coupon_discount): o código do cupom deve ter no máximo 11 dígitos e iniciar com os 4 primeiros dígitos do id do seller; informe em benefits.limit o limite total de cupons e o limite máximo de usos por CPF/CNPJ.
  • Meios de pagamento: para percentage_discount, os meios de pagamento do seller são consultados internamente — não envie payment_methods no corpo da requisição.

Regras de Configuração (rules)​

As regras abaixo podem ser informadas em rules para ativar comportamentos adicionais na promoção:

  • allow_disclosure — permite que o canal divulgue a promoção em ações como recuperação de carrinho abandonado. Aplicável a coupon_discount.
  • allow_limit_sku_sales — aplica limite de vendas por SKU na campanha. Aplicável a absolute_discount e fidelity_discount, e não é permitida quando a promoção é criada com scope = full_catalog (apenas seller_choice).

Request​

Responses​

Successful Response