> 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>