주문의 배송 상태 소개
- WAIT : 주문 처리 대기중
- PREPARING : 배송 준비중 (송장 정보 등록 가능)
- IN_DELIVERY : 배송중
- COMPLETED : 배송 완료
- CANCELLED : 배송 취소됨 (취소 요청을 처리 완료해서 환불 완료된 경우에 이 상태를 갖게 됩니다)
Plain Text
복사
주문관련 Q&A
•
주문 조회 후 주문 상태가 변경되는지?
◦
셀러가 주문 정보를 조회한다고 해서 주문 상태가 변경되지는 않습니다.
◦
셀러가 별도로 배송상태 변경 API 호출을 통해 배송 상태를 변경할 수 있습니다.
▪
PUT /seller/orders/lines/delivery-state
◦
배송 준비 중 → 배송중 단계로 변경 시에는 송장 등록이 필요합니다.
▪
PUT /seller/orders/lines/tracking-info
•
무통장 입금 시 주문 프로세스
◦
우선 임시로 주문이 생성되고, 주문의 결제 상태가 입금 대기 중으로 변경됩니다.
◦
입금 기간 동안 입금을 하는 경우, 결제 상태가 결제 완료로 바뀌며 유효한 주문으로 자동으로 변경됩니다.
◦
입금완료된 시점이 결제완료 시점이며 주문 수집에서 노출됩니다.
•
주문의 취소
•
취소 요청 상태
◦
SUBMITTED : 취소 요청이 최소로 생겼을 때의 초기 상태 (취소 요청됨)
◦
RESOLVED : 취소 요청이 처리 완료된 상태 (환불 완료)
◦
WITHDRAWN : 사용자가 취소 요청을 철회한 상태
◦
REJECTED : 입점사가 사용자의 취소 요청을 철회한 상태
•
주문 배송 상태가 '주문 처리 대기 중', '배송 준비 중' 인 경우에만 취소가 가능합니다.
•
셀러의 경우 취소를 요청 상태까지만 진행할 수 있고, 승인 및 환불을 한 번에 진행할 수도 있습니다.
◦
취소 요청까지만 하는 경우
▪
POST /seller/orders/{orderId}/lines/cancel
◦
취소 요청 및 승인 및 환불까지 진행하는 경우
▪
POST /seller/orders/lines/cancel/tickets/confirm-and-proceed
•
취소 요청 상태인 경우 승인 및 환불처리를 할 수도 있고, 취소 요청을 거절할 수도 있습니다.
◦
취소 승인 및 환불처리 하는 경우
▪
POST /seller/orders/lines/cancel/{ticketId}/confirm-and-proceed
◦
취소 요청 거절하는 경우
▪
POST /seller/orders/lines/cancel/{ticketId}/confirm-and-proceed
배송 상태에 따른 액터(Actor) 별 허용 액션 목록
배송 상태별 구분 | 주문 처리 대기 중
(deliveryState == WAIT) | 배송 준비 중
(deliveryState == PREPARING) | 배송 중
(deliveryState == IN_DELIVERY) | 배송 완료
(deliveryState == COMPLETED) |
App/Web | - 주문 취소
- 즉시 환불(RESOLVED)까지 진행됨
- 배송 취소됨으로 배송 상태가 변경됨
- 배송지 변경 | - 주문 취소
- 요청됨(SUBMITTED) 상태까지만 진행할 수 있음
- 요청됨 상태의 취소 요청을 철회(WITHDRAWN)할 수 있음 | - 리뷰 작성
- 구매 확정
- 주문 반품
- 요청됨(SUBMITTED) 상태까지만 진행할 수 있음
- 요청됨 상태의 반품 요청을 철회(WITHDRAWN)할 수 있음
- 상품의 배송 정책이 반품 자동 승인이 적용 중이라면 바로 승인(CONFIRMED)처리까지 진행됨. 이때, 선환불 대상의 경우 즉시 환불처리(RESOLVED)됨
- 주문 교환
- 교환 가능한 셀러의 경우 교환을 요청할 수 있음
- 요청한 교환을 철회할 수 있음
- 교환비 발생하는 경우 교환비 입금 진행
- 자동 승인 대상의 경우 입금 완료 시 바로 승인됨 상태로 변경됨 | |
CX | - 주문 취소
- 요청됨(SUBMITTED) 상태까지만 진행할 수도 있음
- 즉시 환불(RESOLVED)까지 진행할 수도 있음
이때는 배송 취소됨으로 배송 상태가 변경됨
- 배송지 변경
- 배송 준비 중으로 배송 상태 변경 | - 주문 취소
- 요청됨(SUBMITTED) 상태까지만 진행할 수도 있음
- 즉시 환불(RESOLVED)까지 진행할 수도 있음
이때는 배송 취소됨으로 배송 상태가 변경됨
- 주문 송장번호 및 배송사 등록/변경
- 배송 중으로 배송 상태 변경
- 단, 송장번호 및 배송사가 모두 입력되어야만 배송 중으로 변경할 수 있음 | - 주문 반품
- 요청됨(SUBMITTED) 상태까지만 진행할 수도 있음
- 승인(CONFIRMED)까지 진행할 수도 있음
- 주문 송장번호 및 배송사 변경
- 배송 완료로 배송 상태 변경 | - 주문 반품
- 요청됨(SUBMITTED) 상태까지만 진행할 수도 있음
- 승인(CONFIRMED)까지 진행할 수도 있음
- 주문 교환
- 교환 가능한 셀러의 경우 교환을 요청할 수 있음 |
셀러 | - 주문 취소
- 즉시 환불(RESOLVED)까지 진행됨
- 배송 취소됨으로 배송 상태가 변경됨
- 배송 준비 중으로 배송 상태 변경 | - 주문 취소
- 즉시 환불(RESOLVED)까지 진행됨
- 배송 취소됨으로 배송 상태가 변경됨
- 주문 송장번호 및 배송사 등록/변경
- 배송 중으로 배송 상태 변경
- 단, 송장번호 및 배송사가 모두 입력되어야만 배송 중으로 변경할 수 있음 | - 주문 송장번호 및 배송사 변경 |
기타 문서
셀러어드민 > 배송관리 > 다운로드 와 셀러 어드민 배송관리 조회 API 필드 맵핑
셀러어드민에서는 합배송으로 묶여있지만, 개별주문 단위로 Flatten 하게 처리되어서 내려갑니다.
최소 단위는 orderSummary.itemGroupsForSeller[0].items 의 각 Element 입니다.
엑셀 양식 | API 필드 | 추가 설명 |
주문번호
|
orderSummary.orderId
| |
주문일시
|
orderSummary.confirmedAtMillis
| |
주문자명
|
deliveryRequest.address.recipientName
| |
우편번호
|
deliveryRequest.address.zipCode
| |
배송주소
|
deliveryRequest.address.address + deliveryRequest.address.detailAddress
| |
배송 요청사항
|
deliveryRequest.request
| |
전화번호
|
deliveryRequest.address.phoneNumber
| |
총 상품 가격
|
orderLine.singlePrice * orderLine.quantity
| |
브랜드명
|
orderLine.brand.name
| |
상품명
|
orderLine.product.name
| |
판매자 상품코드
|
orderLine.product.mallProductCode
| |
옵션명
|
orderLine.productItem.title
| |
판매자 옵션코드
|
orderLine.productItem.mallProductItemCode
| |
판매가
|
orderLine.singlePrice
| |
수량
|
orderLine.quantity
| |
주문 당시 출고 예정일
|
orderLine.estimateShipmentAt
| |
출고 일시
|
orderLine.delivery.shippedAtMillis
| |
셀러부담할인액
|
orderLine.discountDutyAmount.sellerAmount
| |
합배송번호
|
orderSummary.itemGroupsForSeller.groupId
| |
개별 주문번호
|
orderLine.id
| |
취소 상태
|
orderLine.primaryCancelTicket.state
| CONFIRMED : 승인됨(진행중)
REJECTED: 반려됨
SUBMITTED: 요청됨
RESOLVED: 처리됨 (환불완료)
WITHDRAWN: 철회됨
정의된 부분이 없을 경우 : 내역 없음 |
반품 상태
|
orderLine.primaryReturnTicket.state
| CONFIRMED : 승인됨(진행중)
REJECTED: 반려됨
SUBMITTED: 요청됨
RESOLVED: 처리됨 (환불완료)
WITHDRAWN: 철회됨
정의된 부분이 없을 경우 : 내역 없음 |
배송 상태
|
orderLine.delivery.state
| CANCELLED : 배송 취소됨
WAIT : 주문 처리 대기 중
PREPARING: 배송 준비 중
IN_DELIVERY: 배송 중
COMPLETED: 배송 완료 |
배송사
|
orderLine.delivery.vendorName
| |
송장번호
|
orderLine.delivery.vendorDeliveryNumber
|