1. 订单相关
开放接口文档
  • 校内专送接口
    • 前言
      • 接入说明
      • 签名生成规则
    • 接口文档
      • 订单相关
        • 发外部单入校内专送
        • 订单询价
        • 获取订单详情
        • 获取订单进程
        • 撤销订单
        • 配送订单状态变更回调
        • 外单发单预检查接口
  1. 订单相关

发外部单入校内专送

应用场景:
拥有自主订单平台的第三方开发运营者,可通过此接口将自己平台产生且需要配送的订单发入校内专送系统,完成配送/取货流程。接入成功后既可程序自动发单,也能在校内专送提供的微页面手动发单。
必填参数:开发者CODE developer_code、关联店CODE shop_code、来源标记类型 order_type、该店单当日序号 daily_number、平台订单号 order_number、开发者类型 type、时间戳 timestamp、密钥签名 sign。
可选参数:目标电话 tel、目标地址/备注 send_cont、楼栋编码 building_code、店铺名称 shop_name、店铺电话 shop_tel、收货人 receiver_name、收货坐标 receiver_tag / contact_tag、预计送达时间 send_time、下单时间 order_time、订单详情 order、商品明细 order_goods、状态回调地址 callback_url。
来源标记类型 order_type:“1”为美团,“2”为饿了么,“3”为抖音,“4”为滴滴,“5”为其他,“6”为快跑者,“7”为收钱吧,“8”为啦啦,“9”为京东,“11”开放店铺,“12”为优店,“13”为微信小店,“15”为青云,“17”为京东秒送,“20”为小橙故事。
支持虚拟号(如 主号_分机号、主号,分机号)、预订单(send_time)、订单金额与商品明细、订单状态回调。
正式发单前,建议先调用预检查接口 entryOrderCheck,提前确认开发者权限、店铺、站长及剩余发入条数。
与本校的校内专送团队合作,让小哥们帮您完成订单配送/取货环节,从此免除自建管理配送团队的烦恼。配送费计扣费方案与校内专送团队自主协商(由站长后台配置)。
请正常业务调用,严禁恶意发单或发入违法违规的订单,违者必究!
请求URL:
https://www.0xiao.com/keloop/api/outerEntryOrder
请求方式:
POST
支持 Content-Type: application/x-www-form-urlencoded(普通表单)或 application/json(JSON 请求体);参数必须放在请求体中。
请求参数:
参数名必选类型说明示例值
developer_code是string开发者CODEU2QHNB2w=
shop_code是string关联店CODE;开放平台类开发者(如小橙故事)传第三方店铺唯一标识,系统自动建档U2TD844B2
shop_name否string店铺名称;开放平台类开发者首次发单用于自动建档,后续变更会同步更新示例店铺
shop_tel否string店铺联系电话;用途同上13800000000
order_type是int来源标记类型,见「应用场景」1
daily_number是int该店单当日序号1
order_number是string平台订单号,需全局唯一;建议按字符串传输,重复提交按同一单处理2024111111111111111
tel否string目标电话,支持虚拟号;需符合手机号格式13311112222
send_cont否string目标地址/备注;部分校园站点会校验地址中的校园信息从二号门进
building_code否string楼栋编码;传入时需有效,系统也会根据地址智能匹配楼栋BTEGNAZl
receiver_name否string收货人姓名/昵称张同学
receiver_tag否string收货坐标(兼容字段,contact_tag 优先)30.123456,104.123456
contact_tag否string下单用户经纬度,最长 32 字符30.123456,104.123456
send_time否string/int预计送达时间,支持秒级时间戳或 Y-m-d H:i:s;不传或传 0 表示立即单2026-10-23 18:00:00
order_time否string/int下单时间,格式同上;不传取当前时间2026-10-23 17:00:00
order否string/object订单详情 JSON 对象,字段见下方说明见请求示例
order_goods否string/array商品明细 JSON 数组,每项至少包含 num(数量)见请求示例
type是int开发者类型/权限位,需与开发者账号权限一致;API发单固定 128,开放平台类开发者按分配值传入(如 4096)128
callback_url否string订单状态更新时的回调地址;不参与签名https://www.0xiao.com/api/callback
sign是string密钥签名(MD5,小写32位),生成规则见下方fb6aecc2e37dc75713c5228168241d38
order 订单详情字段说明:
字段名类型说明示例值
actual_priceint实付金额(单位:分)2500
original_priceint原价(单位:分),不传默认取实付金额3000
delivery_feeint配送费(单位:分)300
remarkstring订单备注不要辣
create_timestring下单时间 Y-m-d H:i:s2026-10-23 17:00:00
send_timestring预计送达时间 Y-m-d H:i:s2026-10-23 18:00:00
order_goods 商品明细说明:
JSON 数组,每项建议包含 num(数量);num 用于统计订单件数/份数,其余字段原样记录。
示例:[{"name":"黄焖鸡米饭","num":1,"price":2500}]
签名规则:
1.
取除 sign、order、order_goods、callback_url 外的全部请求参数(只对实际提交的参数签名,不要额外补参数)。
2.
按参数名 ASCII 升序排序(即 PHP ksort)。
3.
拼成 key1=value1&key2=value2&... 形式,参数值不做 URL 编码。
4.
字符串末尾直接拼接开发者密钥 appkey(中间不加 &)。
5.
对整个字符串做 md5(),取小写32位。
示例(appkey 为示例密钥,非真实值):
排序后:daily_number=1&developer_code=U2QHNB2w=&order_number=2024111111111111111&order_type=1&shop_code=U2TD844B2&timestamp=1792746000&type=128
拼接密钥:daily_number=1&developer_code=U2QHNB2w=&order_number=2024111111111111111&order_type=1&shop_code=U2TD844B2&timestamp=1792746000&type=1285f3c9d2a7b1e4c8f0a6d9b2e7c4f1a8d
sign = md5(上述字符串) = fb6aecc2e37dc75713c5228168241d38
PHP 参考实现:
完整请求示例(JSON):
同步响应参数:
参数名参数描述
code状态码(100:请求成功、104:出现错误)
message操作提示信息
data成功时为发单记录ID(可用于后续撤单/查询);部分失败场景返回对应记录ID,参数或签名类错误返回空数组
request_id请求追踪ID,排查问题时提供给技术支持
响应示例:
请求成功示例
重复提交同一订单号(已发入)
请求失败示例(缺少参数)
请求失败示例(发入条数不足)
错误提示对照:
message触发原因
请求超时timestamp 缺失或与服务端时间差 ≥ 60 秒
系统繁忙请稍后再试同一订单号正在处理中(并发重复提交),稍后重试
请求参数错误:手机号格式不正确tel 格式不合法
缺少请求参数developer_code、shop_code、order_type、daily_number 任一为空
来源类型错误order_type 不在平台支持的类型范围内
找不到对应楼栋building_code 无效
当前店铺不存在shop_code 无法解析为有效店铺,或店铺已关闭
当前平台站长不存在店铺所属站点无正常状态的站长
不支持非校园订单该站点仅支持校园订单,send_cont 中未包含所属校园信息
签名错误签名计算不一致(参数增删、排序、URL 编码、密钥错误均会导致)
请求参数错误:您不是开发者或没有对应权限开发者不存在、被禁用,或 type 权限位不匹配
外部订单当前平台未购买发入条数扣费账号(站长或商家)未购买专送发入条数
外部订单当前平台发入条数不足剩余条数 ≤ 本次所需扣减条数(1条)
发入失败,请重试系统处理异常,可使用相同 order_number 重试
修改于 2026-10-23 06:57:23
上一页
签名生成规则
下一页
订单询价
Built with