# 跑腿上游渠道接入文档(2B) - 推单模式询价下单
本文档为 跑腿上游渠道接入文档(2B) 的询价下单模式子文档,仅描述【推单模式询价下单】流程。通用约定、附录、签名算法等公共内容请参考主文档。
# 询价下单模式说明
推单模式下单流程:调用方直接通过 /pushOrder 接口以自主报价(或合同约定价)方式向运力商推送订单,无需先经过询价流程;下单后如需追加运费,可再调用 /addFeeAfterPush 加价推单接口进行报价追加。
- 报价模式(
push_type=0):由调用方指定push_price推送价格 - 合同约定模式(
push_type=1):按运力商合同约定价推送 - 支持通过
block_sp_code_list屏蔽指定运力,参考附录 3.10 运力列表 code
# 接口
# 1.1 推单接口
Route: /pushOrder
请求Body:
| 名称 | 类型 | 描述 | 必须 |
|---|---|---|---|
| third_order_id | string(64) | 接入方运单 ID | Yes |
| push_type | int | 推送方式(目前只有报价模式-0) 0-报价模式 1-合同约定模式 | Yes |
| push_price | int | 推送价格,单位分。报价模式(push_type=0)下必填 | No |
| sender_address | AddressInfo | 地址信息,详细结构见附录 AddressInfo | Yes |
| receiver_address | AddressInfo | 地址信息,详细结构见附录 AddressInfo | Yes |
| city_name | string(32) | 城市名字(含 "市",例如 "郑州市") | Yes |
| city_code | string(32) | 地级市 code | No |
| subscribe_type | int | 预约类型(目前只有实时单-0) 0-实时单 1-预约取件时间 2-预约送达 | Yes |
| subscribe_time | long | 预约时间戳(秒),预约取件 / 预约送达时必填 | No |
| goods_type | int | 参考附录 3.3 物品类型表 | Yes |
| goods_weight | int | 物品重量,单位 KG。(不传默认 1) | No |
| goods_price | int | 物品价格(用于保价),单位分 | No |
| product_detail_list | List<ProductDetail> | 物品明细列表,详细结构见附录 ProductDetail | No |
| distance | int | 订单距离,单位米 | Yes |
| remark | string(256) | 订单备注 | No |
| short_order_num | string(64) | 骑手取货短单号 | No |
| service_type | int | 服务类型(目前都是拼送-1) 1-拼送 2-专送 | No |
| receive_code | string(32) | 收货确认码 | No |
| block_sp_code_list | List<string> | 屏蔽运力 sp_code 列表。参考附录 3.10 运力列表 code | No |
| order_source | string(32) | 订单来源,参考附录 3.5 订单来源 | No |
| order_num | string(64) | 订单流水号 | No |
响应Body业务字段:
| 名称 | 类型 | 描述 | 必须 |
|---|---|---|---|
| third_order_id | string(64) | 接入方运单 ID(透传) | Yes |
| order_code | string(64) | 腾讯侧 order_code | Yes |
# 1.2 加价推单接口
Route: /addFeeAfterPush
请求Body:
| 名称 | 类型 | 描述 | 必须 |
|---|---|---|---|
| third_order_id | string(64) | 接入方运单 ID | Yes |
| push_type | int | 推送方式(目前只有报价模式-0) 0-报价模式 1-合同约定模式 | No |
| push_price | int | 推送价格,单位分。报价模式(push_type=0)下必填 | No |
响应Body业务字段:
| 名称 | 类型 | 描述 | 必须 |
|---|---|---|---|
| third_order_id | string(64) | 接入方运单 ID(透传) | Yes |
| order_code | string(64) | 腾讯侧 order_code | Yes |