配送任务
改动点
- 订单任务列表中修改:
- 增加按照下单日期, 按运营周期或按收货日期的筛选
- 增加订单号以及商户名搜索
- 增加司机筛选
- 增加地理标签筛选
- 增加订单状态筛选
- 增加订单状态数据的返回
- 增加司机任务列表拉取接口, 可选择下单日期,, 运营周期, 收货日期以及承运商来筛选
数据库改动
mysql 数据库
表名: tbl_delivery_record
修改: 增加字段, create_time以及modify_time字段
类型:
create_time datetime 创建时间
modify_time datetime 修改时间
接口
/station/task/distribute/orders/get 订单任务表拉取接口
接口名: /station/task/distribute/orders/get
Method: GET
请求参数:
order_start_time O date 下单开始时间
order_end_time O date 下单结束时间
time_config_id O date 运营周期id
cycle_start_time O date 运营开始时间
cycle_end_time O date 运营结束时间
receive_start_time O date 收货开始时间
receive_end_time O date 收货结束时间
search_text O str 订单号或者商户名
carrier_id O int 承运商id
driver_id O int 司机id
area_id O int 地理标签id
area_level O int 地理标签等级
order_status O int 订单状态
order_ids O list 订单号数组
export O int 1表示导出
offset O int 偏移多少页
limit O int 每页多少条数据
响应:
code M int 0为成功，其它为失败
msg M str 提示信息
data M list 返回数据
data:{
in_query M boolean false表示未在筛选条件中查找到
address M obj 地理信息
address:[
[
{
id M obj 地理位置id
name M obj 地理位置名称
level M obj 地理等级
upstream_id M obj 上游地理位置id
},
...
],
...
]
distribute_order M obj 正在配送订单数据
distribute_order:{
driver_id M obj 司机id
driver_id:{
driver_name M str 司机名称
driver_status M int 0表示删除, 其它正常
distribute_count M int 该司机配送的订单数
distribute_total_price M float 总配送价格
}
}
order M list 订单数据
order:[
{
id M str 订单id
customer_name M str 商户名称
receive_address M str 收货配送地址
area M str 地理标签(三级全称)
receive_begin_time M date 收货开始时间
receive_end_time M date 收货结束时间
total_price M int 总金额
order_pay_method M int 支付方式(2-到付)
status M int 订单状态(-1-订单已删除, 1-等待分拣, 5-正在分拣, 10-正在配送, 15-已签收, 100-已支付)
driver_id M int 司机id
driver_name M str 司机名称
driver_status M int 0表示停用, 其它则正常
carrier_id M int 承运商id
}
]
}
pagination M obj 分页信息
pagination:{
offset M int 页数
limit M int 每页数据条数
count M int 总数据条数
}
逻辑: 指定条件, 筛选订单
/station/task/distribute/driver_tasks/get
接口名: /station/task/distribute/driver_tasks/get
Method: GET
请求:
order_start_time O date 下单开始时间
order_end_time O date 下单结束时间
time_config_id O date 运营周期id
cycle_start_time O date 运营开始时间
cycle_end_time O date 运营结束时间
receive_start_time O date 收货开始时间
receive_end_time O date 收货结束时间
carrier_id O int 承运商id
offset O int 第几页
limit O int 每页数量
响应:
code M int 0为成功，其它为失败
msg M str 提示信息
data M list 返回数据
data:{
driver_id M int 司机id
driver_name M str 司机名称
carrier_name M str 承运商名称
customer_count M int 配送商户数
order_count M int 订单数
sale_money M int 销售额
}
逻辑: 拉取司机的配送任务总概统计
/station/task/distribute/edit_assign
接口名: /station/task/distribute/edit_assign
Method: POST
请求:
order_id M str 订单id
driver_id M int 司机id
receive_address_id M str 收货配送地址id
receive_begin_time M datetime 收货开始时间
operation_type M int 0表示删除, 1表示保存
响应:
code M int 0为成功，其它为失败
msg M str 提示信息
/station/transport/driver_tasks/print 配送任务清单和配送装车清单打印接口
接口名: /station/transport/driver_tasks/print
Method: GET
请求:
print_drivers M obj 打印数据
{
driver_id M list 司机id
driver_id:[
order_id M str 订单id
]
}
响应:
code M int 0为成功，其它为失败
msg M str 提示信息
data M list 返回数据
data:{
driver_id M obj 司机id
driver_id:{
driver_name M str 司机名称
driver_phone M int 司机联系方式
car_num M str 车牌号
order_detail M list 订单详细
[
{
sku_id M str sku的id
order_id M str 订单号
customer_name M str 商户名称
receive_address M str 收货配送地址
area M str 地理标签(三级全称)
receive_begin_time M date 收货开始时间
receive_end_time M date 收货结束时间
order_pay_method M int 支付方式(2-到付)
}
...
]
sku_detail M list 商品详细
[
{
sku_id M str sku的id
sort_name M int 分拣名称
sku_name M str 商品名称
quantity M int 份量
std_unit M str 基本单位
category_1_id M str 一级分类id
category_1_name M str 一级分类名称
category_2_id M str 二级分类id
category_2_name M str 二级分类名称
customer_detail M list 商家明细
[
{
sort_id M int 分拣id
customer_name M str 商家名称
sku_amount M int 商家下改sku数目
}
...
]
}
...
]
}
...
}
逻辑:
多个司机以及根据筛选条件打印配送任务清单和配送装车清单
/station/task/distribute/auto_assign 智能规划
接口名: /station/task/distribute/auto_assign
Method: POST
请求:
order_ids M list 需要智能规划的订单id
响应:
code M int 0为成功，其它为失败
msg M str 提示信息
data M None null
逻辑:
智能规划未分配司机的订单