# 跑腿上游渠道接入文档(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