반품 아이템 (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 |