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,提前确认开发者 权限、店铺、站长及剩余发入条数。https://www.0xiao.com/keloop/api/outerEntryOrderContent-Type: application/x-www-form-urlencoded(普通表单)或 application/json(JSON 请求体);参数必须放在请求体中。| 参数名 | 必选 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
developer_code | 是 | string | 开发者CODE | U2QHNB2w= |
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_price | int | 实付金额(单位:分) | 2500 |
original_price | int | 原价(单位:分),不传默认取实付金额 | 3000 |
delivery_fee | int | 配送费(单位:分) | 300 |
remark | string | 订单备注 | 不要辣 |
create_time | string | 下单时间 Y-m-d H:i:s | 2026-10-23 17:00:00 |
send_time | string | 预计送达时间 Y-m-d H:i:s | 2026-10-23 18:00:00 |
order_goods 商品明细说明:num(数量);num 用于统计订单件数/份数,其余字段原样记录。[{"name":"黄焖鸡米饭","num":1,"price":2500}]sign、order、order_goods、callback_url 外的全部请求参数(只对实际提交的参数签名,不要额外补参数)。ksort)。key1=value1&key2=value2&... 形式,参数值不做 URL 编码。appkey(中间不加 &)。md5(),取小写32位。appkey 为示例密钥,非真实值):排序后:daily_number=1&developer_code=U2QHNB2w=&order_number=2024111111111111111&order_type=1&shop_code=U2TD844B2×tamp=1792746000&type=128
拼接密钥:daily_number=1&developer_code=U2QHNB2w=&order_number=2024111111111111111&order_type=1&shop_code=U2TD844B2×tamp=1792746000&type=1285f3c9d2a7b1e4c8f0a6d9b2e7c4f1a8d
sign = md5(上述字符串) = fb6aecc2e37dc75713c5228168241d38| 参数名 | 参数描述 |
|---|---|
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 重试 |