Promotions & Coupons¶

Vectis promotions let you create discount rules that apply automatically or via coupon codes. Promotions are evaluated during checkout and allocated per line item on the resulting order.

Discount Rules¶

Every promotion is a discount rule composed of two parts:

• Conditions — criteria that must be met for the rule to activate.
• Actions — the discount applied when conditions are satisfied.

Conditions¶

Conditions can be combined. Common condition types:

Actions¶

Coupon Codes vs Automatic Promotions¶

Coupon codes can have a usage limit (total redemptions) and a per-customer limit.

Stacking and Priority¶

When multiple promotions match a cart, stacking rules determine which apply:

• Exclusive — only this promotion applies; all others are ignored. Use for "best deal wins" scenarios.
• Stackable — combines with other stackable promotions.

Promotions are evaluated in priority order (lower number = higher priority). If an exclusive promotion matches, the system stops and applies only that one.

Cart Integration (GraphQL)¶

Storefront code applies and removes coupons with these mutations:

mutation {
  applyCoupon(cartId: "...", code: "SUMMER20") {
    cart {
      applied_coupons { code discount_amount }
      grand_total
    }
  }
}

mutation {
  removeCoupon(cartId: "...", code: "SUMMER20") {
    cart { grand_total }
  }
}

The cart.applied_coupons field shows all active coupon codes and their computed discount amounts. Automatic promotions appear in cart.applied_promotions.

Checkout Allocation¶

When checkout completes, each matching promotion writes allocations to individual order lines:

• Every line item records which promotions contributed and how much was discounted.
• The order's discount_total is the sum of all allocations.
• This per-line granularity supports accurate tax calculation (tax is computed on the discounted price).

Admin Panel¶

From Marketing → Promotions in the admin:

• Create / edit discount rules — set name, priority, date range, and exclusive/stackable flag.
• Configure conditions — add one or more condition types with their parameters.
• Configure actions — choose the discount type and amount.
• Manage coupon codes — generate single codes or bulk batches. Set usage limits.
• View performance — see how many times a promotion has been used and total discount given.