본문으로 건너뛰기

19. 일반회원 주문 (bmrmember-order)

일반회원 주문(bmrmember-order)
  • 일반회원[bmrmember]: 리터니즈의 API 서비스를 이용하는 고객사
  • 주문[Order]: 리터니즈에서 반품 정보 및 진행상황을 관리하는 단위
    • 상태값[statuses]주문 상태 코드
    • 고유 식별값[Primary Key]: 주문번호[bulkNumber] — 주문 접수 시 자동 생성
    • 주요 식별값
      • 송장번호[orderNumber]: 고유값이 아님(Not Unique). 반품 주문의 운송사 또는 리터니즈[직접 수거]의 송장번호
      • 고객주문번호[customerNumber]: 브랜드[ecommerce]에서 사용하는 고유 식별번호. 브랜드 내 중복 입력 시 에러 발생. 주문 재접수[reissue] 시 기존 고객주문번호에 _{재주문 횟수} post fix가 추가됨
  • 반품 아이템[ReturnItem]: 반품 주문에 포함된 하나 이상의 반품 상품
    • 상태값[confirm] → 처리상태 코드
    • 주문 등록 시 입력 → 19.3. 주문 접수
    • 관리 단위(주문의 상태[statuses] 기준)
      • 접수[placed]부터 검품센터 입고[received]: 주문[Order]에 포함되어 처리
      • 검품센터 입고 이후 검품 완료[inspected] 시까지: 반품 아이템[ReturnItem] 단위로 처리
      • 검품 완료 이후 고객사 배송완료[completed] 시까지: 출고 박스[outBox] 단위로 처리
  • 출고 박스[OutBox]: 하나 이상의 반품 아이템[ReturnItem]을 포함. 리터니즈 반품센터부터 리터니즈 이용 고객사까지의 반품 아이템 운송 단위
  • 🔗 url: /api/bmrmember-order/
APIMethodURL
19.1. 주문 목록 조회GET/api/bmrmember-order/?page={PAGE}
19.2. 주문 상세 조회GET/api/bmrmember-order/{bulkNumber}
19.3. 주문 접수POST/api/bmrmember-order/
19.4. 주문 취소PATCH/api/bmrmember-order/{bulkNumber}/cancel/
19.5. 주문 재접수 (주문번호)POST/api/bmrmember-order/{bulkNumber}/reissue
19.6. 주문 재접수 (브랜드 주문번호)POST/api/bmrmember-order/reissue-order
19.7. 송장번호 수정 [추가예정]PATCH/api/bmrmember-order/{bulkNumber}/order-number/
19.8. 참조 정보 수정PATCH/api/bmrmember-order/{bulkNumber}/reference-info/

하위 객체 명세: 반품 아이템 (returnItem) · 출고 박스 (outBox)

주문 상태 (statuses)

주문[Order]의 진행 상태. 리터니즈 물류 처리에 따라 자동으로 전환되며 GET 응답의 statusesstatusesHistory로 확인합니다.

코드의미단계
placed주문 접수 완료접수
wait배차 대기수거
allocated배차 완료수거
unallocate배차 취소수거
ready픽업출발수거
pickedup픽업완료수거
failed미회수수거 (재접수 가능)
stopover거점도착운송
returned검품센터 도착입고
received검품센터 입고 완료입고
inspecting검품중 (주문 내 반품 아이템 검품 시작 시)검품
inspected검품완료검품
cancelled주문취소
waitDelivery출고대기출고
gohome검품센터 출고완료출고
completed고객사 입고완료완료

박스 타입 (boxType)

가로·세로·높이의 합, 무게 조건 중 더 높은 등급으로 지정합니다.

코드크기(가로+세로+높이)무게
A80cm 이하2kg 이하
B80cm 초과 100cm 이하2kg 초과 5kg 이하
C100cm 초과 120cm 이하5kg 초과 10kg 이하
D1120cm 초과 140cm 이하10kg 초과 15kg 이하
D2140cm 초과 160cm 이하15kg 초과 20kg 이하
E160cm 초과 190cm 이하20kg 초과 25kg 이하
F190cm 초과 220cm 이하20kg 초과 25kg 이하