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

# 주문 클레임 처리

회원ID/명, 휴대폰번호, 주문번호에 해당하는 고객 정보 및 주문 목록을 조회하여 주문 클레임 처리를 지원합니다.

***

## 주요 기능

* **고객 목록 조회:**
  * 회원ID/명, 휴대폰번호, 주문번호에 해당하는 고객 목록을 조회합니다.
  * 비회원의 경우 회원ID/명 입력 후 조회 시 조회되지 않습니다.
  * 주문을 하지 않은 고객은 조회되지 않습니다.
* **주문 목록 조회:**
  * 선택한 고객의 mbrNo(회원번호), cellNo(휴대폰번호) 조건에 일치하는 주문 목록을 조회합니다.
* **주문 상세 정보 조회:**
  * 선택한 주문 row의 주문정보와 회원정보, 결제/환불 정보, 주문상품 내역을 조회합니다.
* **주문상품 상세 정보 조회:**
  * 선택한 주문상품 row의 배송정보, 반품/회수 정보, 상품 정보, 협력사 정보를 조회합니다.

***

## 프로세스 정의

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

{% stepper %}
{% step %}

### 고객 목록 조회

검색 조건에 해당하는 고객 목록을 조회합니다.
{% endstep %}

{% step %}

### 주문 내역 조회

선택한 고객 정보와 일치하는 주문 내역을 조회합니다.
{% endstep %}

{% step %}

### 주문 상세 내역 조회

선택한 주문의 주문정보와 주문자 정보를 조회하여, 주문번호에 따른 다음과 같은 상세 내역을 조회할 수 있습니다.

* 결제 상세 / 결제수단 / 프로모션적용 내역
  {% endstep %}

{% step %}

### 상품 내역 조회

주문번호에 해당하는 주문 상품 내역을 조회하여 주문번호에 따른 다음과 같은 상세 내역을 조회할 수 있습니다.

* 배송정보 / 반품 / 회수정보 내역
* 상품 번호와 일치하는 상품 정보 및 협력사 정보
  {% endstep %}
  {% endstepper %}

***

## API 기능 목록

<table><thead><tr><th width="126.77783203125">API</th><th width="267.22216796875">설명</th><th width="93.5556640625">Server</th><th width="92.22216796875">메소드</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=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%ED%81%B4%EB%A0%88%EC%9E%84%EC%B2%98%EB%A6%AC&#x26;path=getOrdClmProcMbrInfoList">🔗API 확인하기 ></a></td></tr><tr><td>주문내역 조회</td><td>선택한 고객 정보와 일치하는 주문 내역을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://beta-venus-api-bo.x2bee.com/api/bo/swagger-ui/index.html">🔗API 확인하기 ></a></td></tr><tr><td>주문정보 및 회원정보 조회</td><td>선택한 주문의 주문정보와 주문자 정보를 조회합니다. 보유한 쿠폰 개수 조회 /api/order/v1/marketing/mbrCpnCnt 보유한 마일리지 조회 /api/member/v1/mileage/mlgBalAmtInfo</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%ED%81%B4%EB%A0%88%EC%9E%84%EC%B2%98%EB%A6%AC&#x26;path=getOrdClmProcOrdMbrInfo">🔗API 확인하기 ></a></td></tr><tr><td>결제 상세 <br>정보 조회</td><td>주문번호에 해당하는 결제 상세 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%ED%81%B4%EB%A0%88%EC%9E%84%EC%B2%98%EB%A6%AC&#x26;path=getOrdClmProcPayDtlInfo">🔗 API 확인하기 ></a></td></tr><tr><td>결제 수단 <br>정보 조회</td><td>주문번호에 해당하는 결제수단 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%ED%81%B4%EB%A0%88%EC%9E%84%EC%B2%98%EB%A6%AC&#x26;path=getOrdClmProcPayWayInfoList">🔗 API 확인하기 ></a></td></tr><tr><td>프로모션 정보 조회</td><td>주문번호에 해당하는 사용한 프로모션(쿠폰, 할인, 적립마일리지)를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%ED%81%B4%EB%A0%88%EC%9E%84%EC%B2%98%EB%A6%AC&#x26;path=getOrdClmProcPromotionInfo">🔗 API 확인하기 ></a></td></tr><tr><td>주문상품 내역 조회</td><td>주문번호에 해당하는 주문 상품 내역을 조회합니다. 상품 정보 조회: /api/goods/v1/detail/goods 배송비 정책 조회: /api/goods/v1/delivery/deliProcInfo 협력사 정보 조회: /api/goods/v1/vendor/list</td><td>BO</td><td>GET</td><td><a href="https://beta-venus-api-bo.x2bee.com/api/bo/swagger-ui/index.html">🔗 API 확인하기 ></a></td></tr><tr><td>배송 상세 및 반품/회수 정보 조회</td><td>주문번호에 해당하는 배송정보, 반품, 회수정보 내역을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%ED%81%B4%EB%A0%88%EC%9E%84%EC%B2%98%EB%A6%AC&#x26;path=getOrdClmProcDeliRtnInfo">🔗 API 확인하기 ></a></td></tr><tr><td>상품 정보 및 협력사 정보 조회</td><td>상품 번호와 일치하는 상품 정보와 상품 협력사 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%ED%81%B4%EB%A0%88%EC%9E%84%EC%B2%98%EB%A6%AC&#x26;path=getOrdClmProcGoodsEntrInfo">🔗 API 확인하기 ></a></td></tr></tbody></table>

***

## 기타 참고사항

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

***