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/
| API | Method | URL |
|---|---|---|
| 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 응답의 statuses와 statusesHistory로 확인합니다.
| 코드 | 의미 | 단계 |
|---|---|---|
placed | 주문 접수 완료 | 접수 |
wait | 배차 대기 | 수거 |
allocated | 배차 완료 | 수거 |
unallocate | 배차 취소 | 수거 |
ready | 픽업출발 | 수거 |
pickedup | 픽업완료 | 수거 |
failed | 미회수 | 수거 (재접수 가능) |
stopover | 거점도착 | 운송 |
returned | 검품센터 도착 | 입고 |
received | 검품센터 입고 완료 | 입고 |
inspecting | 검품중 (주문 내 반품 아이템 검품 시작 시) | 검품 |
inspected | 검품완료 | 검품 |
cancelled | 주문취소 | — |
waitDelivery | 출고대기 | 출고 |
gohome | 검품센터 출고완료 | 출고 |
completed | 고객사 입고완료 | 완료 |
박스 타입 (boxType)
가로·세로·높이의 합, 무게 조건 중 더 높은 등급으로 지정합니다.
| 코드 | 크기(가로+세로+높이) | 무게 |
|---|---|---|
A | 80cm 이하 | 2kg 이하 |
B | 80cm 초과 100cm 이하 | 2kg 초과 5kg 이하 |
C | 100cm 초과 120cm 이하 | 5kg 초과 10kg 이하 |
D1 | 120cm 초과 140cm 이하 | 10kg 초과 15kg 이하 |
D2 | 140cm 초과 160cm 이하 | 15kg 초과 20kg 이하 |
E | 160cm 초과 190cm 이하 | 20kg 초과 25kg 이하 |
F | 190cm 초과 220cm 이하 | 20kg 초과 25kg 이하 |