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

# 주문 취소

고객이 주문한 상품 중 주문 취소 기능을 제공합니다. 이 기능을 통해 고객은 주문한 상품 중 일부 또는 전체를 취소할 수 있으며, 취소 사유 및 수량을 선택할 수 있습니다. 클레임 귀책 사유에 따라 추가 결제 또는 환불이 이뤄지며, 쿠폰이 복원되고 취소한 상품의 수량만큼 재고가 복원됩니다. 이와 함께, 취소 완료 안내를 위한 메일 및 메시지가 발송됩니다.

***

## 주요 기능

* **주문 상품 취소**
  * 주문한 상품 중 취소가 가능한 대상을 확인하고, 취소할 상품 및 수량을 선택할 수 있습니다.
* **취소 사유 선택**
  * 클레임 귀책 사유에 따라 취소 사유를 선택할 수 있습니다.
* **추가 결제 또는 환불 처리**
  * 귀책 사유와 배송비 정책에 따라 결제 또는 환불이 처리됩니다.
* **쿠폰 복원 및 재고 복원**
  * 취소한 상품에 적용된 쿠폰이 있다면 복원되며, 취소한 상품의 수량만큼 재고가 복원됩니다.
* **안내 메일 및 메시지 발송**
  * 취소가 완료되면 고객에게 안내 메일 및 메시지가 발송됩니다.

## 프로세스 정의

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

{% stepper %}
{% step %}

### 주문 취소 대상 조회

사용자는 주문목록 또는 주문상세 페이지를 통하여 주문을 취소 할 수 있습니다. 주문한 상품 중 취소가 가능한 상품만을 조회하여 주문 취소 팝업에 노출됩니다.
{% endstep %}

{% step %}

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

\[클레임공통] 취소 상품 및 수량을 선택한 뒤 다음 단계에서 취소 사유를 선택하면 클레임 귀책 사유와 초도배송비 부과 정책을 기준으로, 결제 또는 환불 비용을 조회합니다.
{% endstep %}

{% step %}

### 주문 취소

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

{% step %}

### 선물하기 주문 취소

배치 프로그램에 의해서 선물하기 주문의 수락 기한이 만료된 주문을 취소 처리합니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="110.3333740234375">API</th><th width="360.1112060546875">설명</th><th width="92.4444580078125">Server</th><th width="89.111083984375">메소드</th><th>비고</th></tr></thead><tbody><tr><td>주문 취소 대상 조회(FO)</td><td>주문한 상품 중 취소가 가능한 대상 상품들을 조회해 옵니다.<br>취소 사유 대분류와 중분류 사유를 조회합니다.</td><td>Order</td><td>POST</td><td><p><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EC%B7%A8%EC%86%8C&#x26;path=getOrderCancelPopupInfoFO">🔗API 확인하기></a></p><p>공통 코드 조회 API 호출(/api/common/v1/common/getGrpCdList)</p></td></tr><tr><td>주문 취소(FO)</td><td>주문취소 데이터 생성 및 사유에 따라 발생하는 환불/결제 를 진행 합니다. 쿠폰복원 또는 재고복원이 이루어 지며, 고객에게 주문 취소 알림을 발송합니다.</td><td>Order</td><td>POST</td><td><p><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EC%B7%A8%EC%86%8C&#x26;path=cancelOrderFO">🔗API 확인하기></a></p><p>회원 임직원 할인한도 업데이트 API 호출(v1/staff/dcLimIncDec)</p><p>상품 재고 업데이트 API 호출(v1/order/stockUpdate)</p><p>공통 이메일 발송 API 호출(/api/common/interface/bizmessage/sendmail)</p><p>공통 메시지 발송 API 호출(/api/common/v1/common/sendMessageList)</p></td></tr><tr><td>클레임 비용 계산 조회(FO)</td><td>주문취소 시 발생되는 부가비용, 혜택정보, 추가결제 또는 환불 예정 정보를 조회합니다.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5&#x26;path=calculateFO">🔗API 확인하기></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="124">명칭</th><th>설명</th><th data-hidden></th></tr></thead><tbody><tr><td>귀책 사유</td><td>클레임을 발생케 한 책임의 원인</td><td></td></tr><tr><td>쿠폰 복원</td><td>주문 시에 사용한 쿠폰을 재 발급 처리하는 기능</td><td></td></tr><tr><td>재고 복원</td><td>주문 시에 차감된 상품의 재고를 차감 이전의 상태로 처리하는 기능</td><td></td></tr></tbody></table>

## 기타 참고사항

* 동일한 배송그룹에 한해서 주문 취소가 동시 접수 가능합니다.
* 부분 결제 취소가 가능한 주문의 경우에만 부분 취소가 가능합니다.
* 주문 취소 가능한 주문내역상태코드와 주문내역구분코드는 공통코드로 관리합니다.
  * ST007(FO시스템 클레임처리 가능상태) 참조 1값 = 주문내역상태코드
  * ST007(FO시스템 클레임처리 가능상태) 참조 2값 = 주문내역구분코드
* 배송 지시 상태 이후 취소 처리시에는 배송지시수량을 업데이트 합니다.
* 임직원 주문의 경우, 할인 한도 금액을 업데이트 합니다.
* 쿠폰이 적용된 상품이 모두 취소 되었을 경우에만 쿠폰을 복원합니다.
* 선물수락 기한일수는 공통코드로 관리합니다.
  * ST006(클레임가능일수) 코드 30 참조1값

##