商户管理后台迭代

功能点

1. 新增和删除店铺功能
2. 新增店铺时候可选择新增账户
3. 通过导入Excel批量新增商户以及帐号
4. 新增商户的校验和编辑以及批量导入商户的校验

接口

/custommanage/restaurant/add 新增商户

接口名: /custommanage/restaurant/add
Method: POST
请求:
    kid O str 账户ID
    username O string 用户名
    password O string 用户密码
    pay_name O string 结款人
    pay_method O int 结款方式(1:日结;2:周结)
    pay_telephone O int 结款人电话
    finance_status O int 财务状态(0: 正常; 1: 冻结)
    whitelist   O int 财务白名单(0: 否; 1: 是)
    name    O string 公司名
    resname M string 店铺名
    receive_name M string 收货人
    receive_telephone M int 收货电话
    begin_time M string 收货开始时间
    end_time M string 收货结束时间
    district_code M string 城市码
    area_level1 M int 区ID
    area_level2 M int 域ID
    addr_detail M string 收货地址
    create_employee O int 开户经理
    sale_employee O int 维护经理
    salemenu_ids M list 报价单id列表[salemenu_id]
响应:
    code M int 0为成功，其它为失败
    msg M string 错误提示信息
    sid M int 新建店铺成功时候返回店铺的id
逻辑:
    参数中有kid表示在已有帐号下新增商户，没有表示同时新增帐号
    新增帐号时username、password、pay_name、pay_method、pay_telephone、district_code为必填参数

/custommanage/restaurant/search 商户搜索

接口名: /custommanage/restaurant/search
Method: GET
请求:
    sid 0 int 商户ID
响应:
    code M int 0为成功, 其它为失败
    unique M int 1为唯一, 0为非唯一
    msg M string 错误提示信息
逻辑: 商户的唯一是相对于当前商户对应的账户(以及当前group)的唯一

/custommanage/restaurant/delete 删除商户

接口名: /custommanage/restaurant/delete
Method: POST
请求:
    sid O int 商户ID
响应:
    code M int 0为成功，其它为失败
    msg M string 错误提示信息
逻辑:
    删除商户与报价单绑定记录, 逻辑上的商户删除

/custommanage/customer/search 搜索帐号

接口名: /custommanage/customer/search
Method: GET
请求:
    text M string 搜索信息(可选择kid或者账户名进行搜索)
响应:
    code M int 0为成功，其它为失败
    msg M string 错误提示信息
    data O list 返回的帐号数据
    [{
        KID M string 帐号ID
        username M string 账户名
        district_code M string 城市码
        payment_name M string 借款人
        pay_method M int 结款方式(1:日结;2:周结)
        payment_telephone M string 结款电话
        finance_status M 是否冻结(0: 否; 1: 是)
        is_whitelist M  财务白名单(o: 否; 1: 是)
        cname M 公司名
    }]
逻辑:
    根据text搜索帐号信息

/custommanage/restaurant/import 导入商户信息

接口名: /custommanage/restaurant/import
Method: post
请求:
    data M list 商户信息列表
    [{      
        username M string 用户名
        password M string 用户密码
        pay_name M string 结款人
        pay_method M int 结款方式(1:日结;2:周结)
        pay_telephone M string 结款电话
        finance_status M int 财务状态(0: 正常; 1: 冻结)
        whitelist   M int 财务白名单(0: 否; 1: 是)
        name O string 公司名
        resname M string 店铺名
        receive_name M string 收货人
        receive_telephone M string 收货电话             
        district_code M string 城市码
        area_level1 M int 区ID
        area_level2 M int 域ID
        addr_detail M string 收货地址
        create_employee O int 开户经理
        sale_employee O int 销售经理
        salemenu_ids M string 报价单id列表，以逗号分隔
    }]
响应:
    code M int 0为成功，其它为失败
    data_check M list 返回检验结构
    [{
        field M 有错字段时候(无错时候原样返回)
        field:{
            data M string 原始数据
            msg M string 错误信息
        }
    }]
    data O list 全部导入成功时候返回店铺id
    [{
        sid M int 店铺id
    }]
逻辑:
    用户名存在则是在已有账户下导入商户, 不存在则是新建用户并导入商户
    导入时候对商户和账户做逻辑校验, 校验通过则存入数据库并返回对应的商户id

/custommanage/saleemployee/search 报价单及配送站点拉取

Method: get
响应:
    code M int 0位成功 其它为失败
    data obj 返回配送站点以及所属的销售单
    data:{
        name M string 仓库名
        district_code M int 站点所属城市id
        distribute_cities M list 可配送城市
        distribute_cities:[
            district_code M int 可配送城市id
        ]
        salemenu list 销售单数字
        salemenu:[
            {
                salemenu_id M int 销售单id
                salemenu_name  M string 销售单名称
            }
        ]
    }
逻辑:
    拉取当前用户权限下的所有配送站点以及对应站点下的销售单

http://static.guanmai.cn/template/manage_user_add.xlsx 模板下载

接口名 /custommanage/template/download
Method: get
响应:
    code M int 0为成功, 其它为失败
    msg M string 错误信息
    template O file 返回商户模板文件

/custommanage/edit/S(\d+) 店铺详细信息修改迭代

接口名 /custommanage/edit/S(\d+)
Method: get
响应:
    ...
    data部分数据增加返回如下
    data:{
        city{
            city_code:{
                name M string 城市名称
                area M list 地区列表
                {
                    area_code:{
                        name M string 地区名称
                        street M list 街道列表
                        [{
                            street_code M 键为街道id,值为街道名称
                        }]
                    }
                }
            }
        }
    }
    ...
逻辑: 返回数据增加城市字段, 各级地区显示按照父子级别关系返回数据
Method: post
请求:
    status M string 修改权限标志
    originalArea M int 城市
    firstArea M int 一级地区
    secondArea M int 二级地区
    shopAddress M string 店铺地址
响应:
    code M int 0为成功, 其它为失败
    msg M string 错误提示信息
逻辑:
    修改城市或者地区以及店铺地址