无法修改处于“临时保存“和”待审批”状态的商品。
Path
PUT
/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partial
Example Endpoint
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/30100208559/partial
Request Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| sellerProductId | O | String |
注册商品ID 商品创建完成时会显示注册商品ID |
||||
Body Parameter
| Name | Required | Type | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| sellerProductId | O | Number | 注册商品ID 商品创建完成时会显示注册商品ID (data) |
||||||||||||||||
| companyContactNumber | String | 退货地址 通过酷澎WING或“退货地创建API”注册退货地后确认 |
|||||||||||||||||
| deliveryCharge | Number | 基本运费 若为付费配送或指定条件包邮，请输入单程运费值 |
|||||||||||||||||
| deliveryChargeOnReturn | Number | 初始退货运费 若为免费配送，则顾客支付退货运费 |
|||||||||||||||||
| deliveryChargeType | String |
配送费类型
※ 使用[CONDITIONAL_FREE]时，您可单独设置想要的指定条件包邮值。 |
|||||||||||||||||
| deliveryCompanyCode | String |
物流公司代码，点击进入物流代码列表
|
|||||||||||||||||
| deliveryMethod | String |
配送方式
“INSTRUCTURE”及“MAKE_ORDER_DIRECT” 已合并为“VENDOR_DIRECT”
|
|||||||||||||||||
| extraInfoMessage | String |
订制指南 将配送方式选为“订制”时，请输入要发给顾客的信息 |
|||||||||||||||||
| freeShipOverAmount | Number |
免运费门槛 ● 示例: 如果您想将指定条件包邮的门槛金额设置为10,000 韩元及以上，请先将[deliveryChargeType]设置为'CONDITIONAL_FREE'，然后在[freeShipOverAmount]中输入10000。 ※ 输入单位须大于100韩元 (以100为增量) ※ 免费配送时，请输入0 |
|||||||||||||||||
| outboundShippingPlaceCode | Number |
发货地代码 选择捆绑配送时必填。可通过“发货地查询API”进行查询 |
|||||||||||||||||
| outboundShippingTimeDay | Number |
标准发货日（天） 请输入订单日期（D-Day）之后预计的发货日期（以天为单位）。（输入“1”表示当日发货。输入“1”表示次日（D+1）发货。） |
|||||||||||||||||
| sameDayShipping | Object | 当日发货配置 | |||||||||||||||||
| sameDayShipping.active | Boolean | 是否启用当日发货 | |||||||||||||||||
| sameDayShipping.cutOffTimeHour | Integer | 当日发货订单截止时间为10:00至23:00。 | |||||||||||||||||
sameDayShipping.cutOffTimeMinute |
Integer | 截止时间（分钟）。当 active=true 时，截止时间必须为 0。 |
|||||||||||||||||
sameDayShipping.cutOffTimeZone |
String |
系统管理，当 active=true 时默认为“KR”。 |
|||||||||||||||||
| pccNeeded | Boolean |
PCC(个人通关代码)是否为必填项 海外代购商品需要PCC(个人通关代码)。 - 默认值：不需要（false）
|
|||||||||||||||||
| remoteAreaDeliverable | String |
需输入PCC也可购买
|
|||||||||||||||||
| returnAddress | String |
退货地址 通过酷澎WING或“退货地创建API”注册退货地后确认 |
|||||||||||||||||
| returnAddressDetail | String |
退货地详细地址 通过酷澎WING或“退货地创建API”注册退货地后确认 |
|||||||||||||||||
| returnCenterCode | String | 退货中心代码 创建退货地后，输入可取货的退货中心代码
※ 自动退货链接服务（Goodsflow）仅适用于签约物流公司，且必须输入退货中心代码 |
|||||||||||||||||
| returnCharge | Number |
退货运费 回收退货商品时的单程运费 |
|||||||||||||||||
| returnChargeName | String |
退货地址 通过酷澎WING或“退货地创建API”注册退货地后确认 |
|||||||||||||||||
| returnZipCode | String |
退货地邮政编码 通过酷澎WING或“退货地创建API”注册退货地后确认 |
|||||||||||||||||
| unionDeliveryType | String |
捆绑配送与否
※ 捆绑配送条件 必须输入发货地信息（只有发货地信息相同的商品才能捆绑配送） 不可设置“不可运费到付” |
|||||||||||||||||
Request Example
{
"sellerProductId": 30100201234,
"deliveryMethod": "SEQUENCIAL",
"deliveryCompanyCode": "HYUNDAI",
"deliveryChargeType": "CONDITIONAL_FREE",
"deliveryCharge": 2500,
"freeShipOverAmount": 10000,
"deliveryChargeOnReturn": 0,
"remoteAreaDeliverable": "N",
"unionDeliveryType": "UNION_DELIVERY",
"returnCenterCode": "1000274592",
"returnChargeName": "반품지명_1",
"companyContactNumber": "02-123-1234",
"returnZipCode": "15200",
"returnAddress": "서울특별시 송파구 송파대로 12길",
"returnAddressDetail": "123호",
"returnCharge": 2500,
"outboundShippingPlaceCode": 63714,
"extraInfoMessage": "",
"pccNeeded": false,
"outboundShippingTimeDay":, 2
}Since none of the fields except for sellerProductId are mandatory, you may freely enter data for only the ones you want to and modify.
{
"sellerProductId": 30100208559,
"deliveryCharge": 3000
}Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | String | 结果代码 SUCCES/ERROR |
||||
| message | String | 信息 |
||||
| data | Long | 注册商品ID =sellerProductId |
||||
Response Example
{
"code": "200",
"message": "",
"data": {
"code": "SUCCESS",
"message": "",
"data": 30100201234
}
}Error Spec
| HTTP status code (error type) |
Error message | Solution |
|---|---|---|
| 400 | 请再次确认卖家商品ID。 | 请确认url path上的sellerProductId和request body的 sellerProductId是否一致。 |
| 400 | 请务必输入卖家商品ID。 | 请确认是否在requestBody中输入了sellerProductId。 |
| 400 | 注册商品ID [xxxxxx]不存在。 | 请确认输入的sellerProductId 是否存在。 |
| 400 | 商品已被删除，无法修改。 | 请确认该商品是否已被删除。 |
| 400 | 商品为“待审批”状态，无法修改。 | 请确认注册商品是否处于“待审批”状态。 |
| 400 | 商品正在生成中，无法修改。 | 请确认注册商品是否处于“临时保存中”状态。 |
| 500 | 商品修改失败。请联系酷澎管理人员。 | 出现意外的系统错误时，请通过线上咨询联系酷澎。 |
URL API Name
UPDATE_PARTIAL_PRODUCT