云管家销售经理版(代客下单)
云管家销售经理版(代客下单)
有关订单的创建编辑删除的逻辑以及返回的数据都参考station
功能1,2:订单列表-新增「订单详情」内页
/manage/ordermanage/order/create(订单创建)
Method:POST
请求:
details M string 商品相关的json数据
address_id M int 商户SID
user_id M int 商户UID
receive_begin_time M string 订单收货开始时间
receive_end_time M string 订单收货结束时间
time_config_id string 时间配置ID
remark O str 订单备注
响应:
code M int 返回码,0表示成功,其他表示错误
msg M string 错误信息
data M dict 新建的订单ID或者更改的订单ID数据
/manage/ordermanage/order/detail(订单详情)
Method:GET
请求:
order_id M string 订单ID
响应:
code M int 返回码,0表示成功,其他表示错误
msg M string 错误信息
data M dict 订单详情数据,数据字段为订单表字段;
/manage/ordermanage/order/edit(订单编辑)
Method:POST
请求:
order_id M string 订单ID
details M list[dict] 商品数据
receive_begin_time M string 订单收货开始时间
receive_end_time M string 订单收货结束时间
响应:
code M int 返回码,0表示成功,其他表示错误
msg M string 错误信息
data M dict 订单详情数据,数据字段为订单表字段;
/manage/ordermanage/order/delete(订单删除)
Method:POST
请求:
order_id M string 订单ID;
响应:
code M int 返回码,0表示成功,其他表示错误
msg M string 错误信息
data M null 无数据;
/manage/custommanage/list 查看可下单的商户
Method : GET
请求参数:
无
响应:
code M int 返回码,0表示成功,其他表示错误
msg M string 错误信息
data M list 商户信息,数据字段为订单表字段;
示例
response
{
"resname": "asdfasdg",
"KID": "K231193",
"SID": "S217658",
"create_employee_phone": "--",
"user_id": 231193,
"telephone": "1323123123123",
"service_station": [
"喵喵"
],
"whitelist": 0,
"area_l1": "龙岗区",
"sales_employee_name": "(待定)",
"check_out": 0,
"area_l2": "南湾",
"name": "sdfgsdfgsdfg",
"sales_employee_phone": "--",
"addr_detail": "asdfasdfasdf",
"city": "深圳市",
"settle_way": "先货后款",
"finance_status": 0,
"create_time": "2019-05-14",
"username": "qwe11111111",
"cname": "",
"create_employee_name": "--",
"pay_method": "日结",
"keycustomer": 0,
"balance": "0"
},
/manage/custommanage/detail 查看商户详情
Method : GET
请求:
address_id M int 商户ID
响应:
code M int 返回码,0表示成功,其他表示错误
msg M string 错误信息
示例:
response
{
"code": 0,
"msg": "ok",
"data": [
{
"receive_time_limit": {
"receiveTimeSpan": "30",
"start": "06:00",
"s_span_time": 6,
"end": "23:30",
"e_span_time": 6
},
"name": "小农女默认服务时间",
"service_time_creator": "T001",
"task_begin_time": "06:00",
"_id": "ST001",
"desc": "小农女默认服务时间",
"receive_time": {
"defaultSpanEndFlag": 1,
"defaultSpanStartFlag": 1,
"defaultEnd": "07:30",
"defaultStart": "07:00"
},
"final_distribute_time": "06:00",
"type": 0,
"final_distribute_time_span": 1,
"order_time_limit": {
"start": "06:00",
"end": "02:00",
"e_span_time": 1
}
}
]
}
/manage/custommanage/check_unpay 查看商户结余
Method:GET
请求:
address_ids M int 商户SID
响应:
code M int 返回码,0表示成功,其他表示错误
msg M string 错误信息
data M string 账户信息,数据字段为订单表字段;
示例:
response
{
"msg": "ok",
"data": [
{
"receive_begin_time": null,
"address_id": 217600,
"receiver_name": "sdfgsdfgsdfg",
"receive_end_time": null,
"address": "sdfgsdfgsdfg",
"type": 17,
"msg": "未审核",
"id": 231137,
"receiver_phone": "11321231231",
"resname": "sdfgsdfgsdfg",
"keycustomer": 0
},
...
],
"code": 0
}
/manage/custommanage/skus/list 查看运营时间下对应的商品
Method: GET
请求:
address_id M string 商户id
time_config_id M string 运营时间
usual_type O int 搜索类型,1:展示常用商品
search_text O string 商品名称、sku_id或spu_id、自定义编码
limit
offset
响应:
code M int 0为成功,其它为失败
msg M string 错误提示信息
data M list 返回的商品列表
[{
'category_id_1': M string 一级分类ID
'category_name_1': M string 一级分类名
'category_id_2': M string 二级分类ID
'category_name_2': M string 二级分类名
'pinlei_id': M string 品类ID
'pinlei_name': M string 品类名
'spu_id': M string spu ID
'spu_name': M string spu名称
'sku_id': M string 商品ID
'sku_name': M string 商品名
'std_unit_name': M string 标准单位
'std_sale_price' M int 标准价(分)
'sale_unit_name': M string 售卖单位
'sale_ratio': M float 售卖规格
'sale_price': M int 售卖价(分)
}]
功能3:订单列表-筛选项新增「代下单/全部」
/manage/ordermanage/orders/list
Method:GET
请求
client O int 订单类型:不传表示全部订单,1表示后台下单,2微信商城,3app,4微信小程序,5有赞推送,6开放平台,7后台, 8云管家代客下单(新增)
响应
不变
功能4:新增「未下单商户」模块
/manage/custommanage/address/list
Method:GET
请求:
begin_date M date 搜索日期区间头
end_date M date 搜索日期区间尾
q O str 搜索字段
response:
{
"code": 0,
"msg": "ok",
"data":{
'no_order_addresses' M list [
{
'address_id' M str 商户ID
'address_name' M str 商户名称
'register_time' M datetime 注册时间
'fist_order_time' M datetime 首次下单时间
'last_order_time' M datetime 最近订单下单时间
'payment_name' M str 结款联系人
'payment_telephone' M str 电话
}
}
}
功能11:订单列表-订单来源新增「云管家代客下单」
/station/orders(老接口,station搜索订单)
Method:GET
请求
client O int 订单类型:不传表示全部订单,1表示后台下单,2微信商城,3app,4微信小程序,5有赞推送,6开放平台,7后台, 8云管家代客下单(新增)
响应
不变
功能5-9:云管家数据权限控制
改动接口(纯后端)
逻辑:根据用户是否为销售经理修改过滤条件
/manage/custommanage/list 商户管理
/manage/custommanage/bill/search 对账单
/manage/applets/data_analyse/order/counts 对账单
/manage/report/customer_order 订单分析
/manage/report/skus 商品分析
/manage/report/customer_order_abnormal 异常分析
/ordermanage/orders/list 查看订单
/manage/applets/data_analyse/lastest_orders_count 首页订单统计
其他:
将station与云管家对订单增删查改的相同校验逻辑移动到order服务
开发周期
订单增删查改(order服务有对应改动) 6天
/manage/ordermanage/orders/create
/manage/ordermanage/orders/get
/manage/ordermanage/orders/edit
/manage/ordermanage/orders/delete
下单时校验商户信息 2天
/manage/custommanage/list
/manage/custommanage/edit
/manage/custommanage/check_unpay
常用商品,报价单列表 1天
/manage/ordermanage/skus/list
station和云管家订单添加筛选条件 1天
/manage/ordermanage/orders/list
/station/orders
查看未下单商户 1天
/custommanage/sales_report/detail
云管家权限控制筛选 4天
/manage/custommanage/list 商户管理
/manage/custommanage/bill/search 对账单
/manage/applets/data_analyse/order/counts 对账单
/manage/report/customer_order 订单分析
/manage/report/skus 商品分析
/manage/report/customer_order_abnormal 异常分析
/ordermanage/orders/list 查看订单
/manage/applets/data_analyse/lastest_orders_count 首页订单统计
总计 15天