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

# 주문서

사용자가 주문을 생성하고 결제를 완료하는 주문서 관리 기능을 제공합니다. 주문서는 다양한 상황과 조건에 따라 구분되며, 사용자의 요청 정보 및 상품, 배송, 결제 등 다양한 정보를 검증하고 조회하여 원활한 주문 프로세스를 지원합니다

***

### 주요 기능

* **주문서 진입 및 검증**
  * 주문서는 상품 상세페이지나 장바구니 화면에서 진입이 가능하며, 15세 이상의 회원 또는 인증을 통과한 비회원만 주문서에 접근할 수 있습니다.
* **다양한 주문서 유형**
  * 주문 기준으로는 일반 주문과 선물하기 주문서가 있으며, 회원 정보 기준으로는 회원 주문과 비회원 주문서로 구분됩니다.
* **주문 정보 조회 및 검증**
  * 최초 주문서 진입 시 주문자 나이, 선물하기 주문 시 회원 여부, 비회원 주문 시 인증 여부 등을 검증합니다.
* **혜택 및 결제 정보 조회**
  * 주문 상품 별 사용 가능한 결제수단 중 중복된 수단을 분류하고 해당 결제수단에 필요한 정보를 조회하여 노출합니다.
* **배송비 및 배송 그룹 관리**
  * 상품 별 배송정보에 따라 배송그룹을 나누어 배송비를 조회하며, 배송지의 도서산간 여부에 따라 추가 배송비가 부과될 수 있습니다.
* **사은행사 및 혜택 조회**
  * 회원 주문서일 경우 사은행사가 존재할 때 결제 전 사은행사 팝업을 노출하고, 쿠폰 및 혜택 팝업에서 사용 가능한 혜택정보와 최대혜택정보를 조회합니다.
* **주문 생성 및 완료**
  * 주문 생성에 필요한 필수 값들을 검증하고 주문번호를 채번한 후, 결제에 필요한 인증 작업이 끝나면 주문 생성 API를 호출하여 주문을 완료합니다.
  * 주문에 성공하면 주문완료 페이지에서 주문완료정보 조회 API를 호출하여 주문정보를 사용자에게 노출합니다.

### 프로세스 정의

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

{% stepper %}
{% step %}

### 주문서 검증

사용자는 상품 상세, 장바구니 화면에서 주문서에 진입할 수 있습니다. 주문서 진입 시 Request 정보, 주문자 나이, 선물하기 주문 시 사용자의 회원 여부, 비회원 주문 시 인증 여부를 검증합니다.
{% endstep %}

{% step %}

### 주문서 조회

회원, 결제수단, 주문상품, 배송, 프로모션, 적립 정보를 주문서 노출에 필요한 주문서 정보와 주문생성을 위한 주문생성 정보로 구분하여 전달합니다.
{% endstep %}

{% step %}

### 주문서 사은행사 조회

주문한 상품의 사은행사 정보를 조회하여, 사은행사가 존재할 경우 결제 전 사은행사 팝업을 노출합니다.
{% endstep %}

{% step %}

### 배송비 조회

화면에서 주문배송지가 변경될 때마다 배송비를 재조회합니다.
{% endstep %}

{% step %}

### 혜택정보 조회

혜택 팝업에서 노출하기 위한 사용 가능한 혜택 정보를 조회합니다. (프로모션 문서 참조)
{% endstep %}

{% step %}

### 적립정보 조회

화면에서 혜택이 변경될 때마다 적립정보를 재조회합니다.
{% endstep %}

{% step %}

### 주문번호 채번

주문 생성을 위한 주문번호를 채번합니다.
{% endstep %}

{% step %}

### 결제정보 조회

결제 인증에 필요한 PG 정보, 가맹점 정보 등을 조회합니다. (결제 문서 참조)
{% endstep %}

{% step %}

### 주문하기

화면에서 선택한 주문정보를 바탕으로 주문생성을 합니다. 주문생성 성공 시 주문자에게 알림톡과 메일을 발송합니다.
{% endstep %}

{% step %}

### 주문 완료정보 조회

주문완료 페이지를 노출하기 위한 주문완료정보를 조회합니다.
{% endstep %}
{% endstepper %}

### API 기능 목록

<table><thead><tr><th width="117.888916015625">API</th><th width="252.4444580078125">설명</th><th width="95.77783203125">Server</th><th width="92">메소드</th><th>비고</th></tr></thead><tbody><tr><td>주문서 진입 검증</td><td><ul><li>주문서 진입 시 사용자 검증을 진행합니다.</li></ul></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%EC%84%9C&#x26;path=validateOrderSheet">🔗API 확인하기></a></td></tr><tr><td>주문서 조회</td><td><ul><li>주문서 정보를 조회합니다.</li><li>주문서 정보에는 회원, 결제수단, 주문상품, 배송, 프로모션, 적립 정보들이 포함됩니다.</li></ul></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%EC%84%9C&#x26;path=order">🔗API 확인하기></a> 1)회원 정보 조회 /api/member/v1/front/memberInfo 2)비회원 정보 조회 /api/member/v1/front/nonMemberInfo 3)회원 기본배송지 조회 /api/member/v1/front/dlvpInfo 4)상품별 사용가능 결제수단 조회 /api/goods/v1/detail/goodsPayMeanList</td></tr><tr><td>주문서 <br>사은행사 <br>조회</td><td><ul><li>주문 상품 정보를 이용하여 사은행사를 조회합니다. </li><li>사은 행사가 존재할 경우, <br>결제하기 이전에 해당 <br>사은 행사 정보를 포함하는 팝업을 노출합니다.</li></ul></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%EC%84%9C&#x26;path=getAeEvtList">🔗API 확인하기></a></td></tr><tr><td>주문서 <br>배송비 조회</td><td><ul><li>주문 정보에 대한 배송비를 조회합니다.</li></ul></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%EC%84%9C&#x26;path=getDeliveryAmountChangeDeliveryPlace">🔗API 확인하기></a></td></tr><tr><td>주문서 적립정보 조회</td><td><ul><li>주문 정보에 대한 적립 정보를 조회합니다.</li></ul></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%EC%84%9C&#x26;path=getAccumulationInfo">🔗API 확인하기></a></td></tr><tr><td>주문번호 <br>채번</td><td><ul><li>주문 생성 정보에 필요한 <br>주문번호를 채번합니다.</li></ul></td><td>Order</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EC%84%9C&#x26;path=getNextOrdNo">🔗API 확인하기></a></td></tr><tr><td>주문하기</td><td><ul><li>주문을 생성합니다. 주문에 성공하면 주문자에게 알림톡과 메일을 발송합니다.</li></ul></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%EC%84%9C&#x26;path=order">🔗API 확인하기></a> 1)회원 정보 조회 /api/member/v1/front/memberInfo 2)임직원할인한도 업데이트 /api/member/v1/staff/dcLimIncDec 3)상품 재고 업데이트 /api/goods/v1/order/stockUpdate</td></tr><tr><td>주문완료정보 조회</td><td><ul><li>주문 성공 후 주문완료 정보를 조회합니다. </li><li>조회 요청한 주문에 <br>클레임이 진행되었다면 <br>예외가 발생합니다.</li></ul></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%EC%84%9C&#x26;path=getOrderCompleteInfo">🔗API 확인하기></a></td></tr></tbody></table>

### 용어 정의

<table><thead><tr><th width="96.2222900390625">명칭</th><th>설명</th><th data-hidden>비고</th></tr></thead><tbody><tr><td>배송그룹</td><td>상품의 상품번호, 합배송 가능여부, 협력사번호, 배송정책번호, 판매방식, 배송방식, 배송예약일시, 출고예정일시 등 정보를 기준으로 함께 배송이 가능한 상품의 집합입니다. <br>이 집합 별로 배송비를 계산합니다.</td><td></td></tr><tr><td>합배송</td><td>주문서 내의 여러 개의 상품을 배송그룹 별로 배송하는 방식</td><td></td></tr></tbody></table>

### 기타 참고사항

* 배송비를 조회하기 전 상품 별 상세 정보를 이용하여 배송 그룹을 생성합니다.\
  (합배송 가능여부, 협력사번호, 배송정책번호, 판매방식, 배송방식, 상품번호, 배송예약일시, 출고예정일시)
* 주문완료정보 조회 API 요청 시 비회원 주문의 경우 비회원 로그인 처리 API를 통해 생성된 쿠키 값을 필수로 전달해야 합니다.