Commerce Promotions
Manage promotions, coupons, and cart discounts.
How It Works
- •Create or update a promotion with rules and dates.
- •Activate or deactivate campaigns.
- •Create coupon codes and validate eligibility.
- •Apply promotions to carts and report savings.
Usage
- •CLI:
stateset-promotions ...orstateset "apply coupon CODE to cart" - •Writes require
--apply. - •MCP tools:
create_promotion,activate_promotion,create_coupon,validate_coupon,apply_cart_promotions.
Output
json
{"status":"active","promotion_id":"promo_123","coupon":"SAVE10"}
Present Results to User
- •Promotion status, dates, and trigger rules.
- •Coupon validation results and discount totals.
- •Any conflicts with existing promotions.
Troubleshooting
- •Coupon invalid: verify dates, usage limits, and cart eligibility.
- •Overlapping promotions: clarify precedence or deactivate one.
References
- •references/promotions-flow.md
- •/home/dom/stateset-icommerce/cli/.claude/agents/promotions.md