> 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/store-front/member/employee-discount-limit.md).

# Employee Discount Limit

A feature for effectively managing benefits provided to employees at the shopping mall. Employees receive a discount benefit up to a certain amount when ordering, and this discount limit resets every year so they can receive new benefits. When ordering, the system checks to prevent discounts from exceeding the employee's discount limit.

***

## Key Features

* **Employee Discount Limit Increase/Decrease Management**
  * Deducts from the employee's remaining discount limit balance when ordering, and restores it upon cancellation/return.
  * When ordering, the system checks that the amount to be deducted does not exceed the remaining discount limit balance.
* **Discount Limit Reset**
  * Resets employees' discount limits every year.
* **History Management**
  * The member information database stores a history of increases and deductions to the employee discount limit.
  * Employees can view their own discount limit history for transparent understanding and use of their benefits.
* **Limit Check Feature**
  * When ordering, orders that would exceed the discount limit are restricted to support effective discount management.
  * Employees can check their current discount eligibility before placing an order.

## Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FgJxxtjlRd0uV9tWLkiw6%2F%E1%84%8B%E1%85%B5%E1%86%B7%E1%84%8C%E1%85%B5%E1%86%A8%E1%84%8B%E1%85%AF%E1%86%AB%E1%84%92%E1%85%A1%E1%86%AF%E1%84%8B%E1%85%B5%E1%86%AB%E1%84%92%E1%85%A1%E1%86%AB%E1%84%83%E1%85%A9.png?alt=media&#x26;token=06c85025-3860-4444-a1bd-f11f602da4a5" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Order

When placing an order, an employee member can receive a discount benefit using the remaining employee discount limit balance. The remaining balance is deducted by the amount used for the discount.
{% endstep %}

{% step %}

### Cancel/Return

When an employee member cancels, exchanges, or returns an order that used the employee discount limit, the employee discount limit amount used on that order is refunded.
{% endstep %}

{% step %}

### Increase/Decrease Employee Discount Limit Balance

* Increases or decreases the employee's remaining discount limit balance.
* When deducting the remaining balance, if the amount to be deducted is greater than the remaining balance, an exception is raised.\
  (Error Code: 6102)
* A history record is saved after the balance is increased or decreased.
  {% endstep %}
  {% endstepper %}

## API Function List

<table><thead><tr><th width="149">API</th><th width="288.5555419921875">Description</th><th width="94.666748046875">Server</th><th width="91.3333740234375">Method</th><th>Remarks</th></tr></thead><tbody><tr><td>Increase/Decrease Employee Discount Limit Balance</td><td>Provides deduction processing from the employee discount limit when applying the employee discount benefit on an order, and increase processing when a claim is processed.</td><td>Member</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%EC%9E%84%EC%A7%81%EC%9B%90%ED%95%A0%EC%9D%B8%ED%95%9C%EB%8F%84&#x26;path=dcLimIncDec">🔗View API ></a></td></tr></tbody></table>

## Definition of Terms

<table><thead><tr><th width="150.6666259765625">Term</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Employee</td><td>Refers to cases where a member using the shopping mall is an executive or employee of the company that operates the shopping mall.</td><td></td></tr><tr><td>Employee Discount Limit</td><td>Refers to the annual discount limit amount that an employee can use at the shopping mall.</td><td></td></tr></tbody></table>

## Other Notes

* The accrual/usage classification code (ME016) determines whether the balance is increased or decreased.\
  (ME016: 10: Accrual (increase) / 20: Usage (decrease))
* Member number, transaction amount, and accrual/usage classification code are required parameters.
* If the member number in the parameters does not correspond to a member, or the member is not an employee, an exception occurs. (Error Code: 6101)
* During an increase, if the resulting remaining balance would exceed the limit, the remaining balance is saved as equal to the limit amount instead (exception handling).
* Claims related to orders from the previous year are not processed for increase requests.
* If deducting an amount would result in the remaining balance falling below 0, an exception occurs. (Error Code: 6102)