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

搜 索

“不良交易表现”-不良交易明细下载

发布时间:2024-01-16          最近刷新时间:2024-01-25

描述

本接口对应“政策表现”> “不良交易表现” >“状态总览” >“不良刊登及交易明细下载” 中“不良交易明细”数据。

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


输入数据

资源路径
GET /gccbtapi/v1/defect_transaction/transactions

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

请求参数

输出
如果查询成功,将返回“不良交易表现”状态总览下不良交易刊登下载数据中“不良交易明细”数据。
如果查询成功但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

数据更新时间

transactionId

交易编号

listingId

物品编号

auctTitl

刊登标题

transDt

交易日期

buyerName

买家账户名

gmv

总交易额

defectFlag

不良交易

inrFlag

物品未收到纠纷

snadFlag

物品与描述不符退货

nnfbFlag

中差评

lowIadFlag

物品描述评分低分

stockoutFlag

因缺货而取消的交易

响应举例

{

    "errorMessage"null,

    "extension"null,

    "ackValue""SUCCESS",

    "statusCode": 200,

    "timeStamp": 1704173291714,

    "data": [

        {

            "createPst""2023-12-19",

            "transactionId""1335825946677",

            "listingId""394969336677",

            "auctTitl""test2",

            "transDt""2023-11-01",

            "buyerName""test2",

            "gmv": 69.91,

            "defectFlag": 1,

            "inrFlag": 0,

            "snadFlag": 0,

            "nnfbFlag": 1,

            "lowIadFlag": 1,

            "stockoutFlag": 0

        },

        {

            "createPst""2023-12-19",

            "transactionId""1336294561234",

            "listingId""394969331234",

            "auctTitl""test",

            "transDt""2023-11-03",

            "buyerName""test",

            "gmv": 66.53,

            "defectFlag": 1,

            "inrFlag": 0,

            "snadFlag": 0,

            "nnfbFlag": 1,

            "lowIadFlag": 0,

            "stockoutFlag": 0

        },

        {

            "createPst""2023-12-19",

            "transactionId""1340069951122",

            "listingId""394987751122",

            "auctTitl""test1",

            "transDt""2023-11-18",

            "buyerName""test1",

            "gmv": 60.67,

            "defectFlag": 1,

            "inrFlag": 0,

            "snadFlag": 0,

            "nnfbFlag": 1,

            "lowIadFlag": 1,

            "stockoutFlag": 0

        }

    ]

}