옵션타입은 크게 선택형과 작성형으로 구분됩니다.
선택형은 주문시 판매자가 미리 설정해둔 옵션 리스트 중에서 구매자가 선택하는 방식이고, 작성형은 주문시 구매자가 주문하려는 옵션 내용을 직접 작성하는 방식입니다.
| 타입명 | 설명 |
|---|---|
| NONE | 옵션 없음 |
| SIMPLE | 독립형 |
| COMBINATION | 조합형 |
| CUSTOM | 작성형 |
| SIMPLE_CUSTOM | 독립형 + 작성형 |
| COMBINATION_CUSTOM | 조합형 + 작성형 |
OptionSortType
독립형 및 조합형 옵션의 정렬 기준을 나타냅니다.
| 타입명 | 설명 |
|---|---|
| CREATE | 등록순 |
| ABC | 가나다순 |
| LOW_PRICE | 낮은 가격순 |
| HIGH_PRICE | 높은 가격순 |
Simple
필드 제약사항
# 옵션명
- 옵션명은 숫자로만 이루어 질 수 없습니다.
- 옵션명은 최대 5개까지 등록 가능합니다.
[
{
"name":"사이즈",
"value":"S",
"usable":true
},
{
"name":"사이즈",
"value":"M",
"usable":true
}
]
| 필드명 | 타입 | 설명 |
|---|---|---|
| name | String | 옵션명 (옵션명 숫자만 입력 불가) |
| value | String | 옵션값 |
| usable | Boolean | 사용여부. 제약사항 참고 |
Combination
필드 제약사항
# 재고수량
- 재고수량은 최소 1개 이상 최대 9999개 이하로 설정 가능합니다.
# 문자열 길이제한 / 특수문자 제한
- 독립형,조합형,작성형 옵션명은 20자까지 입력 가능합니다.
- 독립형,조합형 옵션값은 50자까지 입력 가능합니다.
# 옵션 등록 갯수 제한
- 상품의 하위 최종 옵션 갯수는 최대 1000개로 제한됩니다.
[
{
"name":[
{
"key":"사이즈",
"value":"M"
},
{
"key":"컬러",
"value":"RED"
}
],
"price":300,
"stockQuantity":50,
"managedCode":"kakao001",
"usable":true
}
]
| 필드명 | 타입 | 설명 |
|---|---|---|
| name | Array | 조합된 최종 옵션 |
| usable | Boolean | 사용여부. 제약사항 참고 |
| stockQuantity | Integer | 옵션재고 |
| managedCode | String | 옵션별 판매자 관리코드 |
Custom
필드 제약사항
# 옵션명
- 옵션명은 숫자로만 이루어질 수 없습니다.
- 최대 5개 까지 등록 가능합니다.
# 등록가이드
- 구매자가 작성시 준수 해야하는 등록 가이드를 입력해주세요.
[
{
"name":"각인 문구",
"description":"최대 10자까지 입력 가능합니다",
"usable":true
"inputRequired":true
"validationRequired":false
}
]| 필드명 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| name | String | 필수 | 작성형 옵션명 (숫자로만 구성된 옵션명 입력 불가) |
| description | String | 선택 | 등록 가이드 (최대 30자까지 등록 가능) |
| usable | Boolean | 필수 | 사용여부. 제약사항 참고 |
| inputRequired | Boolean | 필수 |
입력필수여부 ※ 26/04/07 부터 입력 |
| validationRequired | Boolean | 필수 |
입력제한조건 설정여부 ※ 26/04/07 부터 입력 |
| optionCustomValidation | Object | 선택 필수 |
입력제한조건 설정여부 true인 경우, 필수 입력 |