> 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/store-front/order/undefined-3.md).

# 선물함

고객이 다른 고객을 대상으로 쇼핑몰 상품을 선물하기 주문을 진행할 수 있습니다. 선물을 받은 고객은 선물을 수락하기 위한 간편한 확인과 절차를 제공하여 더 나은 서비스 경험을 제공합니다.

***

### 주요 기능

* **선물 이력 조회:**
  * 마이페이지 > 선물함에서 주문 이력 목록과 상세를 확인할 수 있습니다.
* **선물 수락 여부 변경:**
  * 선물하기 주문에 대해 선물함에서 수락 여부를 변경할 수 있습니다.
* **보낸 선물함 기능:**
  * 보낸 선물함에서는 보낸 선물의 주문 이력과 상세를 기간별로 조회할 수 있습니다.
  * 주문 취소 및 상품 옵션 변경이 가능합니다.
* **받은 선물함 기능:**
  * 받은 선물함에서는 받은 선물의 주문 이력과 상세를 기간별로 조회할 수 있습니다.
  * 선물을 수락하기 위해 배송지를 입력할 수 있습니다.
  * 배송지 입력을 기간 내에 완료하지 않으면 거절 상태로 변경되어 주문이 취소됩니다.
  * 받은 선물 상품의 옵션 변경은 배송지 입력 이후에 받은 선물함에서 가능합니다.

<figure><img src="/files/bUqnd3QTr5IViyc9witZ" alt=""><figcaption></figcaption></figure>

### 프로세스 정의

{% stepper %}
{% step %}

### 선물 수신자 배송지 입력

선물을 받은 회원은 수신한 알림톡의 랜딩URL 화면과 마이페이지의 받은 선물함에서 배송지 입력을 통해 선물을 수락할 수 있습니다.
{% endstep %}

{% step %}

### 보낸 선물한 내역 조회

선물을 보낸 회원은 마이페이지의 보낸 선물함에서 보낸 선물들의 내역을 기간별로 조회할 수 있습니다.
{% endstep %}

{% step %}

### 받은 선물함 내역 조회

선물을 받은 회원은 마이페이지의 받은 선물함에서 받은 선물들의 내역을 기간별로 조회할 수 있습니다.
{% endstep %}

{% step %}

### 선물함 상세 조회

받거나 보낸 선물하기 주문의 상세(주문 정보, 보낸사람 정보, 상품정보, 결제정보, 적립포인트)를 조회할 수 있습니다.
{% endstep %}

{% step %}

### 선물하기 주문 취소

배치 프로그램에 의해서 선물 수락 가능 기간 초과한 접수 주문 건들을 취소 처리합니다.
{% endstep %}
{% endstepper %}

### API 기능 목록

<table><thead><tr><th width="119">API</th><th width="390.333251953125">설명</th><th width="93.5555419921875">Server</th><th width="92.4444580078125">메소드</th><th>비고</th></tr></thead><tbody><tr><td>선물 수신자 배송지 입력</td><td><p>선물 수신자의 배송지를 해당 주문 데이터에 <br>반영합니다. </p><p>배송지시예약일시를 수락한 일시로, 선물상태<br>코드를 수락으로 변경합니다.</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">🔗API 확인하기></a></td></tr><tr><td>보낸 선물함 내역 조회</td><td>보낸 선물함 목록을 조회합니다.</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">🔗API 확인하기></a></td></tr><tr><td>받은 선물함 내역 조회</td><td>받은 선물함 목록을 조회합니다.</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">🔗API 확인하기></a></td></tr><tr><td>선물함 상세 조회</td><td>보낸 / 받은 선물함 상세 내역을 조회합니다.</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">🔗API 확인하기></a></td></tr></tbody></table>

### 용어 정의

<table><thead><tr><th width="170.6666259765625">명칭</th><th>설명</th><th data-hidden>비고</th></tr></thead><tbody><tr><td>배송지시예약일시</td><td>주문 상세 테이블에 있는 컬럼으로 입력된 일시에 배송지시가 됩니다.</td><td></td></tr></tbody></table>

### 기타 참고사항

* 배송지 입력 유효기간은 공통코드로 관리합니다.\
  ST006(클레임가능일수) 선물수락 기한일수의 참조 1값
* 받은 선물의 경우 취소/교환/반품 클레임이 불가능