订单列表优化
拉取站点可配送地区信息
接口名: /station/area_dict
功能: 拉取站点可配送地区信息
Method:GET
请求:
响应:
code M int 返回码,0表示成功,其他表示错误
msg M string 错误信息
data M list 站点对应的可配送地区信息
示例:
request
http://station.guanmai.cn/station/area_dict
response
{
"code": 0,
"msg": "ok",
"data": [{
"city": "深圳市"
"city_id": "440300"
"districts": [{
"district": "南山区"
"district_id": "30200000000"
"areas": [
{
"area": "南山中心区"
"area_id": "30200100000"
},
{
"area": "华侨城"
"area_id": "30200200000"
},
{
"area": "南油"
"area_id": "30200300000"
},
{
"area": "蛇口"
"area_id": "30200400000"
},
{
"area": "白石洲"
"area_id": "30200500000"
},
{
"area": "前海"
"area_id": "30200600000"
},
{
"area": "南头"
"area_id": "30200700000"
},
{
"area": "西丽"
"area_id": "30200800000"
},
{
"area": "科技园"
"area_id": "30200900000"
},
]
}]
}]
}
使用搜索拉取站点订单时,加入地区过滤,加入新的排序方式,添加新的返回字段
接口名:/station/orders
Method:GET
请求:
query_type M int 搜索类型 [1: 按照下单时间搜索,2: 按照运营周期搜索,3: 按照收货日期搜索]
if query_type == 1
start_date M string 开始下单日期(精确到天)
end_date M string 截止下单日期(精确到天)
if query_type == 2
time_config_id M string 时间配置ID
cycle_start_time M string 开始周期时间(精确到分钟)
cycle_end_time M string 结束周期时间(精确到分钟)
if query_type == 3
receive_start_date M string 开始收货日期(精确到天)
receive_end_date M string 结束收货日期(精确到天)
search_text M string 搜索内容
search_area(新增) O string 搜索地区(通过'_'来拼接市,区,街道三级编号,其中任意一级信息可向后全部缺省)
sort_type O string 排序类型(date_desc日期倒序(默认);date_asc日期升序;price_desc价格倒序;price_asc价格升序
新增:
addr_desc商户倒序;addr_asc商户升序;freight_desc运费倒序;freight_asc运费升序;
status_desc订单状态倒序;status_asc订单状态升序;
)
status O int 订单状态
offset O int 分页offset
limit O int 分页limit
响应:
code M int 返回码,0表示成功,其他表示错误
msg M string 错误信息
data M list 订单列表数据,数据字段为订单表字段;
示例:
request:
http://station.dev.guanmai.cn/station/orders?query_type=1&start_date=2017-05-01&end_date=2017-05-07&search_text=&search_area=深圳市_南山区_科技园&offset=0&limit=20
返回结果中新增了六个字段
sale_money 销售额(不含运费
sale_money_with_freight 销售额(含运费
real_money 出库金额
abnormal_money 异常金额
refund_money 实退金额
refund_kind 退货商品种类的数量
response:
{
"code": 0,
"data": {
"pagination": {
"offset": 0,
"count": 8,
"limit": 20
},
"list": [
{
"driver_id": 『新增』,
"driver_name": 『新增』,
"freight": 20,
"details": [
{
"sync_origin_id": "D805892",
"spu_id": "C00935",
"total_item_pay": 25.76,
"accept_quantity": 7,
"version": 55,
"quantity": 7,
"spu_remark": "",
"real_item_price": 25.76,
"total_item_price": 25.76,
"sale_price": 3.68,
"id": "D805892",
"real_quantity": 7
}
],
"time_config_info": {
"_id": "ST001",
"desc": "小农女默认服务时间",
"final_distribute_time": "06:00",
"order_time_limit": {
"end": "02:00",
"start": "06:00",
"e_span_time": 1
},
"type": 0,
"task_begin_time": "06:00",
"final_distribute_time_span": 1,
"receive_time_limit": {
"end": "23:30",
"receiveTimeSpan": "30",
"start": "06:00",
"s_span_time": 6,
"e_span_time": 6
},
"service_time_creator": "T001",
"name": "小农女默认服务时间"
},
"customer": {
"receiver_phone": "产品技术测试1111111",
"address": "产品技术测试1111111",
"station_id": "",
"new_consumer": 0,
"address_id": "10936",
"salemenu_id": "",
"receiver_name": "产品技术测试1111111",
"extender": {
"resname": "产品技术测试1111111"
},
"id": "22953"
},
"receive_end_time": "2016-10-16 23:30",
"status": 1,
"origin_total_price": 25.76,
"date_time": 1476065329.588,
"receive_begin_time": "2016-10-16 06:00",
"station_id": "T002",
"id": "PL316094",
"date_time_str": "2016-10-10 10:08:49",
"total_price": 25.76
},
]
},
"msg": "ok"
}
/station/order/edit/{{order_id}} 拉取订单详情
接口名:/station/order/edit/{{order_id}}
Method:GET
请求:
order_id M string 订单ID
响应:
code M int 返回码,0表示成功,其他表示错误
msg M string 错误信息
data M dict 订单详情数据,数据字段为订单表字段;
示例:
request
http://station.guanmai.cn/station/order/edit/PL12345
// 新增字段: is_weigh 是否称重 布尔类型
// exc_quantity 异常数量 int
// 出库金额: real_quantity int
response
{
"code": 0,
"data": {
"source_order_ids": [],
"freight": 2000,
"time_config_id": "ST001",
"customer": {
"receiver_phone": "18682285748",
"address": "小梅沙 海琴路23号 (师傅尽量在10点过后去 不要太早,谢谢)",
"uid": "16934",
"receive_end_time": "2016-10-16 23:30",
"address_id": "8219",
"receiver_name": "邓生",
"extender": {
"resname": "正宗粉面馆",
"order_pay_method": 2
},
"address_sign_id": "30700100000",
"receive_begin_time": "2016-10-16 06:00",
"supply_station_id": "T002"
},
"status": 1,
"origin_total_price": 17460,
"_abnormal_lock": "no",
"_id": "PL316101",
"salemenu_ids": [
"S0520"
],
"total_pay": 14300,
"details": [
{
"spu_id": "C00035",
"category_title_2": "叶菜类",
"accept_quantity": 1,
"version": 311,
"name": "上海青|中条|优质|件",
"quantity": 1,
"sync_origin": "D804813",
"sale_ratio": 45,
"real_item_price": 12300,
"sale_unit_name": "件",
"total_item_price": 12300,
"category_title_1": "蔬菜",
"std_unit_name": "斤",
"id": "D804813",
"real_quantity": 1,
"supplier_name": "小农女",
"total_item_pay": 12300,
"sale_num_least": 1,
"purchase_quantity": 1,
"origins": [],
"spu_remark": "test",
"salemenu_id": "S0520",
"sale_price": 123
}
],
"_lock": "no",
"fake_total_price": 17460,
"time_config_info": {
"_id": "ST001",
"desc": "小农女默认服务时间",
"final_distribute_time": "06:00",
"order_time_limit": {
"end": "02:00",
"start": "06:00",
"e_span_time": 1
},
"type": 0,
"task_begin_time": "06:00",
"final_distribute_time_span": 1,
"receive_time_limit": {
"end": "23:30",
"receiveTimeSpan": "30",
"start": "06:00",
"s_span_time": 6,
"e_span_time": 6
},
"service_time_creator": "T001",
"name": "小农女默认服务时间"
},
"district_code": "440300",
"sort_id": 0,
"date_time": "2016-10-10T12:01:52.789",
"is_aggregation": 0,
"station_id": "T002",
"remark": null,
"real_price": 17460,
"total_price": 12300
},
"msg": "ok"
}
确认合单时增加提示信息
station 部分
接口名:/station/order/create
Method:GET
请求:
details M string 商品相关的json数据
address_id M int 商户SID
uid M int 商户UID
receive_begin_time M string 订单收货开始时间
receive_end_time M string 订单收货结束时间
time_config_id string 时间配置ID
force O int 是否强制合单标志,0-不合单,新建一个订单;1-强制合单;
响应:
code M int 返回码,0表示成功,其他表示错误
msg M string 错误信息
data M list 新建的订单ID或者更改的订单ID数据
示例:
request
http://station.guanmai.cn/station/order/create
POST参数:
details: [{"sku_id":"D804813","amount":1,"unit_price":123,"spu_remark":"666","spu_id":"C00035"}]
address_id: 20508
uid: 25512
receive_begin_time: 2016-10-16 06:00
receive_end_time: 2016-10-16 23:30
time_config_id: ST001
当存在可合并订单时,在返回值data中新增如下字段
response
{
"data": [
{
"order_id": "PL637312",
"date_time": "2017-11-03 14:52:06" (新增)
}
],
"code": 10,
"msg": "该商户今日存在可合并订单"
}
bshop 部分
接口名:/order/confirm
Method:GET
返回结果中添加''data_time'字段,表示可合单的订单创建时间
新的生成Excel表逻辑与格式
接口名: /station/sales_analysis/orderdetail
Method:GET
添加 'search_area' 查询字段
返回结果为Excel文件
拉取商家对应的报价单信息
使用如下接口
/salemenu/sale/list
按商品查看新增按销售单过滤功能,合并三个搜索框功能,增加使用不同周期过滤的字段
接口名:/station/order/order_sku_list
Method:GET
请求:
query_type M int 搜索类型 [1: 按照下单时间搜索,2: 按照运营周期搜索,3: 按照收货日期搜索]
if query_type == 1
start_date M date 开始下单日期(精确到天)
end_date M date 截止下单日期(精确到天)
if query_type == 2
time_config_id M string 时间配置ID
start_date M date 开始周期时间(精确到分钟)
end_date M date 结束周期时间(精确到分钟)
if query_type == 3
start_date M date 开始收货日期(精确到天)
end_date M date 结束收货日期(精确到天)
// sku_text O string 商品id或商品名
// customer_text O string 商户id或商户名
// order_id O string 订单号
search_text O string 搜索内容,为上三个字段的合并功能
status O string 订单状态
offset O int 分页offset
limit O int 分页limit
新增参数:
salemenu_id O string 销售单号
响应:
code M int 返回码,0表示成功,其他表示错误
msg M string 错误信息
data M dict 商户的销售单信息
示例:
request
/station/order/order_sku_list?start_date=2017-11-03&end_date=2017-11-06&search_text=&salemenu_id=S0520
&query_type=1&status=undelivery&offset=0&limit=20
response
{
"data": {
"list": [
{
"std_sale_price": "20.82",
"salemenu_id": "S0520",
"outer_id": "",
"resname": "巴蜀豆花饭庄",
"salemenu_name": "深圳餐厅售卖单",
"id": "D1340083",
"order_id": "PL637311",
"sale_ratio": 1,
"name": "鸡粉|凤球唛鸡粉|1kg",
"std_unit_name": "罐",
"sale_unit_name": "罐",
"is_price_timing": false,
"status": 1,
"address_id": "S08098"
},
{
"std_sale_price": "6.60",
"salemenu_id": "S0520",
"outer_id": "",
"resname": "巴蜀豆花饭庄",
"salemenu_name": "深圳餐厅售卖单",
"id": "D1079936",
"order_id": "PL637312",
"sale_ratio": 1,
"name": "白菜苔|斤",
"std_unit_name": "斤",
"sale_unit_name": "斤",
"is_price_timing": false,
"status": 1,
"address_id": "S08098"
},
{
"std_sale_price": "135.68",
"salemenu_id": "S0520",
"outer_id": "",
"resname": "巴蜀豆花饭庄",
"salemenu_name": "深圳餐厅售卖单",
"id": "D1099340",
"order_id": "PL637312",
"sale_ratio": 1,
"name": "稻中稻香油粘米|50斤",
"std_unit_name": "包",
"sale_unit_name": "包",
"is_price_timing": false,
"status": 1,
"address_id": "S08098"
}
],
"pagination": {
"offset": 0,
"count": 3,
"limit": 20
}
},
"code": 0,
"msg": "ok"
}
以下是有变化的接口
station
修改
/views/order/TransportOrdersQueryView orders 拉取订单列表
/views/order/OrderEditView 增加订单详情页返回字段
/views/order/OrderCreateView 合单
/views/order_sku/OrderSkuListView 拉取sku列表
/views/daily_sales/DailySalesOrderDetailView 新的生成Excel表逻辑与格式
/dals/order_sku/get_ordered_sku 新增过滤方式,合并搜索方法
新增
/views/area/GetAreaDict 获取站点可配送范围
/dals/order_sku/get_cycle_time 按查找周期时间来获得查询时间范围(copy自views/order/TransportOrdersQueryView,实际为静态方法,未提出)
/dals/refund/get_refund_num_by_sku_id 根据sku_id查询退货数
common
新增
/mysql/area/get_district_area_dict 获取城市下的所有区,街道信息字典
/mysql/area/get_area_list 获取区下的所有街道id列表
bshop
修改
/order/confirm 下单时获得合单信息 修改其调用的format_simple_order方法
website/order/dals/order/format_simple_order 添加了返回订单的创建时间''data_time'字段