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

# 클레임 공통 API

주문 및 클레임 업무에 필요한 핵심 기능들을 제공합니다. 주문과 클레임 처리 시 추가 결제/환불 정보, 쿠폰 사용/복원 정보, 배송비 및 혜택 데이터, 새로운 배송/회수지 생성 관련 정보 등을 효율적으로 처리할 수 있습니다. 이 API는 BO에서 반품/교환 철회 대상을 조회할 때 활용됩니다.

***

## 주요 기능

* **클레임 처리 정보 제공**
  * 추가 결제/환불 금액 정보 및 환불수단 정보
  * 쿠폰 사용/복원 정보
  * 반품쿠폰 사용 리스트 정보
* **배송비 및 혜택 데이터 제공**
  * 클레임 배송비, 혜택 데이터 제공
* **새로운 배송/회수지 생성 관련 정보 제공**
  * 클레임 처리 시 새로운 배송/회수지 생성 시 배송 번호 채번 정보 제공
* **상세 화면 내역 제공**
  * 클레임 처리 이후 상세 화면 정보 제공
  * 주문번호와 클레임 번호 기준으로 주문 내역, 클레임 상품 정보, 환불/결제 내역, 환불예정 쿠폰, 배송지 정보 제공
* **반품/교환 철회 대상 조회**
  * BO에서 반품/교환 철회 대상 조회 (사은품 제외, 일반 상품 대상)

## API 기능 목록

<table><thead><tr><th width="125.666748046875">API</th><th width="363.888916015625">설명</th><th width="94.6666259765625">Server</th><th width="91.333251953125">메소드</th><th>비고</th></tr></thead><tbody><tr><td>클레임 비용 계산 조회</td><td>클레임 비용 계산을 조회합니다. <br>클레임 업무 별 화면 추가 결제/환불 금액 정보 및 환불수단 정보 제공합니다. <br>클레임 업무 처리 시 DB 기준 부가비용, 혜택정보 추가결제/환불 예정 데이터 생성 정보 및 쿠폰 사용/복원 정보 제공합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=claim&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%20%EA%B3%B5%ED%86%B5&#x26;path=claimCalculateCost">🔗API 확인하기 ></a></td></tr><tr><td>클레임 상세 내역 조회</td><td>클레임 상세 내역을 조회합니다. 요청 주문번호, 클레임번호에 해당하는 클레임 상세 내역을 제공합니다. 주문 내역 정보, 클레임 상품 정보, 환불/결제 내역, 환불예정쿠폰, 배송지정보를 제공합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=claim&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%20%EA%B3%B5%ED%86%B5&#x26;path=claimDetailsInfo">🔗API 확인하기 ></a></td></tr><tr><td>배송 번호 <br>채번 목록 <br>조회</td><td>배송 번호 채번 목록 조회합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=claim&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%20%EA%B3%B5%ED%86%B5&#x26;path=getNewNumberedDeliNo">🔗API 확인하기 ></a></td></tr><tr><td>반품/교환 <br>철회 대상 <br>조회</td><td>BO에서 반품/교환 철회대상 조회합니다. <br>사은품 제외하고 일반 상품이 대상입니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=claim&#x26;depth=%EC%A3%BC%EB%AC%B8%EA%B5%90%ED%99%98&#x26;path=getReturnExchangeCancelTargetInfo">🔗API 확인하기 ></a></td></tr><tr><td>클레임 추가 결제정보 조회</td><td>클레임 추가결제에 필요한 정보를 조회힙니다. 사용가능한 주결제수단, 보조결제수단 목록을 조회합니다. 로그인된 회원 정보가 있을 경우, 사용가능 마일리지 정보도 보조결제수단목록에 포함되어 조회됩니다.</td><td>BO</td><td>POST</td><td></td></tr></tbody></table>

## 기타 참고사항

* 클레임 접수, 철회 시 클레임 비용 계산 조회를 이용하여 부가비용, 혜택, 환불정보를 조회하지만, 이후 클레임 상태를 변경하는 업무(예: 반품완료)에서는 클레임 상세 조회를 통하여 클레임 처리를 합니다.