# 腾讯出行服务跑腿MCP开发文档

# 1. 简介

本文档用于描述腾讯出行服务基于跑腿业务MCP能力外输的对接说明。 当外输方接入腾讯跑腿MCP时,必要实现以下行为

  • 在出行服务开放平台 https://open.go.qq.com/ (opens new window) 登录注册商户,分别注册一个【第三方接入应用】和 一个【MCP应用】

  • 客户端实现拉起出行OAuth授权能力

    • 外输方需要在己方APP拉起出行服务小程序OAuth授权页,出行侧会引导用户完成必要授权,授予并同步accessToken信息给到外输方
    • 当用户refreshToken过期,外输方需重新拉起出行服务小程序OAuth授权页,刷新有效accessToken
  • 接入或实现相关API接口

    • 参考第二节
    • 接入接口【refreshToken刷新】,使能用refreshToken主动刷新accessToken
    • 接入接口【跑腿订单详情查询】,使能后台获取指定订单详细数据
    • 实现接口【登录态同步】,使能后台接收出行同步的accessToken
    • 实现接口【订单状态同步】,使能后台接收出行同步的订单变化
  • 接入MCP能力

    • 参考第三节,通过外输方Agent接入多个跑腿MCP能力

本文档分为2个部分:

  • 第一部分:API 能力描述
  • 第二部分:MCP能力描述

# 2. API能力描述

# 2.1 基础说明

  • 接口协议 除非特殊指定,默认请求方式均为 HTTPS/POST 方式。
  • 返回数据格式 除非特殊指定,默认返回数据格式均为 JSON 格式。
  • 字符编码 除非特殊指定,默认字符编码均为 UTF-8 编码格式。
  • 请求格式 接口内如果没有特殊说明的,请求格式一律统一为 application/json 。
  • 重试机制 调⽤出行服务接口时,返回码 Code 不成功,要有重试机制(具体见错误码表)。
  • 通用参数
字段名 字段类型 最大长度 必填 说明
api_key string 32 腾讯出行服务分配给服务商调用api_key
seq_id string 36 请求流水号,调用方自动生成一个随机ID,建议使用uuid
timestamp int 11 请求发送时的时间戳(unix时间戳) 秒
nonce string 10 10位随机字符串
sign string 32 验证签名参数
  • 通用返回值
字段名 字段类型 最大长度 必填 说明
code int 11 服务响应状态,参见错误码表
message string 64 服务响应状态说明,参见错误码表
data object - 具体的接口对应不同的对象详见具体的接口
  • 鉴权说明

    **步骤 1**
    从请求串中获得 api_key、seq_id、timestamp, nonce 通用字段以及其他的业务段和鉴权结果字段 sign。
    
    **步骤 2**
    根据签名算法,对参与签名的内容进行签名;
    按照除 sign 外参数名称排序(字典升序排列)成"key1=value1&key2=value2&...."的原始字符串 src1;参数值为 null 不参与签名。
    将原始字符串+分配给调用方的 api_sercret 形成字符串 src2;
    将 src2 进行 md5 后转成大写形成签名内容 dest
    
    **步骤 3**
    将步骤 2 中得到的签名内容 dest 与请求中的 sign 字段内容做比较,如果相同则验证成功,否则判定请求非法。
    
    举例:
    假设/user/sync 接口文档中业务字段为[slon, slat],分配的 api_sercret= DZaslH9B9ycqRrE77laCPB2Om,
    请求参数如下:
    api_key=PSUBZLHOKUO6HV52A5CAUSSE5KSB6Y, seq_id=b8b4f0b8-01fb-4c06-80b9-3ab895a8c616, timestamp=1554695343, slat=39.998299, slon=116.285561
    则需要签名的内容:
    api_key=PSUBZLHOKUO6HV52A5CAUSSE5KSB6Y&seq_id=b8b4f0b8-01fb-4c06-80b9-3ab895a8c616&slat=39.998299&slon=116.285561&timestamp=1554695343DZaslH9B9ycqRrE77laCPB2Om
    
    **步骤 4**
    计算的 MD5 值为 8a983278e5366eb93feb0d4143e1c522,大写值为 8A983278E5366EB93FEB0D4143E1C522。
    
    **步骤 5**
    将步骤 4 中得到的 MD5 值,与请求中 sign 字段的值比较。两者相同请求合法。
    
  • 注意事项

    1、需要签名的字段与请求串中字段先后顺序没有关系,只与进行签名的内容有关,必须按照文档中的顺序拼接。
    2、api_sercret 内容为双方保密内容,不在请求中传输,严禁公开。
    3、通用字段 api_key,seq_id,timestamp,nonce 参与所有接口的签名。
    4、字段值是 JSON 的类型,把字段值 json 串参与签名, 不用拆分重排里面字段。
    
# 错误码表
错误码范围 分类
0 成功
500 服务器异常
5000 ~ 5999 通用错误
10001 ~ 10050 业务错误
20000 ~ 29999 转发相关错误
30000 ~ 39999 用户状态错误

# 2.2 需外输方提供API

  • 接口域名路径由外输方提供
  • 接口AKSK研发线下同步

# 2.2.1 登录态同步

  • 接口说明 本接口用于出行服务在用户完成OAuth授予后,向外输方同步用户accessToken。
  • 请求地址 /token/sync (外输方可自定义)
  • 请求方式 POST
  • 请求参数 通用参数 + 业务参数

业务参数

参数名称 类型 最大长度 必选 说明
usercode string 64 来自外输方的用户标识码
access_token string 256 访问令牌
refresh_token string 256 刷新令牌
expires_in int 11 过期时间(秒)
  • 返回数据
参数名称 类型 最大长度 必选 说明
code int 11 服务响应状态,参见错误码表
message string 64 服务响应状态说明,参见错误码表
  • 请求数据示例
{
  "api_key": "PSUBZLHOKUO6HV52A5CAUSSE5KSB6Y",
  "seq_id": "b8b4f0b8-01fb-4c06-80b9-3ab895a8c616",
  "timestamp": 1554695343,
  "nonce": "abc123def4",
  "sign": "8A983278E5366EB93FEB0D4143E1C522",
  "usercode": "user123456",
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "refresh_token_value",
  "expires_in": 7200
}
  • 返回数据示例
{
  "code": 0,
  "message": "success"
}

# 2.2.2 订单状态同步

  • 接口说明 本接口用于出行服务向外输方提供外输订单的信息同步。
  • 请求地址 /order/sync (外输方可自定义)
  • 请求方式 POST
  • 请求参数 通用参数 + 业务参数

业务参数

参数名称 类型 最大长度 必选 说明
usercode string 64 来自外输方的用户标识码
order_code string 64 订单ID
order_data string - 订单数据,JSON字符串格式
  • 返回数据
参数名称 类型 最大长度 必选 说明
code int 11 服务响应状态,参见错误码表
message string 64 服务响应状态说明,参见错误码表
  • 请求数据示例
{
  "api_key": "PSUBZLHOKUO6HV52A5CAUSSE5KSB6Y",
  "seq_id": "b8b4f0b8-01fb-4c06-80b9-3ab895a8c616",
  "timestamp": 1554695343,
  "nonce": "abc123def4",
  "sign": "8A983278E5366EB93FEB0D4143E1C522",
  "usercode": "user123456",
  "order_code": "order_123456789",
  "order_data": "{\"status\":90900,\"amount\":100.0,\"create_time\":\"2023-01-01 10:00:00\"}"
}
  • 返回数据示例
{
  "code": 0,
  "message": "success"
}

# 2.3 腾讯方API

# 2.3.1 refreshToken刷新
  • 接口说明 本接口用于外输方通过后台刷新refreshToken
  • 请求路径 /tms/auth/refreshToken
  • 请求方式 POST
  • 请求参数 通用参数 + 业务参数

业务参数

参数名称 类型 最大长度 必选 说明
usercode string 64 来自外输方的用户标识码
refresh_token string 256 刷新令牌
  • 返回数据
参数名称 类型 最大长度 必选 说明
code int 11 服务响应状态,参见错误码表
message string 64 服务响应状态说明,参见错误码表
data object -

data结构定义

参数名称 类型 最大长度 必选 说明
access_token string 256 访问令牌
refresh_token string 256 刷新令牌
expires_in int 11 过期时间(秒)
  • 请求数据示例
{
  "api_key": "PSUBZLHOKUO6HV52A5CAUSSE5KSB6Y",
  "seq_id": "b8b4f0b8-01fb-4c06-80b9-3ab895a8c616",
  "timestamp": 1554695343,
  "nonce": "abc123def4",
  "sign": "8A983278E5366EB93FEB0D4143E1C522",
  "usercode": "user123456",
  "refresh_token": "refresh_token_value_here"
}
  • 返回数据示例
{
  "code": 0,
  "message": "success",
  "data": {
    "access_token": "new_access_token_value",
    "refresh_token": "new_refresh_token_value",
    "expires_in": 7200
  }
}
# 2.3.2 订单查询接口
  • 接口说明 : 用于查询跑腿订单的最新状态及费用明细。
  • 接口路径 :/runerrand/api/mcp/order/detail
  • 输入参数结构
序号 字段名 类型 必填 说明 示例
1 usercode String 外输方用户标识 your-usercode-value
2 order_code String 订单ID,不传时查询当前账号下未完成订单 yb0IEI5Fc2SVp6

JSON 示例:

{
  "usercode": "guangfanuser123",
  "order_code": "order_987654321"
}
  • 输出参数结构
参数名 类型 长度 必选 说明
code int 10 参考下方响应Code定义
message string 64 错误描述信息
data object 响应数据对象,详见ResponseData结构定义
# ResponseData结构定义
参数名称 类型 参数描述
orderCode string 订单ID
orderStatusText string 订单状态文案,如:派单中、取件中、送件中、已完成等
spName string 运力商名称,如:顺丰同城、达达、京东秒送等
expressTypeName string 送件类型名称,如:特惠跑腿、极速跑腿
riderName string 骑手姓名
riderPhone string 骑手手机号
deliveryTime integer 预计送达时间,Unix时间戳(秒)
totalFee string 总费用,单位元
payFee string 实际费用(已扣除优惠后),单位元
paidFee string 已支付费用,单位元
couponFee string 优惠费用,单位元
cancelFee string 取消费,单位元(有值时需告知用户)
refundFee string 退款费用,单位元
waitRefundFee string 待退款费用,单位元
customerInfo List 客服信息列表,详见CustomerInfo结构定义
orderSuggestion string 大模型话术建议,可直接参考该字段组织回复话术
# CustomerInfo结构定义
参数名称 类型 参数描述
title string 客服标题,如:顺丰同城电话客服
phones List 客服电话列表,示例:["4001881888"]
onlineTimeInfos List 客服在线时间列表,示例:["8:00-22:00"]

JSON 示例:

{
  "orderCode": "TxT481UfeA37s0h7K-J4sgu8OMMTVrveVdoqTTn3ZbtOo",
  "orderStatusText": "送件中",
  "orderStatus": 30300,
  "riderName": "伊卜热伊木·麦麦提艾力",
  "riderPhone": "16609099710",
  "spName": "顺丰同城",
  "expressTypeName": "特惠跑腿",
  "deliveryTime": "预计送达时间",
  "totalFee": "总费用",
  "payFee": "实际费用",
  "paidFee": "已支付费用",
  "couponFee": "优惠费用",
  "cancelFee": "取消费",
  "refundFee": "退款费用",
  "waitRefundFee": "待退款费用",
  "customerInfo": [{"title":"顺丰同城电话客服","phones":["4001881888"]}],
  "orderSuggestion":"骑手已到达取件点,正在取件中。骑手当前距离收件点xxkm,预计xx月xx日 xx:xx到达收件点。如需联系骑手,请致电xxxxxxx。"
}

# 3. MCP能力描述

# 3.1 接入方式

# 创建MCP KEY

登录腾讯出行服务开放平台控制台,申请MCP KEY。具体参考腾讯出行服务MCP接入指南 (opens new window)

# 协议支持

支持 SSE 协议 和 Streamable HTTP 协议,所有请求均基于 JSON-RPC 2.0 进行通信。

# 接入地址

SSE协议接入地址:

https://weixin.go.qq.com/mcp/gw-sse/sse

Streamable HTTP协议接入地址:

https://weixin.go.qq.com/mcp/gw-stream-http/mcp
# 接入方式

请求头鉴权接入,需要在请求头 Authorization 中填入申请的MCP KEY,在请求头 Access-Token 中填入用户访问令牌。

以Streamable HTTP协议示例:

curl -X "POST" 'https://weixin.go.qq.com/mcp/gw-stream-http/mcp' \
--header 'Authorization: YOUR_MCP_KEY' \
--header 'Access-Token: USER_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
}'

# 3.2 响应状态编码(code)

# 公共响应码

所有MCP接口通用的响应码:

编码 说明
0 成功
10000 服务器开小差了,请稍后重试
10001 参数校验错误
10002 业务失败
10003 无数据
11001 用户未登录
# 业务个性响应码

todo

# 3.3 MCP能力

# 输出格式说明

所有 MCP 工具的输出均遵循 JSON-RPC 2.0 协议格式。实际返回结构如下:

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "content": [
            {
                "type": "text",
                "text": "<业务响应JSON字符串>"
            }
        ]
    }
}

其中 result.content[].text 字段的值是一个 JSON 字符串,其内容为各工具的业务响应(即下文各工具描述的输出参数结构 code/message/data)。

完整响应结构说明:

层级 字段名 类型 说明
外层(JSON-RPC) jsonrpc string 固定值 "2.0"
外层(JSON-RPC) id int 请求ID,与请求中的 id 对应
外层(JSON-RPC) result object MCP 结果对象
result content array 内容数组
content[] type string 内容类型,固定为 "text"
content[] text string 业务响应 JSON 字符串(包含 code/message/data)

JSON 示例(完整MCP协议响应):

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "content": [
            {
                "type": "text",
                "text": "{\"code\":0,\"message\":\"成功\",\"data\":{\"orderId\":\"order_987654321\",\"fromName\":\"天安门\",\"toName\":\"天坛公园\"}}"
            }
        ]
    }
}

text字段内容解析后:

{
  "code": 0,
  "message": "成功",
  "data": {
    "orderId": "order_987654321",
    "fromName": "天安门",
    "toName": "天坛公园"
  }
}

MCP工具见下附录

# 4. 第三方应用拉起出行小程序能力描述

# 4.1 跳转流程

Clipboard_Screenshot_1779785743.png

# 4.2 前置条件

序号 准备事项 说明
1 微信开放平台注册移动应用 微信开放平台 (opens new window) 创建移动应用并通过审核,获得移动应用 AppID
2 关联出行服务小程序 在微信开放平台「管理中心 → 移动应用 → 详情 → 关联小程序信息」中关联出行小程序(已认证的开放平台账号可跳转任意合法小程序,无需关联)
3 出行服务开放平台注册 出行服务开放平台 (opens new window) 注册商户,创建【第三方接入应用】和【MCP应用】
4 获取出行侧参数 从出行侧获取小程序原始ID、授权页路径等,详见 1.1.5
5 iOS配置Universal Links iOS应用需按微信要求配置Universal Links,详见官方iOS接入指南

# 4.3 参考资源与示例

资源 链接
APP拉起小程序 - 功能介绍 https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/Launching_a_Mini_Program.html (opens new window)
APP拉起小程序 - Android开发示例 https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/Android_Development_example.html (opens new window)
APP拉起小程序 - iOS开发示例 https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/iOS_Development_example.html (opens new window)
Android接入指南(SDK集成) https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Access_Guide/Android.html (opens new window)
iOS接入指南(SDK集成 + Universal Links配置) https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Access_Guide/iOS.html (opens new window)
Android SDK下载(Maven Central) implementation 'com.tencent.mm.opensdk:wechat-sdk-android:+'
iOS SDK下载(CocoaPods) pod 'WechatOpenSDK-XCFramework'
微信开放平台 SDK Sample Demo 各接入指南页面底部提供范例代码下载

Android 拉起授权页:

IWXAPI api = WXAPIFactory.createWXAPI(context, "第三方移动应用AppID");
WXLaunchMiniProgram.Req req = new WXLaunchMiniProgram.Req();
req.userName = "gh_xxxxxxx";                    // 出行小程序原始ID(出行侧提供)
req.path = "/pages/oauth/authorize"              // 授权页路径(出行侧提供)
         + "?usercode=" + usercode               // 第三方用户标识
         + "&app_id=" + guangfanOpenAppId;       // 第三方在出行开放平台的应用ID
req.miniprogramType = WXLaunchMiniProgram.Req.MINIPTOGRAM_TYPE_RELEASE; // 0正式版 1开发版 2体验版
api.sendReq(req);

Android 接收回调(WXEntryActivity.onResp):

public void onResp(BaseResp resp) {
    if (resp.getType() == ConstantsAPI.COMMAND_LAUNCH_WX_MINIPROGRAM) {
        WXLaunchMiniProgram.Resp launchResp = (WXLaunchMiniProgram.Resp) resp;
        String extMsg = launchResp.extMsg;  // 小程序返回的授权结果通知
        // 处理授权状态(注意:token通过后台接口同步,不在extMsg中)
    }
}

# 4.4 相关参数

参数名 说明 示例值 用途
userName 出行服务小程序的原始ID gh_ad64296dc8bd WXLaunchMiniProgram.Req.userName,指定拉起的小程序
path OAuth授权页面路径 /launch/launch WXLaunchMiniProgram.Req.path,指定拉起的页面
path 所需 Query 参数定义 授权页路径上需携带的参数列表及规则 target=oauthAuth&from=xxx 按规则拼接完整path,来源值双方约定
extMsg 回调数据格式 授权完成后小程序返回给APP的数据结构定义 {"auth_status":"success"} 第三方客户端解析授权结果
miniprogramType 推荐值 各阶段(联调/测试/上线)应使用的小程序版本类型 联调用1,上线用0 控制拉起的小程序版本

# 版本说明

版本 说明 日期 编辑者
1.0 文档初始化 2026-04-01 zeuszzhou,ellerywang,yannigao
1.1 补充小程序拉起方式,更新部分mcp描述 2026-04-13 zeuszzhou,jankinxie
1.2 订单详情新增接单车型品类标识,更新部分mcp描述 2026-04-27 zeuszzhou
1.3 MCP输出结构补充JSON-RPC 2.0协议包裹说明,腾讯接口路径更正 2026-05-21 pioneerchen,ellerywang
1.4 调整排版 2026-05-26 ellerywang
1.5 更新MCP通用错误码 2026-05-27 andynwang
1.6 更新MCP业务错误码 2026-06-01 zeusszhou

# 5. 附录. 工具列表

# 5.1 概述

能力 标识 描述
跑腿询价 runerrand_estimate_price 根据寄件和收件地址信息,获取各运力商的跑腿配送预估价格列表。返回的 estimatePriceRecordIdskuId 用于后续创建订单
跑腿预取消订单 runerrand_precancel_order 在订单未完成前,根据订单ID查询是否可以取消跑腿订单,并返回取消费
查询跑腿订单详情 runerrand_query_order_detail 用户根据订单ID询问订单进度、费用明细、骑手信息或需要联系客服时调用
查询进行中的跑腿订单 runerrand_query_going_order 查询用户当前是否有进行中的跑腿订单
取消跑腿订单 runerrand_cancel_order 根据订单 orderCode 取消订单
创建跑腿订单 runerrand_book_order 根据询价结果和用户勾选的SKU下单,创建跑腿订单并返回支付信息

# 5.2 跑腿询价

# 输入参数结构

参数名称 类型 是否必填 参数描述
fromAddrDetail string 寄件地址名称,示例:腾讯武汉研发中心
fromLat number 寄件地址纬度
fromLng number 寄件地址经度
fromUserName string 寄件人姓名
fromUserPhone string 寄件人手机号
toAddrDetail string 收件地址名称
toLat number 收件地址纬度
toLng number 收件地址经度
toUserName string 收件人姓名
toUserPhone string 收件人手机号
goodsType integer 物品类型枚举,1-文件证照;2-服饰;3-食品饮料;4-蛋糕;5-鲜花;6-数码;7-水果生鲜;8-药品;9-汽配;10-日用品;11-家居家纺;0-其他。不传或者不在以上枚举范围内时按默认(其他类型)处理
goodsWeight number 物品重量,单位kg,不传默认0;如用户表述实际重量则传入实际重量

# 返回参数结构

参数名称 类型 参数描述
code integer 响应状态码,0表示成功
message string 响应消息
data object 响应数据对象,详见ResponseData结构定义
# ResponseData结构定义
参数名称 类型 参数描述
estimatePriceRecordId string 预估缓存Key,后续创建订单时必填
spEstimatePrices List 运力商预估列表,详见SpEstimatePrice结构定义
# SpEstimatePrice结构定义
参数名称 类型 参数描述
skuId string SKU标识,格式为:运力ID_车型编码,后续创建订单时使用,示例:60796_1
spName string 运力商名称,如顺丰同城、美团跑腿、京东秒送
expressTypeName string 送件类型名称,如特惠跑腿、极速跑腿
defaultChecked integer 是否默认勾选,1-默勾,0-不默勾
totalFee string 实际应支付金额(元,小数点后两位),已扣除优惠金额,示例:2.59
couponFee string 优惠金额(元,小数点后两位),示例:2.59
deliveryTime string 预计送达时间,格式:xx年xx月xx日 xx时xx分xx秒,示例:2026年01月05日 15时25分36秒

# 5.3 跑腿预取消订单

# 输入参数结构

参数名称 类型 是否必填 参数描述
orderCode string 订单ID

# 返回参数结构

参数名称 类型 参数描述
code integer 响应状态码,0表示成功
message string 响应消息
data object 响应数据对象,详见ResponseData结构定义
# ResponseData结构定义
参数名称 类型 参数描述
couldCancel boolean 是否可以取消订单,true-可取消,false-不可取消
cancelFee string 取消费,单位元,如:2.00(有取消费时需告知用户)

# 5.4 查询跑腿订单详情

# 输入参数结构

参数名称 类型 是否必填 参数描述
orderCode string 订单ID

# 返回参数结构

参数名称 类型 参数描述
code integer 响应状态码,0表示成功
message string 响应消息
data object 响应数据对象,详见ResponseData结构定义
# ResponseData结构定义
参数名称 类型 参数描述
orderCode string 订单ID
orderStatusText string 订单状态文案,如:派单中、取件中、送件中、已完成等
spName string 运力商名称,如:顺丰同城、达达、京东秒送等
expressTypeName string 送件类型名称,如:特惠跑腿、极速跑腿
riderName string 骑手姓名
riderPhone string 骑手手机号
deliveryTime integer 预计送达时间,Unix时间戳(秒)
totalFee string 总费用,单位元
payFee string 实际费用(已扣除优惠后),单位元
paidFee string 已支付费用,单位元
couponFee string 优惠费用,单位元
cancelFee string 取消费,单位元(有值时需告知用户)
refundFee string 退款费用,单位元
waitRefundFee string 待退款费用,单位元
customerInfo List 客服信息列表,详见CustomerInfo结构定义
orderSuggestion string 大模型话术建议,可直接参考该字段组织回复话术
# CustomerInfo结构定义
参数名称 类型 参数描述
title string 客服标题,如:顺丰同城电话客服
phones List 客服电话列表,示例:["4001881888"]
onlineTimeInfos List 客服在线时间列表,示例:["8:00-22:00"]

# 5.5 查询进行中的跑腿订单

# 输入参数结构

本工具无需入参(参数对象为空)。

# 返回参数结构

参数名称 类型 参数描述
code integer 响应状态码,0表示成功
message string 响应消息
data object 响应数据对象,详见ResponseData结构定义
# ResponseData结构定义
参数名称 类型 参数描述
hasOnGoingOrder boolean 是否有进行中订单,true-有,false-无
orderCode string 进行中的订单ID,hasOnGoingOrder=true 时有值,可用于后续查询订单详情;无进行中订单时为空字符串
orderStatus integer 订单状态码,无进行中订单时为 0
orderStatusText string 订单状态描述,如:派单中、已接单、配送中等
spName string 运力商名称
expressTypeName string 送件类型名称,如:极速取送、特惠取送

# 5.6 取消跑腿订单

# 输入参数结构

参数名称 类型 是否必填 参数描述
orderCode string 订单ID

# 返回参数结构

参数名称 类型 参数描述
code integer 响应状态码,0表示成功,非0表示失败
message string 错误描述信息,成功时为空字符串

# 5.7 创建跑腿订单

# 输入参数结构

参数名称 类型 是否必填 参数描述
estimatePriceRecordId string 询价缓存Key,由 runerrand_estimate_price 询价接口返回,创建订单时必填
expressSkuInfos List 用户勾选的SKU列表,当前仅支持单选,传入询价接口返回的 skuId,示例:["600018_1"]
userPhone string 用户下单手机号

# 返回参数结构

参数名称 类型 参数描述
code integer 响应状态码,0表示成功
message string 响应消息
data object 响应数据对象,详见ResponseData结构定义
# ResponseData结构定义
参数名称 类型 参数描述
orderCode string 订单ID,后续查询订单状态、取消订单时使用
payInfo PayInfo 支付信息,详见PayInfo结构定义
# PayInfo结构定义
参数名称 类型 参数描述
tradeType integer 支付方式,1-微信小程序拉起收银台支付,2-扫码支付
prepayId string 预支付订单ID,tradeType=1 时有效,示例:wx07506492195240d3450000013620263000
paySign string 支付签名,tradeType=1 时有效
nonceStr string 随机字符串,tradeType=1 时有效,示例:ZZYHVRTYLWUTIJBKBETWZURI
signType string 签名算法,tradeType=1 时有效,示例:RSA
timeStamp string 时间戳(秒),tradeType=1 时有效,示例:1777129041
codeUrl string 微信支付二维码URL,tradeType=2 时有效
scanUrl string 扫码支付页地址,tradeType=2 时有效