주문 반품처리 API는 반품 관련 클레임 대상을 조회하고, BO의 요청에 해당하는 클레임을 처리합니다. 반품 관련 클레임 처리시 화면에 이 API를 통해 접수된 반품 목록을 제공하며, 반품 처리에 필요한 정보를 화면에 제공합니다.
접수된 반품 목록을 제공합니다.
...
주요 기능
반품 관련 클레임 처리 기능을 제공합니다.
반품 접수 내역을 조회합니다.
반품접수
: 반품 접수 대상은 주문, 교환 상품 중 고객이 상품을 수령한접수상품의 반품을 고객이 신청하는 기능.
주문 진행 상태(출고완료, 배송완료)
에 따라 가능 여부 확인.
반품 수량
, 사유, 수거지
반품 배송비의 경우 무료 반품 쿠폰 사용이 가능하며, 반품 접수 완료 후 고객에게 알림이 발송됩니다. (이메일/알림톡/알림함)반품취소
: 반품 취소 대상은 반품된 상품이 회수되기 전까지(결제대기, 접수, 회수지시) 조회가 가능합니다.
반품 취소의 경우 수량 선택 없이 전체 취소만 가능합니다.
반품 접수 시 결제한 금액을 환불하고 사용된 무료 반품 쿠폰은 복원합니다.반품완료
: 반품 완료 대상은 반품 상품이 정상적으로 회수 완료된 경우 조회가 가능합니다.
반품 완료는 수량 선택 없이 반품 접수 단위로 처리됩니다.
주문 시 사용된 쿠폰을 복원하고, 차감된 상품 재고는 원복 합니다.
재고 증가 대상에는 사은품도 포함되며, 교환 중 반품 전환으로 접수된 건은 제외됩니다.
임직원 주문의 경우, 완료 처리시 할인 한도 금액을 업데이트 합니다.
반품 완료 후 고객에게 알림이 발송됩니다.(이메일/알림톡/알림함)반품불가
: 반품 불가 대상은 반품 상품 회수 후 확인과정(회수확인, 회수완료)에서 검수 결과(LO011)가 불량반품(20)인 경우 조회가 가능합니다.
반품 불가는 수량 선택 없이 반품 접수 단위로 처리됩니다.
반품 불가 접수시에는 반품불가사유를 수기로 입력합니다.
반품 취소와 동일한 절차로 진행되나, 취소 후 재 반품이 불가합니다. (반품 가능여부 관리)반품보류
: 반품 보류 대상은 당사 귀책으로 반품된 상품 회수 후 확인 과정(회수확인, 회수완료)에서 조회가 가능합니다.
반품 보류는 수량 선택 없이 반품 접수 단위로 처리됩니다. 반품 보류 접수시에는 반품 보류 사유를 수기로 입력합니다.
반품 보류는 검수 결과 고객 귀책으로 판단되는 경우에 한해 처리가 진행되며, 귀책 사유에 따라 미 부과된 비용을 재계산하여 고객에게 청구합니다.
추가결제금액이 발생한 경우 주문상태는 결제대기(31)로 전환되며, 무료 반품 쿠폰 사용이 가능합니다. 추가 결제 비용이 없는 경우 회수 완료 처리됩니다.- 반품전환
반품 전환 대상은 교환 상품 회수 후 확인 과정(회수확인, 회수완료)에서 조회가 가능합니다.
반품 전환은 수량 수량 선택 없이 교환접수 단위로 처리됩니다.
교환 접수는 철회되며 교환 접수 시 결제한 금액 환불 및 차감된 재고 복원이 이뤄집니다.
교환 상품은 당사 귀책으로 구분되어 별도의 비용 발생 없이 반품 접수됩니다옵션 선택 가능.
추가 결제 및 환불 정보 자동 계산.
무료 반품 쿠폰 사용 가능.
반품 취소
반품 접수 상태에서 전체 취소 기능 제공.
결제한 금액 환불 및 무료 반품 쿠폰 복원.
반품 완료
반품 접수 완료 상태에서 반품 처리 기능.
주문 시 사용된 쿠폰 복원 및 상품 재고 원복.
임직원 주문의 경우 할인 한도 금액 업데이트.
반품 불가
불량반품(20) 확인 후 반품 불가 처리.
반품 불가 사유 수기 입력.
반품 보류
귀책으로 인한 반품 보류 처리 가능.
추가 결제 시 무료 반품 쿠폰 사용 가능.
반품 전환
교환 상품 회수 후 반품 전환 가능.
교환 접수 철회되며 결제 금액 환불.
프로세스 정의_반품 접수 및 목록 조회
...
구분 | 설명 | |
---|---|---|
1 | 반품주문조회 | 선택 및 입력된 검색 조건에 부합하는 반품 접수 내역을 조회합니다. |
2 | 반품접수 처리대상조회 | 주문한 상품 중 반품이 가능한 상품 목록을 조회하여 반품 접수 팝업에 노출합니다. |
3 | 클레임 비용 계산 조회 | 관리자가 선택한 회수지, 반품 사유에 따른 추가 결제 금액, 반품 완료 후 환불 금액 및 수단 정보를 조회합니다. |
4 | 배송 번호 채번 처리 | 반품 접수 시 사용될 회수지의 신규 배송번호를 발급합니다. |
5 | 반품 접수 | 선택된 상품의 반품 접수를 진행합니다. |
...
API 기능 목록
API | 설명 | Server | 메소드 | 비고 | 🔗API 확인하기 >|
---|---|---|---|---|---|
반품접수 처리대상조회 | 주문한 상품 중 반품이 가능한 대상을 모두 조회합니다. | API-BO | POSTSwagger API |
| |
반품완료 처리대상조회 | 반품 접수된 주문 상품 중 반품 완료 처리가 가능한 대상을 모두 조회합니다. | API-BO | POSTSwagger API |
(/api/order/v1/claim/return/returnTargetInfo) | |
반품불가 대상 조회 | 반품 접수된 주문 상품 중 반품 불가 처리가 가능한 대상을 모두 조회합니다. | API-BO | POSTSwagger API |
| |
반품전환 처리대상조회 | 교환 접수된 주문 상품 중 반품 전환 처리가 가능한 대상을 모두 조회합니다. | API-BO | POSTSwagger API |
| |
반품보류 처리대상조회 | 반품 접수된 주문 상품 중 반품 보류 처리가 가능한 대상을 모두 조회합니다. | API-BO | POSTSwagger API |
| |
반품접수 | 선택된 상품의 반품접수를 진행합니다. | API-BO | POSTSwagger API |
| |
반품철회 | 반품 접수 건을 철회합니다. | API-BO | POSTSwagger API |
| |
반품불가 | 반품 접수 건을 철회하고, 재 반품이 불가하도록 상태를 변경합니다. | API-BO | POSTSwagger API |
| |
반품완료 | 회수 완료된 반품 접수 건을 완료 처리합니다. | API-BO | POSTSwagger API |
| |
반품전환 | 교환 과정에서 회수된 상품을 당사 귀책으로 반품 접수합니다. | API-BO | POSTSwagger API |
| |
반품보류 | 당사 귀책으로 접수된 반품 상품이 회수 확인 과정에서 고객 귀책으로 판단된 경우, | API-BO | POSTSwagger API |
| |
반품주문조회 | 조건에 부합하는 반품 접수 내역을 조회합니다. | API-BO | POSTSwagger API | ||
클레임 비용 계산 조회 | 클레임 업무 별 부가비용, 혜택정보, 추가 결제/환불 예정 금액 및 | API-BO | POST | ||
배송 번호 채번 처리 | 클레임 업무 처리 시 필요한 신규 배송번호를 채번합니다. | API-BO | POST | ||
클레임 상세 내역 조회 | 클레임 상세 내역을 조회합니다. | API-BO | POST | ||
반품/교환 철회대상 조회 | 반품, 교환 접수 건 중 철회가 가능한 대상을 조회합니다. | API-BO | POST주문교환 |
기타 참고사항
동일 배송그룹에 한해 반품 접수가 가능합니다.
반품 접수 및 취소 시 처리 가능 주문내역상태와 주문내역구분 값을 확인합니다. 해당 정보는 공통코드로 관리됩니다.
→ ST007(FO시스템 클레임처리 가능상태) 참조 1값 = 주문내역상태코드
→ ST007(FO시스템 클레임처리 가능상태) 참조 2값 = 주문내역구분코드반품 대상 조회 시 상품 속성인 “반품가능여부”값을 확인합니다.
반품 사유의 경우 공통코드로 관리되며, 사유 별 귀책 구분, 대상 주문 내역 구분 등의 정보를 포함하고 있습니다.
사은품이 있는 상품의 경우, 부분 수량 반품이 불가합니다.
주문 시 부분취소불가 결제수단을 사용한 경우, 전체 주문 반품만 가능합니다.
동일 배송그룹 내에 이미 초도 배송비가 발생한 반품 신청 이력이 있고, 해당 반품 건이 취소 가능 상태인 경우 추가 반품접수가 불가합니다.
초도 배송비가 발생한 반품 접수 시, 동일 배송그룹내의 취소가 가능한 반품 이력이 있는 경우 추가 반품접수가 불가합니다.
반품 접수 시 추가 결제금액이 발생한 경우, 결제 금액이 환불 예정금액보다 큰 경우에만 결제대기상태로 전환되며 그 외에는 환불 금액에서 차감됩니다.
회수지시 상태의 반품 접수건의 취소 진행 시 배송지시취소수량을 업데이트 합니다.
반품불가와 반품보류의 수기 입력 사유 정보는 주문배송정보의 회수완료 대기처리사유로 저장됩니다.
반품 목록 조회 시 파트너 접속 관리자의 경우, 해당 협력사의 접수 내역만 노출됩니다.