商户管理后台迭代优化版
改动点
- 新增商户接口修改了部分传入参数名称以及修改了返回数据格式
- 商户搜索接口改为商户唯一性判断接口, 由原来的.../search改为.../check_unique
- 账户搜索接口修改了返回数据格式
- 批量导入商户接口修改了部分传入参数名称和返回数据格式
- 报价单以及配送站点拉取接口由.../search改为.../get, 部分字段名称修改
接口
/custommanage/restaurant/add 新增商户
接口名: /custommanage/restaurant/add
Method: POST
请求:
kid O str 账户ID
username O str 用户名
password O string 用户密码
payer_name O str 结款人姓名 (PS: 修改)
pay_method O int 结款方式(1:日结;2:周结)
payer_telephone O str 结款人电话 (PS: 修改)
finance_status O int 财务状态(0: 正常; 1: 冻结)
whitelist O int 财务白名单(0: 否; 1: 是)
company_name O str 公司名 (PS: 修改)
restaurant_name M str 店铺名 (PS: 修改)
receiver_name M str 收货人姓名 (PS: 修改)
receiver_telephone M str 收货人电话 (PS: 修改)
district_code M str 城市id
area_level1 M int 一级区域id
area_level2 M int 二级区域id
restaurant_address M str 店铺详细收货地址 (PS: 修改)
create_employee_id O int 开户经理id (PS: 修改)
sale_employee_id O int 维护经理id (PS: 修改)
salemenu_ids M list 报价单id列表[salemenu_id]
响应:
code M int 0为成功，其它为失败
msg M str 提示信息
data M obj 新建成功返回数据 (PS: 修改)
data:{
sid M str 店铺id
}
逻辑:
参数中有kid表示在已有帐号下新增商户，没有表示同时新增帐号
新增帐号时username、password、payer_name、pay_method、payer_telephone为必填参数
/custommanage/restaurant/check_unique 商户唯一判断
接口名: /custommanage/restaurant/check_unique (PS: 修改)
Method: GET
请求:
sid 0 str 商户id
响应:
code M int 0为成功, 其它为失败
msg M string 提示信息
data M obj 新建成功返回数据 (PS: 修改)
data:{
unique M boolean True(唯一)或者False(非唯一)
}
逻辑: 这里的商户唯一仅仅用户删除商户前判断该商户是否是最后一个商户
/custommanage/restaurant/delete 删除商户
接口名: /custommanage/restaurant/delete
Method: POST
请求:
sid O str 商户id
响应:
code M int 0为成功，其它为失败
msg M string 提示信息
逻辑:
删除商户与报价单绑定记录, 逻辑上的商户删除
/custommanage/customer/search 搜索帐号
接口名: /custommanage/customer/search
Method: GET
请求:
text M str 搜索字段(可输入kid或者username进行搜索)
响应:
code M int 0为成功，其它为失败
msg M str 提示信息
data O list 返回的帐号数据
data:[
{
KID M str 帐号id
username M str 账户名
district_code M str 城市id
payer_name M str 结款人姓名 (PS: 修改)
pay_method M int 结款方式(1:日结;2:周结)
payer_telephone M str 结款人电话 (PS: 修改)
finance_status M int 财务状态(0: 否; 1: 是)
whitelist M int 财务白名单(o: 否; 1: 是)
company_name M str 公司名 (PS: 修改)
}
]
逻辑:
根据text搜索帐号信息(搜索结果排列顺序: kid完全匹配 > username完全匹配 > kid模糊匹配 > username模糊匹配)
/custommanage/restaurant/import 导入商户信息
接口名: /custommanage/restaurant/import
Method: post
请求:
data M list 商户信息列表
[{
username M str 用户名
payer_name M str 结款人姓名 (PS: 修改)
pay_method M int 结款方式(1:日结;2:周结)
payer_telephone M str 结款人电话 (PS: 修改)
finance_status M int 财务状态(0: 正常; 1: 冻结)
whitelist M int 财务白名单(0: 否; 1: 是)
company_name O str 公司名 (PS: 修改)
restaurant_name M str 店铺名 (PS: 修改)
receiver_name M str 收货人姓名 (PS: 修改)
receiver_telephone M str 收货人电话 (PS: 修改)
district_code M str 城市id
area_level1 M int 一级区域id
area_level2 M int 二级区域id
restaurant_address M str 店铺详细收货地址 (PS: 修改)
create_employee_id O int 开户经理id (PS: 修改)
sale_employee_id O int 销售经理id (PS: 修改)
salemenu_ids M list 报价单id列表，以英文分号分隔
}]
响应:
code M int 0为成功，其它为失败
msg M str 提示信息
data M list 检验失败返回封装的错误数据 (PS: 修改)
data:[
{
field M dict
field:{
data M field原始数据
msg M str 错误提示信息
}
}
]
逻辑:
仅仅针对新建kid时候批量导入商户信息(可一个kid对应多个sid或者当sid)
/custommanage/saleemployee/get 报价单及配送站点拉取
接口名: /custommanage/saleemployee/get (PS: 修改)
Method: get
响应:
code M int 0位成功 其它为失败
data obj 返回配送站点以及所属的销售单
data:{
station_name M str 仓库名 (PS: 修改)
district_code M int 站点城市id
distribute_city_ids M list 可配送城市 (PS: 修改)
distribute_city_ids:
district_code M int 可配送城市id
]
salemenus list 销售单列表
salemenu:[
{
salemenu_id M int 销售单id
salemenu_name M str 销售单名称
}
]
}
逻辑:
拉取当前用户权限下的所有配送站点以及对应站点下的销售单
http://static.guanmai.cn/template/manage_user_add.xlsx 模板下载
接口名 http://static.guanmai.cn/template/manage_user_add.xlsx
Method: get
响应:
excel模板文件
/custommanage/edit/S(\d+) 店铺详细信息修改迭代
接口名 /custommanage/edit/S(\d+)
Method: get
响应:
...
data部分数据增加返回如下
data:{
city:{
city_id:{
name M str 城市名称
area_id:{
name M string 地区名称
street M list 街道列表
[
{
street_id M str 街道名称
}
]
}
}
}
}
...
逻辑: 返回数据增加城市字段, 各级地区显示按照父子级别关系返回数据
Method: post
请求:
status M string 修改权限标志
originalArea M int 城市
firstArea M int 一级地区
secondArea M int 二级地区
shopAddress M string 店铺地址
响应:
code M int 0为成功, 其它为失败
msg M string 错误提示信息
逻辑:
修改城市或者地区以及店铺地址