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

# 반품

주문 반품처리 API는 반품 관련 클레임 대상을 조회하고, BO의 요청에 해당하는 클레임을 처리합니다. 이 API를 통해 접수된 반품 목록을 제공하며, 반품 처리에 필요한 정보를 화면에 제공합니다.

***

## 주요 기능

* **반품 접수**
  * 상품의 반품을 고객이 신청하는 기능.
  * 주문 진행 상태(출고완료, 배송완료)에 따라 가능 여부 확인.
  * 반품 수량, 사유, 수거지 옵션 선택 가능.
  * 추가 결제 및 환불 정보 자동 계산.
  * 무료 반품 쿠폰 사용 가능.
* **반품 취소**
  * 반품 접수 상태에서 전체 취소 기능 제공.
  * 결제한 금액 환불 및 무료 반품 쿠폰 복원.
* **반품 완료**
  * 반품 접수 완료 상태에서 반품 처리 기능.
  * 주문 시 사용된 쿠폰 복원 및 상품 재고 원복.
  * 임직원 주문의 경우 할인 한도 금액 업데이트.
* **반품 불가**
  * 불량반품(20) 확인 후 반품 불가 처리.
  * 반품 불가 사유 수기 입력.
* **반품 보류**
  * 귀책으로 인한 반품 보류 처리 가능.
  * 추가 결제 시 무료 반품 쿠폰 사용 가능.
* **반품 전환**
  * 교환 상품 회수 후 반품 전환 가능.
  * 교환 접수 철회되며 결제 금액 환불.

***

## 프로세스 정의\_반품 접수 및 목록 조회

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

{% stepper %}
{% step %}

### 반품주문조회

선택 및 입력된 검색 조건에 부합하는 반품 접수 내역을 조회합니다.
{% endstep %}

{% step %}

### 반품접수 처리대상조회

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

{% step %}

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

관리자가 선택한 회수지, 반품 사유에 따른 추가 결제 금액, 반품 완료 후 환불 금액 및 수단 정보를 조회합니다.
{% endstep %}

{% step %}

### 배송 번호 채번 처리

반품 접수 시 사용될 회수지의 신규 배송번호를 발급합니다.
{% endstep %}

{% step %}

### 반품 접수

선택된 상품의 반품 접수를 진행합니다.
{% endstep %}
{% endstepper %}

***

## 프로세스 정의\_반품 철회

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

{% stepper %}
{% step %}

### 반품 철회대상 조회

철회 가능한 반품 접수 건을 모두 조회합니다.
{% endstep %}

{% step %}

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

반품 철회 시 환불 금액과 수단 정보를 조회합니다.
{% endstep %}

{% step %}

### 반품 철회

선택된 반품 접수 건을 철회합니다.
{% endstep %}
{% endstepper %}

***

## 프로세스 정의\_반품 완료

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

{% stepper %}
{% step %}

### 반품완료 처리대상 조회

반품 접수 건 중 반품 완료 처리가 가능한 대상을 조회합니다.
{% endstep %}

{% step %}

### 클레임 상세 내역 조회

반품 접수 처리 내역을 조회합니다.
{% endstep %}

{% step %}

### 반품완료

선택된 반품 접수 건을 완료 처리 합니다.
{% endstep %}
{% endstepper %}

***

## 프로세스 정의\_반품 불가

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

{% stepper %}
{% step %}

### 반품완료 처리대상 조회

반품 접수 건 중 반품 완료 처리가 가능한 대상을 조회합니다.
{% endstep %}

{% step %}

### 클레임 상세 내역 조회

반품 접수 처리 내역을 조회합니다.
{% endstep %}

{% step %}

### 반품완료

선택된 반품 접수 건을 완료 처리 합니다.
{% endstep %}
{% endstepper %}

***

## 프로세스 정의\_반품 전환

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

{% stepper %}
{% step %}

### 반품완료 처리대상 조회

반품 접수 건 중 반품 완료 처리가 가능한 대상을 조회합니다.
{% endstep %}

{% step %}

### 클레임 상세 내역 조회

반품 접수 처리 내역을 조회합니다.
{% endstep %}

{% step %}

### 반품완료

선택된 반품 접수 건을 완료 처리 합니다.
{% endstep %}
{% endstepper %}

***

## 프로세스 정의\_반품 보류

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

{% stepper %}
{% step %}

### 반품보류 처리대상조회

반품 접수 건 중 반품 보류 처리가 가능한 대상을 조회합니다.
{% endstep %}

{% step %}

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

반품 보류 시 추가 결제 금액 및 환불 예정 금액, 환불 수단 정보를 조회합니다.
{% endstep %}

{% step %}

### 반품보류

선택된 반품 접수 건을 보류 처리합니다.
{% endstep %}
{% endstepper %}

***

## API 기능 목록

<table><thead><tr><th width="97.888916015625">API</th><th width="297.5555419921875">설명</th><th width="93.555419921875">Server</th><th width="91.2222900390625">메소드</th><th>비고</th></tr></thead><tbody><tr><td>반품접수 처리대상조회</td><td>주문한 상품 중 반품이 가능한 대상을 모두 조회합니다.<br>반품 접수 진행 시 필요한 주문정보 및 공통코드를 조회합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=getReturnTransformPopupBaseInfo">🔗API 확인하기 ></a> 주문(Order) 반품접수 대상 조회(BO) API 호출 (/api/order/v1/claim/return/returnTargetInfo)</td></tr><tr><td>반품완료 처리대상조회</td><td>반품 접수된 주문 상품 중 반품 완료 처리가 가능한 대상을 모두 조회합니다.<br>반품 완료 진행 시 필요한 주문정보를 조회합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=getReturnCompletePopupBaseInfo">🔗API 확인하기 ></a> 주문(Order) 반품접수 대상 조회(BO) API 호출 (/api/order/v1/claim/return/returnTargetInfo)</td></tr><tr><td>반품불가 대상 조회</td><td>반품 접수된 주문 상품 중 반품 불가 처리가 가능한 대상을 모두 조회합니다.<br>반품 불가 진행 시 필요한 주문정보를 조회합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=getReturnRejectPopupInfo">🔗API 확인하기 ></a> 주문(Order) 반품접수 대상 조회(BO) API 호출 (/api/order/v1/claim/return/returnTargetInfo)</td></tr><tr><td>반품전환 처리대상조회</td><td>교환 접수된 주문 상품 중 반품 전환 처리가 가능한 대상을 모두 조회합니다.<br>반품 전환 진행 시 필요한 주문정보를 조회합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=getReturnTransformPopupBaseInfo">🔗API 확인하기 ></a> 주문(Order) 반품접수 대상 조회(BO) API 호출 (/api/order/v1/claim/return/returnTargetInfo)</td></tr><tr><td>반품보류 처리대상조회</td><td>반품 접수된 주문 상품 중 반품 보류 처리가 가능한 대상을 모두 조회합니다.<br>반품 보류 진행 시 필요한 주문정보를 조회합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=getReturnPendingPopupBaseInfo">🔗API 확인하기 ></a> 주문(Order) 반품접수 대상 조회(BO) API 호출 (/api/order/v1/claim/return/returnTargetInfo)</td></tr><tr><td>반품접수</td><td>선택된 상품의 반품접수를 진행합니다.<br>관리자가 지정한 상품 / 수량 / 회수지 / 반품 사유 / 쿠폰 사용 유무에 따라<br>비용 및 혜택을 재계산 하고 검증합니다.<br>반품 과정에서 추가로 발생한 금액이 있는 경우 결제대기 상태로 전환되며,<br>추후 고객에게 배송비 결제를 요청합니다.<br>무료 반품 쿠폰 사용시, 회수배송비는 제외되고, 쿠폰은 사용처리 됩니다.<br>반품 접수 완료 후 고객에게 배송비 결제 안내 알림을 발송합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=acceptReturn">🔗API 확인하기 ></a> 주문(Order) 반품접수(BO) API 호출 (/api/order/v1/claim/return/acceptReturn)</td></tr><tr><td>반품철회</td><td>반품 접수 건을 철회합니다.<br>반품접수시 결제한 비용을 환불합니다.<br>반품접수시 사용된 무료 반품쿠폰을 복원합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=acceptReturn">🔗API 확인하기 ></a> 주문(Order) 반품철회(BO) API 호출 (/api/order/v1/claim/return/withdrawalReturn)</td></tr><tr><td>반품불가</td><td>반품 접수 건을 철회하고, 재 반품이 불가하도록 상태를 변경합니다.<br>반품 접수 시 결제한 비용을 환불합니다.<br>반품 접수 시 사용된 무료 반품쿠폰을 복원합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=acceptReturn">🔗API 확인하기 ></a> 주문(Order) 반품불가(BO) API 호출 (/api/order/v1/claim/return/rejectReturn)</td></tr><tr><td>반품완료</td><td>회수 완료된 반품 접수 건을 완료 처리합니다.<br>주문 시 사용한 쿠폰 및 재고를 복원하고, 주문 금액을 환불합니다.<br>반품 완료 후 고객에게 알림을 발송합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=completeReturn">🔗API 확인하기 ></a> 주문(Order) 반품완료(BO) API 호출 (/api/order/v1/claim/return/completeReturn)</td></tr><tr><td>반품전환</td><td>교환 과정에서 회수된 상품을 당사 귀책으로 반품 접수합니다.<br>진행중인 교환은 철회하고, 교환 접수 시 발생한 금액에 대해 환불을 진행합니다.<br>교환 접수 시 차감된 재고를 복원합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=transformReturn">🔗API 확인하기 ></a> 주문(Order) 교환중 반품(BO) API 호출 (/api/order/v1/claim/return/transformReturn)</td></tr><tr><td>반품보류</td><td>당사 귀책으로 접수된 반품 상품이 회수 확인 과정에서 고객 귀책으로 판단된 경우,<br>귀책 사유에 의해 미 청구된 비용을 재계산하고, 접수 정보를 수정합니다.<br>재 계산 결과 추가 비용이 발생한 경우, 고객에게 배송비 결제를 요청합니다.<br>추가 비용 결제 없이 반품 진행이 가능한 경우, 회수완료 처리 합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=returnPending">🔗API 확인하기 ></a> 주문(Order) 반품보류(BO) API 호출 (/api/order/v1/claim/return/returnPending)</td></tr><tr><td>반품주문조회</td><td>조건에 부합하는 반품 접수 내역을 조회합니다.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=getReturnOrderList">🔗API 확인하기 ></a></td></tr><tr><td>클레임 비용 계산 조회</td><td>클레임 업무 별 부가비용, 혜택정보, 추가 결제/환불 예정 금액 및<br>쿠폰 사용/복원 정보를 제공합니다.</td><td>BO</td><td>POST</td><td><a href="/pages/8661137bb88f27d8bdd564a79ca1b98672079971">클레임 공통 API</a></td></tr><tr><td>배송 번호 채번 처리</td><td>클레임 업무 처리 시 필요한 신규 배송번호를 채번합니다.</td><td>BO</td><td>POST</td><td><a href="/pages/8661137bb88f27d8bdd564a79ca1b98672079971">클레임 공통 API</a></td></tr><tr><td>클레임 상세 내역 조회</td><td>클레임 상세 내역을 조회합니다.<br>주문 정보, 클레임 대상 정보, 환불/결제 내용, 복원예정 쿠폰, 배송지 정보를 제공합니다.</td><td>BO</td><td>POST</td><td><a href="/pages/8661137bb88f27d8bdd564a79ca1b98672079971">클레임 공통 API</a></td></tr><tr><td>반품/교환 철회대상 조회</td><td>반품, 교환 접수 건 중 철회가 가능한 대상을 조회합니다.</td><td>BO</td><td>POST</td><td><a href="/pages/f03bd08394360871dfb46e23e4d975407f2cf2fd">주문 교환</a></td></tr></tbody></table>

***

## 기타 참고사항

* 동일 배송그룹에 한해 반품 접수가 가능합니다.
* 반품 접수 및 취소 시 처리 가능 주문내역상태와 주문내역구분 값을 확인합니다. 해당 정보는 공통코드로 관리됩니다.\
  → ST007(FO시스템 클레임처리 가능상태) 참조 1값 = 주문내역상태코드\
  → ST007(FO시스템 클레임처리 가능상태) 참조 2값 = 주문내역구분코드
* 반품 대상 조회 시 상품 속성인 “반품가능여부”값을 확인합니다.
* 반품 사유의 경우 공통코드로 관리되며, 사유 별 귀책 구분, 대상 주문 내역 구분 등의 정보를 포함하고 있습니다.
* 사은품이 있는 상품의 경우, 부분 수량 반품이 불가합니다.
* 주문 시 부분취소불가 결제수단을 사용한 경우, 전체 주문 반품만 가능합니다.
* 동일 배송그룹 내에 이미 초도 배송비가 발생한 반품 신청 이력이 있고, 해당 반품 건이 취소 가능 상태인 경우 추가 반품접수가 불가합니다.
* 초도 배송비가 발생한 반품 접수 시, 동일 배송그룹내의 취소가 가능한 반품 이력이 있는 경우 추가 반품접수가 불가합니다.
* 반품 접수 시 추가 결제금액이 발생한 경우, 결제 금액이 환불 예정금액보다 큰 경우에만 결제대기상태로 전환되며 그 외에는 환불 금액에서 차감됩니다.
* 회수지시 상태의 반품 접수건의 취소 진행 시 배송지시취소수량을 업데이트 합니다.
* 반품불가와 반품보류의 수기 입력 사유 정보는 주문배송정보의 회수완료 대기처리사유로 저장됩니다.
* 반품 목록 조회 시 파트너 접속 관리자의 경우, 해당 협력사의 접수 내역만 노출됩니다.

***