> 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/back-office/order-bo/undefined-3.md).

# 상담원 주문

고객 상담원이 회원으로 등록된 고객을 대상으로 주문을 생성하는 서비스로, 특정 제약사항이 적용됩니다.

## 주요 기능

* **회원 정보 확인**
  * 주문자 정보에서 특정 회원을 선택하면 해당 회원의 가용 마일리지를 조회하여 표시합니다.
* **상품 및 옵션 정보**
  * 상품을 선택하면 해당 상품의 단품 옵션 정보를 API 호출하여 표시합니다.
* **주문상품 확정**
  * 주문상품을 확정하면 상품 상세 조회 API를 호출하여 주문상품 정보를 설정합니다.
* **배송정보 설정**
  * 배송지를 확정하면 배송비 조회 API 및 적립정보 조회 API를 호출하여 주문배송 정보와 적립 정보를 설정합니다.
* **주문 생성**
  * 주문 시 필수 값 검증 후 주문번호 채번 API를 호출하여 주문번호를 생성하고, 주문 생성 API를 호출하여 주문을 완료합니다.
* **알림 발송**
  * 주문 성공 시 주문자에게 알림톡과 알림 메일을 발송합니다.

## 프로세스 정의

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

{% stepper %}
{% step %}

### 가용 마일리지 조회

주문자 정보 선택 시 해당 회원의 가용 마일리지를 조회합니다.
{% endstep %}

{% step %}

### 주문상품 단품 옵션 조회

상품 선택 시 해당 상품의 옵션 정보를 조회합니다.
{% endstep %}

{% step %}

### 주문상품 상세 조회

주문 상품 확정 시 상품의 상세 정보를 조회합니다.
{% endstep %}

{% step %}

### 배송비 조회

배송지 선택 시 배송비를 조회합니다.
{% endstep %}

{% step %}

### 적립 정보 조회

주문 및 배송지 정보 확정 시 적립 정보를 조회합니다.
{% endstep %}

{% step %}

### 주문번호 채번

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

{% step %}

### 주문하기

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

## API 기능 목록

<table><thead><tr><th width="129">API</th><th width="332.888916015625">설명</th><th width="94.6666259765625">Server</th><th width="89.1112060546875">메서드</th><th>비고</th></tr></thead><tbody><tr><td>가용 마일리지 조회</td><td>주문서에서 회원 정보 선택 시 해당 회원의 가용 마일리지를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%83%81%EB%8B%B4%EC%9B%90%20%EC%A3%BC%EB%AC%B8&#x26;path=getAvailableMileageAmount">🔗API 확인하기 ></a></td></tr><tr><td>주문상품 단품 옵션 조회</td><td>주문서에서 상품 선택 시 해당 상품의 단품 옵션을 조회합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%83%81%EB%8B%B4%EC%9B%90%20%EC%A3%BC%EB%AC%B8&#x26;path=getItemInfo">🔗API 확인하기 ></a></td></tr><tr><td>주문상품 상세 조회</td><td>주문서에서 상품선택 완료 시 상품의 상세 정보를 조회합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%83%81%EB%8B%B4%EC%9B%90%20%EC%A3%BC%EB%AC%B8&#x26;path=getGoodsDetailInfo">🔗API 확인하기 ></a></td></tr><tr><td>주문서 배송비 조회</td><td>주문서에서 배송지 선택 시 배송비 정보를 조회합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%83%81%EB%8B%B4%EC%9B%90%20%EC%A3%BC%EB%AC%B8&#x26;path=getDeliveryAmountInfo">🔗API 확인하기 ></a></td></tr><tr><td>주문서 적립정보 조회</td><td>주문 정보에 맞는 적립 정보를 조회합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%83%81%EB%8B%B4%EC%9B%90%20%EC%A3%BC%EB%AC%B8&#x26;path=getAccumulationInfo">🔗API 확인하기 ></a></td></tr><tr><td>주문번호 채번</td><td>주문 생성 정보에 필요한 주문번호를 채번합니다.</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%83%81%EB%8B%B4%EC%9B%90%20%EC%A3%BC%EB%AC%B8&#x26;path=getOrderNo">🔗API 확인하기 ></a></td></tr><tr><td>주문하기</td><td>주문을 생성합니다. 주문에 성공하면 주문자에게 알림톡과 메일을 발송합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%83%81%EB%8B%B4%EC%9B%90%20%EC%A3%BC%EB%AC%B8&#x26;path=order">🔗API 확인하기 ></a></td></tr></tbody></table>

## 용어 정의

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

## 기타 참고 사항

* 배송비를 조회하기 전 상품 별 상세 정보를 이용하여 배송 그룹을 생성합니다.\
  (합배송 가능여부, 협력사 번호, 배송정책 번호, 판매방식, 배송방식, 상품 번호, 배송예약일시, 출고예정일시)