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

# 주문조회

회원과 비회원을 위한 주문 조회 및 상세 정보 관리 기능을 제공합니다. 회원은 회원번호를 통해 주문 목록을 조회하고, 조회 기간 및 주문 상태에 따라 세부 옵션을 선택할 수 있습니다. 비회원은 주문 번호와 비밀번호로 주문 상세를 조회할 수 있습니다. 주문 관리는 효율적으로 이뤄지며, 클레임에 대한 버튼 제어는 공통 코드(ST007)를 통해 이뤄집니다.

***

## 주요 기능

* **주문 목록 조회**
  * 회원번호에 해당하는 주문 목록을 조회하며, 비회원의 경우 주문 상세 조회만 가능합니다.
* **조회 기간 및 주문 상태 설정**
  * 조회 시작일시와 종료일시 사이의 주문 목록을 조회하며, 주문현황 구분코드를 통해 모든 주문이나 취소/교환/반품에 대한 목록을 조회합니다.
* **주문 상세 조회**
  * 주문 상세는 주문번호에 해당하는 주문 상품 정보, 결제정보, 적립마일리지, 환불정보 등을 제공합니다.
* **비회원 주문 조회 및 상세 조회**
  * 비회원은 주문번호와 비밀번호로 주문 상세를 조회할 수 있습니다. 비회원 로그인 처리는 해당 주문이 존재하며, 비밀번호가 유효한 경우에 성공하며, 주문번호와 비회원 비밀번호 쿠키 정보를 세팅합니다.
* **주문 내역 관리**
  * 주문 내역 조회, 옵션 및 배송지 변경, 취소, 교환, 반품 접수, 배송비 결제가 가능합니다.
* **클레임 버튼 제어**
  * 클레임에 대한 버튼 제어는 공통 코드(ST007)를 통해 이뤄집니다.

## 프로세스 정의

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

{% stepper %}
{% step %}

### 주문 목록 조회

회원인 경우 마이페이지 > 주문내역을 통해 주문목록을 조회할 수 있습니다.
{% endstep %}

{% step %}

### 비회원 로그인

비회원 주문조회에서 주문번호와 비밀번호 입력 후 일치하는 주문이 있는지 조회 후 있으면 주문번호, 비밀번호를 쿠키에 셋팅 해줍니다.
{% endstep %}

{% step %}

### 주문내역 상세 조회

회원의 경우 주문 목록에서 주문 번호 클릭 시 주문내역 상세 조회로 이동합니다. 비회원의 경우 비회원 로그인 처리가 완료된 후 주문내역 상세 화면으로 이동합니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="99.0001220703125">API</th><th width="359.77783203125">설명</th><th width="93.5555419921875">Server</th><th width="91.3333740234375">매소드</th><th>비고</th></tr></thead><tbody><tr><td>주문내역 조회</td><td>회원번호에 해당하는 주문 목록을 조회합니다.</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%A1%B0%ED%9A%8C&#x26;path=orderInfoList">🔗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%A3%BC%EB%AC%B8%EC%A1%B0%ED%9A%8C&#x26;path=orderDetailInfoList">🔗API 확인하기></a></td></tr><tr><td>비회원 <br>로그인</td><td>비회원 주문조회시 주문 유효성 검사 후 비회원 쿠키 정보를 생성합니다.</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%A1%B0%ED%9A%8C&#x26;path=nonMemberLoginProcess">🔗API 확인하기></a></td></tr></tbody></table>

## 기타 참고사항

* 모든 클레임 버튼은 공통코드로 관리합니다.\
  &#x20;ST007(FO 시스템 클레임처리 가능상태) 참조 1값(주문내역상태코드: OM005), 참조2값(주문내역구분코드: OM003)
* Ex) 배송지 변경 버튼 노출의 경우 참조1값이 12,21(OM005 : 주문완료(12), 배송지시(21)) , 참조2값이 10(OM003 : 주문완료) 인 경우만 가능합니다.
* 상태에 따른 버튼 노출 기준표

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api-guide/store-front/order/undefined-5.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.