创建顾客可以下载并使用的优惠券。
若想使用优惠券，商品的总订单金额必须满足卖家设置的金额，否则将无法使用。
优惠券可按固定比例/满减折扣的形式发行，同一张优惠券最多可包含 3 种形式。
（例：购买10,000韩元减1,000韩元；购买20,000韩元减3,000韩元；购买30,000韩元减3,000韩元等）
每个属性ID(vendorite)可以创建一张优惠券，创建后更新到前端至少需1小时。
（如果下午 3 点创建优惠券，则可将优惠券有效时间最早设置为当天下午 4 点。）
最初创建下载优惠券时设置的优惠券适用商品，之后无法更改。
如果要添加或删除使用优惠券的商品，则须停用之前发行的优惠券并创建新的优惠券。
最初创建优惠券时，请谨慎选择使用优惠券的商品！
路径
POST
/v2/providers/marketplace_openapi/apis/api/v1/coupons
示例
https://api-gateway.coupang.com/v2/providers/marketplace_openapi/apis/api/v1/coupons
请求体参数
|
Name |
Required |
Type |
Description |
||||||||||
|
title |
O |
String |
优惠券名称 优惠券下载页面名称 （注意！）您输入的优惠券名称会显示在商品页面上，并曝光给顾客。请输入便于顾客理解的名称 |
||||||||||
|
contractId |
O |
Number |
卖家合同ID |
||||||||||
|
couponType |
O |
String |
优惠券类型(下载优惠券使“DOWNLOAD”) |
||||||||||
|
startDate |
O |
String |
优惠券开始日期 'YYYY-MM-DD HH:MM:SS' |
||||||||||
|
endDate |
O |
String |
优惠券结束日期 'YYYY-MM-DD HH:MM:SS' |
||||||||||
|
userId |
O |
String |
用户账户 (WING登录ID) |
||||||||||
|
policies |
O |
Object |
优惠券详细政策 每张优惠券最多可创建 3 个详细政策 不可为一张优惠券创建不同类型的政策（例如：PRICE / PRICE => 可用，PRICE / RATE => 不可用 |
||||||||||
|
|
title |
|
String |
优惠券政策名称 该名称是在购物车中选择优惠券时显示的名称，与优惠券名称不同 （注意！）您输入的优惠券名称会显示在商品页面上，并曝光给顾客。请输入便于顾客理解的名称。 |
|||||||||
|
|
typeOfDiscount |
|
String |
优惠券政策类型 |
|||||||||
|
|
CODE |
MEANING |
|
||||||||||
|
|
|
|
|
|
RATE |
固定比率 |
|
||||||
|
PRICE |
满减折扣 |
||||||||||||
|
|
|||||||||||||
|
|
description |
|
String |
优惠券详细说明 购物车中优惠券政策名称的补充说明 |
|||||||||
|
|
minimumPrice |
|
Number |
使用优惠券的最低购买金额 为使用优惠券必须达到的订单金额 |
|||||||||
|
|
discount |
|
Number |
优惠券折扣金额或比率
|
|||||||||
|
|
maximumDiscountPrice |
|
Number |
最高折扣金额 typeOfDiscount 为RATE 时有效 为PRICE时，可输入任意数字 |
|||||||||
|
|
maximumPerDaily |
|
Number |
最多发行数量 (1人/1天) 不可超过9,999 |
|||||||||
请求体示例
{
"title": "쿠폰 명칭",
"contractId": "15",
"couponType": "DOWNLOAD",
"startDate": "2019-05-22 19:55:00",
"endDate": "2019-06-08 11:00:00",
"userId": "testaccout1",
"policies": [
{
"title": "해당쿠폰의 정책 1 명칭",
"typeOfDiscount": "PRICE",
"description": "해당정책 안내 문구 작성",
"minimumPrice": 10000,
"discount": 1000,
"maximumDiscountPrice": 1000,
"maximumPerDaily": 1
},
{
"title": "해당쿠폰의 정책 2 명칭",
"typeOfDiscount": "PRICE",
"description": "해당정책 안내 문구 작성",
"minimumPrice": 20000,
"discount": 2000,
"maximumDiscountPrice": 1000,
"maximumPerDaily": 1
},
{
"title": "해당쿠폰의 정책 3 명칭",
"typeOfDiscount": "PRICE",
"description": "해당정책 안내 문구 작성",
"minimumPrice": 30000,
"discount": 3000,
"maximumDiscountPrice": 1000,
"maximumPerDaily": 1
}
]
}返回消息
|
Name |
Type |
Description |
|||||||
|
couponId |
Number |
优惠券ID 创建优惠券商品/删除&查询优惠券时使用 |
|||||||
|
vendorId |
String |
卖家编号 |
|||||||
|
couponType |
String |
优惠券分类 |
|||||||
|
lastModifiedBy |
String |
优惠券创建(最终修改)账户 |
|||||||
|
lastModifiedDate |
String |
优惠券创建(最终修改)时间 |
|||||||
|
title |
String |
优惠券名称 优惠券下载页面名称 |
|||||||
|
publishedDate |
String |
|
|||||||
|
startDate |
String |
优惠券开始时间 'YYYY-MM-DD HH:MM:SS' |
|||||||
|
couponStatus |
String |
优惠券状态 创建时显示为“STANDBY” |
|||||||
|
policies |
Object |
优惠券政策 |
|||||||
|
|
description |
String |
优惠券详细政策 购物车中优惠券政策名称的补充说明 |
||||||
|
|
discount |
Number |
优惠券折扣金额或比率 (%) |
||||||
|
|
maximumDiscountPrice |
Number |
最高折扣金额 typeOfDiscount 为RATE 时有效 为PRICE时，显示为-1 |
||||||
|
|
maximumPerDaily |
Number |
最多发行数量 (1人/1天) |
||||||
|
|
minimumPrice |
Number |
使用优惠券的最低购买金额 为使用优惠券必须达到的订单金额 |
||||||
|
|
title |
String |
优惠券政策名称 该名称是在购物车中选择优惠券时显示的名称，与优惠券名称不同 |
||||||
|
|
typeOfDiscount |
String |
优惠券政策类型
|
||||||
|
|
managedCode |
String |
内部管理编号 |
||||||
返回消息示例
{
"couponId": 15354534,
"vendorId": "A00013264",
"couponType": "DOWNLOAD",
"lastModifiedBy": "testaccout1",
"lastModifiedDate": "2019-05-22 15:40:59",
"title": "쿠폰 명칭",
"publishedDate": null,
"startDate": "2019-05-22 19:55:00",
"couponStatus": "STANDBY",
"couponPolicies": [
{
"description": "해당정책 안내 문구 작성",
"discount": 1000,
"maximumDiscountPrice": -1,
"maximumPerDaily": 1,
"minimumPrice": 10000,
"title": "해당쿠폰의 정책 1 명칭",
"typeOfDiscount": "PRICE",
"manageCode": "FMS_15_A00013264_15585072594380"
},
{
"description": "해당정책 안내 문구 작성",
"discount": 2000,
"maximumDiscountPrice": -1,
"maximumPerDaily": 1,
"minimumPrice": 20000,
"title": "해당쿠폰의 정책 2 명칭",
"typeOfDiscount": "PRICE",
"manageCode": "FMS_15_A00013264_15585072594381"
},
{
"description": "해당정책 안내 문구 작성",
"discount": 3000,
"maximumDiscountPrice": -1,
"maximumPerDaily": 1,
"minimumPrice": 30000,
"title": "해당쿠폰의 정책 3 명칭",
"typeOfDiscount": "PRICE",
"manageCode": "FMS_15_A00013264_15585072594382"
}
]
}错误信息
|
HTTP状态代码（错误类型） |
错误信息 |
解决方案 |
|
400 (确认请求参数) |
contractId=15* 的合同不属于 Seller=A00012345 。 |
请确认您输入的合同ID(contractId)值是否正确。 |
|
400 (确认请求参数) |
请确认startAt模式。yyyy-MM-dd HH:mm:ss, 请确认促销时间段。 |
请确认您输入的优惠券开始日期(startDate)值是否正确。 |
|
400 (确认请求参数) |
请确认endAt模式。yyyy-MM-dd HH:mm:ss, 请确认促销时间段。 |
请确认您输入的优惠券结束日期(endDate)值是否正确。 |
|
400 (确认请求参数) |
createCouponRequest.title栏为空白。 createCouponRequest.title 为必填项。 |
请确认是否输入了优惠券名称(title)。 |
|
400 (确认请求参数) |
请以10韩元为单位输入policies[0]的金额。 |
请确认您输入优惠券折扣金额(discount)是否是以10韩元为单位。 |
|
400 (确认请求参数) |
policies[0].maxPerDaily须输入1～9999间的数值。 |
请确认您输入的最多发行数量(maximumPerDaily)值是否正确。 |
接口名称
CREATE_COUPON