> 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/order/order-exchange.md).

# Order Exchange

Provides exchange and exchange cancellation features for ordered products, enabling customers to respond quickly and effectively when they are dissatisfied. Both members and non-members can access this via order information and login information, and can look up products eligible for exchange among their ordered and exchanged products based on the order progress status.

***

## Key Features

* **Exchange and Exchange Cancellation**
  * Provides exchange request and cancellation features via the order list or order detail page.
  * Provides the information required for the exchange request so customers can enter the necessary information.
* **Exchange-Eligible Product Lookup**
  * Looks up exchange-eligible products among ordered products based on the order progress status (Shipped or Delivered).
  * Provides the option to select only among products within the same delivery group.
* **Exchange Information Entry**
  * Provides options to select the exchange quantity, exchange product, pickup address, delivery address, responsible party, and more.
* **Cost and Benefit Recalculation**
  * Recalculates cost and benefits based on the exchange product and responsible party, and processes payment or refund.
* **Stock Processing**
  * Processes stock increases/decreases according to exchange requests and cancellations.
* **Notification**
  * Sends a notification to the customer after the exchange request and cancellation are completed, informing them of the status.

***

## Process Definition — Exchange Request

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FM3LyGrpQ0zKdHeDRTKI6%2F%E1%84%8C%E1%85%AE%E1%84%86%E1%85%AE%E1%86%AB%E1%84%80%E1%85%AD%E1%84%92%E1%85%AA%E1%86%AB.png?alt=media&#x26;token=67988d3c-4b54-46b4-9da6-2f70b36a7ca2" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Exchange Target Lookup

Users can submit an exchange request via the order list or order detail page. The list of exchange-eligible products among the ordered products is retrieved and displayed in the exchange request popup.
{% endstep %}

{% step %}

### Claim Cost Calculation Lookup

Retrieves the additional payment cost based on the exchange reason.
{% endstep %}

{% step %}

### Claim Additional Payment Information Lookup

If an additional cost arises, retrieves the list of available payment methods, and for members, their held mileage information.
{% endstep %}

{% step %}

### Delivery Number Issuance Processing

Issues a new delivery number for the pickup/delivery address to be used for the exchange request.
{% endstep %}

{% step %}

### Image Upload Processing

Uploads the attached reason image.
{% endstep %}

{% step %}

### Exchange Request

Processes the exchange request for the selected product.
{% endstep %}
{% endstepper %}

***

## Process Definition — Exchange Cancellation

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2F3Kyw4fe8mxVTePuy2AMG%2F%E1%84%80%E1%85%AD%E1%84%92%E1%85%AA%E1%86%AB%E1%84%8E%E1%85%B1%E1%84%89%E1%85%A9.png?alt=media&#x26;token=eed95cd8-a3bd-4c17-9bef-b4c0023e8d23" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Claim Detail Lookup

Retrieves the exchange request history. Provides the exchange progress status, payment history, and delivery/pickup address information.
{% endstep %}

{% step %}

### Exchange Withdrawal

Users open the exchange detail popup via the order list or order detail page. The Cancel Exchange button appears for exchange requests eligible for withdrawal. Clicking the Cancel Exchange button processes the cancellation of that exchange.
{% endstep %}
{% endstepper %}

***

## Process Definition — Delivery Fee Payment

When this occurs, the request status is marked as “Payment Pending,” and the customer proceeds with payment directly via the delivery fee payment popup.

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FEC2DgVmJDsR7uvxIp4km%2F%E1%84%87%E1%85%A2%E1%84%89%E1%85%A9%E1%86%BC%E1%84%87%E1%85%B5%20%E1%84%80%E1%85%A7%E1%86%AF%E1%84%8C%E1%85%A6.png?alt=media&#x26;token=d6969700-6462-41cb-891e-221de7fe3f86" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Claim Delivery Fee Payment-Pending Status Target Information

Retrieves the additional payment amount and payment method information. For members, retrieves their held mileage information. For exchange requests, an exchange delivery fee may be incurred depending on the exchange reason.
{% endstep %}

{% step %}

### Claim Delivery Fee Payment Processing

Requests payment using the selected payment method.
{% endstep %}
{% endstepper %}

***

## API Function List

<table><thead><tr><th width="97.888916015625">API</th><th width="380.888916015625">Description</th><th width="92.4444580078125">Server</th><th width="90.2222900390625">Method</th><th>Remarks</th></tr></thead><tbody><tr><td>Exchange Target Lookup</td><td>Retrieves exchange-eligible products among the ordered products. Retrieves the order information and common codes needed to process an exchange request.</td><td>Order</td><td>POST</td><td><p><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EA%B5%90%ED%99%98&#x26;path=getExchageTargetInfoFO">🔗FO: View API ></a></p><p>BO: <a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EA%B5%90%ED%99%98&#x26;path=getExchageTargetInfo">View API ></a></p></td></tr><tr><td>Exchange Request</td><td>Processes the exchange request for the selected product. An exchange delivery fee may be charged depending on the exchange reason, and payment is requested if a cost arises. Stock for the exchange product is deducted, and a notification is sent to the customer after the exchange request is completed.</td><td>Order</td><td>POST</td><td><p>FO: <a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EA%B5%90%ED%99%98&#x26;path=acceptExchangeFO">🔗View API ></a></p><p>BO: <a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EA%B5%90%ED%99%98&#x26;path=acceptExchange">View API ></a></p></td></tr><tr><td>Exchange Request Withdrawal</td><td>Withdraws the exchange request. Refunds the amount paid at the time of the exchange request, processes the stock increase/decrease, and sends a notification to the customer once the exchange withdrawal is complete.</td><td>Order</td><td>POST</td><td><p>FO: <a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EA%B5%90%ED%99%98&#x26;path=withdrawalExchangeFO">🔗View API ></a></p><p>BO: <a href="https://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EA%B5%90%ED%99%98&#x26;path=withdrawalExchange">View API ></a></p></td></tr><tr><td>Claim<br>Cost Calculation Lookup</td><td>Retrieves the additional cost, benefits, and additional payment amount incurred during exchange.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5&#x26;path=calculateFO">🔗View API ></a></td></tr><tr><td>Delivery Number Issuance Processing</td><td>Generates a new delivery number for the exchange pickup/delivery address.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5&#x26;path=getNewNumberedDeliNo">🔗View API ></a></td></tr><tr><td>Image<br>Upload<br>Processing</td><td>Uploads the attached image according to the exchange responsible party reason.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5&#x26;path=claimImgUpload">🔗View API ></a></td></tr><tr><td>Claim<br>Additional Payment Information Lookup</td><td>If an additional payment amount arises during exchange, retrieves the payment method and mileage information.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5&#x26;path=getAdditionalFeePaymentInfo">🔗View API ></a></td></tr><tr><td>Claim<br>Delivery Fee<br>Payment-Pending Status Target Information</td><td>Retrieves the additional payment amount and payment method information for exchanges in Payment Pending status.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5&#x26;path=getClaimPayWaitStateInfo">🔗View API ></a></td></tr><tr><td>Claim<br>Delivery Fee<br>Payment Processing</td><td>Requests payment for the additional cost (exchange delivery fee) incurred at the time of the exchange request.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5&#x26;path=doPayDeliveryFee">🔗View API ></a></td></tr></tbody></table>

***

## Terminology

<table><thead><tr><th width="104">Term</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Payment Pending</td><td>If the exchange reason is attributable to the customer, an exchange delivery fee is incurred. When the customer submits the exchange request directly, the delivery fee payment is processed during the request step; however, when the exchange is requested via the customer center, the request is completed only after the customer separately makes payment via the delivery fee payment screen. In this case, the status before the customer makes payment is marked as “Payment Pending.”</td><td></td></tr></tbody></table>

***

## Other Notes

* Exchange requests can only be submitted within the same delivery group.
* When submitting or cancelling an exchange request, the processable order history status and order history classification values are checked. This information is managed via a common code.
  * ST007 (FO System Claim-Processable Status) reference value 1 = order history status code
  * ST007 (FO System Claim-Processable Status) reference value 2 = order history classification code
* Exchange reasons are managed via a common code, and include information such as the responsible party classification, target order history classification, and whether it is exposed in FO, for each reason.
* For products with a gift item, partial-quantity exchange is not possible.
* If a payment method that does not support partial cancellation was used at the time of order, only a full exchange is possible.
* Exchange is only possible for a general product (reservation products are not eligible) of the same price that is currently on sale.
* Exchange is not possible if the product has no stock.
* If the exchange reason is attributable to the customer, an exchange delivery fee is incurred.
* If an exchange delivery fee is incurred, a payment request is made, and it is refunded upon cancellation.
* When an exchange request is submitted, the stock of the exchange product is deducted, and it is restored upon cancellation.
* When cancelling an exchange in the Pickup Instructed status, the delivery instruction cancellation quantity is updated.