The POS and Sitoo Adapter is deprecated and will not be supported on the next generation platform Norce Commerce. Read about it here: Difference between Norce commerce and Norce Storm.
Norce [Storm] has extensive and flexible ways to set up promotions to be used on the web. The Sitoo POS system has more restricted promotions, called vouchers in Sitoo POS, and this document aims at pointing out what can and can not be done in Norce [Storm] and at the same time integrated with Sitoo POS.
A promotion in Norce is composed of two parts: at least one requirement and at least one effect, so that when the requirement or requirements are fulfilled the effect is applied.
Example: Provide the code “Discount” and get 10% off. In this case the requirement is set to having a coupon code with the wording “Discount”, and the effect is set to discount the basket total by 10%.
In Norce it is possible to exclude articles of type freight from totals calculation. This is not possible in Sitoo, so be aware that a percentage discount for a basket will also affect freight articles in Sitoo.
Any promotions created in Norce [Storm] that cannot be integrated with Sitoo will simply be ignored by the Sitoo adapter. Also note that any promotion with more than one requirement will be ignored by the integration.
This documentation will start from the Sitoo POS vouchers and show how the corresponding promotion must be set up in Norce by listing requirements and effects. For each voucher type the Sitoo POS API description and code for the voucher is provided in parentheses.
Sitoo provides three vouchers for order discount, one to discount the order by a percentage and one by an amount.
(OrderDiscountM, 100)
This voucher must have a specific code provided. Amounts are given including VAT.
- Requirement: Checkout code
- Effect: Discount basket. Set the discount amount in the amount box.
OrderDiscountX, 110
This voucher must have a specific code provided.
- Requirement: Checkout code
- Effect: Discount basket. Set the discount percentage in the percentage box.
OrderBuyForMGetDiscountN, 120
Amounts must be given including VAT.
- Requirement: Basket total above. Note that freight will be included in Sitoo.
- Effect: Discount basket. Set the discount amount in the amount box.
Sitoo provides five vouchers for product discounts. Common for all of these is that they require a selection of products that are affected by the voucher. In Norce these products must be the same for both the requirement and effect since there’s only one list connected to the voucher in Sitoo POS, i.e. you may not require product A to discount product B.
ProductDiscountM, 200
The product(s) must be listed in both the requirement and the effect, and the effect will be applied the number of times indicated by quantity. No value = unlimited.
- Requirement: Basket product(s). Quantity for requirement will be ignored.
- Effect: Discount products. Discount amount set by selecting “Fixed amount”.
If you add more than one line with different discounts every different discount will be a voucher of its own in Sitoo POS.
ProductDiscountX, 210
The product(s) must be listed in both the requirement and the effect, and the effect will be applied the number of times indicated by quantity. No value = unlimited.
- Requirement: Basket product(s). Quantity for requirement will be ignored.
- Effect: Discount products. Discount amount set by selecting “Percentage discount”. Discount may also be set generically for the entire promotion by using the Generic price rule for the promotion. Discount should then be set to “Use generic discount”.
If you add more than one line with different discounts every different discount will be a voucher of its own in Sitoo POS.
ProductBuyXForPriceM, 220
The product(s) must be listed in both the requirement.
- Requirement: Basket product(s). Quantity for requirement must be set.
- Effect: Discount products. Set the price rule to fixed price and the price to the total price divided by the number of products. Example: Buy 3 for 99 – set the fixed price of each product to 33.
ProductBuyXPayForY, 230
The product(s) must be listed in both the requirement and the effect and the general discount must be used.
- Requirement: Basket product(s). Quantity for requirement must be set.
- Effect: Discount products. Set the Generic price rule to “Percentage discount” and enter 100%. Set every product line to Discount “Use genereric discount” and quantity to the number of products that are supposed to be free. So in the case of “Take 3 pay for 2” the quantity for the effect should be 1, i.e. one free product.
ProductBuyXPayForYDiscountZRest
Not supported in Storm.
Sitoo provides one voucher for package discounts.
PackageBuyForPriceM, 300
Not currently supported by Storm.