淘宝开放平台

登录
文档中心 > API类目 > 天猫供应链

天猫供应链

qimen.taobao.logistics.express.collect.resource.callback (上门取退可揽范围新建/更新结果回告接口)

○ 淘天->快递，异步结果回告接口 ○ 平台通知服务商淘天物流新增、更新快递上门取退可揽范围能力的结果。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
supplier_id String 必须 10000000001 服务商ID
delivery_code String 必须 STO-001 服务商配资源唯一编码
success Boolean 必须 true true|false
biz_code String 可选 200 响应码
biz_message String 可选 SUCCESS 响应信息
address_id_results AddressIdResults [] 可选
  • 最大列表长度：99999
    		•  当地址传入方式为菜鸟地址库ID传入时，则必须填写 地址id（数组）；四级/三级/二级
    • └ address_id
    • String
    • 可选
    • 330110005
    • 地址id
    • └ error_message
    • String
    • 可选
    • 错误原因
    • 错误原因
    • └ error_code
    • String
    • 可选
    • ADDRESS_UNKNOWN
    • 错误码
    address_name_results AddressNameResults [] 可选
  • 最大列表长度：99999
    		•  当地址传入方式为详细地址时填写
    • └ province
    • String
    • 可选
    • 浙江省
    • 省
    • └ city
    • String
    • 可选
    • 杭州市
    • 市
    • └ area
    • String
    • 可选
    • 余杭区
    • 区
    • └ town
    • String
    • 可选
    • 五常街道
    • 街道
    • └ error_message
    • String
    • 可选
    • 错误原因
    • 错误原因
    • └ error_code
    • String
    • 可选
    • ADDRESS_UNKNOWN
    • 错误码
    region_id_results RegionIdResults [] 可选
  • 最大列表长度：99999
    		•  地理围栏（经纬度），电子围栏最多5000个点（数组）
    • └ latitude
    • String
    • 可选
    • 120.21201
    • 经度（高德）
    • └ longitude
    • String
    • 可选
    • 30.2084
    • 纬度（高德）
    • └ error_message
    • String
    • 可选
    • 错误原因
    • 错误原因
    • └ error_code
    • String
    • 可选
    • ADDRESS_UNKNOWN
    • 错误码
    biz_request_id String 必须 xxxxx 业务请求ID（服务商发起请求的ID）
    service_type String 可选 1 服务类型：1-上门取退
    ability_type String 可选 1 能力：1-上门取退

    响应参数

    名称 类型 示例值 描述
    success Boolean true true|false
    error_code String 100001 错误码
    error_message String 系统错误 系统错误

    请求示例

    {"address_name_results":[{"area":"余杭区","error_message":"错误原因","province":"浙江省","town":"五常街道","city":"杭州市","error_code":"ADDRESS_UNKNOWN"}],"address_id_results":[{"error_message":"错误原因","address_id":"330110005","error_code":"ADDRESS_UNKNOWN"}],"service_type":"1","delivery_code":"STO-001","biz_code":"200","region_id_results":[{"error_message":"错误原因","latitude":"120.21201","error_code":"ADDRESS_UNKNOWN","longitude":"30.2084"}],"biz_request_id":"xxxxx","success":true,"biz_message":"SUCCESS","ability_type":"1","supplier_id":"10000000001"}

    响应示例

    {
    "success":true,
    "error_code":"100001",
    "error_message":"系统错误"
}

    验签示例

    {"error_message":"Illegal request","success":"false","error_code":"sign-check-failure"}

    错误码解释

    错误码 错误描述 解决方案
    response-body-parse-error

    API工具

    错误码查询工具 SDK下载

    FAQ

    有用( 0 ) 我要提问
    返回
    顶部