> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/api-guides-en/back-office/marketing-bo/discount-mileage-management.md).

# Discount/Mileage Management

The Discount/Mileage Management service efficiently registers and manages various benefits, such as immediate product discounts, product mileage, and employee discounts. Through this service, promotion managers can flexibly adjust benefits by setting detailed conditions and provide a variety of benefits to users. Employee discount benefits can increase employee loyalty and satisfaction, and also help improve understanding of and promote the company's products.

***

## Key Features

* **Discount Benefit**
  * Minimizes losses by applying a percentage-based discount to the product price.
  * Quickly determines whether a reverse margin exists by checking the cost price.
* **Mileage Benefit**
  * Increases customer engagement by accruing a set percentage of mileage on product purchases.
  * Flexibly sets discount and mileage types to diversify benefits.
* **Employee Discount**
  * Increases employee loyalty and satisfaction and contributes to promotion by offering discounts to company employees.
  * Supports effective service management through discount rate settings and detailed conditions.

## Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FZi6mzVL6XclQPILtgSJq%2F%E1%84%92%E1%85%A1%E1%86%AF%E1%84%8B%E1%85%B5%E1%86%AB_%E1%84%86%E1%85%A1%E1%84%8B%E1%85%B5%E1%86%AF%E1%84%85%E1%85%B5%E1%84%8C%E1%85%B5%20%E1%84%80%E1%85%AA%E1%86%AB%E1%84%85%E1%85%B5.png?alt=media&#x26;token=c193c1cd-dd1b-42b0-bbad-9c1cc3cd72d6" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Discount/Mileage Inquiry

Looks up the list and count of registered discount/mileage benefits.
{% endstep %}

{% step %}

### Benefit Reverse Margin Check

When newly registering a discount/mileage benefit, for immediate product discount or employee discount benefits, checks the supply cost via a reverse margin check to minimize the company's losses.
{% endstep %}

{% step %}

### Discount/Mileage Detail Inquiry

Looks up the detail information of a registered discount/mileage benefit.
{% endstep %}

{% step %}

### Discount/Mileage Registration

Saves and updates a newly registered or existing discount/mileage benefit.
{% endstep %}

{% step %}

### Multilingual Inquiry

Looks up the multilingual registration information for a discount/mileage benefit.
{% endstep %}

{% step %}

### Multilingual Registration

Registers the multilingual information for a discount/mileage benefit.
{% endstep %}
{% endstepper %}

## API Function List

<table><thead><tr><th width="139" align="center">API</th><th width="334.22216796875" align="center">Description</th><th width="95.7777099609375">Server</th><th width="89.111083984375">Method</th><th align="center">Notes</th></tr></thead><tbody><tr><td align="center">Discount/Mileage List Inquiry</td><td align="center">Looks up registered discount and mileage benefits using conditions.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getPromotionManagingList">🔗View API ></a></td></tr><tr><td align="center">Discount/Mileage List Count Inquiry</td><td align="center">Looks up the total count of registered discount and mileage benefits using conditions.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getPromotionManagingListCount">🔗View API ></a></td></tr><tr><td align="center">Common Code Inquiry</td><td align="center">Looks up the discount/mileage type common code among the search conditions when looking up discounts/mileage.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getPromotionManagingList">🔗View API ></a></td></tr><tr><td align="center">Discount/Mileage Detail Screen Call</td><td align="center">Looks up the detail information of a registered discount or mileage benefit.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getPromotion">🔗View API ></a></td></tr><tr><td align="center">Reverse Margin<br>Product Check<br>on Benefit Registration</td><td align="center">When registering a discount/mileage benefit, for immediate product discount or employee discount types, looks up the product's supply cost to check for a reverse margin.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getOverMrgnGoods">🔗View API ></a></td></tr><tr><td align="center">Discount/Mileage Registration and<br>Update</td><td align="center">Newly registers or updates the information of a registered discount/mileage benefit.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=cudPromotion">🔗View API ></a></td></tr><tr><td align="center">Promotion<br>Multilingual Information<br>Inquiry</td><td align="center">Looks up the multilingual information of a discount/mileage benefit.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getMultilingualInfo">🔗View API ></a></td></tr><tr><td align="center">Promotion<br>Multilingual Registration</td><td align="center">Registers the multilingual information of a discount/mileage benefit.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=saveMultilingualInfo">🔗View API ></a></td></tr></tbody></table>

## Terminology

<table><thead><tr><th width="106.7777099609375" align="center">Term</th><th>Description</th><th data-hidden align="center">Notes</th></tr></thead><tbody><tr><td align="center">Discount Type (Percentage)</td><td>A benefit that discounts or accrues a certain percentage of a product's price when the product is purchased.<br>Depending on this discount/mileage type, the actual purchase price or the perceived amount from accrual varies through a discount or mileage accrual.<br>Because the percentage-based method causes the actual purchase amount to vary relative to the product's price, the higher the<br>product's price, the greater the benefit amount received can be.</td><td align="center"></td></tr></tbody></table>

## Other Notes

* Reverse Margin
  * Refers to a case in which the product's selling price minus the applied benefit amount is greater than or equal to the product's supply cost, resulting in a loss even when the product is sold.
  * A reverse margin must always be checked for immediate product discount or employee discount benefits.
* **Mileage Policy**

<table><thead><tr><th width="102.4443359375" align="center">Accrual Type</th><th align="center">Accrual Item</th><th width="152.4444580078125" align="center">Accrual Target</th><th align="center">Accrual Rate</th><th width="142.4444580078125" align="center"></th><th align="center">Accrual Date</th><th align="center">Expiration</th><th align="center"></th><th align="center">Accrual Limit</th><th align="center">Notes</th></tr></thead><tbody><tr><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"><strong>Applied Rate</strong></td><td align="center"><strong>Base Amount</strong></td><td align="center"></td><td align="center"><strong>Order Expiration</strong></td><td align="center"><strong>Automatic Expiration</strong></td><td align="center"></td><td align="center">Delivery fee excluded</td></tr><tr><td align="center">Order Accrual</td><td align="center">Base Accrual</td><td align="center">N/A</td><td align="center">Managed separately</td><td align="center">Based on order amount</td><td align="center">Delivery completed + 14 days</td><td align="center">Return</td><td align="center">1 year from accrual date</td><td align="center">N/A</td><td align="center">Delivery fee excluded</td></tr><tr><td align="center"></td><td align="center">Additional accrual by customer tier</td><td align="center">GREEN/FAMILY/GOLD/VIP/VVIP</td><td align="center">Managed separately</td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td></tr><tr><td align="center"></td><td align="center">Promotion accrual</td><td align="center">Promotion</td><td align="center">Based on entered value</td><td align="center">Based on entered value</td><td align="center">Delivery completed + 14 days</td><td align="center">　</td><td align="center">30 days from accrual date</td><td align="center"></td><td align="center"></td></tr></tbody></table>

* **Coupon and Discount Policy**

<table><thead><tr><th width="102.4443359375" align="center">Category</th><th align="center">1st Discount</th><th align="center">2nd Discount</th><th align="center"></th><th align="center"></th><th align="center">3rd Discount</th><th align="center"></th></tr></thead><tbody><tr><td align="center"><strong>Type</strong></td><td align="center">Selling price discount (single-item discount)</td><td align="center">Product discount coupon</td><td align="center">Employee discount</td><td align="center">Immediate product discount</td><td align="center">Stackable discount coupon</td><td align="center">Cart coupon</td></tr><tr><td align="center"><strong>Discount Type</strong></td><td align="center">Fixed amount</td><td align="center">Fixed amount/Percentage</td><td align="center">Percentage</td><td align="center">Percentage</td><td align="center">Fixed amount/Percentage</td><td align="center">Fixed amount/Percentage</td></tr><tr><td align="center"><strong>Characteristics</strong></td><td align="center">Set when the product is registered</td><td align="center">Another discount type within the same tier cannot be selected (cannot be used simultaneously) (e.g., 2nd-tier product coupon + employee discount cannot be used together) When calculating the maximum benefit price, the larger amount is applied first; if amounts are equal, applied in the order of immediate product discount -> product discount coupon -> employee discount</td><td align="center"></td><td align="center"></td><td align="center">Another discount type within the same tier cannot be selected (cannot be used simultaneously) 3rd-tier discount can be used independently. When calculating the maximum benefit price, the larger amount is applied first; if amounts are equal, applied in order of the coupon's validity end date</td><td align="center"></td></tr><tr><td align="center"><strong>Calculation Base Amount</strong></td><td align="center">Selling price</td><td align="center">Price after 1st discount applied</td><td align="center"></td><td align="center"></td><td align="center">Price after 2nd discount applied</td><td align="center"></td></tr><tr><td align="center"><strong>Minimum Purchase Criteria</strong></td><td align="center">N/A</td><td align="center">Quantity: fixed at 1<br>Amount: selling price of 1 unit of the product</td><td align="center">N/A</td><td align="center">N/A</td><td align="center">Quantity: fixed at 1<br>Amount: selling price of 1 unit of the product</td><td align="center">Quantity: sum of eligible products<br>Amount: sum of the post-discount amounts of eligible products (previous tier)</td></tr><tr><td align="center"><strong>Application Basis</strong></td><td align="center">Adjusts the product's selling price</td><td align="center">Applies an individual discount to all quantities of the product</td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center">Applies a discount to all quantities of eligible products</td></tr><tr><td align="center"><strong>Margin Check</strong></td><td align="center">At product registration</td><td align="center">Coupon/discount is exposed and usable only when “supply price >= selling price - discount amount”</td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td></tr><tr><td align="center"><strong>3rd-Tier Discount Applicability</strong></td><td align="center">N/A</td><td align="center">O</td><td align="center">X</td><td align="center">O</td><td align="center">N/A</td><td align="center">N/A</td></tr><tr><td align="center"><strong>Common Application Rules</strong></td><td align="center">N/A</td><td align="center">Discounts can be applied in 1-won increments, and any amount under 1 won is rounded.<br>Promotions are recalculated only when a claim is filed before all products in the order have shipped.<br>To prevent a 0-won payment, coupons/discounts with a discount amount greater than the selling price cannot be used.</td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td></tr></tbody></table>
