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

qimen.taobao.logistics.address.ability.callback (行政地址能力同步结果回告接口)

○ 淘天-->服务商 ○ 通知服务商淘天物流新增/更新驿站上门能力的处理结果。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
biz_request_id String 必须 10000000001 业务请求ID(服务商发起请求的ID)
supplier_id String 必须 STO-001 淘天物流服务商ID
outer_code String 必须 yzsm_cn_1 外部编码
service_type String 必须 2 服务类型:2-驿站正向上门
ability_type String 必须 2 能力:2-驿站正向上门
success Boolean 必须 true true|false
error_code String 可选 sys 响应码
error_message String 可选 xxx 响应信息
address_id_results AddressIdResult [] 可选
  • 最大列表长度:99999
  • 只会返回错误的地址id,如果淘天物流无法识别的地址则返回错误码
    • └ error_message
    • String
    • 可选
    • 未知错误
    • 错误原因
    • └ address_id
    • String
    • 可选
    • 330110005
    • 错误的地址ID
    address_name_results AddressNameResults [] 可选
  • 最大列表长度:99999
  • 只会返回错误的地址信息,如果淘天物流无法识别的地址则返回错误码
    • └ error_message
    • String
    • 可选
    • 未知错误
    • 错误原因
    • └ town
    • String
    • 可选
    • 五常街道
    • 街道
    • └ area
    • String
    • 可选
    • 余杭区
    • └ city
    • String
    • 可选
    • 杭州市
    • └ province
    • String
    • 可选
    • 浙江省
    is_retry Boolean 必须 false 是否重试

    响应参数

    名称 类型 示例值 描述
    success Boolean true true|false
    error_code String 100001 错误码
    error_message String 系统错误 系统错误
    is_retry Boolean true 是否可重试 true|false

    请求示例

    {"error_message":"xxx","address_name_results":[{"error_message":"未知错误","area":"余杭区","town":"五常街道","province":"浙江省","city":"杭州市"}],"service_type":"2","address_id_results":[{"error_message":"未知错误","address_id":"330110005"}],"biz_request_id":"10000000001","success":true,"is_retry":false,"error_code":"sys","ability_type":"2","supplier_id":"STO-001","outer_code":"yzsm_cn_1"}

    响应示例

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

    验签示例

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

    错误码解释

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

    API工具

    FAQ

    返回
    顶部