주문 교환

고객이 주문한 상품에 대한 교환 서비스를 제공하는데, 주문이 완료된 상품에 대한 교환 프로세스를 지원하며 교환 처리 중 취소할 수 있는 기능도 제공합니다. 이 API를 통해 교환 접수가 완료되면 해당 고객에게 교환 처리에 대한 알림이 전송됩니다.


주요 기능

  • 교환 가능 상품 조회:

    • 주문 및 교환한 상품 중 주문 진행상태(출고완료 혹은 배송완료)에 따라 교환이 가능한 상품을 조회합니다.

  • 교환 접수 가능 여부 확인:

    • 교환 접수 시 선택된 단품 옵션의 교환 가능 여부를 판단합니다.

  • 철회 가능 상품 조회:

    • 교환 접수 진행 상태(결제대기, 접수 혹은 회수지시)에 따라 철회가 가능한 상품을 조회합니다.

  • 교환 정보 제공:

    • 교환 접수/철회 시 필요한 정보를 제공합니다.

  • 부가비용 및 결제/환불 정보 제공:

    • 교환 접수/철회 시 재계산되는 부가 비용과 혜택, 결제/환불 예정 교환 배송 비용 정보를 제공합니다.

  • 교환배송비 관리:

    • 교환 접수 시 교환 배송비가 발생하면 결제 대기 상태로 변경되고, 추후 고객에게 배송비 결제를 요청합니다.

    • 교환 취소 시 결제한 교환 배송비를 환불 처리합니다.

  • 재고 처리:

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

  • 알림 발송:

    • 교환 접수 완료 후 고객에게 알림을 발송합니다. (이메일/알림톡/알림함)

 

프로세스 정의_ 교환 접수 및 목록 조회

 

구분

설명

구분

설명

1

교환주문목록조회

선택 및 입력된 검색 조건에 부합하는 교환 접수 내역을 조회합니다.

2

주문교환대상조회

주문한 상품 중 교환이 가능한 상품 목록을 조회하여 교환 접수 팝업에 노출합니다.

3

클레임 비용 계산 조회

교환 사유에 따른 추가 결제 비용을 조회합니다.

4

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

교환하려는 단품 옵션의 교환 가능여부를 확인합니다.

5

배송 번호 채번 처리

교환 접수 시 사용될 회수지/배송지의 신규 배송번호를 발급합니다.

6

교환 접수

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

프로세스 정의_ 교환 철회

구분

설명

구분

설명

1

교환 철회대상 조회

철회 가능한 교환 접수 건을 모두 조회합니다.

2

클레임 비용 계산 조회

교환 철회 시 환불 금액과 수단 정보를 조회합니다.

3

교환 접수 철회

선택된 교환 접수 건을 철회합니다.

API 기능 목록

API

설명

Server

메소드

비고

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값 = 주문내역구분코드

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

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

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

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

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

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

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

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

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

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

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