[可下载优惠券] 应用到产品单项

# 01

简介

[可下载优惠券] 应用到产品单项

# 02

详细内容

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

该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

# 03

请求体参数

请求参数

请求体参数

Name	Type	Description
couponItems*	object[]	商品添加优惠券时使用的数据
couponId couponItems[].couponId	string	优惠券ID 可在优惠券创建response中查看
userId couponItems[].userId	string	用户账户 (WING 登录ID)
vendorItemIds couponItems[].vendorItemIds	object[]	使用优惠券的属性ID 每次请求最多可以上传100个属性ID
body	object
couponId body.couponId	string	相应的优惠券ID
errorCode	string	发生的错误类型
errorMessage	string	错误详细信息
400 (Check request parameter)	string	查看优惠券ID（couponid）值是否输入正确。查看是否是商品添加优惠券失败，优惠券ID被删除、

请求示例application/json

{
  "couponItems": [
    {
      "couponId": "15350660",
      "userId": "testaccount1",
      "vendorItemIds": [
        2306264997,
        4802314648,
        4230264914
      ]
    }
  ]
}

# 04

响应体

响应消息

Name	Type	Description
requestResultStatus	string	调用结果 SUCCESS / FAIL
body	object
couponId body.couponId	integer	相应的优惠券ID
errorCode	string	发生的错误类型
errorMessage	string	错误详细信息

Response Example

{
  "requestResultStatus": "SUCCESS",
  "body": {
    "couponId": 15350660
  },
  "errorCode": null,
  "errorMessage": null
}

# 05

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
400	400 (Check request parameter)	该促销展已被删除。	查看优惠券ID（couponid）值是否输入正确。查看是否是商品添加优惠券失败，优惠券ID被删除、