coupang
GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partialv1

商品查询(无需审批要求)

# 01

简介

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

# 02

详细内容

API支持的买家用户地区:韩国,台湾

查询商品配送及退地等相信息,这些信息无需经过商品审核要求即可查询。 

通过此API响应消息,可在 [商品修改API(无需审批)] 中快速修改信息。

 

Path

GET

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

Request Parameters

Path Segment Parameter

Name Required Type Description
sellerProductId O String

注册商品ID 

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

Request Example

无需请求体

Response Message

Name Type Description
code String

结果代码 

SUCCES/ERROR 

message String
信息
data    
  sellerProductId Number

商品ID 

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

  companyContactNumber String

退货地联系方式 

在酷澎WING或退货地创建API中注册退货地后后确认 

  deliveryCharge Number

基本运费 

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

  deliveryChargeOnReturn Number

初始退货运费 

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

  deliveryChargeType String
Delivery fee type配送费类型 
Parameter Name Status
FREE 免费配送 
NOT_FREE 付费配送 
CHARGE_RECEIVED 运费到付 
CONDITIONAL_FREE 指定条件包邮 

设置免费配送: 

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

查看物流公司代码 ,点击下面链接查看

  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”进行查询 

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

捆绑配送条件  

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

不可设置“不可运费到付 

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
    }
}

Error Spec

HTTP 状态代码 (错误类型)  错误信息  解决方案
400 商品(XXXXXXXXX)数据不存在。   请确认是否为现有商品的sellerProductId 
  
 

URL API Name

GET_PARTIAL_PRODUCT_BY_PRODUCT_ID