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

搜 索

未使用合规服务待下架刊登

发布时间:2025-10-15          最近刷新时间:2026-03-27

描述

本接口对应“政策表现”> “直邮服务标准” >“未使用合规服务待下架刊登” 中的数据。 卖家中心相关界面供参考:


输入数据

资源路径

版本

注释

GET /gccbtapi/v1/direct_shipping/listing

V1

最新版本

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

数据更新时间

evaluationStartDate

评估开始日期

evaluationEndDate

评估结束日期

nextEvaluationDate

下一次评估时间

listingStatus

合规服务使用考核结果
1: 正常
2: 超标
3: 限制预警
4: 限制

问题刊登

listingId 刊登号

transactionId

交易号

corridor

买家路向

itemLocation

物品所在地

asp

单价

shippingOptionUsed

买家选择物流选项

trackingNumber

卖家上传的跟踪号

inputCarrierName

卖家填写的物流供应商

carrierDetected

eBay识别的物流服务商

serviceRequired

符合政策要求的物流服务

aScanTime

揽收扫描时间

actionReason

不合规原因

evaluationDate

审核日期(不再生效,固定返回null)

actionDate

生效日期 (不再生效,固定返回null)

appealable

Y:可申诉
N:不可申诉

appealStatus

申诉状态
Null未提交
PENDING: 待审核
REJECT: 申诉失败
APPROVAL: 申诉成功

响应举例

 {
    "errorMessage": null,
    "extension": null,
    "ackValue": "SUCCESS",
    "statusCode": 200,
    "timeStamp": 1760160982102,
    "data": {
        "listingStatus": 4,
        "evaluationStartDate": "2025-08-07",
        "evaluationEndDate": "2025-08-20",
        "nextEvaluationDate": "2025-09-07",
        "listings": [
            {
                "corridor": "US",
                "itemLocation": "CN",
                "currency": "USD",
                "asp": 9.0,
                "shippingOptionUsed": "Standard SpeedPAK from Greater China",
                "trackingNumber": "VR761970422YP",
                "inputCarrierName": "YANWEN",
                "carrierDetected": "YANWEN",
                "serviceRequired": "SpeedPAK物流管理方案或商业快递(如DHL、UPS、FedEx)",
                "aScanTime": "2025-08-02 16:22:00.0",
                "actionReason": "未使用政策要求的物流服务",
                "evaluationDate": null,
                "actionDate": null,
                "appealStatus": null,
                "appealable": "Y",
                "listingId": 146718951234,
                "transactionId": 0,
                "createPst": "2025-09-16"
            }
        ]
    }
} 
已复制!