coupang
POST/v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/itemsv1

[立减优惠券] 添加产品单品

# 01

简介

API支持的买家用户地区:韩国 该API用于将创建的优惠券添加至单件商品。本API是异步的方式,仅执行处理请求 。 可使用响应的 “requestedId” 值,通过确认请求状态 API 来查看实际 API 执行结果值。 请在添加产品到立减优惠券的时候谨慎选择产品列表,因为此立减优惠券创建之后卖家就无法对优惠券的产品列表进行删除操作。如果您确实需要删除其中的一些产品,请暂停旧的优惠券, 创建新的立减优惠券,并添加新的 产品列表。

# 02

详细内容

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

该API用于将创建的优惠券添加至单件商品。本API是异步的方式,仅执行处理请求 

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

 

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

 

路径

POST

/v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items

示例

https://api-gateway.coupang.com/v2/providers/fms/apis/api/v1/vendors/A00012345/coupons/68/items

请求参数

Name 

Required 

Type 

Description 

vendorId 

O 

String 

卖家ID 

酷澎分配给卖家的固有代 

e.g. A00012345 

couponId 

O 

Number 

要使用的优惠券ID 

请求体参数

Name 

Required 

Type 

Description 

vendorItems 

 

Array 

要添加优惠券的属性ID 

一次最多可添加10,000属性ID 

请求体示例

{
  "vendorItems": [
    3226138951,
    3226138847
  ]
}

返回消息

Name Type Description
code Number
服务器返回码 
message String
服务器返回消息
httpStatus Number
HTTP 状态码(与服务器返回码相同)
httpStatusMessage String
HTTP 状态消息(与服务器返回消息相同)
errorMessage String
错误详情,HTTP 状态码为 200 时,无错误信息
data Object
请求成功与否的数据
  success Boolean
真或假
  content Object
处理状态的请求ID数据 
    requestedId String
查看处理状态的请求ID  
e.g. 1542675975663862164
    success Boolean
真或假
  Pagination Array
无分页

返回消息示例

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

错误信息

HTTP Status 

Code (Error 

Code) 

Error Message 

Solution 

400 (check parameter requested) 

vendorItems可能不为空,数量必须要1和10000之间。 

查看要添加优惠券的属性ID(vendoritems)是否输入正确。 

一次最多添加10,000属性ID 

400 (check parameter requested) 

请确认卖家权限。 

查看卖家ID(vendorid)值是否输入正确。 

400 (check parameter requested) 

请确认优惠券ID 

208463**** 

查看优惠券ID(couponid)值是否输入正确。