# 주문취소

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

***

## 주요 기능

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

## 프로세스 정의

<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">API-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">API-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">API-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">API-BO</td><td valign="top">POST</td><td></td></tr></tbody></table>

## 기타 참고사항

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


---

# Agent Instructions: 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/back-office/claim-bo/undefined.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.