coupang
시작하기2025-07-28

상품 생성 방법 가이드

 

카테고리 별 필수 구매옵션 확인하는 법 

카테고리 메타정보 조회 API에서 조건 1 또는 조건 2를 만족하면, 필수 구매 옵션입니다. 

 

조건 1. 다음 파라미터 값을 만족하는 속성

  1. "required": "MANDATORY"
  2. "groupNumber": "NONE"
  3. "exposed": "EXPOSED" 

조건 2. 다음 파라미터 값을 가진 여러 속성 중 하나를 선택해서 입력해야 하는 속성

  1. “required”: "MANDATORY"
  2. "groupNumber": "1"
  3. "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

}

 

 

다른 가이드