> 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-change.md).

# Order Change

Provides a feature that lets customers change the delivery address and options of an ordered product. Delivery address changes are only possible on the order detail screen, while option changes are possible on both the order list and order detail screens. Changes are only possible when the order history classification code (OM003) is in the Order Completed (11) status, and delivery address changes are only possible between a remote island/mountainous area and a general area.

***

## Key Features

* **Delivery Address Change**
  * Delivery address changes are possible from the order detail screen when the status is Order Completed (11).
  * Updates all delivery sequence numbers for the corresponding order number.
  * Only delivery address changes between a remote island/mountainous area and a general area are possible.
* **Option Change**
  * Option changes are possible from the order list and order detail screens when the status is Order Completed (11).
  * Only a single item's option can be changed, and it can only be changed to a color+size combination of another item of the same price that is currently on sale and has stock available.
  * The same item and items that are reservation products cannot be changed.

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FQXqse8vKowTmUab5GVOm%2F%E1%84%8C%E1%85%AE%E1%84%86%E1%85%AE%E1%86%AB%E1%84%87%E1%85%A7%E1%86%AB%E1%84%80%E1%85%A7%E1%86%BC.png?alt=media&#x26;token=2ba36b79-207f-4704-91c6-aca3a7499e35" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Order History Detail Lookup

For non-members, the details are viewed via non-member login; for members, the details are viewed via My Page > Order History Lookup > Order History Detail.
{% endstep %}

{% step %}

### Option Change

After clicking the Option Change button, the eligible item information is received, and the option can be changed.\
When Complete Change is clicked, the option change validation is performed, and upon successful validation, it is saved to the order DB.
{% endstep %}

{% step %}

### Delivery Address Change

When Change Delivery Address is clicked, the delivery address list popup appears, and the delivery address can be changed upon selection.\
For non-members, a delivery address entry popup appears, and when Complete Selection is clicked, the delivery address change validation is performed, and upon successful validation, it is saved to the order DB.
{% endstep %}
{% endstepper %}

## API Function List

<table><thead><tr><th width="117.77783203125">API</th><th width="301.2222900390625">Description</th><th width="93.5555419921875">Server</th><th width="91.3333740234375">Method</th><th>Remarks</th></tr></thead><tbody><tr><td>Order Delivery Address Update (FO)</td><td>Changes the order delivery address.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B3%80%EA%B2%BD&#x26;path=ordDlvChangeFO">🔗View API ></a></td></tr><tr><td>Order Product Option Change (FO)</td><td>A single order item's option can be changed. It can be changed to another item of the same price that is currently on sale and has stock available.</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%EB%B3%80%EA%B2%BD&#x26;path=ordChangeFO">🔗View API ></a></p><p>Product-specific eligible item information lookup API</p><p><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8&#x26;path=getOrderItmInfos">🔗View API ></a></p><p>Item-specific stock increase/decrease API</p><p><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8&#x26;path=setStockUpdate">🔗View API ></a></p></td></tr></tbody></table>

## Other Notes

* The display of the option change button is managed via a common code.\
  ST007 (FO System Claim-Processable Status) code 91 (Option Change) reference value 1 (order history status code: OM005), reference value 2 (order history classification code: OM003)
* The display of the delivery address change button is managed via a common code.\
  ST007 (FO System Claim-Processable Status) code 92 (Delivery Address Change) reference value 1 (order history status code: OM005), reference value 2 (order history classification code: OM003)\
  Ex) For the delivery address change button to appear, reference value 1 must be 12 or 21 (OM005: Order Completed (12), Delivery Instructed (21)), and reference value 2 must be 10 (OM003: Order Completed).
* Button display criteria table by status

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FQkfeAZPbslzzUnCYWeJj%2Fimage.png?alt=media&#x26;token=a3ede12e-a8cf-4a2d-a741-0ab7048e17a2" alt=""><figcaption></figcaption></figure>