coupang
시작하기2024-09-09

상품 생성 방법 가이드

 

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

카테고리 메타정보 조회 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
}

 

 

다른 가이드