필수 구매 옵션을 이해해야 하는 이유
2024년 10월 10일부터는 카테고리 별 매핑되지 않은 구매 옵션을 임의로 만들어 등록할 수 없습니다. 예를 들어, 카테고리 A의 필수 구매 옵션이 '수량', ‘용량' 속성일 경우, ‘색상’ 옵션을 입력하면 상품 등록이 실패합니다.
카테고리 별 필수 구매옵션 확인하는 법
카테고리 메타정보 조회 API에서 조건 1 또는 조건 2를 만족하면, 필수 구매 옵션입니다.
조건 1. 다음 파라미터 값을 만족하는 속성
- "required": "MANDATORY"
- "groupNumber": "NONE"
- "exposed": "EXPOSED"
조건 2. 다음 파라미터 값을 가진 여러 속성 중 하나를 선택해서 입력해야 하는 속성
- “required”: "MANDATORY"
- "groupNumber": "1"
- "exposed": "EXPOSED"
필수 구매 옵션 별 입력 가능 값 확인하는 법
카테고리 메타 정보 조회 API에서 필수 구매 옵션 별 입력 가능 값을 확인할 수 있습니다.
- "dataType" 필드를 통해 입력 가능한 데이터 타입 확인 (NUMBER, SELECT, STRING 등)
- "usableUnits" 필드를 통해 입력 가능한 속성의 단위 값 확인 (kg, g, 개, 세트 등)
카테고리 메타 정보 조회 API 예시 - Category ID 27742 (비타민)
| { "isAllowSingleItem": null, "attributes": [ { "attributeTypeName": "개당 캡슐/정", "dataType": "NUMBER", "basicUnit": "개", "usableUnits": [ "캡슐", "정", "회분" ], "required": "MANDATORY", "groupNumber": "1", "exposed": "EXPOSED" }, { "attributeTypeName": "개당 중량", "dataType": "NUMBER", "basicUnit": "g", "usableUnits": [ "mg", "g", "kg", "oz", "lb" ], "required": "MANDATORY", "groupNumber": "1", "exposed": "EXPOSED" }, { "attributeTypeName": "개당 용량", "dataType": "NUMBER", "basicUnit": "ml", "usableUnits": [ "ml", "L", "cc" ], "required": "MANDATORY", "groupNumber": "1", "exposed": "EXPOSED" }, { "attributeTypeName": "수량", "dataType": "NUMBER", "basicUnit": "개", "usableUnits": [ "개", "세트", "박스" ], "required": "MANDATORY", "groupNumber": "NONE", "exposed": "EXPOSED" }, { "attributeTypeName": "번들사이즈", "dataType": "NUMBER", "basicUnit": "개", "usableUnits": [ "개", "개입", "매", "매입", "팩", "입", "장", "병", "인용", "인분", "box", "Ea", "포", "캔", "박스", "스틱", "권", "set", "세트", "조", "캡슐", "통", "정", "봉", "마리", "롤", "p", "구", "피스", "회", "회분", "단계", "번", "프렛", "음판", "건반", "쪽", "단", "칸", "종", "분류", "현", "선", "공", "자리", "폭", "rpm", "색", "대", "쌍" ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "영양제 사용대상", "dataType": "STRING", "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "영양제 타입", "dataType": "STRING", "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "총 캡슐/정 수량", "dataType": "NUMBER", "basicUnit": "개", "usableUnits": [ "개", "개입", "매", "매입", "팩", "입", "장", "병", "인용", "인분", "box", "Ea", "포", "캔", "박스", "스틱", "권", "set", "세트", "조", "캡슐", "통", "정", "봉", "마리", "롤", "p", "구", "피스", "회", "회분", "단계", "번", "프렛", "음판", "건반", "쪽", "단", "칸", "종", "분류", "현", "선", "공", "자리", "폭", "rpm", "색", "대", "쌍" ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "비건 여부", "dataType": "STRING", "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "유기농/친환경 등", "dataType": "STRING", "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "대용량상품", "dataType": "STRING", "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "영양제 영양 성분", "dataType": "STRING", "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "건강기능식품", "dataType": "STRING", "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "구성품", "dataType": "STRING", "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "식품 프리미엄", "dataType": "STRING", "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" } ], "noticeCategories": null, "requiredDocumentNames": null, "certifications": null } |
카테고리 메타 정보 조회 API 예시 - Category ID 62676 (휴대폰 악세서리)
| { "isAllowSingleItem": false, "attributes": [ { "attributeTypeName": "색상", "dataType": "STRING", "inputType": "INPUT", "inputValues": [ ], "basicUnit": "없음", "usableUnits": [ ], "required": "MANDATORY", "groupNumber": "NONE", "exposed": "EXPOSED" }, { "attributeTypeName": "수량", "dataType": "NUMBER", "inputType": "INPUT", "inputValues": [ ], "basicUnit": "개", "usableUnits": [ "개", "개입", "세트" ], "required": "MANDATORY", "groupNumber": "NONE", "exposed": "EXPOSED" }, { "attributeTypeName": "사용 용도", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "스마트폰용", "태블릿용", "스마트폰+태블릿" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "거치대 고정 방식", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "스탠드형", "집게형", "클램프형", "부착형", "볼트 고정형" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "바디조절 방식", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "고정형", "자바라/관절형", "스프링형", "접이식형" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "후면거울", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "가능" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "시계줄 재질", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "가죽", "스테인리스/메탈", "고무/실리콘", "패브릭/나일론", "티타늄", "우레탄/젤리", "직물/플라스틱", "뱅글/팔찌" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "캐릭터", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "가면라이더", "펭수", "건담", "겨울왕국", "도라에몽", "드래곤볼", "또봇", "똘똘이", "라바", "레고", "로보카폴리", "리락쿠마", "마블", "미니특공대", "미키프렌즈", "미피", "뽀로로", "스타워즈", "실바니안패밀리", "요괴워치", "원피스", "코코몽", "콩순이", "콩지", "타요", "터닝메카드", "토마스와 친구들", "파워레인저", "포켓몬스터", "푸", "헬로카봇", "헬로키티", "쥬쥬", "미미", "바비", "크니쁘니", "팬돌이", "로지", "브레드이발소", "어몽어스", "에디슨프렌즈", "캐치티니핑", "바이트초이카", "동물의숲", "슈퍼마리오", "스누피" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "색상계열", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "블랙계열", "네이비계열", "그레이계열", "실버계열", "레드계열", "오렌지계열", "옐로우계열", "그린계열", "블루계열", "바이올렛/보라계열", "핑크계열", "화이트계열", "브라운계열", "골드계열", "베이지계열", "멀티(혼합)컬러", "투명계열" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "시계판 사이즈", "dataType": "NUMBER", "inputType": "INPUT", "inputValues": [ ], "basicUnit": "cm", "usableUnits": [ "mm", "cm", "m", "km" ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "애플펜슬 모델", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "1세대", "2세대", "C타입" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "삼각대/셀카봉 용도", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "스마트폰", "카메라", "액션캠" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "블루투스 가능여부", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "블루투스 가능" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "최대 무게/체중", "dataType": "NUMBER", "inputType": "INPUT", "inputValues": [ ], "basicUnit": "g", "usableUnits": [ "mg", "g", "kg", "t", "oz", "lb" ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "최장 길이", "dataType": "NUMBER", "inputType": "INPUT", "inputValues": [ ], "basicUnit": "cm", "usableUnits": [ "mm", "cm", "m", "km" ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "휴대폰스트랩 형태", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "핑거형", "목걸이형" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "스트랩 여부", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "스트랩있음" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "휴대폰스트랩 구성", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "스트랩", "스트랩+케이스" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "펜촉교체 가능 여부", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "펜촉교체 가능" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "터치팁 형태", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "펜슬팁", "볼팁", "디스크팁", "볼팁+디스크팁" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "패션 잡화/슈즈 장식", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "스터드/찡", "퀼팅", "체인", "버클/벨티드", "비즈/스팽글/진주", "팬던트/참", "태슬/수술", "리본", "폼폼/퍼", "지퍼", "끈/레이스업", "벨크로", "브로그", "토글", "패치", "자수", "단추" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "패션 의류/잡화 색상계열", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "블랙계열", "네이비계열", "그레이계열", "실버계열", "레드계열", "오렌지계열", "옐로우계열", "그린계열", "블루계열", "바이올렛/보라계열", "핑크계열", "화이트계열", "브라운계열", "골드계열", "베이지계열", "멀티(혼합)컬러", "투명" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "패션 잡화 소재", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "가죽", "인조가죽(합성피혁)", "면(아사)/캔버스", "실크(견)", "캐시미어혼방", "왕골(밀짚)", "리얼퍼", "에나멜", "젤리/고무", "데님/청", "쉬폰", "새틴", "메쉬/망사", "코듀로이/골덴", "스웨이드/무스탕", "패딩/누빔", "송치" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "성별", "dataType": "STRING", "inputType": "SELECT", "inputValues": [ "여아용", "남아용", "아동공용", "여성용", "남성용", "남여공용" ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" }, { "attributeTypeName": "출시년월", "dataType": "STRING", "inputType": "INPUT", "inputValues": [ ], "basicUnit": "없음", "usableUnits": [ ], "required": "OPTIONAL", "groupNumber": "NONE", "exposed": "NONE" } |
상품 등록 시 Response Message 예시
|
{ "code": "SUCCESS", "message": "유효하지 않은 구매 옵션 값 혹은 단위가 존재합니다.", "details": %attributeValueName% 의 단위값이 유효하지 않습니다. 자세한 사항은 아래 errorItems 에서 확인할 수 있습니다. 또한, 카테고리 메타 정보 조회 API(https://developers.coupangcorp.com/hc/en-us/articles/360034035713-Category-Metadata-Query) 혹은 공지사항에서 업데이트된 내용 확인할 수 있습니다.", "errorItems": [ { "itemIndex": 0, "itemName": "coke 500ml 10ea", "attributes": [ { "attributeTypeName": "quantity", "attributeValueName": "100ml", "message": "유효하지 않은 단위값입니다." } ] } ], "data": null } |