/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/products/items/cashbackv1[图书] 搜索商品返现
简介
API支持的买家用户地区：韩国 查看该产品单项号码 上使用的返现规则。 搜索到 没 有 返现 的 属性 ID (vendorItemId) 时 ，返回 404 或 400 错误 。
详细内容
API支持的买家用户地区：韩国
查看该产品单项号码上使用的返现规则。
搜索到没有返现的 属性ID (vendorItemId)时，返回 404 或 400 错误。
路径
GET
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/products/items/cashback
示例
请求参数
|
Name |
Required |
Type |
Description |
|
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g.) A00012345 |
链接请求参数
|
Name |
Required |
Type |
Description |
|
ruleId |
O |
Number |
Rule ID 输入返现相关合约签订后所提供的规则ID |
|
vendorItemId |
O |
Number |
属性ID |
请求体
无
返回消息
|
Name |
Type |
Description |
|||||||
|
code |
Number |
Http 申请状态代码 EX) 200, 400, 500 |
|||||||
|
message |
String |
成功或失败时相应信息会出现
|
|||||||
|
data |
Object |
|
|||||||
|
|
ruleId |
Number |
Rule ID |
||||||
|
|
valueType |
String |
返现类型 FIXED（定额折扣）, FIXED_WITH_QUANTITY（按数量定额折扣） |
||||||
|
|
value |
Number |
累计值 最少值1 |
||||||
|
|
maxAmount |
String |
最大返现值 |
||||||
|
|
|
|
最少值0；FIXED或FIXED_WITH_QUANTITY无需该参数 |
||||||
|
|
vendorItemId |
Number |
属性ID |
||||||
|
|
startAt |
String |
开始时间 格式：yyyy-MM-dd HH:mm:ss |
||||||
|
|
endAt |
String |
结束时间 格式: yyyy-MM-dd HH:mm:ss |
||||||
|
|
disabled |
boolean |
是否可使用返现规则 |
||||||
|
|
disabledAt |
String |
不可使用返现规则的时间 格式: yyyy-MM-dd HH:mm:ss |
||||||
返回消息示例
{
"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
}
}错误信息
|
HTTP Status Code (Error Type) |
Error Message |
Solution |
|
404 (Check parameter requested) |
请求的vendorItemId 没有对应的促销信息: 7015***6995 |
要查看的属性ID (vendorItemId) 是否使用了返现。 |
|
400 (Check parameter requested) |
VendorItemId不可为空 |
确认输入的属性ID (vendorItemId) 是否正确。 |
|
400 (Check parameter requested) |
无效vendorItemId, 该vendorItemId不存在或不属于该vendorId |
要查看的属性ID (vendorItemId) 是否正确，或者是否使用了返现。 |
接口名称
GET_PRODUCT_CASHBACK