Pricing, tax and promotions
This section explains deterministic money calculations and the live promotion form/selection rules.
Understand POS money calculations
Understand POS money calculationsFollow integer minor-unit storage for prices, discounts, tax, shipping and totals.
Open guide →GuideUnderstand the maximum supported money value
Understand the maximum supported money valueKnow the helper rejects amounts beyond 100 billion minor units.
Open guide →GuideUnderstand decimal-to-minor conversion
Understand decimal-to-minor conversionAvoid floating-point storage by converting user-entered money to integer minor units.
Open guide →GuideUnderstand product tax calculation
Understand product tax calculationApply the saved tax rate to the discounted line basis.
Open guide →GuideUnderstand shipping calculation
Understand shipping calculationAdd the configured flat shipping amount to online orders.
Open guide →GuideUnderstand rounding behaviour
Understand rounding behaviourKnow where minor-unit rounding is captured in the order.
Open guide →GuideCreate an automatic promotion
Create an automatic promotionLeave coupon code blank so qualifying baskets can receive the rule automatically.
Open guide →GuideCreate a coupon promotion
Create a coupon promotionSet a tenant-unique coupon code customers can enter.
Open guide →GuideCreate a percentage promotion
Create a percentage promotionSet a valid percentage value.
Open guide →GuideCreate a fixed-amount promotion
Create a fixed-amount promotionSet a valid fixed discount in the store currency.
Open guide →GuideSet the promotion minimum line value
Set the promotion minimum line valueRequire each candidate line to meet the configured threshold.
Open guide →GuideScope a promotion to all products
Scope a promotion to all productsLeave both product and category scopes at All products.
Open guide →GuideScope a promotion to one category
Scope a promotion to one categorySelect a tenant category.
Open guide →GuideScope a promotion to one product
Scope a promotion to one productSelect a tenant product; product scope is more specific.
Open guide →GuideSet promotion start and end dates
Set promotion start and end datesUse a valid active date range.
Open guide →GuideSet a promotion usage limit
Set a promotion usage limitUse zero for unlimited or a non-negative limit.
Open guide →GuideActivate or disable a promotion
Activate or disable a promotionControl eligibility without deleting history.
Open guide →GuideUnderstand one best promotion per line
Understand one best promotion per lineKnow the calculator compares eligible discounts and selects the highest one.
Open guide →GuideUnderstand promotion non-stacking
Understand promotion non-stackingDo not expect multiple discounts on the same line in version 1.0.0.
Open guide →GuideUnderstand promotion usage counting
Understand promotion usage countingKnow one use is recorded per applied promotion per order.
Open guide →GuideTroubleshoot a duplicate coupon code
Troubleshoot a duplicate coupon codeChoose a tenant-unique code.
Open guide →GuideTroubleshoot an invalid promotion value
Troubleshoot an invalid promotion valueCorrect type-specific percent/fixed values.
Open guide →GuideTroubleshoot an invalid promotion scope
Troubleshoot an invalid promotion scopeSelect a product/category belonging to the current tenant.
Open guide →GuideTroubleshoot an unavailable promotion at checkout
Troubleshoot an unavailable promotion at checkoutRefresh the basket after status, date, limit or stock changes.
Open guide →GuideVerify promotion totals on an order
Verify promotion totals on an orderCompare line snapshots, discount, tax and total minor values.
Open guide →