coupang
API 文档
商品 API品类 API品牌 API运输 / 订单 API退货 API换货 API促销 / 优惠券物流信息客服 / 咨询结算CGF / CGF liteRocket Growth
GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partial2609170000

商品查询（无需审批要求）

# 01

简介

商品查询（无需审批要求）

# 02

详细内容

API支持的买家用户地区：韩国,台湾
您可查询商品配送及退货地等相关信息，这些信息无需经过商品审核要求即可查询。
通过此API的响应消息，您可在 [商品修改API(无需审批)] 中快速修改信息。

路径

GET/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/30100201234/partial

URL API Name

GET_PARTIAL_PRODUCT_BY_PRODUCT_ID
# 03

Path 参数

NameTypeDescription
sellerProductId*string
注册商品ID

商品创建完成时显示的注册商品ID
# 04

响应体

响应消息

NameTypeDescription
codestring
结果代码

SUCCES/ERROR
messagestring
信息
dataobject
sellerProductId
data.sellerProductId
integer
注册商品ID

商品创建完成时显示的注册商品ID (data)
companyContactNumber
data.companyContactNumber
string
退货地联系方式

在酷澎WING或退货地创建API中注册退货地后后确认
deliveryCharge
data.deliveryCharge
integer
基本运费

若为付费配送或指定条件包邮，请输入单程运费值
deliveryChargeOnReturn
data.deliveryChargeOnReturn
integer
初始退货运费

若为免费配送，则顾客支付退货运费
deliveryChargeType
data.deliveryChargeType
string
Delivery fee type配送费类型
Parameter Name Status
FREE 免费配送
NOT_FREE 付费配送
CHARGE_RECEIVED 运费到付
CONDITIONAL_FREE 指定条件包邮
● 设置免费配送：

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

※ 使用[CONDITIONAL_FREE]时，您可单独设置想要的指定条件包邮值。
Parameter NameStatus
FREE
NOT_FREE
CHARGE_RECEIVED
CONDITIONAL_FREE
deliveryCompanyCode
data.deliveryCompanyCode
string
查看物流公司代码 ，点击下面链接查看

link for courier code
deliveryMethod
data.deliveryMethod
string
配送方式
Parameter Name Status
SEQUENCIAL 一般配送 (依次发货)
COLD_FRESH 冷冻生鲜
MAKE_ORDER 订制
AGENT_BUY 代购
VENDOR_DIRECT 上门安装或卖家直接配送
“INSTRUCTURE”及“MAKE_ORDER_DIRECT” 已合并为“VENDOR_DIRECT”
Parameter NameStatus
SEQUENCIAL
COLD_FRESH
MAKE_ORDER
AGENT_BUY
VENDOR_DIRECT
extraInfoMessage
data.extraInfoMessage
string
订制指南

将配送方式选为“订制”时，请输入要发给顾客的信息
freeShipOverAmount
data.freeShipOverAmount
integer
免运费门槛

示例: 如果您想将指定条件包邮的门槛金额设置为10,000 韩元及以上，请先将[deliveryChargeType]设置为'CONDITIONAL_FREE'，然后在[freeShipOverAmount]中输入10000。

※ 输入单位须大于100韩元 (以100为增量)

※ 免费配送时，请输入0
outboundShippingPlaceCode
data.outboundShippingPlaceCode
integer
发货地代码

选择捆绑配送时必填。可通过“发货地查询API”进行查询
pccNeeded
data.pccNeeded
boolean
是否需要PCC(个人通关代码)

海外代购商品需要PCC(个人通关代码)
  • 默认值：不需要（false）
true 顾客购买商品时须输入PCC(PCC可在订单中查看)
false 顾客无需输入PCC也可购买
Parameter NameStatus
true
false
remoteAreaDeliverable
data.remoteAreaDeliverable
string
顾客无需输入PCC也可购买
Parameter Name Status
Y 偏远地区可配送
N 偏远地区不配送
Parameter NameStatus
Y
N
returnAddress
data.returnAddress
string
退货地址

在酷澎WING或退货地创建API中注册配送地后确认
returnAddressDetail
data.returnAddressDetail
string
退货地详细地址

在酷澎WING或退货地创建API中注册配送地后确认
returnCenterCode
data.returnCenterCode
string
退货中心代码

创建退货地后，输入显示的退货中心代码

●可通过酷澎WING或退货地创建API创建退货地

●无法创建退货地时，请输入"NO_RETURN_CENTERCODE"，直接上传退货地信息

※ 自动退货联动服务（Goodsflow）仅在您有签约物流公司的情况下可用。 退货中心代码为必填项
returnCharge
data.returnCharge
integer
退货运费

回收退货商品时的单程运费
returnChargeName
data.returnChargeName
string
退货地名称

在酷澎WING或退货地创建API中注册配送地后确认
returnZipCode
data.returnZipCode
string
退货地邮政编码

在酷澎WING或退货地创建API中注册配送地后确认
unionDeliveryType
data.unionDeliveryType
string
捆绑配送与否
Parameter Name Status
UNION_DELIVERY 可捆绑配送
NOT_UNION_DELIVERY 不可捆绑配送
※ 捆绑配送条件

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

不可设置“不可运费到付”
Parameter NameStatus
UNION_DELIVERY
NOT_UNION_DELIVERY

Response Example

{
  "code": "SUCCESS",
  "message": "",
  "data": {
    "sellerProductId": 30100201234,
    "deliveryMethod": "SEQUENCIAL",
    "deliveryCompanyCode": "HYUNDAI",
    "deliveryChargeType": "NOT_FREE",
    "deliveryCharge": 2500,
    "freeShipOverAmount": 0,
    "deliveryChargeOnReturn": 0,
    "remoteAreaDeliverable": "N",
    "unionDeliveryType": "NOT_UNION_DELIVERY",
    "returnCenterCode": "56642",
    "returnChargeName": "타워730",
    "companyContactNumber": "02-123-7678",
    "returnZipCode": "13590",
    "returnAddress": "서울특별시 송파구 송파대로 570 (신천동)",
    "returnAddressDetail": "타워",
    "returnCharge": 2500,
    "outboundShippingPlaceCode": 63714,
    "extraInfoMessage": "",
    "pccNeeded": false
  }
}
# 05

错误码

HTTP代码消息
400HTTP_400Bad Request

错误说明

HTTP类型错误消息解决方案
400400

商品(XXXXXXXXX)数据不存在。

请确认是否为现有商品的sellerProductId。