(通用) 查看单份优惠卷合同

# 01

简介

(通用) 查看单份优惠卷合同

# 02

详细内容

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

该API用于查看所设置的单份合同。

路径

GET/v2/providers/fms/apis/api/v2/vendors/{vendorId}/contract

示例端点

https://api-gateway.coupang.com/v2/providers/fms/apis/api/v2/vendors/A00012345/contract?contractId=9962

# 03

Path 参数

Name	Type	Description
vendorId*	string	卖家ID 酷澎分配给卖家的固有代码 e.g. A00012345

# 04

Query 参数

Name	Type	Description
contractId*	number	卖家合同ID

# 05

响应体

响应消息

Name	Type	Description
code	integer	服务器响应代码
message	string	服务器响应信息
httpStatus	integer	HTTP
httpStatusMessage	string	HTTP 状态信息 (与服务器响应信息的值相同)
errorMessage	string	除HTTP Status 200以外，剩下Status 中包含服务器详细失败原因信息
data	object	单份合同数据
success data.success	boolean	成功与否 True or false
content data.content	object	单份合同
contractId data.content.contractId	integer	卖家合同ID e.g. 1, 2
vendorContractId data.content.vendorContractId	integer	卖家合同代码 (酷澎管理代码) e.g. -1, 1, 2
sellerId data.content.sellerId	string	卖家ID e.g. A00012345
sellerShareRatio data.content.sellerShareRatio	integer	该合同中规定的卖家分摊比例(%) e.g. 100
coupangShareRatio data.content.coupangShareRatio	integer	该合同中规定的酷澎分摊比例(%) e.g. 100
gmvRatio data.content.gmvRatio	integer	单月销售额比率，单月预算基于酷澎的销售额自动生成 e.g. 100
start data.content.start	string	开始时间 e.g. 2018-01-22 00:00:00
end data.content.end	string	结束时间 e.g. 2018-12-31 23:59:59
type data.content.type	string	合同类型 e.g. CONTRACT_BASED, NON_CONTRACT_BASED
usedBudget data.content.usedBudget	boolean	是否使用预算限制 e.g. true, false 目前不使用的字段，true为基本值
modifiedAt data.content.modifiedAt	string	最终修改时间 e.g. 2017-09-25 11:40:01
modifiedBy data.content.modifiedBy	string	最终修改人ID
Pagination data.Pagination	string	单件查看，因此无分页、

Response Example

{
  "code": 200,
  "message": "OK",
  "httpStatus": 200,
  "httpStatusMessage": "OK",
  "errorMessage": "",
  "data": {
    "success": true,
    "content": {
      "contractId": 9962,
      "vendorContractId": 7,
      "sellerId": "A00012345",
      "sellerShareRatio": 100,
      "coupangShareRatio": 0,
      "gmvRatio": 100,
      "start": "2018-01-22 00:00:00",
      "end": "2018-12-31 23:59:59",
      "type": "CONTRACT_BASED",
      "useBudget": true,
      "modifiedAt": "2018-01-22 16:07:10",
      "modifiedBy": "allie"
    },
    "pagination": null
  }
}

# 06

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
401	401 (check requested parameter)	请确认卖家权限。	查看卖家ID（vendorid）值是否输入正确
401	401 (check requested parameter)	无法查看该合同ID	查看合同ID（contractid）值是否输入正确
401	401 (check requested parameter)	必需参数“contractId”不存在	查看合同ID（contractid）值是否已输入