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

# Order Sheet

Provides order sheet management features that let users create orders and complete payment. Order sheets are classified according to various situations and conditions, and support a smooth ordering process by validating and retrieving various information such as the user's request information, product, delivery, and payment details.

***

### Key Features

* **Order Sheet Entry and Validation**
  * The order sheet can be entered from the product detail page or the cart screen, and only members aged 15 or older, or non-members who have passed verification, can access the order sheet.
* **Various Order Sheet Types**
  * By order type, there are general orders and gifting order sheets, and by member information, they are classified into member orders and non-member order sheets.
* **Order Information Lookup and Validation**
  * When first entering the order sheet, the orderer's age, member status for gifting orders, and verification status for non-member orders are validated.
* **Benefit and Payment Information Lookup**
  * Among the payment methods available for each ordered product, duplicate methods are classified, and the information required for the payment method is retrieved and displayed.
* **Delivery Fee and Delivery Group Management**
  * Delivery groups are divided according to each product's delivery information to look up delivery fees, and additional delivery fees may be charged depending on whether the delivery address is a remote island/mountainous area.
* **Gift Promotion and Benefit Lookup**
  * For member order sheets, if a gift promotion exists, a gift promotion popup is displayed before payment, and the available benefit information and maximum benefit information are retrieved in the coupon and benefit popup.
* **Order Creation and Completion**
  * After validating the required values needed for order creation and issuing an order number, once the authentication process required for payment is complete, the order creation API is called to complete the order.
  * If the order succeeds, the order completion information lookup API is called on the order completion page to display the order information to the user.

### Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FUVzu59wJBHSx6HNxeR1l%2Fimage.png?alt=media&#x26;token=a60779b8-fcad-4b43-b547-0de09ff9320a" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Order Sheet Validation

Users can enter the order sheet from the product detail or cart screen. Upon entering the order sheet, the request information, the orderer's age, the user's member status for gifting orders, and verification status for non-member orders are validated.
{% endstep %}

{% step %}

### Order Sheet Lookup

Member, payment method, order product, delivery, promotion, and accumulation information are divided into order sheet information needed to display the order sheet and order creation information needed to create the order, and delivered accordingly.
{% endstep %}

{% step %}

### Order Sheet Gift Promotion Lookup

Retrieves gift promotion information for the ordered product, and if a gift promotion exists, displays the gift promotion popup before payment.
{% endstep %}

{% step %}

### Delivery Fee Lookup

Re-retrieves the delivery fee whenever the order delivery address is changed on the screen.
{% endstep %}

{% step %}

### Benefit Information Lookup

Retrieves the available benefit information to display in the benefit popup. (See the Promotion document.)
{% endstep %}

{% step %}

### Accumulation Information Lookup

Re-retrieves the accumulation information whenever the benefit is changed on the screen.
{% endstep %}

{% step %}

### Order Number Issuance

Issues an order number for order creation.
{% endstep %}

{% step %}

### Payment Information Lookup

Retrieves the PG information, merchant information, etc. needed for payment authentication. (See the Payment document.)
{% endstep %}

{% step %}

### Place Order

Creates the order based on the order information selected on the screen. If order creation succeeds, a notification (AlimTalk) and email are sent to the orderer.
{% endstep %}

{% step %}

### Order Completion Information Lookup

Retrieves the order completion information to display on the order completion page.
{% endstep %}
{% endstepper %}

### API Function List

<table><thead><tr><th width="117.888916015625">API</th><th width="252.4444580078125">Description</th><th width="95.77783203125">Server</th><th width="92">Method</th><th>Remarks</th></tr></thead><tbody><tr><td>Order Sheet Entry Validation</td><td><ul><li>Performs user validation when entering the order sheet.</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">🔗View API ></a></td></tr><tr><td>Order Sheet Lookup</td><td><ul><li>Retrieves order sheet information.</li><li>Order sheet information includes member, payment method, order product, delivery, promotion, and accumulation information.</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">🔗View API ></a> 1) Member information lookup /api/member/v1/front/memberInfo 2) Non-member information lookup /api/member/v1/front/nonMemberInfo 3) Member default delivery address lookup /api/member/v1/front/dlvpInfo 4) Available payment methods by product lookup /api/goods/v1/detail/goodsPayMeanList</td></tr><tr><td>Order Sheet<br>Gift Promotion<br>Lookup</td><td><ul><li>Retrieves gift promotions using the ordered product information.</li><li>If a gift promotion exists,<br>a popup containing the gift<br>promotion information is displayed before payment.</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">🔗View API ></a></td></tr><tr><td>Order Sheet<br>Delivery Fee Lookup</td><td><ul><li>Retrieves the delivery fee for the order information.</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">🔗View API ></a></td></tr><tr><td>Order Sheet Accumulation Information Lookup</td><td><ul><li>Retrieves accumulation information for the order information.</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">🔗View API ></a></td></tr><tr><td>Order Number<br>Issuance</td><td><ul><li>Issues the order number<br>needed for order creation information.</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">🔗View API ></a></td></tr><tr><td>Place Order</td><td><ul><li>Creates the order. If the order succeeds, a notification (AlimTalk) and email are sent to the orderer.</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">🔗View API ></a> 1) Member information lookup /api/member/v1/front/memberInfo 2) Employee discount limit update /api/member/v1/staff/dcLimIncDec 3) Product stock update /api/goods/v1/order/stockUpdate</td></tr><tr><td>Order Completion Information Lookup</td><td><ul><li>Retrieves order completion information after a successful order.</li><li>An exception occurs if a claim<br>has been processed for the requested order.</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">🔗View API ></a></td></tr></tbody></table>

### Terminology

<table><thead><tr><th width="96.2222900390625">Term</th><th>Description</th><th data-hidden>Remarks</th></tr></thead><tbody><tr><td>Delivery Group</td><td>A set of products that can be delivered together, grouped based on information such as product number, combined-delivery eligibility, partner number, delivery policy number, sales method, delivery method, scheduled delivery date/time, and expected shipping date/time.<br>Delivery fees are calculated per group.</td><td></td></tr><tr><td>Combined Delivery</td><td>A method of delivering multiple products within an order sheet by delivery group</td><td></td></tr></tbody></table>

### Other Notes

* Before looking up delivery fees, delivery groups are created using each product's detailed information.\
  (Combined-delivery eligibility, partner number, delivery policy number, sales method, delivery method, product number, scheduled delivery date/time, expected shipping date/time)
* When requesting the order completion information lookup API for a non-member order, the cookie value generated through the non-member login processing API must be passed as a required parameter.