您可通过注册商品ID(sellerProductId)查询已注册商品的信息。
并查看修改商品价格/库存/销售状态时所需的属性 ID (vendorItemId)。此外,通过查询商品信息,您还可以获得用于商品修改的详细信息。
Path
GET
/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}
Example Endpoint
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}
请求参数
路径参数
参数名称 | 是否必填 | 类型 | 描述 | ||||
---|---|---|---|---|---|---|---|
sellerProductId | O | Number |
注册商品ID 商品创建完成时显示的注册商品ID |
请求体示例
响应消息
参数 | 类型 | 描述 | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
code | String |
结果代码 SUCCES/ERROR
|
||||||||||||||||||||||||
message | String |
|
||||||||||||||||||||||||
data |
|
|||||||||||||||||||||||||
sellerProductId | Number |
注册商品ID |
||||||||||||||||||||||||
statusName | String |
注册商品状态 审批中/临时保存/待审批/已批准/部分批准/未通过审批/商品已删除 |
||||||||||||||||||||||||
displayCategoryCode | Number |
显示品类代码 可通过品类列表查询API或下载品类信息Excel查看 |
||||||||||||||||||||||||
sellerProductName | String |
注册商品名 订单上的商品名 |
||||||||||||||||||||||||
vendorId | String |
卖家ID 酷澎提供给卖家的固有代码 |
||||||||||||||||||||||||
saleStartedAt | String |
销售开始日期 格式为"yyyy-MM-dd'T'HH:mm:ss" |
||||||||||||||||||||||||
saleEndedAt | String |
销售结束日期 格式为"yyyy-MM-dd'T'HH:mm:ss" , *年份可选择至2099年 |
||||||||||||||||||||||||
displayProductName | String |
显示商品名 此为实际在酷澎销售页面上显示的商品名,可能会根据品牌、商品名、商品群的变化而改变。 |
||||||||||||||||||||||||
brand | String |
品牌 输入品牌的韩文/英文标准名称 |
||||||||||||||||||||||||
generalProductName | String |
商品名 不包括购买属性[Attribute exposed]信息(尺寸、颜色等)。 |
||||||||||||||||||||||||
productGroup | String |
商品群 即商品类型; 输入商品群时,可参考显示品类的最下位名称。 与商品名[generalProductName]重复时,无需输入 |
||||||||||||||||||||||||
deliveryMethod | String |
配送方式
|
||||||||||||||||||||||||
deliveryCompanyCode | String |
物流代码,
注意:必须填写以下链接里Coupang支持的物流公司代码Link for courier codes
|
||||||||||||||||||||||||
deliveryChargeType | String |
配送费类型
※ 使用[CONDITIONAL_FREE]时,您可单独设置想要的指定条件包邮值。 |
||||||||||||||||||||||||
deliveryCharge | Number |
基本运费 若为付费配送或指定条件包邮,请输入单程运费值。 |
||||||||||||||||||||||||
freeShipOverAmount | Number |
免运费门槛
※ 输入单位须大于100韩元 (以100为增量) ※ 免费配送时,请输入0 |
||||||||||||||||||||||||
deliveryChargeOnReturn | Number |
初始退货运费 若为免费配送,则顾客支付退货运费 |
||||||||||||||||||||||||
remoteAreaDeliverable | String |
偏远地区配送与否
|
||||||||||||||||||||||||
unionDeliveryType | String |
捆绑配送与否
※ 捆绑配送条件 必须输入发货地信息(只有发货地信息相同的商品才能捆绑配送) 不可设置“不可运费到付” |
||||||||||||||||||||||||
returnCenterCode | String |
退货中心代码 在酷澎WING中注册配送地后确认 |
||||||||||||||||||||||||
returnChargeName | String |
退货地名称 在酷澎WING中注册配送地后确认 |
||||||||||||||||||||||||
companyContactNumber | String |
退货地联系方式 在酷澎WING中注册配送地后确认 |
||||||||||||||||||||||||
returnZipCode | String |
退货地邮政编码 在酷澎WING中注册配送地后确认 |
||||||||||||||||||||||||
returnAddress | String |
退货地址 在酷澎WING中注册配送地后确认 |
||||||||||||||||||||||||
returnAddressDetail | String |
退货地详细地址 在酷澎WING中注册配送地后确认 |
||||||||||||||||||||||||
returnCharge | Number |
退货运费 回收退货商品时的单程运费 |
||||||||||||||||||||||||
outboundShippingPlaceCode | Number |
发货地代码 选择捆绑配送时必填。可通过“发货地查询API”进行查询 |
||||||||||||||||||||||||
vendorUserId | String |
真实用户ID(酷澎WING ID) 属于卖家(Vendor)的用户ID |
||||||||||||||||||||||||
requested | Boolean |
是否自动申请批准 Y/N
|
||||||||||||||||||||||||
items | List |
卖家商品属性列表
|
||||||||||||||||||||||||
sellerProductItemId | Number |
卖家商品属性ID
|
||||||||||||||||||||||||
isAutoGenerated | String |
自动生成商品选项(true或false) |
||||||||||||||||||||||||
vendorItemId | Number |
属性 ID 临时保存状态时,属性ID值为Null。您可在商品审批完成后,查看到该值。 |
||||||||||||||||||||||||
itemName | String |
卖家商品属性名
|
||||||||||||||||||||||||
originalPrice | Number |
折扣率基准价 此为折扣前的价格,以显示折扣率(%)。如果输入的价格与销售价格相同,则显示为“酷澎价”(saleprice) 审批完成后可通过[修改各属性折扣率基准价]API修改 |
||||||||||||||||||||||||
salePrice | Number |
售价 输入售价 最初进行商品注册时,只能在申请商品审批前输入售价 审批完成后,可通过[修改各商品售价]API修改 |
||||||||||||||||||||||||
maximumBuyCount | Number |
可售数量 输入可销售的库存数量。 “最初”注册商品时,只能在申请商品审批前输入可销售数量。审批通过后,可通过[修改各属性数量]API修改 |
||||||||||||||||||||||||
maximumBuyForPerson | Number |
人均最多可购买数量 每人最多可购买的数量。 如果没有限制,请输入“0” (例如:如果输入的人均最多可购买数量为 100,最长购买期限为 3。那么这意味着,一个人在3天内最多可购买 100 件) |
||||||||||||||||||||||||
maximumBuyForPersonPeriod | Number |
最长购买期限 设置某个时间段内每人可以购买的最大数量 。 如果没有限制,请输入“1” (例如:如果输入的人均最多可购买数量为 100,最长购买期限为 3。那么这意味着,一个人在3天内最多可购买 100 件) |
||||||||||||||||||||||||
outboundShippingTimeDay | Number |
标准发货日(天) 预计交货日在下单日(D-Day)之后,请以“天”为单位输入。 (例如:次日(D+1)发货,请输入“1”) |
||||||||||||||||||||||||
adultOnly | String |
19岁及以上
|
||||||||||||||||||||||||
taxType | String |
是否需纳税
|
||||||||||||||||||||||||
parallelImported | String |
是否为平行进口
|
||||||||||||||||||||||||
overseasPurchased | String |
是否为海外代购
|
||||||||||||||||||||||||
pccNeeded | Boolean |
是否需要PCC(个人通关代码) 海外代购商品需要PCC。 默认值:不需要(false)。需要(true)时,顾客购买商品时须输入PCC;不需要(false)时,无需输入PCC也可购买。 |
||||||||||||||||||||||||
bestPriceGuaranteed3P | Boolean |
是否保证最低价 true/false |
||||||||||||||||||||||||
externalVendorSku | String |
卖家商品编号 (企业商品编号) 可任意设置卖家固有的商品编号值,输入值包含在订单查询API response中。 |
||||||||||||||||||||||||
barcode | String |
条形码 |
||||||||||||||||||||||||
emptyBarcode | Boolean |
无条形码 若无条形码,则为True |
||||||||||||||||||||||||
emptyBarcodeReason | String |
为什么没有条形码?(最大长度:100个字符) |
||||||||||||||||||||||||
modelNo | String |
型号 |
||||||||||||||||||||||||
extraProperties |
卖家商品属性的附加信息 Key : 以值的形态存在。可根据需要多次重复输入。 |
|||||||||||||||||||||||||
Key | String |
值
|
||||||||||||||||||||||||
certifications | List |
商品认证信息 商品认证信息 |
||||||||||||||||||||||||
certificationType | String |
认证信息类型 可通过“品类元数据查询API”获取认证信息类型 非认证对象品类:NOT_REQUIRED |
||||||||||||||||||||||||
certificationCode | String |
商品认证信息编号 该编号由认证机构颁发 |
||||||||||||||||||||||||
certificationAttachments | List<Map<String,String>> |
认证信息附件 认证机构提供的移动设备卖方许可证证书图像; Map 的 key 固定为以下两个,只需要其中一个:
注意: 用于注册手机电子产品类别(displayCategoryCode = 62600, 家电/数码>手机/平板电脑/配件>手机/平板电脑>手机>裸机), 2. 零售商预先批准的认证标志或移动运营商的认证标志 Example:
|
||||||||||||||||||||||||
searchTags | List |
搜索词 可根据需要重复输入。["搜索词1","搜索词2"] |
||||||||||||||||||||||||
images | List |
图片列表 可根据需要重复输入 |
||||||||||||||||||||||||
imageOrder | Number |
图片标示顺序 0,1,2... |
||||||||||||||||||||||||
imageType | String |
图片类型 主图类型 可将3MB或以下的正方形图片以 JPG /PNG格式上传(最小 500 x 500 px,最大 5000 x 5000 px)
REPRESENTATION : 正方形主图
DETAIL : 其它图片(最多可上传9个) USED_PRODUCT : 曾用图片(最多可上传4个) |
||||||||||||||||||||||||
cdnPath | String |
酷澎CDN路径 如果上传到酷澎CDN,请手动输入,且须在vendorPath和cdnPath中至少任选其一 |
||||||||||||||||||||||||
vendorPath | String |
卖家图片路径 卖家使用的图像路径。 若路径以 http://为开头,则会被自动下载并添加至酷澎CDN。且须在vendorPath和cdnPath中至少任选其一 |
||||||||||||||||||||||||
notices | List |
商品通知信息列表
|
||||||||||||||||||||||||
noticeCategoryName | String |
商品通知信息品类名 为各品类输入一个可用的商品通知信息品类 |
||||||||||||||||||||||||
noticeCategoryDetailName | String |
商品通知信息品类详细名
|
||||||||||||||||||||||||
content | String |
内容
|
||||||||||||||||||||||||
attributes | List |
属性列表(属性) 该列表中输入的属性以品类为基准。销售申请批准前,只能查询所输入的属性项目。批准后,可搜索为让该商品显示在酷澎目录中而推荐的所有属性项目。未输入的项目的attributeValueName为“”值。(请参考Response Example) |
||||||||||||||||||||||||
attributeTypeName | String |
属性类型名
|
||||||||||||||||||||||||
attributeValueName | String |
属性值
|
||||||||||||||||||||||||
exposed | String |
购买属性/搜索属性区分字段 EXPOSED : 购买属性 NONE : 搜索属性 |
||||||||||||||||||||||||
editable | String |
是否修改区分字段 true : 可修改 false : 不可修改 |
||||||||||||||||||||||||
contents | List |
内容列表 可根据需要重复输入 |
||||||||||||||||||||||||
contentsType | String |
内容类型
|
||||||||||||||||||||||||
contentDetails | List |
详细内容列表
|
||||||||||||||||||||||||
content | String |
内容
|
||||||||||||||||||||||||
detailType | String |
详细类型
|
||||||||||||||||||||||||
offerCondition | String |
商品状态 商品创建后,无法修改offerCondition。
|
||||||||||||||||||||||||
offerDescription | String |
曾用商品的详细说明
对曾用商品状态的说明,700个字符以内 仅在offerCondition输入为“曾用”时可用 |
||||||||||||||||||||||||
requiredDocuments | List |
必须提交所需文件时输入 |
||||||||||||||||||||||||
templateName | String |
所需文件模版名 |
||||||||||||||||||||||||
documentPath | String |
所需文件酷澎CDN路径 须在documentPath和vendorDocumentPath中任选其一 |
||||||||||||||||||||||||
vendorDocumentPath | String |
所需文件卖家路径 所需文件路径。若路径以 http://为开头,则会被自动下载并添加至酷澎CDN。须在documentPath和vendorDocumentPath中任选其一 |
||||||||||||||||||||||||
extraInfoMessage | String |
订制指南 将配送方式选为“订制”时,请输入要发给顾客的信息 |
||||||||||||||||||||||||
manufacture | String |
制造商 |
Response Example
{
"code": "SUCCESS",
"message": "",
"data": {
"sellerProductId": 123459542,
"sellerProductName": "test_클렌징오일_관리용_상품명",
"displayCategoryCode": 56137,
"categoryId": 1617,
"productId": 131023672,
"vendorId": "A0001235",
"mdId": "NLUP",
"mdName": "dummy",
"saleStartedAt": "2019-01-09T18:41:14",
"saleEndedAt": "2099-01-01T23:59:59",
"displayProductName": "해피바스 솝베리 클렌징 오일",
"brand": "해피바스",
"generalProductName": "솝베리 클렌징 오일",
"productGroup": "클렌징 오일",
"statusName": "승인완료",
"deliveryMethod": "VENDOR_DIRECT",
"deliveryCompanyCode": "KDEXP",
"deliveryChargeType": "FREE",
"deliveryCharge": 0,
"freeShipOverAmount": 0,
"deliveryChargeOnReturn": 2500,
"deliverySurcharge": 0,
"remoteAreaDeliverable": "N",
"bundlePackingDelivery": 0,
"unionDeliveryType": "UNION_DELIVERY",
"returnCenterCode": "1234274592",
"returnChargeName": "반품지_1",
"companyContactNumber": "02-1234-678",
"returnZipCode": "06168",
"returnAddress": "서울특별시 강남구 삼성동",
"returnAddressDetail": "1-23 19층",
"returnCharge": 2500,
"outboundShippingPlaceCode": 74010,
"vendorUserId": "wing_loginId_123",
"requested": false,
"items": [
{
"offerCondition": "NEW",
"offerDescription": null,
"sellerProductItemId": 1271845812,
"vendorItemId": 4279191312,
"itemId": 362266710,
"itemName": "200ml_1개_(변경될수있음)",
"originalPrice": 0,
"salePrice": 1280960,
"supplyPrice": 1111873,
"maximumBuyCount": 1,
"maximumBuyForPerson": 0,
"outboundShippingTimeDay": 2,
"maximumBuyForPersonPeriod": 1,
"unitCount": 1,
"adultOnly": "EVERYONE",
"freePriceType": null,
"taxType": "TAX",
"parallelImported": "NOT_PARALLEL_IMPORTED",
"overseasPurchased": "NOT_OVERSEAS_PURCHASED",
"externalVendorSku": "0001",
"pccNeeded": false,
"bestPriceGuaranteed3P": false,
"emptyBarcode": true,
"emptyBarcodeReason": "상품확인불가_바코드없음사유",
"barcode": null,
"saleAgentCommission": 9,
"modelNo": "171717",
"images": [
{
"imageOrder": 0,
"imageType": "REPRESENTATION",
"cdnPath": "vendor_inventory/images/2019/01/09/18/9/3c1cee6d-9ab1-454a-8742-de94215cab1b.jpg",
"vendorPath": "151009021007000006.jpg"
},
{
"imageOrder": 1,
"imageType": "DETAIL",
"cdnPath": "vendor_inventory/images/2019/01/09/18/4/b43651a8-974e-4965-a650-9238ea1ecc15.jpg",
"vendorPath": "plg27673_0000004440.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": "피부타입",
"attributeValueName": "",
"exposed": "NONE",
"editable": true
},
{
"attributeTypeName": "피부고민",
"attributeValueName": "",
"exposed": "NONE",
"editable": true
},
{
"attributeTypeName": "수량",
"attributeValueName": "1개",
"exposed": "EXPOSED",
"editable": true
},
{
"attributeTypeName": "개당 중량",
"attributeValueName": "",
"exposed": "EXPOSED",
"editable": true
},
{
"attributeTypeName": "사용 부위",
"attributeValueName": "",
"exposed": "NONE",
"editable": true
},
{
"attributeTypeName": "개당 용량",
"attributeValueName": "200ml",
"exposed": "EXPOSED",
"editable": true
}
],
"contents": [
{
"contentsType": "TEXT",
"contentDetails": [
{
"content": "<div><\/div> <div> <img src=\"http://img1a.coupangcdn.com/image/vendor_inventory/images/2019/01/09/18/7/0338f9a4-d6cb-4713-9948-5f49c4a61f27.jpeg\"> <div><\/div> <\/div>",
"detailType": "TEXT"
}
]
}
],
"certifications": [
{
"certificationType": "NOT_REQUIRED",
"certificationCode": ""
}
],
"extraProperties": {
"transactionType": "manufacturer",
"onlineSalePriceForBooks": "10000",
"coupangSalePrice": "5000",
"businessType": "Beauty"
},
"searchTags": [
"검색어1",
"검색어2"
]
},
{
"offerCondition": "NEW",
"offerDescription": null,
"sellerProductItemId": 1271845813,
"vendorItemId": 4279191317,
"itemId": 385617482,
"itemName": "200ml_2개(변경될 수 있음)",
"originalPrice": 13000,
"salePrice": 10000,
"supplyPrice": 8680,
"maximumBuyCount": 1,
"maximumBuyForPerson": 0,
"outboundShippingTimeDay": 2,
"maximumBuyForPersonPeriod": 1,
"unitCount": 1,
"adultOnly": "EVERYONE",
"freePriceType": null,
"taxType": "TAX",
"parallelImported": "NOT_PARALLEL_IMPORTED",
"overseasPurchased": "NOT_OVERSEAS_PURCHASED",
"externalVendorSku": "0001",
"pccNeeded": false,
"bestPriceGuaranteed3P": false,
"emptyBarcode": true,
"emptyBarcodeReason": "상품확인불가_바코드없음사유",
"barcode": null,
"saleAgentCommission": 9,
"modelNo": "171717",
"images": [
{
"imageOrder": 0,
"imageType": "REPRESENTATION",
"cdnPath": "vendor_inventory/images/2019/01/09/18/7/17173ab4-db79-48ab-8d29-4e1a7126abbf.jpg",
"vendorPath": "151009021007000006.jpg"
},
{
"imageOrder": 1,
"imageType": "DETAIL",
"cdnPath": "vendor_inventory/images/2019/01/09/18/3/a455fe6a-ea81-40e8-85ca-547db8d27c16.jpg",
"vendorPath": "plg27673_0000004440.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": "피부타입",
"attributeValueName": "",
"exposed": "NONE",
"editable": true
},
{
"attributeTypeName": "피부고민",
"attributeValueName": "",
"exposed": "NONE",
"editable": true
},
{
"attributeTypeName": "수량",
"attributeValueName": "2개",
"exposed": "EXPOSED",
"editable": true
},
{
"attributeTypeName": "개당 중량",
"attributeValueName": "",
"exposed": "EXPOSED",
"editable": true
},
{
"attributeTypeName": "사용 부위",
"attributeValueName": "",
"exposed": "NONE",
"editable": true
},
{
"attributeTypeName": "개당 용량",
"attributeValueName": "200ml",
"exposed": "EXPOSED",
"editable": true
}
],
"contents": [
{
"contentsType": "TEXT",
"contentDetails": [
{
"content": "<div><\/div> <div> <img src=\"http://img1a.coupangcdn.com/image/vendor_inventory/images/2019/01/09/18/7/0338f9a4-d6cb-4713-9948-5f49c4a61f27.jpeg\"> <div><\/div> <\/div>",
"detailType": "TEXT"
}
]
}
],
"certifications": [
{
"certificationType": "NOT_REQUIRED",
"certificationCode": ""
}
],
"extraProperties": {
"transactionType": "manufacturer",
"onlineSalePriceForBooks": "10000",
"coupangSalePrice": "5000",
"businessType": "Beauty"
},
"searchTags": [
"검색어1",
"검색어2"
]
}
],
"requiredDocuments": [
],
"extraInfoMessage": null,
"manufacture": "제조사_테스트",
"productOrigin": "GENERAL"
}
}
Error Spec
HTTP 状态代码 (错误类型 | 错误信息 | 解决方案 |
---|---|---|
400 (Check request variable) |
正在注册或修改商品信息。请稍后重试。 [1320***883] |
请在提交商品注册10分钟后进行查询。 |
400 (Check request variable) | 卖家[A00123456] 无法查询其它卖家[A0011***5]的商品. | 请确认注册商品ID(sellerProductId)是否正确。 |
400 (Check request variable) | 未找到商品(123456789)信息。 | 请确认注册商品(sellerProductId)是否正确。 |
400 (Check request variable) | 卖家商品ID[null]仅可输入数字。 | 请确认注册商品(sellerProductId)是否正确。 |
URL API Name
GET_PRODUCT_BY_PRODUCT_ID