商品注册

Example:
"certifications": [
       {
         "certificationType": "MOBILE_DEVICE_DEALER_PERMIT",
         "certificationCode": "",
         "certificationAttachments": [
           {
              "vendorPath": "http://vendor.com/image/vendoritem/3001519145/cert.jpg"
           },
           {
              "vendorPath": "http://vendor.com/image/vendoritem/3001519145/logo.jpg"
          }
         ]
       }
]

{
  "displayCategoryCode": 56137,
  "sellerProductName": "노트북 파우치 13인치",
  "vendorId": "A00012345",
  "saleStartedAt": "2017-11-30T00:00:00",
  "saleEndedAt": "2099-01-01T23:59:59",
  "displayProductName": "노트북 파우치 13인치",
  "brand": "삼성전자",
  "brandId": "100",
  "generalProductName": "노트북 파우치",
  "productGroup": "클렌징 오일",
  "deliveryMethod": "SEQUENCIAL",
  "deliveryCompanyCode": "KDEXP",
  "deliveryChargeType": "FREE",
  "deliveryCharge": 0,
  "freeShipOverAmount": 0,
  "deliveryChargeOnReturn": 2500,
  "remoteAreaDeliverable": "N",
  "unionDeliveryType": "UNION_DELIVERY",
  "returnCenterCode": "1000274592",
  "returnChargeName": "반품지_1",
  "companyContactNumber": "02-1234-678",
  "returnZipCode": "135-090",
  "returnAddress": "서울특별시 강남구 삼성동",
  "returnAddressDetail": "333",
  "returnCharge": 2500,
  "outboundShippingPlaceCode": "74010",
  "vendorUserId": "wing_loginId_123",
  "requested": true,
  "items": [
    {
      "itemName": "노트북 파우치 13인치",
      "originalPrice": 4980000,
      "salePrice": 4960000,
      "autoPricingInfo": {
        "minSalePrice": 40000000,
        "active": true
      },
      "maximumBuyCount": "100",
      "maximumBuyForPerson": "0",
      "outboundShippingTimeDay": "1",
      "maximumBuyForPersonPeriod": "1",
      "unitCount": 1,
      "adultOnly": "EVERYONE",
      "taxType": "TAX",
      "parallelImported": "NOT_PARALLEL_IMPORTED",
      "overseasPurchased": "NOT_OVERSEAS_PURCHASED",
      "pccNeeded": "false",
      "externalVendorSku": "0001",
      "barcode": "",
      "emptyBarcode": true,
      "emptyBarcodeReason": "상품확인불가_바코드없음사유",
      "modelNo": "171717",
      "extraProperties": {
        "coupangSalePrice": 5000,
        "onlineSalePriceForBooks": 10000,
        "transactionType": "manufacturer",
        "businessType": "Beauty"
      },
      "certifications": [
        {
          "certificationType": "NOT_REQUIRED",
          "certificationCode": ""
        }
      ],
      "searchTags": [
        "검색어1",
        "검색어2"
      ],
      "images": [
        {
          "imageOrder": 0,
          "imageType": "REPRESENTATION",
          "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2018/06/25/3719529368/27a6b898-ff3b-4a27-b1e4-330a90c25e9c.jpg"
        },
        {
          "imageOrder": 1,
          "imageType": "DETAIL",
          "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2017/02/21/3000169918/34b79649-d625-4f49-a260-b78bf7a573a8.jpg"
        },
        {
          "imageOrder": 2,
          "imageType": "DETAIL",
          "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2018/06/28/3000169918/5716aa61-70bd-47cd-8f3d-f3d49e7f496d.jpg"
        }
      ],
      "notices": [
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "용량(중량)",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "제품 주요 사양",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "사용기한 또는 개봉 후 사용기간",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "사용방법",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "제조업자 및 제조판매업자",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "제조국",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "화장품법에 따라 기재, 표시하여야 하는 모든 성분",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "식품의약품안전처 심사 필 유무",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "사용할 때 주의사항",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "품질보증기준",
          "content": "제품 이상 시 공정거래위원회 고시 소비자분쟁해결기준에 의거 보상합니다."
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "소비자상담관련 전화번호",
          "content": "상세페이지 참조"
        }
      ],
      "attributes": [
      {
          "attributeTypeName": "Global Trade Item Number",
          "attributeValueName": "8801234567890",
          "exposed": "NONE"
        },
        {
          "attributeTypeName": "Manufacturer Part Number",
          "attributeValueName": "T0123456",
          "exposed": "NONE"
        },
        {
          "attributeTypeName": "수량",
          "attributeValueName": "1개"
        }
      ],
      "contents": [
        {
          "contentsType": "TEXT",
          "contentDetails": [
            {
              "content": "<html><div></div><div><img src='http://image11.coupangcdn.com/image/product/content/vendorItem/2018/06/26/196713/738d905f-ed80-4fd8-ad21-ed87b195a19e.jpg' /><div></html>",
              "detailType": "TEXT"
            }
          ]
        }
      ],
      "offerCondition": "NEW",
      "offerDescription": ""
    },
    {
      "itemName": "노트북 파우치 15인치",
      "originalPrice": 5000000,
      "salePrice": 5000000,
      "autoPricingInfo": {
        "minSalePrice": 15000,
        "active": true
      },
      "maximumBuyCount": 100,
      "maximumBuyForPerson": 0,
      "outboundShippingTimeDay": 2,
      "maximumBuyForPersonPeriod": 1,
      "unitCount": 1,
      "adultOnly": "EVERYONE",
      "taxType": "TAX",
      "parallelImported": "NOT_PARALLEL_IMPORTED",
      "overseasPurchased": "NOT_OVERSEAS_PURCHASED",
      "pccNeeded": "false",
      "externalVendorSku": "0001",
      "barcode": "",
      "emptyBarcode": true,
      "emptyBarcodeReason": "상품확인불가_바코드없음사유",
      "modelNo": "171717",
      "extraProperties": {
        "coupangSalePrice": 5000,
        "onlineSalePriceForBooks": 10000,
        "transactionType": "manufacturer",
        "businessType": "Beauty"
      },
      "certifications": [
        {
          "certificationType": "NOT_REQUIRED",
          "certificationCode": ""
        }
      ],
      "searchTags": [
        "검색어1",
        "검색어2"
      ],
      "images": [
        {
          "imageOrder": 0,
          "imageType": "REPRESENTATION",
          "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2018/06/26/3001519145/74100e2a-d1ad-4b50-9c78-840c12a3e10d.jpg"
        },
        {
          "imageOrder": 1,
          "imageType": "DETAIL",
          "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2017/02/21/3000169918/34b79649-d625-4f49-a260-b78bf7a573a8.jpg"
        },
        {
          "imageOrder": 2,
          "imageType": "DETAIL",
          "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2018/06/28/3000169918/5716aa61-70bd-47cd-8f3d-f3d49e7f496d.jpg"
        }
      ],
      "notices": [
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "용량(중량)",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "제품 주요 사양",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "사용기한 또는 개봉 후 사용기간",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "사용방법",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "제조업자 및 제조판매업자",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "제조국",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "화장품법에 따라 기재, 표시하여야 하는 모든 성분",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "식품의약품안전처 심사 필 유무",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "사용할 때 주의사항",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "품질보증기준",
          "content": "상세페이지 참조"
        },
        {
          "noticeCategoryName": "화장품",
          "noticeCategoryDetailName": "소비자상담관련 전화번호",
          "content": "상세페이지 참조"
        }
      ],
      "attributes": [
              {
          "attributeTypeName": "Global Trade Item Number",
          "attributeValueName": "8801234567890"
        },
        {
          "attributeTypeName": "Manufacturer Part Number",
          "attributeValueName": "T0123456"
        },
        {
          "attributeTypeName": "수량",
          "attributeValueName": "1개"
        }
      ],
      "contents": [
        {
          "contentsType": "TEXT",
          "contentDetails": [
            {
              "content": "<html><div></div><div><img src='http://image11.coupangcdn.com/image/product/content/vendorItem/2018/06/26/196713/738d905f-ed80-4fd8-ad21-ed87b195a19e.jpg' /><div></html>",
              "detailType": "TEXT"
            }
          ]
        }
      ],
      "offerCondition": "NEW",
      "offerDescription": ""
    }
  ],
  "requiredDocuments": [
    {
      "templateName": "기타인증서류",
      "vendorDocumentPath": "http://image11.coupangcdn.com/image/product/content/vendorItem/2018/07/02/41579010/eebc0c30-8f35-4a51-8ffd-808953414dc1.jpg"
    }
  ],
  "extraInfoMessage": "",
  "manufacture": "아모레퍼시픽",
  "bundleInfo": {
       "bundleType": "SINGLE"
   }
}

响应参数 

名称	类型	描述
code	String	result code  SUCCES/ERROR
message	String	message
data	Long	registered product ID  =sellerProductId

 

响应示例

成功的响应

{
  "code": "200",
  "message": "",
  "data": {
    "code": "SUCCESS",
    "message": "",
    "data": 427011919
  }
}

值得注意的响应

1）'ERROR' 返回示例 

在此情况下，商品注册失败。您需要添加必填的购买选项属性。

{
  "code": "ERROR",   //
  "message": "[]. 유효하지 않은 구매 옵션 값 혹은 단위가 존재합니다.",
  "data": null,
  "details": "'30 개입'의 단위값이 유효하지 않습니다. '40 개입'의 단위값이 유효하지 않습니다. 다음과 같이 필수 구매 옵션 (미입력시 등록/노출 제한)을 입력해주세요. : '총 수량'. 자세한 사항은 아래 errorItems 에서 확인할 수 있습니다. 또한, 카테고리 메타 정보 조회 API(https://developers.coupangcorp.com/hc/en-us/articles/360034035713-Category-Metadata-Query) 혹은 공지사항에서 업데이트된 내용 확인할 수 있으며, 상품 생성 API (https://developers.coupangcorp.com/hc/en-us/articles/360033877853-Product-Creation)에서 업데이트된 에러 스펙 확인할 수 있습니다.",
  "errorItems": [
      {
          "itemIndex": 0,
          "itemName": "190ml 30개",
          "itemAttributes": [
              {
                  "attributeTypeName": "총 수량",
                  "attributeValueName": null,
                  "message": "필수 구매 옵션 (미입력시 등록/노출 제한) 존재하지 않습니다."
              }
          ]
      },
      {
          "itemIndex": 1,
          "itemName": "190ml 40개",
          "itemAttributes": [
              {
                  "attributeTypeName": "총 수량",
                  "attributeValueName": "40 개입",
                  "message": "유효하지 않은 단위값입니다."
              }
          ]
      }
  ]
}

2）'Success' 返回示例 

在此情况下，发生了 MOTA 错误，您需要更新属性值。

{
   "code": "SUCCESS",
   "message": "[]",
   "data": 16009258995,
   "details": "다음과 같이 필수 구매 옵션을 입력해주세요. : '개당 용량' or '개당 중량'. 다음과 같이 필수 구매 옵션 (미입력시 등록/노출 제한)을 입력해주세요. : '개당 용량' and '개당 중량'. 자세한 사항은 아래 errorItems 에서 확인할 수 있습니다. 또한, 카테고리 메타 정보 조회 API(https://developers.coupangcorp.com/hc/en-us/articles/360034035713-Category-Metadata-Query) 혹은 공지사항에서 업데이트된 내용 확인할 수 있으며, 상품 생성 API (https://developers.coupangcorp.com/hc/en-us/articles/360033877853-Product-Creation)에서 업데이트된 에러 스펙 확인할 수 있습니다.",
   "errorItems": [
       {
           "itemIndex": 0,
           "itemName": "350ml 1개",
           "itemAttributes": [
               {
                   "attributeTypeName": "개당 용량",
                   "attributeValueName": null,
                   "message": "번들 속성 그룹(groupNumber=1)의 '개당 용량', '개당 중량'에서 필수 속성을 하나만 선택합니다"
               },
               {
                   "attributeTypeName": "개당 중량",
                   "attributeValueName": null,
                   "message": "번들 속성 그룹(groupNumber=1)의 '개당 용량', '개당 중량'에서 필수 속성을 하나만 선택합니다"
               },
               {
                   "attributeTypeName": "개당 용량",
                   "attributeValueName": null,
                   "message": "필수 구매 옵션 (미입력시 등록/노출 제한) 존재하지 않습니다."
               },
               {
                   "attributeTypeName": "개당 중량",
                   "attributeValueName": null,
                   "message": "필수 구매 옵션 (미입력시 등록/노출 제한) 존재하지 않습니다."
               }
           ]
       }
   ]
}

错误码提示

HTTP 状态代码 (错误类型)	错误信息	解决方案
400 (确认请求参数)	Error："The value of attributeValueName is incorrect. Please enter the acceptable values as following the error spec guide.”   attributeValueName 的值不正确。 请按照错误规范指南输入可接受的值	请确认输入的尿布级别是否可用，只能输入以下值，每个库存ID最多可以新输入1个值。 1단계, 2단계, 3단계, 4단계, 5단계, 6단계, 7단계, 신생아(NB), 소형(S), 중형(M), 대형(L), 특대형(XL), 점보형(2XL), 점보형 이상(3XL)
400 (确认请求参数)	品类的必需属性不存在。	这是属性（attributes）值中必需（MANDATORY）  输入的项目被遗漏时发生的错误，需要通过“品类元数据查询API”确认并输入所需的属性值。
400 (确认请求参数)	必填购买选项（若未输入将导致注册/曝光受限）不存在。	请输入必填购买选项。请检查商品详情，确保已正确输入必要的选项值。
400 (确认请求参数)	输入值错误。line: 123	确认请求的 JSON 文本相应line中输入的参数、值和数组格式是否正确。
400 (确认请求参数)	请输入正确的退货中心代码。	通过“发货地&退货地查询API”确认您输入的发货地和退货地代码是否正确。
400 (确认请求参数)	java.lang.NullPointerException	需要确认请求的 JSON 文本中是否存在拼写错误。.
400 (确认请求参数)	输入的商品必需通知信息[例如：制造商和制造经销商]与品类[例如：化妆品]中提供的信息不同。	这是输入的通知信息有问题时出现的错误。请查询品类元数据信息，确认其是否与输入的通知信息（“notices”：[]）完全一致。
400 (确认请求参数)	配送费类型为满19800免费配送时，	如果设置了 freeShipOverAmount:19800，
400 (确认请求参数)	指定条件包邮价格为19800韩元，初始运费为0韩元。	则需要确认初始运费 (deliveryChargeOnReturn) 值是否输入为“0”。
400 (确认请求参数)	请确认[物流公司代码]。	如果设置了偏远地区配送（remoteAreaDeliverable：“Y”），则只能输入在发货地注册的物流公司。
400 (确认请求参数)	UNAUTHORIZATION	这是因认证信息不正确而出现的错误。请确认认证是否正确。
400 (check request parameter)	请检查送货方式。	如果您选择海外代购（AGENT_BUY），请检查收货地址是否为海外收货地址。 无法选择国内（韩国）收货地址。
400 (check request parameter)	如果发货方式是代购(AGENT_BUY)，Coupang强制要求客户进入PCCC发货。	如果选择海外代购（AGENT_BUY），请检查pccNeeded参数值是否设置为true。
400 (check request parameter)	autoPricingInfo.minSalePrice must be less than salePrice	请将 minSalePrice 设为低于 salePrice
400 (check request parameter)	autoPricingInfo cannot be modified after product approval	审批通过后请改用 [按 item 改价] API

 

※ 注意事项 

确认过商品创建成功的消息后，酷澎建议您通过【商品列表区间查询API】或WING 查看商品状态是否为“已批准”。 

• 如果状态为“未通过审批”，请确认拒绝原因，修改后重新申请审批。 

• 可通过WING中的状态修改记录或[商品状态修改记录查询API]查看“未通过审批”的原因。 

             *商品创建及API修改的调用不得超过每秒十次。 

 

URL API Name

CREATE_PRODUCT