coupang
API 文档
商品 API品类 API品牌 API运输 / 订单 API退货 API换货 API促销 / 优惠券物流信息客服 / 咨询结算CGF / CGF liteRocket Growth
GET/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/products/items/cashback2609170000

[图书] 搜索商品返现

# 01

简介

[图书] 搜索商品返现

# 02

详细内容

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

查看该产品单项号码上使用的返现规则。

搜索到没有返现的 属性ID (vendorItemId)时，返回 404 或 400 错误。

路径

GET/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/products/items/cashback

示例端点

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/products/items/cashback?ruleId=1&vendorItemId=3000000005
# 03

Path 参数

NameTypeDescription
vendorId*string
卖家ID

酷澎分配给卖家的固有代码

e.g.) A00012345
# 04

Query 参数

NameTypeDescription
ruleId*number
Rule ID

输入返现相关合约签订后所提供的规则ID
vendorItemId*number
属性ID
# 05

响应体

响应消息

NameTypeDescription
codestring
Http 申请
messagestring
成功或失败时相应信息会出现
200: OK
400: 错误请求，将显示相应的错误请求消息
500: 内部错误
dataobject
ruleId
data.ruleId
integer
Rule ID
valueType
data.valueType
string
返现类型

FIXED（定额折扣）, FIXED_WITH_QUANTITY（按数量定额折扣）
value
data.value
integer
累计值

最少值1
maxAmount
data.maxAmount
integer
最大返现值
vendorItemId
data.vendorItemId
string
属性ID
startAt
data.startAt
string
开始时间

格式：yyyy-MM-dd HH:mm:ss
endAt
data.endAt
string
结束时间

格式: yyyy-MM-dd HH:mm:ss
disabled
data.disabled
boolean
是否可使用返现规则
disabledAt
data.disabledAt
string
不可使用返现规则的时间

格式: yyyy-MM-dd HH:mm:ss

Response Example

{
  "code": "200",
  "message": "OK",
  "data": {
    "vendorItemId": "3000000005",
    "vendorId": "A00012345",
    "valueType": "FIXED",
    "value": 1000,
    "startAt": "2016-12-29 09:43:54",
    "maxAmount": 0,
    "ruleId": 1,
    "endAt": "2017-01-01 09:43:54",
    "disabledAt": null,
    "disabled": false
  }
}
# 06

错误码

HTTP代码消息
400HTTP_400Bad Request

错误说明

HTTP类型错误消息解决方案
404404 (Check parameter requested)

请求的vendorItemId 没有对应的促销信息: 7015***6995

要查看的属性ID (vendorItemId) 是否使用了返现。

400400 (Check parameter requested)

VendorItemId不可为空

确认输入的属性ID (vendorItemId) 是否正确。

400400 (Check parameter requested)

无效vendorItemId, 该vendorItemId不存在或不属于该vendorId

要查看的属性ID (vendorItemId) 是否正确，或者是否使用了返现。