该API用于将创建好的满减优惠券用于商品(vendorItemId)上。
商品添加优惠券失败时,该优惠券也将被销毁。
路径
PUT
/v2/providers/marketplace_openapi/apis/api/v1/coupon-items
示例
https://api-gateway.coupang.com/v2/providers/marketplace_openapi/apis/api/v1/coupon-items
请求体参数
Name |
Required |
Type |
Description |
|
couponItems |
O |
Array |
商品添加优惠券时使用的数据 |
|
|
couponId |
|
Number |
优惠券ID 可在优惠券创建response中查看 |
|
userId |
|
String |
用户账户 (WING 登录ID) |
|
vendorItemIds |
|
Array |
使用优惠券的属性ID |
请求体示例
{
"couponItems": [
{
"couponId": "15350660",
"userId": "testaccount1",
"vendorItemIds": [
2306264997,
4802314648,
4230264914
]
}
]
}
返回消息
Name |
Type |
Description |
|
requestResultStatus |
String |
调用结果 SUCCESS / FAIL |
|
body |
Object |
|
|
|
couponId |
Integer |
相应的优惠券ID |
errorCode |
String |
发生的错误类型 |
|
errorMessage |
String |
错误详细信息 |
返回消息示例
{
"requestResultStatus": "SUCCESS",
"body": {
"couponId": 15350660
},
"errorCode": null,
"errorMessage": null
}
错误信息
HTTP Status Code (Error type) |
Error message |
Solution |
400 (Check request parameter) |
该促销展已被删除。 |
查看优惠券ID(couponid)值是否输入正确。查看是否是商品添加优惠券失败,优惠券ID被删除、 |
接口名称
Add_VENDOR_ITEMS_TO_COUPON