> 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/gift-box.md).

# Gift Box

Customers can place gifting orders for shopping mall products to other customers. Customers who receive a gift are provided with a simple confirmation and process for accepting the gift, offering a better service experience.

***

### Key Features

* **Gift History Lookup:**
  * The order history list and details can be checked in My Page > Gift Box.
* **Gift Acceptance Status Change:**
  * The acceptance status of a gifting order can be changed in the Gift Box.
* **Sent Gift Box Feature:**
  * In the Sent Gift Box, the order history and details of sent gifts can be viewed by period.
  * Order cancellation and product option changes are possible.
* **Received Gift Box Feature:**
  * In the Received Gift Box, the order history and details of received gifts can be viewed by period.
  * A delivery address can be entered to accept a gift.
  * If the delivery address is not entered within the period, the status changes to Declined and the order is cancelled.
  * Option changes for received gift products are possible in the Received Gift Box after the delivery address has been entered.

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FGjrPNoAqdQEkgDmBJclW%2Fimage.png?alt=media&#x26;token=2bf1155a-e059-4961-b8af-e3aea734778e" alt=""><figcaption></figcaption></figure>

### Process Definition

{% stepper %}
{% step %}

### Gift Recipient Delivery Address Entry

Members who receive a gift can accept it by entering a delivery address, either through the landing URL screen in the received notification (AlimTalk) or in the Received Gift Box on My Page.
{% endstep %}

{% step %}

### Sent Gift History Lookup

Members who sent a gift can view the history of sent gifts by period in the Sent Gift Box on My Page.
{% endstep %}

{% step %}

### Received Gift Box History Lookup

Members who received a gift can view the history of received gifts by period in the Received Gift Box on My Page.
{% endstep %}

{% step %}

### Gift Box Detail Lookup

The details of a received or sent gifting order (order information, sender information, product information, payment information, accumulated points) can be viewed.
{% endstep %}

{% step %}

### Gifting Order Cancellation

A batch program cancels received orders that have exceeded the gift acceptance period.
{% endstep %}
{% endstepper %}

### API Function List

<table><thead><tr><th width="119">API</th><th width="390.333251953125">Description</th><th width="93.5555419921875">Server</th><th width="92.4444580078125">Method</th><th>Remarks</th></tr></thead><tbody><tr><td>Gift Recipient Delivery Address Entry</td><td><p>Reflects the gift recipient's delivery address in the corresponding order data.</p><p>Changes the scheduled delivery instruction date/time to the acceptance date/time, and updates the gift status code to Accepted.</p></td><td>Order</td><td>PUT</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%84%A0%EB%AC%BC%ED%95%A8&#x26;path=registerShippingAddressForReceiveGift">🔗View API ></a></td></tr><tr><td>Sent Gift Box History Lookup</td><td>Retrieves the sent gift box list.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%84%A0%EB%AC%BC%ED%95%A8&#x26;path=sendGiftBoxList">🔗View API ></a></td></tr><tr><td>Received Gift Box History Lookup</td><td>Retrieves the received gift box list.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%84%A0%EB%AC%BC%ED%95%A8&#x26;path=receiveGiftBoxList">🔗View API ></a></td></tr><tr><td>Gift Box Detail Lookup</td><td>Retrieves the sent / received gift box details.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%84%A0%EB%AC%BC%ED%95%A8&#x26;path=getGiftDetailInfo">🔗View API ></a></td></tr></tbody></table>

### Terminology

<table><thead><tr><th width="170.6666259765625">Term</th><th>Description</th><th data-hidden>Remarks</th></tr></thead><tbody><tr><td>Scheduled Delivery Instruction Date/Time</td><td>A column in the order detail table; the delivery instruction is issued at the entered date/time.</td><td></td></tr></tbody></table>

### Other Notes

* The delivery address entry validity period is managed via a common code.\
  ST006 (Claimable Days) Reference value 1 of the gift acceptance deadline days
* For received gifts, cancellation/exchange/return claims are not possible.