eBay大中华区API开发者平台 开发者专区

搜 索

“额度申请快速通道”状态查询接口

发布时间: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"

      }

    ]

  }

错误信息包含以下几种情况,这些情况下接口不会返回详细检查数据:

1.

Your application to increase your selling limits has been unsuccessful. Please contact Customer Service if you would like to submit an application for an officer to review your application.

中文说明:很抱歉,您目前无法使用快速通道提高额度,请联系客服进行人工提额。

2.

We are unable to consider your application as you do not have any recent transactions. Your limit will remain the same at this time.

中文说明:很抱歉,您近期无交易,目前无法提高额度,请先使用当前额度进行销售。

3.

We are unable to approve your application as you have already been awarded the maximum possible limit for your account at this time.

中文说明:很抱歉,您当前的额度已经到达上限,暂时无法提额。

4.

Sorry, this features is not available for your account!

中文说明:很抱歉,该功能不适用于您的帐号。

5.

请注意:本接口限定每天可以查询同一个eBay ID不超过10次,超过可以继续查询其他eBay ID。请注意合理设置查询频率。

timestamp

long

总是出现

响应的服务器时间

data

array

有时出现

请求成功,并且有数据,这个字段应该是个数组。否则可能返回null




字段含义


字段名

描述

summaryStatus

帐户调额总体状态:VALID为可符合调额要求,INVALID为不符合调额要求

weeklyDataRefreshDate

周更新数据刷新时间,包括:

         ·  是否涉及侵权

         ·  过去12周纠纷率

         ·  过去12周不良交易率

         ·  过去12周与物品描述不符率

         ·  Linked suspended or restricted accounts number(仅部分帐户适用)

standardValue

标准值

currentValue

当前值

compoundValues

子项列表:适用于部分检查项,所有子项均需满足标准值要求。例如:卖家级别分为USUKDEGlobal

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"

            }

        ]

    }

}