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

搜 索

良交易表现>状态总览数据>不良交易刊登/待处理刊登数据接口

发布时间:2021-12-07          最近刷新时间:2023-12-29

描述

详细政策说明参见:https://www.ebay.cn/newcms/Home/seller_center/4

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

输入数据

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

其它设置参见“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

刊登状态:
Y 在线
N已下线

status

物品编号

listingId

刊登标题

auctTitl

交易额

gmv

SKU

sku

总交易量 transCnt

不良交易量

defectCnt

不良交易量比率

defectRate

物品未收到纠纷

inrCnt

物品与描述不符纠纷/退货

snadCnt

中差评

nnfbCnt

运送时间评分低分

lowStCnt

物品描述评分低分

lowIadCnt

因缺货而取消的交易

stockoutCnt

是否为待处理刊登

qcProgram

待处理刊登要求下线时间

qcProgramDeadline

响应举例

{
    "ackValue": "SUCCESS",
    "statusCode": 200,
    "timeStamp": 1638260292597,
    "data": [
        {
            "createPst": "2021-11-29",
            "status": "Y",
            "listingId": 1578653333,
            "auctTitl": "sample",
            "sku": "AU1-wyl022cqh[IB1074497]",
            "gmv": 45.293,
            "transCnt": 4,
            "defectCnt": 1,
            "defectRate": 0.25,
            "inrCnt": 0,
            "snadCnt": 0,
            "nnfbCnt": 1,
            "lowStCnt": 1,
            "lowIadCnt": 1,
            "stockoutCnt": 0,
            "qcProgram": "N",
            "qcProgramDeadline": "2021-12-11"
        },
        {
            "createPst": "2021-11-29",
            "status": "Y",
            "listingId": 1578652222,
            "auctTitl": "sample",
            "sku": "AU1-ztpiecu2pcs[IB1074509]",
            "gmv": 92.611,
            "transCnt": 10,
            "defectCnt": 2,
            "defectRate": 0.2,
            "inrCnt": 0,
            "snadCnt": 0,
            "nnfbCnt": 2,
            "lowStCnt": 0,
            "lowIadCnt": 0,
            "stockoutCnt": 0,
            "qcProgram": "N",
            "qcProgramDeadline": "2021-12-11"
        },
        {
            "createPst": "2021-11-29",
            "status": "N",
            "listingId": 1578651111,
            "auctTitl": "sample",
            "sku": "AU0-blb6303pom[IB1060183]",
            "gmv": 96.1686,
            "transCnt": 7,
            "defectCnt": 2,
            "defectRate": 0.2857,
            "inrCnt": 1,
            "snadCnt": 1,
            "nnfbCnt": 0,
            "lowStCnt": 0,
            "lowIadCnt": 0,
            "stockoutCnt": 0,
            "qcProgram": "Y",
            "qcProgramDeadline": "2021-12-11"
        }
    ]
}