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

# 클레임 공통

상품을 구매한 고객의 클레임 전반적인 업무에 필요한 기능들을 제공합니다.

***

### 주요 기능

* **클레임 상세 정보 제공**
  * 클레임 처리 시 추가 결제/환불 금액 정보 및 환불수단 정보를 상세하게 제공합니다.
  * 쿠폰 사용/복원 정보 및 반품쿠폰 사용 리스트 정보를 제공하여 클레임 이력을 투명하게 관리합니다.
* **배송 및 혜택 데이터 제공**
  * 클레임에 대한 배송비, 혜택 데이터를 상세히 제공하여 고객 및 관리자가 쉽게 파악할 수 있습니다.
* **배송 번호 채번 정보 제공**
  * 클레임 처리 시 새로운 배송/회수지가 생성되는 경우 배송 번호 채번 정보를 제공하여 정확한 관리를 지원합니다.
* **이미지 업로드 지원**
  * 클레임 처리 시 이미지 업로드가 필요한 경우, 이미지 업로드 정보를 제공하여 원활한 작업을 지원합니다.
* **클레임 배송비 결제 정보 제공**
  * 클레임 배송비 결제 시 추가 결제정보를 제공합니다. 이는 BO에서 클레임 접수 후 FO에서 추가 결제를 하는 경우에 활용됩니다.
* **클레임 처리 이후 상세 정보 제공**
  * 클레임 처리 이후에는 상세 화면들에 대한 내역을 제공합니다. 주문번호와 클레임 번호를 기준으로 주문 내역 정보, 클레임 상품 정보, 환불/결제 내역, 환불예정쿠폰, 배송지 정보 등을 통합적으로 제시합니다.
* **결제대기 상태의 클레임 추가 결제**
  * 결제대기 상태의 클레임에 대해 배송비 추가 결제를 진행하고 주문내역상태를 수정하는 기능을 제공합니다.

### API 기능 목록

<table><thead><tr><th width="122.333251953125">API</th><th width="398.22216796875">설명</th><th width="96.888916015625">Server</th><th width="90.22216796875">메소드</th><th>비고</th></tr></thead><tbody><tr><td>클레임 비용 계산 조회</td><td>클레임 비용 계산을 조회합니다. 클레임 업무 별 화면 추가 결제/환불 금액 정보 및 환불수단 정보 제공합니다. 클레임 업무 처리 시 DB 기준 부가비용, 혜택정보 추가결제/환불 예정 데이터 생성 정보 및 쿠폰 사용/복원 정보 제공합니다.</td><td>Order</td><td>POST</td><td>FO: <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> BO: <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=calculate">🔗API 확인하기 ></a></td></tr><tr><td>클레임 상세 내역 조회</td><td>클레임 상세 내역을 조회합니다. 요청 주문번호, 클레임번호에 해당하는 클레임 상세 내역을 제공합니다. 주문 내역 정보, 클레임 상품 정보, 환불/결제 내역, 환불예정쿠폰, 배송지정보를 제공합니다.</td><td>Order</td><td>POST</td><td>FO: <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=getClaimDetailsInfoFO">🔗API 확인하기 ></a> BO: <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=getClaimDetailsInfo">🔗API 확인하기 ></a></td></tr><tr><td>배송 번호 <br>채번 목록 <br>조회</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=getNewNumberedDeliNo">🔗API 확인하기 ></a></td></tr><tr><td>이미지 <br>업로드 처리</td><td>S3 이미지 업로드를 처리합니다. 업로드 완료 시 주문번호, 주문순번, 주문처리순번, 파일URL, 파일명을 제공합니다.</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=claimImgUpload">🔗API 확인하기 ></a></td></tr><tr><td>클레임 추가 결제정보 <br>조회</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=getAdditionalFeePaymentInfo">🔗API 확인하기 ></a></td></tr><tr><td>클레임 <br>배송비 결제대기상태 <br>대상 정보</td><td>FO에서 클레임 배송비 결제대기상태 대상 정보를 조회합니다. 주문 번호, 클레임번호는 필수로 있어야 합니다. 반품/교환 접수 클레임의 추가배송비, 상품목록을 조회 합니다.</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=getClaimPayWaitStateInfo">🔗API 확인하기 ></a></td></tr><tr><td>클레임 <br>배송비 결제 처리</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=doPayDeliveryFee">🔗API 확인하기 ></a></td></tr></tbody></table>

## 기타 참고사항

* 클레임 접수, 철회시 클레임 비용 계산 조회를 이용하여 부가비용, 혜택, 환불정보를 조회하지만 이후 클레임 상태를 변경하는 업무(ex 반품완료)에서는 클레임 상세 조회를 통하여 클레임 처리를 합니다.
* 이미지 업로드 시 확장자는 .png, .bmp, jpeg, gif로 제한됩니다.
* 클레임 접수 처리 전 이미지 업로드가 이미 성공하고 파일 정보를 받은 후 접수 처리시에는 DB에 정보들만 저장합니다.