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

搜 索

直邮交易可追踪服务使用情况接口

发布时间:2020-05-20          最近刷新时间:2023-06-28

描述

本接口对应“政策表现”>“物流服务标准”> “直邮交易可追踪物流服务使用情况” 模块数据。

卖家中心相关界面供参考:

 
注:某些政策不适用于所有账号,可能没有对应的数据返回。

输入数据

资源路径
GET /gccbtapi/v1/directshipping/acct_data

其它设置参见“eBay大中华卖家API简介”首页中“其他通用设置”的描述。

请求参数

输出
如果查询成功,将返回卖家DirectShipping数据。
如果查询成功但data是空数组或没值,则可能是我们目前对该用户没有数据支持,请做好相关对用户的提示。

响应字段描述

输出字段

类型

出现频率

含义

ackValue

string

总是出现

SUCCESS FAILURE

errorMessage

object

有时出现

如果发生异常或请求错误,就可能看到errorMessage字段。

"errorMessage": {

    "error": [

      {

        "errorId": 1001,

        "domain": "PARAMETER",

        "category": "REQUEST",

        "message": "Parameter dateRange is missing",

        "longMessage": "Parameter dateRange is missing",

        "actionToTake": "CORRECTINPUTDATA"

      }

    ]

  }

timestamp

long

总是出现

响应的服务器时间

data

array

有时出现

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

字段含义

数据含义

对应对象

数据更新时间

createPst

评估起始时间

startDate

评估结束时间

endDate

账户状态

accountStatus

是否新卖家

newSellerFlag

是否允许卖家申诉

allowAppealFlag

寄往美国的汽摩配直邮交易
usPaSummary

所有直邮交易/所有交易

allSummary

其他直邮交易

寄往美国直邮交易

usSummary

寄往英国直邮交易

ukSummary

寄往德国直邮交易

deSummary

寄往澳大利亚直邮交易

auSummary

寄往加拿大直邮交易

caSummary

寄往法国、意大利、西班牙直邮交易

fritesSummary

寄往其他国家直邮交易

otherSummary

关于状态值的说明


accountStatus状态值

状态含义

0

正常:达到10%合规比例

1

超标:该检查项未达标,暂时未因为本检查项受到到警告或限制处理

2

限制预警:检查项首次未达标,将发送警告邮件到卖家账户注册邮箱

3

限制:该检查项多次未达标并因此受限,将发送邮件到卖家账户注册邮箱

null

数据未更新或无数据

newSellerFlag状态值


0

老卖家

1

新卖家

allowAppealFlag状态值


0

不可申诉

1

可申诉

color的状态值


1

红色

2

绿色

3

黑色

 

响应举例:

{

    "errorMessage": null,

    "extension": null,

    "ackValue": "SUCCESS",

    "statusCode": 200,

    "timeStamp": 1687860479055,

    "data": {

        "createPst": "2023-06-27",

        "startDate": "2023-06-04",

        "endDate": "2023-06-21",

        "accountStatus": 0,

        "nextEvaluationDate": "2023-07-02",

        "newSellerFlag": 0,

        "allowAppealFlag": 0,

        "allSummary": {

            "trans": 155,

            "adoption": 0.94,

            "color": 2,

            "requirement": 0.9

        },

        "usSummary": {

            "trans": 110,

            "adoption": 0.92,

            "color": 3,

            "requirement": null

        },

        "usPaSummary": {

            "trans": 4,

            "adoption": 1.0,

            "color": 2,

            "requirement": 1.0

        },

        "ukSummary": {

            "trans": 26,

            "adoption": 1.0,

            "color": 3,

            "requirement": null

        },

        "deSummary": null,

        "auSummary": {

            "trans": 8,

            "adoption": 0.88,

            "color": 3,

            "requirement": null

        },

        "caSummary": {

            "trans": 5,

            "adoption": 1.0,

            "color": 3,

            "requirement": null

        },

        "fritesSummary": {

            "trans": 1,

            "adoption": 1.0,

            "color": 3,

            "requirement": null

        },

       "otherSummary": {

            "trans": 9,

            "adoption": 1.0,

            "color": 3,

            "requirement": null

        }

    }

}