Coupang Developer Center

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

该API用于创建基于合同ID（contractid）的优惠券。因以异步方式，仅执行处理请求，

可使用响应的“requestedId” 值，通过确认请求状态API来查看实际API 执行结果值。

请在添加产品到立减优惠券的时候谨慎选择产品列表，因为此立减优惠券创建之后卖家就无法对优惠券的产品列表进行删除操作。如果您确实需要删除其中的一些产品，请暂停旧的优惠券，创建新的立减优惠券，并添加新的产品列表。

路径

POST

/v2/providers/fms/apis/api/v2/vendors/{vendorId}/coupon

示例

https://api-gateway.coupang.com/v2/providers/fms/apis/api/v2/vendors/A00012345/coupon

请求参数

Name

Required

Type

Description

vendorId

String

卖家ID

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

请求体

Name

Required

Type

Description

contractId

Number

卖家合同ID

name

String

促销展名 (最多45个字)

maxDiscountPrice

Number

最多折扣金额

最少10韩元

discount

Number

折扣率

startAt

String

有效期开始时间

有效期开始日期可设置为次日00:00

例：如果优惠券在8月4日15:00创建，则8月5日00:00开始可以使用优惠券

endAt

String

有效期结束时间

type

String

折扣方式

RATE (固定折扣率), FIXED_WITH_QUANTITY (按数量定额折扣), PRICE (定额折扣)

wowExclusive

Boolean

发放对象

可使用优惠券的对象

false	所有顾客 (默认)
true	火箭Wow会员

一般的满减优惠券，请创建为"false"。

true 是以火箭Wow会员为对象，用于goldbox等促销展中所选商品的值，应用于商品时需要提前申请批准。

请求体示例

{
  "contractId": "10",
  "name": "newCoupon 20180328",
  "maxDiscountPrice": "1000",
  "discount": "10",
  "startAt": "2017-12-08 00:00:00",
  "endAt": "2017-12-09 00:00:00",
  "type": "PRICE",
  "wowExclusive": "false"
}

返回消息

Name			Type	Description
code			Number	服务器响应代码
message			String	服务器响应信息
httpStatus			Number	HTTP状态代码 (与服务器响应代码的值相同)
httpStatusMessage			String	HTTP 状态信息 (与服务器响应信息的值相同)
errorMessage			String	除HTTP Status 200以外，剩下Status 中包含服务器详细失败原因信息
data			Object	执行成功与否的数据
	success		Boolean	成功与否 true or false
	content		Object	可查看处理状态的请求ID数据
		requestedId	String	查看处理状态的请求ID ex) 1542675975663862164
		success	Boolean	成功与否 true or false
	Pagination		null	无分页

返回消息示例

{
  "code": 200,
  "message": "OK",
  "httpStatus": 200,
  "httpStatusMessage": "OK",
  "errorMessage": "",
  "data": {
    "success": true,
    "content": {
      "requestedId": "123543582159745830895",
      "success": true
    },
    "pagination": null
  }
}

错误信息

HTTP status code (error type)	Error message	Solution
400 (check request parameter)	优惠券必须在合同有效期内（合同有效期：2017-03-01 00:00:00 ~ 2017-12-31 23:59:59）（优惠券有效期：2016-12-05 00:00 :00~2017-09-05 00:00:00)	查看优惠券的有效期开始日期和结束日期是否包含在合同有效期内。
400 (check request parameter)	无法解析“2017-13-05 00:00:00”：monthOfYear 的value13 必须在 [1,12] 范围内	查看是否正确输入了有效期的开始或结束日期值。
400 (check request parameter)	无法解析“2017-08-32 00:00:00”：dayOfMonth的value 32 必须在 [1,31] 范围内	查看是否正确输入了有效期的开始或结束日期值。
400 (check request parameter)	请查看startAt 格式。 yyyy-MM-dd HH:mm:ss	查看是否输入了正确的有效期开始时间格式。
400 (check request parameter)	请查看endAt 格式。 yyyy-MM-dd HH:mm:ss	查看是否输入了正确的有效期结束时间格式。.
400 (check request parameter)	Can only input positive number for discount. (discount rate: 1~100; discount amount: 1 or larger) discount只能输入正数。（固定折扣率为1~100，定额为1以上）	查看是否输入了正确的折扣率的值。

[立减优惠券] 创建

简介

详细内容

路径

示例