Coupang Developer Center

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

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

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

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

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

Number

注册商品ID

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

companyContactNumber

String

退货地址

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

deliveryCharge

Number

基本运费

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

deliveryChargeOnReturn

Number

初始退货运费

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

deliveryChargeType

String

配送费类型

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

设置免费配送：设置初始退货运费(单程)[deliveryChargeOnReturn]及退货运费金额(单程)[returnCharge]
设置付费配送：设置基本运费[deliveryCharge]及退货运费金额(单程)

设置指定条件包邮：设置基本运费及退货运费金额(单程)

设置运费到付：我们已单独列出了符合运费到付条件的品类，并通过酷澎卖家客服中心分享，以指导卖家。

※ 使用[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”

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）

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

remoteAreaDeliverable

String

需输入PCC也可购买

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	不可捆绑配送

※ 捆绑配送条件

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

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

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

商品修改 (无需审批)

简介

详细内容

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Body Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name