Mercury:Manual: Difference between revisions

From Esoul Wiki
Jump to navigation Jump to search
Line 20: Line 20:


==== Automatic Cancellation ====
==== Automatic Cancellation ====
==== Service Start & End ====
It's possibl
==== Subscription ====


=== Coupon ===
=== Coupon ===

Revision as of 07:29, 26 July 2025

Website Setup

Shop Setup

Shop Management

Order

In general, the orders are submitted by the user. It's allowed for administrators to submit an order from the management panel in a similar way. It's often considered for example for submission via telephone.

There are some general limitations apply to each order.

An order can have two addresses, one invoice address, one delivery adddress. If there's no delivery address specified, then the invoice address is considered as delivery address.

An order has a start

management of the order

Automatic Cancellation

Service Start & End

It's possibl


Subscription

Coupon

A coupon is an one-time random code, which is often used as discount code in digital or printed form. A user can apply the code by entering it in the order process to get the specified discount (see detailed description below).

Each code has it's own start time and end time (expiration time). A user can only apply a code in this time interval.

Mercury allows to apply multiple coupons (no matter if they're in the same group or not) unless a coupon is declared as exclusive. You can limit the total discount of multiple coupons with coupon permissions, which is described later.

To create a coupon, you have to create a coupon group at first, which contains codes with same settings (name, amount, etc.). Then you can add codes to the group. There's an export function allowing you to export multiple codes to CSV table.

Please protect the codes carefully to avoid any illegal usage.

Detailed Application Rules

Each coupon has four core parameters: service, discount rate, minimal discount, and maximal discount.

When submitting an order, the system calculates the total price of all articles belonging to the specified service as the base.

Then the discount rate of base will be reduced. For example when a coupon with 10% rate of an order of $10 is applied, the discount will be 10% x $10 = $1, the final amount will be (1 - 10%) x $10 = $9 as shown in the table below. Below is another example *.

Article    Num    Price     Total Price
Apple      2      $2        $4
Jeans      1      $10       $10
Coupon [service: 'food', discount rate: 10%, minimal discount: $0, maximal discount: $100]

Final                       $ 14
Discount                    $ -0.4
Final after Discount        $ 13.6

If the discount is less than minimal discount, the coupon is still applied but the discount is set to $0. In the above example, if the minimal discount is set to $2, then the final amount will be $10. Below is another example *.

Article    Num    Price     Total Price
Apple      2      $2        $4
Jeans      1      $10       $10
Coupon [service: 'food', discount rate: 10%, minimal discount: $1, maximal discount: $100]

Final                       $ 14
Discount                    $  0
Final after Discount        $ 14

If the discount is more than maximal discount, the coupon is still applied but the discount is limit so that the discount is not larger than the specified value. In the above example if the maximal discount is set to $0.5 and minimal discount is unset (or set to $0), then the discount will be 5% x $10 = $0.5 and the final amount will be (1 - 5%) x $10 = $9.5, or calculate in this way $10 - $0.5 = $9.5 since the original discount $1 is larger than $0.5. Below is another example *.

Article    Num    Price     Total Price
Apple      2      $2        $4
Jeans      1      $10       $10
Coupon [service: 'food', discount rate: 10%, minimal discount: $0, maximal discount: $0.2]

Final                       $ 14
Discount                    $ -0.2
Final after Discount        $ 13.8

When multiple discounts are applied, the discount is calculated separately from the base.

Article    Num    Price     Total Price
Apple      2      $2        $4
Jeans      1      $10       $10
Coupon1 [service: 'food', discount rate: 10%, minimal discount: $0, maximal discount: $0.2]
Coupon2 [service: 'food', discount rate: 20%, minimal discount: $0, maximal discount: $100]

Final                       $ 14
Discount from Coupon 1      $ -0.2
Discount from Coupon 2      $ -0.8
Final after Discount        $ 13

It's notable that all the discounts are calculated after the tax if specified. Please also be aware that there are ceilings in the calculation, the final discount could be slightly higher than the specification. It's most important when you sell an article with very low price near the minimal unit (e.g. $0.01), please read the next sections for details.


* The examples are helping you to understand the discount. In the actual invoice, the discount won't be listed as a single amount but distributed to the articles.

Distribution of Discount and Handling of Returns

The above examples are helping you to understand the discount. In the actual usage, the total discount is distributed to each article. An example is shown below. Due to the distribution, the actual discount could be slightly higher than the planned discount. In general the difference is very small, but the difference could be large if the price is too low. Considering this example.

The distribution makes return of the articles easier. The real amount after the distributed discount should be sent back [is returned]. It's notable that there's no control of the condition of the discount after the article is returned. This should be fine and fair for the most cases, if you prefer to recheck the condition, it has to be done manually.

Define Permissions

Handling of Returns

Voucher

A voucher is an one-time random code, which is often used as gift card in digital or printed form. A user can apply the code by entering it in their user center to get the specified amount of money assigned to their balance. The balance can be used later to pay the order fully or partially.

Each code has it's own start time and end time (expiration time). A user can only apply a code in this time interval.

To create a voucher, you have to create a voucher group at first, which contains codes with same settings (name, amount, etc.). Then you can add codes to the group. There's an export function allowing you to export multiple codes to CSV table.

Mercury is ready to sell digital products. You can sell the generated voucher code as digital gift cards.

Please protect the codes carefully to avoid any illegal usage .