버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.

...

API

설명

Server

메소드

비고

교환접수철회

교환 접수 건을 철회합니다

교환 접수 시 결제한 금액을 환불 처리합니다.

교환 접수 시 차감된 재고를 증감 처리합니다.

BO

POST

🔗API 확인하기 >

  1. 주문(Order) 교환 접수 철회(BO) API 호출 (/api/order/v1/claim/exchange/withdrawalExchange)

교환클레임옵션변경대상체크

교환 접수 시, 교환하려는 단품 옵션의 교환 가능 여부를 조회합니다.

BO

POST

🔗API 확인하기 >

  1. 주문(Order) 교환 대상상품 옵션변경 가능여부 체크 API 호출 (/api/order/v1/claim/exchange/isExistsExchangeGoodsItm)

반품/교환 철회대상 조회

반품, 교환 접수 건 중 철회가 가능한 대상을 조회합니다.

BO

POST

🔗API 확인하기 >

  1. 주문(Order) 반품/교환 철회대상 조회 API 호출(/api/order/v1/claim/common/getReturnExchangeCancelTargetInfo)

교환주문목록 조회

조건에 부합하는 교환 접수 내역을 조회합니다.

BO

POST

🔗API 확인하기 >

주문교환대상조회

주문한 상품 중 교환 가능 대상을 조회합니다.
교환 접수 진행 시 필요한 주문정보 및 공통코드를 조회합니다.

BO

POST

🔗API 확인하기 >

  1. 주문(Order) 교환 대상 조회(BO) API 호출(/api/order/v1/claim/exchange/getExchageTargetInfo)

교환접수

선택된 상품의 교환접수를 진행합니다.

교환 사유에 따라 교환 배송비가 부과될 수 있으며,

비용이 발생한 경우 결제대기 상태로 저장되며,
추후 고객에게 배송비 결제를 요청합니다.
교환 상품의 재고 차감이 이루어지며

교환 접수 완료 후 고객에게 알림을 발송합니다.

BO

POST

🔗API 확인하기 >

  1. 주문(Order) 교환접수(BO) API 호출(/api/order/v1/claim/exchange/acceptExchange)

클레임 비용 계산 조회

클레임 업무 별 부가비용, 혜택정보, 추가 결제/환불 예정 금액 및
쿠폰 사용/복원 정보를 제공합니다.

BO

POST

클레임 공통 API

배송 번호 채번 처리

클레임 업무 처리 시 필요한 신규 배송번호를 채번합니다.

BO

POST

클레임 공통 API

기타 참고사항

  • 동일 배송그룹에 한해 교환 접수가 가능합니다.

  • 교환 접수 및 취소 시 처리 가능 주문내역상태와 주문내역구분 값을 확인합니다. 해당 정보는 공통코드로 관리됩니다.
    → ST007(FO시스템 클레임처리 가능상태) 참조 1값 = 주문내역상태코드
    → ST007(FO시스템 클레임처리 가능상태) 참조 2값 = 주문내역구분코드

  • 교환 사유의 경우 공통코드로 관리되며, 사유 별 귀책 구분, 대상 주문 내역 구분 등의 정보를 포함하고 있습니다.

  • 사은품이 있는 상품의 경우, 부분 수량 교환이 불가합니다.

  • 주문 시 부분취소불가 결제수단을 사용한 경우, 전체 교환만 가능합니다.

  • 동일한 가격의 판매중인 일반상품(예약상품 불가)만 교환이 가능합니다.

  • 상품의 재고가 없는 경우 교환이 불가합니다.

  • 교환 사유가 고객에게 있는 경우, 교환 배송비가 발생합니다.

  • 교환 배송비가 발생한 경우 주문상태는 결제대기로 등록되며, 고객이 직접 배송비 결제 후 접수가 진행됩니다.

  • 교환 접수 취소 시 결제된 교환 배송비는 환불 처리 됩니다.

  • 교환 접수 시, 교환 상품의 재고가 차감되고 취소 시 재고가 복원됩니다.

  • 회수지시 상태의 교환 건에 대한 취소 진행 시 배송지시취소수량을 업데이트 합니다.

  • 교환 목록 조회 시 파트너 접속 관리자의 경우, 해당 협력사의 접수 내역만 노출됩니다.