文档中心 > API类目 > 淘天物流API

qimen.taobao.logistics.express.service.send (服务指令下发)

服务指令下发到tms,用于tms按照特定服务来履行

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
business_type String 可选 1 业务类型(1-通用业务 )
service_flag String 必须 1 操作类型(1-服务下发;2-改约;3-取消; )
service_type String 必须 1 服务类型(1-送货上门;2-放指定驿站 ; 6- 加价选配)
biz_code String 可选 23423423 服务单
supplier_id String 必须 3434234 服务商id
tms_cp_code String 可选 STO 菜鸟的CPcode
delivery_code String 可选 STO01 服务商配资源唯一编码
mail_no String 必须 23423423 包裹运单号
delivery_date String 可选 2023-02-01 履行服务日期
delivery_time_range String 可选 09:00-11:00 履行服务时间段
site_id String 可选 1234 站点id
site_name String 可选 杭州驿站01 驿站名称
site_address String 可选 杭州市余杭区**街道 驿站地址
remark String 可选 备注信息 备注
feature FeatureDO 可选 扩展属性
  • └ trade_ids
  • String
  • 可选
  • 2332,4343,3434
  • 订单列表
  • └ package_id
  • String
  • 可选
  • 234234
  • 包裹编码
  • └ ident_code
  • String
  • 可选
  • 2323
  • 手机号后四位
  • └ mfc_create_time
  • String
  • 可选
  • 1231231
  • 创单时间戳
  • └ postal_service_policy
  • Boolean
  • 可选
  • true
  • 邮政规则标识
  • └ road_district_flag
  • String
  • 可选
  • 1
  • 路区订单标
  • └ extra_protect_flag
  • String
  • 可选
  • 1
  • 重保
  • └ instant_delivery_flag
  • String
  • 可选
  • 1
  • 及时送
  • └ warehouse_outbound_weight
  • String
  • 可选
  • 23.204
  • 仓出库重量,单位g
  • └ warehouse_code
  • String
  • 可选
  • store_001
  • 仓编码
  • └ third_sort_code
  • String
  • 可选
  • 2324HF
  • 三段码
  • └ yztp_priority
  • String
  • 可选
  • 1
  • 驿站退坡场景服务优先级(1/2/3)
  • └ yztp_source
  • String
  • 可选
  • 1
  • 驿站退坡下发来源(1-物流部规则/2-CCO创建)
delivery_address String 可选 文一西路969号 服务地址
site_type String 可选 1 驿站类型
version String 可选 1710750165 时间版本
preference PreferenceDO 可选 偏好信息
  • └ phone_call_preference
  • String
  • 可选
  • 1
  • 电联偏好(1-需电联2-无需电联,空的情况直接下发)
  • └ default_preference
  • String
  • 可选
  • 1
  • 兜底偏好(1-联系不上放代收2-联系不上放门口3-无人签收放门口,空的情况直接下发)
operate_type String 可选 SERVICE_NOTIFY 订单创建:ORDER_CREATE 轨迹订阅:TRACE_REGISTER 服务通知:SERVICE_NOTIFY
phone_call_type String 可选 99 电联要求( 97- 98-禁止电联;99-需要平台电联;100-需要小件员人工电联
requirements ServiceRequirement [] 可选
  • 最大列表长度:100
  • 服务要求
    • └ finish_time
    • String
    • 可选
    • 2020-06-02 12:00:00
    • 完成时间
    • └ content
    • String
    • 可选
    • SIGN_PHOTO
    • 要求内容(DELIVERY_INSTANT 及时派送, SIGN_IN_PERSON 本人签收,SIGN_PHOTO 签收拍照片 )
    • └ action
    • String
    • 可选
    • DELIVERY
    • 操作节点(DELIVERY 派送 SIGN 签收)
    item_list ItemsDO [] 可选
  • 最大列表长度:100
  • 包裹明细
    • feature
    • ItemFeatureDO
    • 可选
    • 明细属性
    • └ alg_weight
    • String
    • 可选
    • 33
    • 预估重量,单位 g
    • └ is_replenish
    • String
    • 可选
    • 1
    • 是否补发
    • └ gbyj_fulfil_req
    • String
    • 可选
    • {"gbBelongDivisionId":"510000","picOpt":[{"picType":"301","picStd":"A00001"},{"picType":"301","picStd":"A00002"}
    • 国补要求
    • └ leaf_category_name
    • String
    • 可选
    • 衣服
    • 类目名称
    • └ item_name
    • String
    • 可选
    • XX牌衣服
    • 商品名称
    • └ consign_time
    • String
    • 可选
    • 2024-12-13 12:00:00
    • 发货时间
    • └ trade_id
    • String
    • 可选
    • 232323
    • 交易单号
    • └ order_line
    • String
    • 可选
    • xxx
    • 货品行id
    • └ sn
    • String
    • 可选
    • SN1
    • SN
    • └ imei
    • String
    • 可选
    • SN1:IMEI1,IMEI2
    • IMEi
    • └ real_root_cat
    • String
    • 可选
    • xxx
    • 一级类目id
    • └ brand_id
    • String
    • 可选
    • 11599
    • 品牌id
    • └ leaf_cid
    • String
    • 可选
    • 50019790
    • 叶子类目

    响应参数

    名称 类型 示例值 描述
    success Boolean true 系统成功失败 true|false
    error_code String 100001 错误码
    error_message String 系统错误 错误码描述
    is_retry Boolean true 是否可重试
    data DataDO 返回具体数据
    • └ is_accepted
    • Boolean
    • true
    • 系统是否接受服务指令
    • └ out_biz_product_code
    • String
    • 3
    • 外部产品类别code

    请求示例

    {"delivery_address":"文一西路969号","operate_type":"SERVICE_NOTIFY","requirements":[{"action":"DELIVERY","finish_time":"2020-06-02 12:00:00","content":"SIGN_PHOTO"}],"biz_code":"23423423","site_type":"1","preference":{"default_preference":"1","phone_call_preference":"1"},"remark":"备注信息","version":"1710750165","mail_no":"23423423","site_name":"杭州驿站01","service_type":"1","delivery_date":"2023-02-01","delivery_code":"STO01","site_address":"杭州市余杭区**街道","feature":{"extra_protect_flag":"1","yztp_priority":"1","postal_service_policy":true,"yztp_source":"1","instant_delivery_flag":"1","ident_code":"2323","warehouse_code":"store_001","package_id":"234234","mfc_create_time":"1231231","third_sort_code":"2324HF","road_district_flag":"1","warehouse_outbound_weight":"23.204","trade_ids":"2332,4343,3434"},"phone_call_type":"99","item_list":[{"real_root_cat":"xxx","consign_time":"2024-12-13 12:00:00","trade_id":"232323","feature":{"is_replenish":"1","alg_weight":"33","gbyj_fulfil_req":"{\"gbBelongDivisionId\":\"510000\",\"picOpt\":[{\"picType\":\"301\",\"picStd\":\"A00001\"},{\"picType\":\"301\",\"picStd\":\"A00002\"}"},"leaf_category_name":"衣服","order_line":"xxx","imei":"SN1:IMEI1,IMEI2","leaf_cid":"50019790","item_name":"XX牌衣服","sn":"SN1","brand_id":"11599"}],"business_type":"1","site_id":"1234","service_flag":"1","delivery_time_range":"09:00-11:00","supplier_id":"3434234","tms_cp_code":"STO"}

    响应示例

    {
        "success":true,
        "error_code":"100001",
        "error_message":"系统错误",
        "is_retry":true,
        "data":{
            "is_accepted":true,
            "out_biz_product_code":"3"
        }
    }

    验签示例

    
                                    

    错误码解释

    错误码 错误描述 解决方案

    API工具

    FAQ

    返回
    顶部