교환 처리

patch
https://api.imweb.me/v2/shop
/orders/{주문번호}/exchange/{상태}
처리가능 상태 설명
항목
설명
reject
교환 거부
accept
수거지시
collect_done
교환수거 완료
withhold
교환보류
releasehold
교환 보류 해제
resend
교환 재발송
exchange_done
교환완료 처리
요청 데이터
항목
타입
설명
prod_order_no
String
개별/부분 처리 시 사용(선택)
etc
Array
상태별 필수 데이터
reject:  OrderExchangeRejectData​
accept:  OrderExchangeAcceptData​
withhold:  OrderExchangeWithHoldData​
resend:  OrderExchangeReSendData​
처리 상태에 맞는 추가 데이터를 전달해주세요.
응답 데이터
항목
타입
설명
success
Array
처리 성공한 주문서 번호
failed
Array
처리 실패한 주문서 목록
​OrderActionFailedList​
OrderExchangeReject Data
항목
타입
설명
parcel_code
String
택배사 코드
​사용가능한 택배사 목록 보기​
invoice_no
String
운송장번호
OrderExchangeAccept Data
항목
타입
설명
etc_price
Float
기타 청구 비용
OrderExchangeWithHold Data
항목
타입
설명
reason_code
String
보류 사유 코드
EXCHANGE_DELIVERYFEE: 교환 배송비 청구
EXCHANGE_EXTRAFEE: 기타 교환 비용청구
EXCHANGE_PRODUCT_READY: 교환 상품 준비 중
EXCHANGE_PRODUCT_NOT_DELIVERED: 교환 상품 미입고
EXCHANGE_HOLDBACK: 교환 구매 확정 보류
ETC: 기타 사유
reason_detail
String
보류 상세사유
etc_price
Float
기타 비용
보류 사유가 EXCHANGE_EXTRAFEE 일 때만 입력해주세요.
etc_price 입력 예시
$etc = [
	'etc_price' => [
		'품목주문서번호' => 1000
	]
];
OrderActionFailedList Data
항목
타입
설명
order_no
String
주문번호
prod_order_list
Array
처리 실패한 품목 주문서 목록 OrderActionFailedProdOrderListData​
OrderActionFailedProdOrderList Data
항목
타입
설명
prod_order_no
String
품목주문번호
msg
String
실패 메세지
detail_msg
String
실패 상세메세지
OrderExchangeReSend Data
항목
타입
설명
method
String
재배송방법
DELIVERY: 택배,등기,소포
VISIT_RECEIPT: 방문수령
DIRECT_DELIVERY: 직접 전달
QUICK_SVC: 퀵서비스
NOTHING: 배송없음
parcel_code
String
택배사 코드
재배송방법이 택배,등기,소포 일 때만 입력해주세요.
​사용가능한 택배사 목록 보기​
invoice_no
String
운송장 번호
재배송방법이 택배,등기,소포 일 때만 입력해주세요.

항목	설명
reject	교환 거부
accept	수거지시
collect_done	교환수거 완료
withhold	교환보류
releasehold	교환 보류 해제
resend	교환 재발송
exchange_done	교환완료 처리

항목	타입	설명
prod_order_no	String	개별/부분 처리 시 사용(선택)
etc	Array	상태별 필수 데이터 reject: OrderExchangeRejectData accept: OrderExchangeAcceptData withhold: OrderExchangeWithHoldData resend: OrderExchangeReSendData 처리 상태에 맞는 추가 데이터를 전달해주세요.

항목	타입	설명
success	Array	처리 성공한 주문서 번호
failed	Array	처리 실패한 주문서 목록 OrderActionFailedList

항목	타입	설명
parcel_code	String	택배사 코드 사용가능한 택배사 목록 보기
invoice_no	String	운송장번호

항목	타입	설명
etc_price	Float	기타 청구 비용

항목	타입	설명
reason_code	String	보류 사유 코드 EXCHANGE_DELIVERYFEE: 교환 배송비 청구 EXCHANGE_EXTRAFEE: 기타 교환 비용청구 EXCHANGE_PRODUCT_READY: 교환 상품 준비 중 EXCHANGE_PRODUCT_NOT_DELIVERED: 교환 상품 미입고 EXCHANGE_HOLDBACK: 교환 구매 확정 보류 ETC: 기타 사유
reason_detail	String	보류 상세사유
etc_price	Float	기타 비용 보류 사유가 EXCHANGE_EXTRAFEE 일 때만 입력해주세요.

항목	타입	설명
order_no	String	주문번호
prod_order_list	Array	처리 실패한 품목 주문서 목록 OrderActionFailedProdOrderListData

항목	타입	설명
prod_order_no	String	품목주문번호
msg	String	실패 메세지
detail_msg	String	실패 상세메세지

항목	타입	설명
method	String	재배송방법 DELIVERY: 택배,등기,소포 VISIT_RECEIPT: 방문수령 DIRECT_DELIVERY: 직접 전달 QUICK_SVC: 퀵서비스 NOTHING: 배송없음
parcel_code	String	택배사 코드 재배송방법이 택배,등기,소포 일 때만 입력해주세요. 사용가능한 택배사 목록 보기
invoice_no	String	운송장 번호 재배송방법이 택배,등기,소포 일 때만 입력해주세요.

Last modified 1yr ago