# 반품신청

## 반품 신청 및 접수 <a href="#plus" id="plus"></a>

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266111579/%ED%9A%8C%EC%9B%90%EB%B0%98%ED%92%88%EC%8B%A0%EC%B2%AD.drawio.png" alt=""></p>

### 1. 반품 신청 상품 조회 <a href="#id-1" id="id-1"></a>

반품 처리할 주문건의 상품목록과 주문정보 등 반품 진행 시 필요한 정보가 나타납니다.

* **반품접수 대상 조회(FO) (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88/returnTargetInfoFO))\
  비회원과 회원 모두 동일한 반품처리대상 조회(FO) API를 사용합니다.

```
POST/v1/claim/return/returnTargetInfoFO 
```

### 2. 반품 비용 조회 <a href="#id-2" id="id-2"></a>

클레임 부가비용, 혜택정보, 추가결제/환불 예정 금액 정보를 조회하여 나타납니다.

* **클레임 비용 계산 조회(FO) (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5\&path=calculateFO))\
  비회원과 회원 모두 동일한 클레임 비용 계산 조회 API를 사용합니다.

```
POST /v1/claim/common/claimCalculateCostFO 
```

### 3. 반품 배송번호 등록하기 <a href="#id-3" id="id-3"></a>

클레임 접수 시 사용가능한 배송번호를 조회하여 적용합니다.

* **배송 번호 채번 처리 (**[🔗API 확인하기 >](http://api.x2bee.com/content?msa=order\&depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5\&path=getNewNumberedDeliNo))\
  비회원과 회원 모두 동일한 배송번호 채번 리스트 조회 API를 사용합니다.

```
POST/v1/claim/common/getNewNumberedDeliNo 
```

### 4. 반품 사유 이미지 업로드하기 <a href="#id-4" id="id-4"></a>

당사 귀책 반품 사유의 경우 필수로 첨부되는 이미지 파일을 S3에 업로드 합니다.

* **이미지 업로드 처리 (**[🔗API 확인하기 >](http://api.x2bee.com/content?msa=order\&depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5\&path=claimImgUpload))\
  비회원과 회원 모두 동일한 이미지 업로드 처리 API를 사용합니다.

```
POST/v1/claim/common/claimImgUpload 
```

### 5. 반품 접수 <a href="#id-5" id="id-5"></a>

반품신청 대상 상품 및 주문을 접수처리 합니다.

\*반품 진행에 따른 추가 배송비 결제가 필요한 경우, 가맹점 정보 조회 API를 공통으로 사용합니다.

* **반품접수(FO) (**[🔗API 확인하기 >](http://api.x2bee.com/content?msa=order\&depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88\&path=acceptReturnFO))\
  비회원과 회원 모두 동일한 반품 접수(FO) API를 사용합니다.

```
POST /v1/claim/return/acceptReturnFO 
```

### 6. 반품 상세 내역 조회 <a href="#id-6" id="id-6"></a>

클레임 상품, 환불/결제 내역, 환불예정쿠폰, 배송정보 등의 상세 정보를 조회하여 나타납니다.

* **클레임 상세 내역 조회(FO) (**[🔗API 확인하기 >](http://api.x2bee.com/content?msa=order\&depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5\&path=getClaimDetailsInfoFO))\
  비회원과 회원 모두 동일한 클레임 상세 내역 조회 API를 사용합니다.

```
POST /v1/claim/common/claimDetailsInfoFO 
```

### 7. 반품 취소하기 <a href="#id-7" id="id-7"></a>

반품접수 완료건을 철회합니다.

* **반품철회(FO) (** [🔗API 확인하기 >](http://api.x2bee.com/content?msa=order\&depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88\&path=withdrawalReturnFO))\
  비회원과 회원 모두 동일한 반품 철회(FO) API를 사용합니다.

```
POST/v1/claim/return/withdrawalReturnFO
```

&#x20;