Promoções

Crie, consulte, edite, ative e exclua promoções da sua loja pela Admin API — as mesmas promoções que o lojista gerencia no painel administrativo.

Uma promoção da Wake Commerce é formada por quatro blocos:

Bloco	Campo no payload	Pergunta que responde
Informações gerais	`generalInformation`	Como se chama, quando vale, qual a prioridade e se acumula com outras promoções.
Cupons	`couponInformation`	A promoção depende de cupom? De um código único ou de vários?
Condições (critérios)	`conditionGroups`	Quando o carrinho tem direito ao benefício? Ex.: subtotal acima de R$ 199, cliente de SP, primeira compra.
Descontos (ações)	`discounts`	Qual é o benefício? Ex.: 10% em uma categoria, frete grátis, brinde.

Opcionalmente, a promoção ainda pode ter regras adicionais por entidade (entityRules — ex.: “não aplicar em produtos remarcados”), parceiros (partners), selos (stamps) e textos de divulgação (disclosure).

Fluxo recomendado

Obtenha um token de acesso (veja Autenticação).
Consulte as estruturas da loja: GET /api/promotions/structure/conditions, …/structure/discounts e …/structure/rules. Elas dizem quais condições, operadores, descontos e argumentos estão disponíveis nesta loja.
Busque os IDs de catálogo que os argumentos exigem (categorias, produtos, marcas…) — veja Onde obter os IDs.
Monte o payload usando as receitas de condições e receitas de descontos e crie a promoção com POST /api/promotions.
Confira o resultado com GET /api/promotions/{promotionId}.

🚧
Sempre confirme o que foi salvo
Combinações de grupo, subgrupo e argumentos que não correspondem a nenhuma condição ou desconto conhecido são ignoradas silenciosamente: a promoção é salva sem elas e a resposta não traz erro. Condições e descontos sem arguments, e argumentos com values vazio, também são descartados. Depois de criar ou editar, consulte a promoção e verifique se todas as condições e descontos estão lá.