Coupang Developer Center

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

为每个产品单项ID 使用返现规则。

它可以应用于使用了相同返现规则的属性，并且只能用于审核通过的属性。

* 返现功能仅适用于图书产品，可与酷澎销售负责人在签订合同并协商好使用政策后使用。

每种返现的业务逻辑请参考下表：

Value type

说明

value

maxAmount

Example

计算公式

返现金额

FIXED（定额折扣）

无论顾客购买的商品数量如何，都会返还固定金额。

即使购买多件商品，也只会累积固定数量的返现。

1000

null

Price :

￦5,000

Quantity

: 2

Paid :

￦10,000

cash_back = value

￦1,000

FIXED_WITH_QUANTITY（按照数量定额）

返现金额为固定金额乘以购买的商品数量。

1000

null

Price :

￦5,000

Quantity

: 2

Paid :

￦10,000

cash_back = value*Quantity

￦2,000

路径

POST

/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

请求参数

Name

Required

Type

Description

vendorId

String

卖家ID

酷澎分配给卖家的固有代码 e.g.) A00012345

请求体

Name	Required	Type	Description
ruleId	O	Number	Rule ID 输入返现相关合约签订后所提供的规则ID
valueType	O	String	返现类型 FIXED（定额折扣）, FIXED_WITH_QUANTITY（按数量定额折扣
value	O	Number	累计值最少值1
maxAmount		Number	最大返现值最少值0；FIXED或FIXED_WITH_QUANTITY无需该参数
vendorItemIds	O	Array	要使用相同返现规则的属性ID 列表可返现的属性ID最多为50个。必须值
startAt	O	String	开始时间 yyyy-MM-ddTHH:mm:ss 至少比当前时间晚2 小时才可使用（如果当前时间是下午 2 点，则可在下午4 点之后设置 startAt）
endAt	O	String	结束时间 yyyy-MM-ddTHH:mm:ss

请求体示例

{
  "ruleId": "3944",
  "valueType": "FIXED_WITH_QUANTITY",
  "value": "270",
  "maxAmount": "",
  "vendorItemIds": [
    "82650648946",
    "3000001897"
  ],
  "startAt": "2022-08-03T16:41:12",
  "endAt": "2099-12-31T23:59:59"
}

返回消息

Name

Type

Description

code

Number

Http 申请状态代码

EX) 200, 400, 500

message

String

成功或失败时相应信息会出现

200:	OK
206:	部分成功
400:	错误请求，将显示相应的错误请求消息
500:	内部错误

data

Object

当返现规则应用成功时，返回属性列表；如果失败，返回失败原因。

successVendorItemIds

Array

应用返现规则成功的属性列表

failVendorItemIds

Array

返现规则应用失败的属性列表和相应的失败原因

返回消息示例

{
  "code": 206,
  "message": "PARTIAL_CONTENT",
  "data": {
    "successVendorItemIds": [
      "3000001886"
    ],
    "failVendorItemIds": [
      {
        "3000001905": "Invalid vendorItemId, vendorItemId doesn't exist or doesn't belong to corresponding vendorId"
      }
    ]
  }
}

错误信息

HTTP status code (Error type)	Error message	Solution
400 (Check parameter requested)	返现值不可为空，最小值为1	查看是否正确输入了1及大于1的返现值（value）
400 (Check parameter requested)	RuleId不可为空，必须为数字	查看RuleId是否输入正确。
400 (Check parameter requested)	返现类型不能为空，可用值为FIXED、RATE和FIXED_WITH_QUANTITY。	查看返现类型（valueType）值是否输入正确。
400 (Check parameter requested)	vendorItemId列表不可为空, 最小数为1，最大为50。	查看vendorItemId列表值是否输入正确。
400 (Check parameter requested)	返现规则的开始或结束时间不可为空。	查看是否正确输入了开始日期和结束日期。
500 (Server Error)	INTERNAL_SERVER_ERROR	API调用成功，但系统内部发生错误。查看返现是否正常应用。

接口名称

UPDATE_PRODUCT_CASHBACK

[图书] 使用商品返现

简介

详细内容

路径

示例