商品 API 品类 API 品牌 API 运输 / 订单 API 退货 API 换货 API 促销 / 优惠券物流信息客服 / 咨询结算 CGF / CGF lite Rocket Growth

商品 API

PUT/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partial2609170000

商品修改 (无需审批)

# 01

简介

商品修改 (无需审批)

# 02

详细内容

API支持的买家用户地区：韩国，台湾

可快速修改配送及退货地址的相关信息，无需单独的审批流程。

可修改的属性内容请参阅 Body Parameter

无法修改处于“临时保存“和”待审批”状态的商品。

路径

PUT/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partial

示例端点

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/30100208559/partial

URL API Name

UPDATE_PARTIAL_PRODUCT

# 03

Path 参数

Name	Type	Description
sellerProductId*	string	注册商品ID 商品创建完成时会显示注册商品ID

# 04

请求体参数

请求参数

请求体参数

Name

Type

Description

sellerProductId*

integer

注册商品ID

商品创建完成时会显示注册商品ID (data)

companyContactNumber

string

退货地址

通过酷澎WING或“退货地创建API”注册退货地后确认

deliveryCharge

integer

基本运费

若为付费配送或指定条件包邮，请输入单程运费值

deliveryChargeOnReturn

number

初始退货运费

若为免费配送，则顾客支付退货运费

deliveryChargeType

string

配送费类型

Parameter Name	Status
FREE	免费配送
NOT_FREE	付费配送
CHARGE_RECEIVED	运费到付
CONDITIONAL_FREE	指定条件包邮

设置免费配送：设置初始退货运费(单程)[deliveryChargeOnReturn]及退货运费金额(单程)[returnCharge]
设置付费配送：设置基本运费[deliveryCharge]及退货运费金额(单程)
设置指定条件包邮：设置基本运费及退货运费金额(单程)
设置运费到付：我们已单独列出了符合运费到付条件的品类，并通过酷澎卖家客服中心分享，以指导卖家。

※ 使用[CONDITIONAL_FREE]时，您可单独设置想要的指定条件包邮值。

Parameter Name	Status
FREE
NOT_FREE
CHARGE_RECEIVED
CONDITIONAL_FREE

deliveryCompanyCode

string

物流公司代码，点击进入物流代码列表

Link for courier code

deliveryMethod

string

配送方式

Parameter Name	Status
SEQUENCIAL	一般配送 (依次发货)
COLD_FRESH	冷冻生鲜
MAKE_ORDER	订制
AGENT_BUY	代购
VENDOR_DIRECT	上门安装或卖家直接配送

“INSTRUCTURE”及“MAKE_ORDER_DIRECT” 已合并为“VENDOR_DIRECT”

Parameter Name	Status
SEQUENCIAL
COLD_FRESH
MAKE_ORDER
AGENT_BUY
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

outboundShippingTimeDay.sameDayShipping

object

当日发货配置

active

outboundShippingTimeDay.sameDayShipping.active

boolean

是否启用当日发货

cutOffTimeHour

outboundShippingTimeDay.sameDayShipping.cutOffTimeHour

integer

当日发货订单截止时间为10:00至23:00。

cutOffTimeMinute

outboundShippingTimeDay.sameDayShipping.cutOffTimeMinute

integer

截止时间（分钟）。当 active=true 时，截止时间必须为 0。

cutOffTimeZone

outboundShippingTimeDay.sameDayShipping.cutOffTimeZone

string

系统管理，当 active=true 时默认为“KR”。

pccNeeded

boolean

PCC(个人通关代码)是否为必填项

海外代购商品需要PCC(个人通关代码)。

默认值：不需要（false）

true	顾客购买商品时须输入PCC(订单内含PCC)
false	需输入PCC也可购买

Parameter Name	Status
true
false

remoteAreaDeliverable

string

需输入PCC也可购买

Parameter Name	Status
Y	偏远地区可配送
N	偏远地区不可配送

Parameter Name	Status
Y
N

returnAddress

string

退货地址

通过酷澎WING或“退货地创建API”注册退货地后确认

returnAddressDetail

string

退货地详细地址

通过酷澎WING或“退货地创建API”注册退货地后确认

returnCenterCode

string

退货中心代码

创建退货地后，输入可取货的退货中心代码

可通过 Wing 或“退货地创建 API”来创建退货地
无法创建退货地时，可输入“NO_RETURN_CENTERCODE”，直接注册退货地信息

※ 自动退货链接服务（Goodsflow）仅适用于签约物流公司，且必须输入退货中心代码

returnCharge

number

退货运费

回收退货商品时的单程运费

returnChargeName

string

退货地址

通过酷澎WING或“退货地创建API”注册退货地后确认

returnZipCode

string

退货地邮政编码

通过酷澎WING或“退货地创建API”注册退货地后确认

unionDeliveryType

string

捆绑配送与否

Parameter Name	Status
UNION_DELIVERY	捆绑配送与否
NOT_UNION_DELIVERY	不可捆绑配送

※ 捆绑配送条件

必须输入发货地信息（只有发货地信息相同的商品才能捆绑配送）

不可设置“不可运费到付”

Parameter Name	Status
UNION_DELIVERY
NOT_UNION_DELIVERY

请求示例application/json

{
  "sellerProductId": 30100208559,
  "deliveryCharge": 3000
}

# 05

响应体

响应消息

Name	Type	Description
code	string	结果代码 SUCCES/ERROR
message	string	信息
data	object	注册商品ID =sellerProductId
code data.code	string
message data.message	string
data data.data	integer

Response Example

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

# 06

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
400	400	请再次确认卖家商品ID。	请确认url path上的sellerProductId和request body的 sellerProductId是否一致。
400	400	请务必输入卖家商品ID。	请确认是否在requestBody中输入了sellerProductId。
400	400	注册商品ID [xxxxxx]不存在。	请确认输入的sellerProductId 是否存在。
400	400	商品已被删除，无法修改。	请确认该商品是否已被删除。
400	400	商品为“待审批”状态，无法修改。	请确认注册商品是否处于“待审批”状态。
400	400	商品正在生成中，无法修改。	请确认注册商品是否处于“临时保存中”状态。
500	500	商品修改失败。请联系酷澎管理人员。	出现意外的系统错误时，请通过线上咨询联系酷澎。