“额度申请快速通道”状态查询接口
发布时间:2021-04-13 最近刷新时间:2023-04-21示例
请注意:示例中的刊登ID和用户ID可能在eBay已经失效,请替换为有效数据。
描述
对应CBT卖家中心的“额度申请快速通道”功能,本接口提供帐户是否符合提额条件的状态查询。符合条件的用户可以通过https://cbtreport.ebay.com.hk/提交调额申请。
输入数据
资源路径
GET /gccbtapi/v1/limit_adjustment/check
其它设置参见“eBay大中华卖家API简介”首页中“其他通用设置”的描述。
请求参数
根据用户提供token中的orcaleid和userid去获取用户对应本接口数据
输出
如果查询成功,将返回卖家本接口数据。
如果查询成功但data是空数组或没值,则可能是该用户没有数据支持,请做好相关对用户的提示。
响应字段描述
输出字段 |
类型 |
出现频率 |
含义 |
ackValue |
string |
总是出现 |
SUCCESS 或 FAILURE |
errorMessage |
object |
有时出现 |
如果发生异常或请求错误,就可能看到errorMessage字段。 "errorMessage": { "error": [ { "errorId": 1001, "domain": "PARAMETER", "category": "REQUEST", "message": " Sorry, system features are not open to your registration site Yet!", "longMessage": " Sorry, system features are not open to your registration site Yet!", "actionToTake": "CORRECTINPUTDATA" } ] }
错误信息包含以下几种情况,这些情况下接口不会返回详细检查数据:
|
timestamp |
long |
总是出现 |
响应的服务器时间 |
data |
array |
有时出现 |
请求成功,并且有数据,这个字段应该是个数组。否则可能返回null。 |
字段含义
字段名 |
描述 |
summaryStatus |
|
weeklyDataRefreshDate |
周更新数据刷新时间,包括: · 是否涉及侵权 · 过去12周纠纷率 · 过去12周不良交易率 · 过去12周与物品描述不符率 |
standardValue |
标准值 |
currentValue |
当前值 |
compoundValues |
子项列表:适用于部分检查项,所有子项均需满足标准值要求。例如:卖家级别分为US,UK,DE,Global |
status |
状态值(VALID为通过,INVALID为不通过)注,只要用户数据有一项不通过,则无法调整额度 |
name |
检查项名称 |
字段名 |
描述 |
SCENARIO_ID |
受限状态 |
ACCOUNT_STATUS |
帐号状态 |
DAYS_TO_LAST_ADJ |
距离上次调额时间(天数) |
DAYS_TO_FIRST_TRANS |
距离第一次销售时间(天数) |
BEFORE_SELLER_STANDARD |
先前卖家级别(区分站点) |
CURRENT_SELLER_STANDARD |
当前卖家级别(区分站点) |
SELLER_STANDARD_FUTURE |
卖家级别预估(区分站点) |
QTY_UTILIZATION |
额度使用率(与销售额度使用率满足其一即可) |
GMS_UTILIZATION |
销售额度使用率(与额度使用率满足其一即可) |
QTY_CONVERSION_RT |
额度转化率(与销售额度转化率满足其一即可) |
GMS_CONVERSION_RT |
销售额度转化率(与额度转化率满足其一即可) |
LATE_SHP_CNT |
延迟送达交易数量(与延迟送达率满足其一即可,优先检查送达率) |
LATE_SHP_RATE |
延迟送达率(与延迟送达交易数量满足其一即可,优先检查送达率) |
OPEN_CLAIM_CNT |
未解决纠纷交易数量(与未解决纠纷率满足其一即可,优先检查纠纷率) |
OPEN_CLAIM_RATE |
未解决纠纷率(与未解决纠纷交易数量满足其一即可,优先检查纠纷率) |
VERO_IND |
是否涉及侵权 |
CLAIM_CNT |
过去12周纠纷交易数量(与过去12周纠纷率满足其一即可,优先检查纠纷率) |
CLAIM_RT |
过去12周纠纷率(与过去12周纠纷交易数量满足其一即可,优先检查纠纷率) |
DF_CNT |
过去12周不良交易数量(与过去12周不良交易率满足其一即可,优先检查不良交易率) |
DF_RT |
过去12周不良交易率(与过去12周不良交易数量满足其一即可,优先检查不良交易率) |
SNAD_CNT |
过去12周与物品描述不符交易数量(与过去12周与物品描述不符率满足其一即可,优先检查不符率) |
SNAD_RT |
过去12周与物品描述不符率(与过去12周与物品描述不符交易数量满足其一即可,优先检查不符率) |
BAD_LINK |
Linked suspended or restricted accounts number(仅部分帐户适用) |
appealFlag新 |
Y可以申诉,N不可申诉,仅部分帐户适用,请提示用户至https://cbtreport.ebay.com.hk/提交申诉。 |
响应举例:
{
"errorMessage": null,
"extension": null,
"ackValue": "SUCCESS",
"statusCode": 200,
"timeStamp": 1111967984979,
"data": {
"summaryStatus": "INVALID",
"weeklyDataRefreshDate": "2023.04.18",
"appealFlag": "N",
"checkedValues": [
{
"name": "SCENARIO_ID",
"currentValue": "NORMAL",
"standardValue": "NORMAL",
"status": "VALID"
},
{
"name": "ACCOUNT_STATUS",
"currentValue": "CONFIRMED",
"standardValue": "CONFIRMED",
"status": "VALID"
},
{
"name": "DAYS_TO_LAST_ADJ",
"currentValue": 26,
"standardValue": 30,
"status": "INVALID"
},
{
"name": "DAYS_TO_FIRST_TRANS",
"currentValue": 1052,
"standardValue": 45,
"status": "VALID"
},
{
"name": "BEFORE_SELLER_STANDARD",
"currentValue": null,
"standardValue": "ABOVE_STANDARD",
"compoundValues": [
{
"name": "US_SELLER_STANDARD",
"currentValue": null,
"standardValue": "ABOVE_STANDARD",
"status": null
},
{
"name": "UK_SELLER_STANDARD",
"currentValue": null,
"standardValue": "ABOVE_STANDARD",
"status": null
},
{
"name": "GLOBAL_SELLER_STANDARD",
"currentValue": null,
"standardValue": "ABOVE_STANDARD",
"status": null
},
{
"name": "DE_SELLER_STANDARD",
"currentValue": null,
"standardValue": "ABOVE_STANDARD",
"status": null
}
],
"status": "VALID"
},
{
"name": "CURRENT_SELLER_STANDARD",
"currentValue": null,
"standardValue": "ABOVE_STANDARD",
"compoundValues": [
{
"name": "US_SELLER_STANDARD",
"currentValue": "BELOW_STANDARD",
"standardValue": "ABOVE_STANDARD",
"status": "INVALID"
},
{
"name": "UK_SELLER_STANDARD",
"currentValue": null,
"standardValue": "ABOVE_STANDARD",
"status": null
},
{
"name": "GLOBAL_SELLER_STANDARD",
"currentValue": null,
"standardValue": "ABOVE_STANDARD",
"status": null
},
{
"name": "DE_SELLER_STANDARD",
"currentValue": null,
"standardValue": "ABOVE_STANDARD",
"status": null
}
],
"status": "INVALID"
},
{
"name": "SELLER_STANDARD_FUTURE",
"currentValue": null,
"standardValue": "ABOVE_STANDARD",
"compoundValues": [
{
"name": "DE_SELLER_STANDARD_FUTURE",
"currentValue": null,
"standardValue": "ABOVE_STANDARD",
"status": "VALID"
},
{
"name": "US_SELLER_STANDARD_FUTURE",
"currentValue": "BELOW_STANDARD",
"standardValue": "ABOVE_STANDARD",
"status": "INVALID"
},
{
"name": "UK_SELLER_STANDARD_FUTURE",
"currentValue": null,
"standardValue": "ABOVE_STANDARD",
"status": "VALID"
},
{
"name": "GLOBAL_SELLER_STANDARD_FUTURE",
"currentValue": null,
"standardValue": "ABOVE_STANDARD",
"status": "VALID"
}
],
"status": "INVALID"
},
{
"name": "QTY_UTILIZATION",
"currentValue": "0.00%",
"standardValue": "40.00%",
"status": "INVALID"
},
{
"name": "GMS_UTILIZATION",
"currentValue": "0.00%",
"standardValue": "40.00%",
"status": "INVALID"
},
{
"name": "QTY_CONVERSION_RT",
"currentValue": "0.00%",
"standardValue": "1.00%",
"status": "INVALID"
},
{
"name": "GMS_CONVERSION_RT",
"currentValue": "0.00%",
"standardValue": "1.00%",
"status": "INVALID"
},
{
"name": "LATE_SHP_RATE",
"currentValue": null,
"standardValue": null,
"compoundValues": [
{
"name": "UK_LATE_SHP_RATE",
"currentValue": null,
"standardValue": "3.00%",
"status": null
},
{
"name": "DE_LATE_SHP_RATE",
"currentValue": null,
"standardValue": "3.00%",
"status": null
},
{
"name": "GLOBAL_LATE_SHP_RATE",
"currentValue": null,
"standardValue": "5.00%",
"status": null
},
{
"name": "US_LATE_SHP_RATE",
"currentValue": "2.97%",
"standardValue": "3.00%",
"status": "VALID"
}
],
"status": "VALID"
},
{
"name": "OPEN_CLAIM_RATE",
"currentValue": null,
"standardValue": null,
"compoundValues": [
{
"name": "GLOBAL_OPEN_CLAIM_RATE",
"currentValue": null,
"standardValue": "0.30%",
"status": null
},
{
"name": "UK_OPEN_CLAIM_RATE",
"currentValue": null,
"standardValue": "0.30%",
"status": null
},
{
"name": "DE_OPEN_CLAIM_RATE",
"currentValue": null,
"standardValue": "0.30%",
"status": null
},
{
"name": "US_OPEN_CLAIM_RATE",
"currentValue": "0.74%",
"standardValue": "0.30%",
"status": "INVALID"
}
],
"status": "INVALID"
},
{
"name": "VERO_IND",
"currentValue": "Y",
"standardValue": "N",
"status": "INVALID"
},
{
"name": "DF_RT",
"currentValue": "5.66%",
"standardValue": "4.00%",
"status": "INVALID"
}
]
}
}