Voucher Documentation

[tommy.developer]

Hi there,
I am currently developing and migrating our e-commerce site from different platform into Aimeos,
but unfortunately, even I have been watched your youtube videos and read the documentation I still don't get the the details.

can I have a full documentation including all possible combinations of provider and decorator for creating a voucher ?
if not, then at least samples of possible combinations and it definitions.



kindly answer the following questions as it may seems confusing for me:
1. Why do I need to create a product/article before creating a voucher? and not creating a voucher directly?
2. How to create a product/article for the voucher?
3. How important the product sku to create a voucher?


4. What are the fixedrebate.productcode and fixedrebate.rebate mean?
5. Can I make another input like the fixedrebate.productcode and fixedrebate.rebate ? if yes, How and what? if not,then what is the use of + button?


6.Kindly elaborate the definitions and on the proper data that is being input for the following image.



7.refer to image above, is possible to do the all decorator combinations in just voucher?


i've been asking the above questions for the benefits or our end users as most of them are not capable of some technical stuff. and it would be a big for us as we have chosen to migrate from other platform to Aimeos.
that would be all for now, and thank you.

[aimeos]

can I have a full documentation including all possible combinations of provider and decorator for creating a voucher ?

The vouchers and decorators are completely documented there:
- https://aimeos.org/docs/latest/manual/coupons/
- https://aimeos.org/docs/latest/manual/c ... ecorators/

You can add any of the available decorators to a coupon provider.

1. Why do I need to create a product/article before creating a voucher? and not creating a voucher directly?
2. How to create a product/article for the voucher?
3. How important the product sku to create a voucher?

Rebates are added as additional lines in the basket. To be able to add custom images and texts for all languages, the configured rebate product is used and only the price of the rebate is added. You can import a rebate product like any other product and how to create a rebate product is explained here:
https://www.youtube.com/watch?v=b3p3GT7UlBQ

4. What are the fixedrebate.productcode and fixedrebate.rebate mean?

The SKU of the rebate product and the rebate amount for each currency you support. Clicking on the "?" button in the upper right corner will reveal help texts for all options.

5. Can I make another input like the fixedrebate.productcode and fixedrebate.rebate ? if yes, How and what? if not,then what is the use of + button?

Yes, you can but it's not necessary because all required/available fields are automatically added as soon as you select the provider and/or decorators.

6.Kindly elaborate the definitions and on the proper data that is being input for the following image.

You've switched between all providers so their configuration options have beed added on the right but only voucher.productcode will be used because "Voucher" is selected as provider. The other ones are ignored.

7.refer to image above, is possible to do the all decorator combinations in just voucher?

Yes, but keep care of the order of the decorators if the "Not" decorator is used.

[tommy.developer]

big thanks for the details that was appreciated!

anyway ,I didn't that much understand some of the provider in the document as I don't have an idea on how and what its usage. I also can fine sample on how to create some of those.
Can you show me on how to create/configure the following Provider:
1. Present
2. Tip

and also for the following decorator:
1. Not
2. Once
3. Required
4. Supplier

atleast videos or images on how to configure and how it works.




I also notice on the BasketValues decorator, how basketvalues.total-value-max work?
I have added value of {"USD":"200.00"} and the basket total value is 200 USD but id the coupon code didn't work.
but when I change the basketvalues.total-value-max vakue to {"USD":"220.00"} , the coupon code works.
there is a 20.00 difference , so is this the expected behavior or do I just missed something?


thank you so much!

[aimeos]

Can you show me on how to create/configure the following Provider:
1. Present
2. Tip

For the "Present" coupon provider the configuration is:

Code: Select all

present.productcode = <product code of a product>
present.quantity = 1

It's also described here: https://aimeos.org/docs/latest/manual/coupons/#present

"Tip" is something very special. You can configure one or more amounts that customers can add to to basket - just like a tip for the waiter in the restaurant.

and also for the following decorator:
1. Not
2. Once
3. Required
4. Supplier

"Not" negates if the coupon is available or not depending on the result of the previous decorators.
https://aimeos.org/docs/latest/manual/c ... ators/#not

"Once" allows logged in customers to use the coupon only once regardless of the available coupon quantity.
https://aimeos.org/docs/latest/manual/c ... tors/#once

"Required" enforces that the configured product is in the basket to grant e.g. the rebate.
https://aimeos.org/docs/latest/manual/c ... /#required

"Supplier" restricts the coupon to the configured supplier that can be selected in the delivery tab of the checkout when the "Supplier" decorator is added to the shipping options.
https://aimeos.org/docs/latest/manual/c ... /#supplier

I also notice on the BasketValues decorator, how basketvalues.total-value-max work?
I have added value of {"USD":"200.00"} and the basket total value is 200 USD but id the coupon code didn't work.
but when I change the basketvalues.total-value-max vakue to {"USD":"220.00"} , the coupon code works.
there is a 20.00 difference , so is this the expected behavior or do I just missed something?

The current implementation is non-inclusive so a total of $200 in the basket is not included in $200 for basketvalues.total-value-max. We will change that in the next version to be inclusive.