주문 처리

PATCH https://api.imweb.me/v2/shop/orders/{주문번호}/{상태}

처리가능 상태 설명

항목
설명

deposit

입금확인 처리

place

배송준비/배송대기 처리

send

발송처리

complete

강제 배송완료 처리

cancel

판매취소

return

반품처리

exchange

교환처리

요청 데이터

circle-info

주문관리 v2의 배송중, 배송완료 처리는 개별 품목 처리가 불가능 합니다. 모든 품목 주문 목록을 prod_order_no_list에 전달해 주셔야 합니다.

항목
타입
설명

prod_order_no

String

개별/부분 처리 시 사용(선택)

etc

Array

상태별 필수 데이터

처리 상태에 맞는 추가 데이터를 전달해주세요.

prod_order_no_list

Array

변경할 품목주문번호 리스트 (주문관리 v2전용, 입금완료 처리는 사용 불가)

order_version

String

조회할 주문 버전

  • v1 (기존 주문)

  • v2 (신규 주문 시스템)

요청 예제

응답 데이터

항목
타입
설명

success

Array

처리 성공한 주문서 번호

failed

Array

처리 실패한 주문서 목록

OrderActionFailedList

OrderSend Data

항목
타입
설명

parcel_code

String

invoice_no

String

운송장번호

OrderCancelRequest Data

항목
타입
설명

reason_code

String

판매취소 사유

  • INTENT_CHANGED: 구매 의사 취소

  • COLOR_AND_SIZE: 색상 및 사이즈 변경

  • WRONG_ORDER: 다른 상품 잘못 주문

  • PRODUCT_UNSATISFIED: 서비스 및 상품 불만족

  • DELAYED_DELIVERY: 배송 지연

  • DROPPED_DELIVERY: 배송 누락

  • SOLD_OUT: 상품 품절

  • BROKEN: 상품 파손

  • INCORRECT_INFO: 상품 정보 상이

  • WRONG_DELIVERY: 오배송

  • WRONG_OPTION: 색상 등이 다른 상품을 잘못 배송

OrderReturnRequest Data

항목
타입
설명

reason_code

String

반품사유

  • INTENT_CHANGED: 구매 의사 취소반품비용 발생시 구매자 부담

  • COLOR_AND_SIZE: 색상 및 사이즈 변경반품비용 발생시 구매자 부담

  • WRONG_ORDER: 다른 상품 잘못 주문반품비용 발생시 구매자 부담

  • PRODUCT_UNSATISFIED: 서비스 및 상품 불만족반품비용 발생시 판매자 부담

  • DELAYED_DELIVERY: 배송 지연반품비용 발생시 판매자 부담

  • DROPPED_DELIVERY: 배송 누락반품비용 발생시 판매자 부담

  • SOLD_OUT: 상품 품절반품비용 발생시 판매자 부담

  • BROKEN: 상품 파손반품비용 발생시 판매자 부담

  • INCORRECT_INFO: 상품 정보 상이반품비용 발생시 판매자 부담

  • WRONG_DELIVERY: 오배송반품비용 발생시 판매자 부담

  • WRONG_OPTION: 색상 등이 다른 상품을 잘못 배송반품비용 발생시 판매자 부담

deliv_fee_method

String

반품비용 처리방법

구매자 귀책 사유일 때만 입력해주세요.

  • REFUND: 환불금에서 차감

  • CASH: 판매자에게 송금

  • BOX: 수거시 박스에 동봉

collect_type

Boolean

직접 수거 여부

parcel_code

String

택배사 코드

직접 수거를 사용하지 않는 경우 필수로 입력해주세요.

사용가능한 택배사 목록 보기

invoice_no

String

운송장번호

직접 수거를 사용하지 않는 경우 필수로 입력해주세요.

OrderExchangeRequest Data

항목
타입
설명

reason_code

String

교환사유

  • INTENT_CHANGED: 구매 의사 취소교환비용 발생시 구매자 부담

  • COLOR_AND_SIZE: 색상 및 사이즈 변경교환비용 발생시 구매자 부담

  • WRONG_ORDER: 다른 상품 잘못 주문교환비용 발생시 구매자 부담

  • PRODUCT_UNSATISFIED: 서비스 및 상품 불만족교환비용 발생시 판매자 부담

  • DELAYED_DELIVERY: 배송 지연교환비용 발생시 판매자 부담

  • DROPPED_DELIVERY: 배송 누락교환비용 발생시 판매자 부담

  • SOLD_OUT: 상품 품절교환비용 발생시 판매자 부담

  • BROKEN: 상품 파손교환비용 발생시 판매자 부담

  • INCORRECT_INFO: 상품 정보 상이교환비용 발생시 판매자 부담

  • WRONG_DELIVERY: 오배송교환비용 발생시 판매자 부담

  • WRONG_OPTION: 색상 등이 다른 상품을 잘못 배송교환비용 발생시 판매자 부담

collect_type

Boolean

직접 수거 여부

parcel_code

String

택배사 코드

직접 수거를 사용하지 않는 경우 필수로 입력해주세요.

사용가능한 택배사 목록 보기

invoice_no

String

운송장번호

직접 수거를 사용하지 않는 경우 필수로 입력해주세요.

OrderActionFailedList Data

항목
타입
설명

order_no

String

주문번호

prod_order_list

Array

처리 실패한 품목 주문 목록OrderActionFailedProdOrderListData

OrderActionFailedProdOrderList Data

항목
타입
설명

prod_order_no

String

품목주문번호

msg

String

실패 메세지

detail_msg

String

실패 상세메세지

Last updated