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

# 주문취소

주문한 상품에 대한 취소 기능을 제공합니다. 이를 통해 취소 가능한 대상을 조회하고 필요한 정보를 제공하여 고객이 주문을 취소할 수 있습니다.

***

## 주요 기능

* **주문 취소 기능 제공**
  * 주문한 상품을 간편하게 취소할 수 있는 기능을 제공합니다.
  * 취소 가능한 대상을 확인하고 취소할 상품과 수량을 선택할 수 있습니다.
* **취소 사유와 배송비에 따른 안내**
  * 취소 사유와 배송비 정책에 따라 추가 결제 금액이 발생할 수 있습니다.
  * 다만, 추가 결제가 발생하는 경우 고객이 직접 취소할 수 있습니다.
* **환불 처리**
  * 취소된 주문금액을 환불합니다.
  * 주문 시 사용된 쿠폰을 복원하고 차감된 재고를 원복합니다.
* **안내 메일 및 메시지 발송**
  * 취소 완료 시 고객에게 안내를 위한 메일 및 메시지(알림톡/알림함)를 발송합니다.

## 프로세스 정의

<figure><img src="/files/0RodyCZv62dlB0usaWN7" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 주문취소 내역 조회

선택 및 입력된 검색 조건에 부합하는 주문 취소 내역을 조회합니다.
{% endstep %}

{% step %}

### 주문 취소 팝업 정보 조회

주문 한 상품 중 취소가 가능한 상품 목록을 조회하여 주문 취소 팝업에 노출합니다.
{% endstep %}

{% step %}

### 클레임 비용 계산 조회

주문 취소 시 발생하는 결제 금액과 환불 예정 금액, 환불 수단 정보를 조회합니다.
{% endstep %}

{% step %}

### 주문 취소 처리(BO)

선택한 상품의 주문을 취소합니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="104.5556640625" valign="top">API</th><th width="305.5555419921875" valign="top">설명</th><th width="102.4443359375" valign="top">Server</th><th width="89.111083984375" valign="top">메소드</th><th>비</th></tr></thead><tbody><tr><td valign="top">주문 취소 팝업 정보 조회(BO)</td><td valign="top">주문한 상품 중 취소가 가능한 대상을 조회합니다.<br>주문 취소 진행 시 필요한 주문정보 및 공통코드를 조회합니다.</td><td valign="top">BO</td><td valign="top">POST</td><td><p><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EC%B7%A8%EC%86%8C&#x26;path=getOrderCancelPopupInfo">🔗API 확인하기 ></a></p><ol start="1"><li>주문(Order) 주문 취소 대상 조회(BO) API 호출</li></ol><p>(/api/order/v1/claim/orderCancel/cancelPopup)</p></td></tr><tr><td valign="top">주문취소 내역 조회</td><td valign="top">조건에 부합하는 주문 취소 내역을 조회합니다.</td><td valign="top">BO</td><td valign="top">POST</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EC%B7%A8%EC%86%8C&#x26;path=getOrderCancelList">🔗API 확인하기 ></a></td></tr><tr><td valign="top">주문 취소 처리(BO)</td><td valign="top">주문을 취소 합니다. 취소 사유에 따라 추가 결제 금액이 발생할 수 있으며, 이 경우 주문취소 진행이 불가합니다. (고객 직접 취소만 가능) 주문 시 사용한 쿠폰을 복원하고, 차감된 재고를 원복 합니다. 주문 금액을 환불합니다. 주문 취소 완료 후 고객에게 알림을 발송합니다.</td><td valign="top">BO</td><td valign="top">POST</td><td><p></p><p><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EC%B7%A8%EC%86%8C&#x26;path=cancelOrder">🔗API 확인하기 ></a></p><ol start="1"><li>주문(Order) 주문취소(BO) API 호출 (/api/order/v1/claim/orderCancel/cancel)</li></ol></td></tr><tr><td valign="top">클레임<br>비용 계산 조회</td><td valign="top">클레임 업무 별 부가비용, 혜택정보, 추가 결제/환불 예정 금액 및 쿠폰 사용/복원 정보를 제공합니다.</td><td valign="top">BO</td><td valign="top">POST</td><td></td></tr></tbody></table>

## 기타 참고사항

* 동일한 배송그룹에 한해서 주문 취소가 가능합니다.
* 주문 취소 가능한 주문내역상태코드와 주문내역구분코드는 공통코드로 관리합니다.\
  : ST007(FO시스템 클레임처리 가능상태) 참조 1값 = 주문내역상태코드:\
  &#x20;ST007(FO시스템 클레임처리 가능상태) 참조 2값 = 주문내역구분코드
* 사은품이 있는 상품의 경우, 부분 수량 취소가 불가합니다.
* 주문 시 부분취소불가 결제수단을 사용한 경우, 전체 취소만 가능합니다.
* 주문 취소 시 추가 결제금액이 발생한 경우, 취소 접수가 불가합니다.
* 주문 시 사용된 쿠폰의 경우, 모든 적용 상품이 취소되는 경우에 한해 복원됩니다.
* 주문 시 차감된 상품의 재고는 취소 시 증감 처리 됩니다.
* 배송 지시 상태 이후 취소 처리시에는 배송지시수량을 업데이트 합니다.
* 임직원 주문의 경우, 할인 한도 금액을 업데이트 합니다.
* 취소 목록 조회 시 파트너 접속 관리자의 경우, 해당 협력사의 접수 내역만 노출됩니다.