반품 아이템 (returnItem)
주문에 포함된 개별 반품 상품입니다. 접수 시 returnItems[]로 전달하고, 조회 응답의 returnItems[]로 검품 결과가 회신됩니다.
수량 분할
접수 시 quantityOrder > 1이면 수량만큼 반품 아이템(itemCode)이 분할 생성되며, 조회 응답의 각 아이템은 quantityOrder: 1입니다.
customerReferenceKey, gifts 등 접수 값은 분할된 각 아이템에 동일하게 복사됩니다.
접수 요청 파라미터 (POST)
19.3. 주문 접수의 returnItems[] 각 항목:
| 파라미터 명 | 필수여부 | 데이터 타입 | 값 | 제한 사항 / 비고 |
|---|---|---|---|---|
productName | 필수 | String | 제품명 | max length=500 |
option | String | 옵션 | max length=500 | |
productCode | String | 고객제품코드 | max length=100 | |
quantityOrder | Integer | 주문수량 | default=1. 수량만큼 아이템 분할 생성 | |
productPrice | Integer | 제품 가격 | default=0 | |
customerReferenceKey | String | 고객사 참조키(아이템) | max length=100, default=''. 고객사(브랜드 BO)가 반품 아이템 단위로 기록하는 임의의 참조 코드. 주문 단위 참조키와 별개 (BMR-865) | |
gifts | List | 사은품 목록 | 생략 또는 빈 배열 = 사은품 없음. 각 항목: name(String, 필수, max 500) 사은품 정보(명) — 온라인BO의 사은품1/2/3을 각각 한 항목으로 전달, productCode(String, 선택, max 100). 예: [{"name": "쇼핑백"}, {"name": "샘플파우치", "productCode": "G-01"}]. 리터니즈는 사은품 상품 매핑을 하지 않고 항목 존재 여부만 판단에 사용. id/returned는 요청 시 무시됨(회신 전용) | |
requestMemo | String | 반품 요청사항 | ||
isBundle | Boolean | 세트상품 여부 | default=false |
조회 응답 필드 (GET)
| 파라미터 명 | 데이터 타입 | 값 | 비고 |
|---|---|---|---|
bulkNumber | String | 주문 번호 | 12자리 |
itemCode | String | 아이템코드 | AAAYY365A000 — AAA: 브랜드 ID, YY: 주문일 연도 뒷 두자리, 365: 365일 중 주문일 순서, A000: 일련번호 (A000 → A999 → B000). 총 12자리 |
isBundle | Boolean | 세트상품 여부 | |
ecommerce | Object | 반품 브랜드(경량) | 아이템이 속한 주문의 브랜드 정보(주문의 ecommerce와 동일, 아이템별 별도 브랜드 없음). ecommerceId, name, url, isInspection, isUsed, isTest, companyCode, parentEcommerceId(상위 브랜드 ID, 없으면 null), parentCompanyCode |
productName | String | 제품명 | 제품 마스터와 매칭된 경우 마스터 값으로 표시 |
option | String | 옵션 | |
productCode | String | 고객제품코드 | |
requestMemo | String | 반품 요청사항 | 접수 시 전달한 값 |
quantityOrder | Integer | 주문수량 | 분할 후 각 아이템은 1 |
productPrice | Integer | 제품 가격 | 접수 시 전달한 값 |
customerReferenceKey | String | 고객사 참조키(아이템) | 미기록 시 ''. 19.8 참조 정보 수정으로 변경 가능 (BMR-865) |
inspectorNote | String | 검품원 의견 | |
gifts | List | 사은품 목록 | 각 항목: id(Integer), name(String), productCode(String, 없으면 ''), returned(Boolean, 항목별 회수 여부 — 리터니즈 검품원 입력, 기본값 false). 접수 시 전달된 항목 외에 검품 현장에서 추가된 사은품도 포함될 수 있음 |
giftReturned | Boolean | 사은품 회수 여부 | gifts 집계값: 1개 이상 returned=true이면 true |
inspectProduct | String | 동일 제품 확인 | 코드 표 |
inspectPackage | String | 제품 포장 상태 | 코드 표 |
inspectContents | String | 제품 본품 상태 | 코드 표 |
reasonItemDamaged | List | 제품 본품 훼손 사유 | 코드 문자열 배열, 없으면 []. 코드 표 |
statusInspect | String | 검품 상태 | 포장/본품 상태로 자동 산출. 코드 표 |
statusInspectRequest | String | 검품 전달사항 상태 | 주문의 검품 전달사항(requestInspect)에 대한 검품원 확인 결과. confirm: 확인 / unknown: 확인불가 / '': 미입력 |
confirm | String | 처리상태 | 코드 표 |
product | Object | 연동 제품 정보 | 리터니즈 제품 마스터와 매칭된 경우 제품 정보(코드/이름/옵션 등), 미매칭 시 null |
outBox | Object | 출고박스 정보 | 출고 박스 (outBox) 참조. 출고 전 null |
inspectImages | List | 검품 이미지 리스트 | 검품 시 촬영된 이미지 목록 (본품·포장·사은품 사진 모두 포함, 종류 구분 없음). 각 항목: id, image(원본 URL), thumbnail(썸네일 URL), itemCode, width, height, created_at |
lastInspectAt | DateTime | 최종 검품일시 | 없으면 null |
outAt | DateTime | 출고 완료일시 | 아이템이 속한 출고 박스의 출고 완료일. 출고 전 null |
shippingAllowedAt | DateTime | 출고 가능 시각 | 검품 완료(lastInspectAt) + 24h + 다음날부터 연속된 휴무일 수만큼 +24h. lastInspectAt 없으면 null |
categories | List | 연동된 카테고리 목록 | 각 항목: categoryCode, name, fullPath. 없으면 [] |
inspectionGuideCategory | String | 카테고리 검품 가이드 | 브랜드 + 카테고리 조합에 등록된 검품 가이드 텍스트(줄바꿈 구분). 없으면 '' |
응답에 포함되지 않는 필드
구 규격서 표에 있던 plan, measureWidth / measureDepth / measureHeight / measureWeight, isWeightInspected는 현재 bmrmember-order GET 응답에 포함되지 않습니다(기초코드 등록 불필요).
검품 결과 코드
동일 제품 확인 (inspectProduct)
리터니즈 검품원 입력 (읽기 전용).
| 코드 | 의미 |
|---|---|
correct | 본품 맞음 |
incorrect | 본품 틀림 |
omitted | 제품 없음 |
unknown | 본품 구분불가 |
wrong_product | 타사 제품 |
check | 클라 이언트 확인요청 |
'' | 미입력 |
제품 포장 상태 (inspectPackage)
리터니즈 검품원 입력 (읽기 전용).
| 코드 | 의미 |
|---|---|
correct | 미개봉 (개봉 검사 미진행, 내용물 정상으로 확정) |
incorrect | 포장 개봉 (개봉 검사 후 포장 교체) |
reused | 포장 재사용 (개봉 검사 후 기존 포장 재사용) — v0.304 신규 |
unknown | 구분불가 — 과거 데이터 표시용, 신규 입력 없음 |
check | 클라이언트 확인요청 |
'' | 미입력 |
제품 본품 상태 (inspectContents)
| 코드 | 의미 |
|---|---|
normal | 정상 |
damaged | 훼손 |
unknown | 구분불가 |
check | 클라이언트 확인요청 |
'' | 미입력 |
제품 본품 훼손 사유 (reasonItemDamaged)
복수 선택 가능 → 코드 문자열 배열로 회신 (예: ["winkles", "hole"]), 없으면 [].
| 구분 | 코드 | 의미 |
|---|---|---|
| 구성품 | missed | 구성품 없음 |
| 구성품 | parts | 구성품 불량 |
| 구성품 | fastenerDamaged | 지퍼/단추 불량 |
| 제품 상태 | foundation | 화장품/생활 오염 |
| 제품 상태 | etcFoundation | 기타 오염 |
| 제품 상태 | winkles | 구겨짐 |
| 제품 상태 | fabricDamaged | 원단 불량 |
| 제품 상태 | sewing | 봉제 불량 |
| 제품 상태 | hole | 구멍/찢어짐 |
| 제품 상태 | odor | 악취 |
| 제품 상태 | laundary | 세탁 의심 |
| 제품 상태 | leatherScratch | 가죽 스크래치 |
| 불일치 | sizeWrong | 사이즈 불일치 |
| 불일치 | colorWrong | 색상 불일치 |
| 사용 중단* | opened | 본품 개봉 |
| 사용 중단* | dyed | 이염(착색) |
| 사용 중단* | strechedout | 목,팔 늘어남 |
| 사용 중단* | furwinkls | 가죽-주름 |
| 사용 중단* | etc | 기타 불량 |
* 사용 중단 코드는 신규 입력은 없으나 과거 데이터 조회 시 회신될 수 있으므로 기초코드에 포함하세요.
검품 상태 (statusInspect)
제품 포장 상태(inspectPackage) + 제품 본품 상태(inspectContents)로 자동 산출 (읽기 전용).
| 코드 | 의미 | 산출 조건 |
|---|---|---|
normal | 미개봉 | inspectPackage = correct |
usable | 포장 개봉 / 본품정상 | incorrect + normal |
unusable | 포장 개봉 / 본품불량 | incorrect + damaged |
reused_usable | 포장 재사용 / 본품정상 — v0.304 신규 | reused + normal |
reused_unusable | 포장 재사용 / 본품불량 — v0.304 신규 | reused + damaged |
check | 클라이언트 확인 요청 | 포장 또는 본품이 check |
not_completed | 검품 미완료 | 주문 상태가 검품완료(inspected) 이전이고 위 조건에 해당 없음 (구분불가 또는 포장/본품 상태 미입력) |
'' | 산출 불가 | 검품완료 이후인데 위 조건에 해당 없음 |
처리상태 (confirm)
리터니즈 검품원이 입력 (읽기 전용, default wait).
| 코드 | 의미 |
|---|---|
wait | 대기 중 |
inspecting | 검품 진행중 |
confirmed | 검품 완료 |
reinspection | 디테일 검품중 |
rerequest | 재검품 요청 (대기 중과 동일하게 처리) |
waitDelivery | 출고대기 (검품 완료 후 출고 박스 포장 대기) |