Skip to content

自提点

数据库变动:

mysql:
新增自提点信息表
CREATE TABLE `tbl_pick_up_station` (
  `id` INT(11) NOT NULL AUTO_INCREMENT,
  `name` VARCHAR(40) NOT NULL COMMENT '自提点名称',
  `principal` VARCHAR(40) NOT NULL COMMENT '负责人',
  `phone` VARCHAR(20) NOT NULL COMMENT '联系电话',
  `address` VARCHAR(60) NOT NULL COMMENT '自提点详情地址',
  `district_code` VARCHAR(45) NOT NULL,
  `area_l1` BIGINT(20) NOT NULL DEFAULT '0' COMMENT 'tbl_area.id,一级地址id',
  `area_l2` BIGINT(20) NOT NULL DEFAULT '0' COMMENT 'tbl_area.id,二级地址id',
  `station_id` VARCHAR(10) NOT NULL COMMENT '所属站点',
  `group_id` INT(11) NOT NULL COMMENT '所属group_id',
  `business_status` TINYINT(4) NOT NULL COMMENT '营业状态(1开启,2关闭)',
  `pstatus` TINYINT(4) NOT NULL DEFAULT '0' COMMENT '是否删除',
  `create_time` DATETIME NOT NULL COMMENT '创建时间',
  `modify_time` DATETIME NOT NULL COMMENT '最后修改时间',
  `delete_time` DATETIME NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '删除时间,未删除为 1-1-1 00:00:00',
  `extra1` INT(11) NOT NULL DEFAULT '0',
  `extra2` INT(11) NOT NULL DEFAULT '0',
  `extra3` INT(11) NOT NULL DEFAULT '0',
  `extra4` VARCHAR(128) NOT NULL DEFAULT '',
  `extra5` VARCHAR(128) NOT NULL DEFAULT '',
  `extra6` VARCHAR(128) NOT NULL DEFAULT '',
  `extra7` DATETIME NOT NULL DEFAULT '0001-01-01 00:00:00',
  `extra8` DATETIME NOT NULL DEFAULT '0001-01-01 00:00:00',
  `extra9` DATETIME NOT NULL DEFAULT '0001-01-01 00:00:00',
  `extra10` DECIMAL(15,4) NOT NULL DEFAULT '0.0000',
  PRIMARY KEY (`id`),
  UNIQUE KEY `name` (`name`,`station_id`,`delete_time`),
  KEY `station_id` (`station_id`),
  KEY `district_code` (`district_code`),
  KEY `area_l1` (`area_l1`),
  KEY `area_l2` (`area_l2`)
  )ENGINE=InnoDB;

商户tbl_user新增商户类型字段
ALTER TABLE tbl_user ADD customer_type TINYINT(4) NOT NULL DEFAULT 1;

订单表中新收货类型和自提点id
ALTER TABLE `order_{}`.`tbl_order_{}` 
CHANGE COLUMN `extra1` `receive_way` INT(11) NOT NULL DEFAULT '1' ,
CHANGE COLUMN `extra2` `pick_up_st_id` INT(11) NOT NULL DEFAULT '0' ;

权限表auth_permissio新增:
配送任务:查看自提点、编辑自提点、删除自提点
INSERT INTO xnn_core_product_2.auth_permission
(content_type_id, level2_id, codename, name_en, name ) VALUES
(68,9, "get_pick_up_station" , "Get Pick Up Station" , "查看自提点"),
(68,9, "edit_pick_up_station" , "Edit Pick Up Station" , "编辑自提点"),
(68,9, "delete_pick_up_station", "Delete Pick Up Station", "删除自提点");

mongo:
order_new:
    订单中customer新增收货方式和自提点id
    receive_way    int
    无收货方式或者收货方式为1都为配送,2为自提
    pick_up_st_id    int
    收货方式为配送时为0

customized_info:
    新增可选收货方式
    optional_receive_way    int     (1为配送,2为自提,10为配送+自提)
    customer_regist_type    int     (1为店铺,2为个人,3为店铺+个人)

接口变动:

以下12个是station相关的接口

station/pick_up_station/get(新增接口)

接口描述:
    获取单个自提点信息
Method:
    GET
请求:
    id             M           int             自提点id
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{}     M           dict            自提点信息容器
    }
    data示例:
    data:{
        id:1,                                  M           int       自提点id
        name:"南山自提点",                       M           str       自提点名称
        principal:"张三",                       M           str       负责人
        phone:"13587656765",                   M           str       联系电话
        district_code:"430100"                 M           str       地区
        area_l1:2120100000000                  M           int       一级地址id
        area_l2:2120100100000                  M           int       二级地址id
        address:"地理位置",                     M           str       自提点地址
        business_status:1,                     M           int       营业状态(1为开启,2为关闭)
    }

station/pick_up_station/list(新增接口)

接口描述:
    获取多个自提点信息
Method:
    GET
请求:
    district_code:"430100"     O       str       地区
    area_l1:2120100000000      O       int       一级地址id
    area_l2:2120100100000      O       int       二级地址id
    business_status:1          O       int       营业状态(1为开启,2为关闭)
    search_text:"南山自提点"     O       str       搜索条件

    page_obj    O   string  起始页(不包含),默认第0页
    reverse     O   bool    是否反向查询。1:是,0:不是。默认为否。
    limit       O   int     返回条数,默认10。传0表示返回所有数据。
    offset      O   int     查询起点偏移条数,默认 0 
    peek        O   int     是否需要 peek,默认不需要 peek。peek 必须大于 limit。
    count       O   bool    是否需要 count,默认不需要 count
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:[]     M           list            自提点信息容器
        pagination: {               M   dict
            "peek": 100,            O   int     前端传 peek 的话,后端就会返回这个字段
            "more": true,           M   bool    是否有更多数据
            "page_obj": "gtyuhb",   M   string
            "count": 2000           O   int     前端传 count 的话,后端就会返回这个字段
        }
    }
    data示例:
    data:[{
        id:1,                                  M           int       自提点id
        name:"南山自提点",                       M           str       自提点名称
        principal:"张三",                       M           str       负责人
        phone:"13587656765",                   M           str       联系电话
        geographic_label:"深圳市-南山区-科技园",  M           str       地理标签
        address:"地址位置",                     M           str       自提点地址
        business_status:1,                     M           int       营业状态(1为开启,2为关闭)
    },{},...]
station/pick_up_station/create(新增接口)

接口描述:
    新增自提点
Method:
    POST
请求:
    name:"南山自提点"                       M           str       自提点名称
    principal:"张三"                       M           str       负责人
    phone:"13587656765"                   M           str       联系电话
    district_code:"430100"                M           str       地区
    l1_area_id:2120100000000              O           int       一级地址id
    l2_area_id:2120100100000              O           int       二级地址id
    address:"自提点地理位置",               M           str       自提点地址
    business_status:1,                    M           int       营业状态(1为开启,2为关闭)
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{}     M           dict            响应信息容器
    }
station/pick_up_station/update(新增接口)

接口描述:
    更新单个自提点信息
Method:
    POST
请求:
    id:1                                  M           int       自提点id
    name:"南山自提点"                       O           str       自提点名称
    principal:"zhangsan"                  O           str       负责人
    phone:"13587656765"                   O           str       联系电话
    district_code:"430100"                O           str       地区
    l1_area_id:2120100000000              O           int       一级地址id
    l2_area_id:2120100100000              O           int       二级地址id
    address:"dizhi"                       O           str       自提点地址
    business_status:1,                    O           int       营业状态(1为开启,2为关闭)
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{}     M           dict            响应信息容器
    }

station/pick_up_station/delete(新增接口)

接口描述:
    逻辑删除自提点信息
Method:
    POST
请求:
    id:1            M           int             自提点id
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{}     M           dict            响应信息容器
    }
station/customized

接口描述:
    店铺运营设置
Method:
    GET
请求:
    不变
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{}     M           dict            响应信息容器
    }
    在data中新增可选收货方式
    示例:
    data:{
        optional_receive_way:1    M    int    收货方式(1为配送,2为自提,10为配送+自提)
        customer_regist_type:1    M    int    商户可选注册类型(1为店铺,2为个人,3为店铺+个人)
        ...
    }
station/customized/update

接口描述:
    更新店铺运营设置
Method:
    POST
请求:
    新增可选收货方式参数
    optional_receive_way:1         M        int    收货方式(1为配送,2为自提,10为配送+自提)
    customer_regist_type:1         M        int    商户可选注册类型(1为店铺,2为个人,3为店铺+个人)
    其余不变
响应:
    不变
station/orders

接口描述:
    获取符合条件的订单信息
Method:
    GET
请求:
    新增收货方式,和自提点id
    receive_way:1            O        int        收货方式(1为配送,2为自提)
    pick_up_st_id:1          O        int        自提点id
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{}     M           dict            响应信息容器
    }
    在data中的订单信息列表中的单个订单信息新增收货方式和自提点名称
    示例:
    data:{
        in_query: false,
        list:[{
            receive_way:1,                 M        int       收货方式(1为配送,2为自提)
            pick_up_st_name:"南山自提点",    M        str/None   自提点名称
            ...
            其余不变
        }],
        pagination: {
            limit: 20, 
            offset: 0, 
            count: 135
        }
    }
station/sales_analysis/orderdetail

接口描述:
    订单详情导出
请求:
    不变
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{}     M           dict            订单信息容器
    }
    在data中的order中每一个订单信息添加收货方式和自提点地址
    示例:
    data:{
        orders: [{
            receive_way:1,            M       int       收货方式(1为配送,2为自提)
            pick_up_st_name:"as"      M       str/None  自提点名称
            ...
        },...]
        其余都不变
    }
station/order/edit

接口描述:
    获取单个订单详情
Method:
    GET
请求:
    不变
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{}     M           dict            订单信息容器
    }
    在data中的custoner中新增收货方式和自提点地址
    示例:
    data:{
        ...,
        customer:{
            receive_way:1,          M       int      收货方式(1为配送,2为自提)
        },
        ...
    }

以下2个sorting相关接口

station/distribute/get_order_by_id

接口描述:
    打印配送单
Method:
    GET
请求:
    不变
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:[]     M           list            订单信息容器
    }
    在data中的每一个订单信息中添加收货方式、自提点名称,自提点地址,负责任,联系方式。
    示例:
    data:[{
        receive_way:1                M       int      收货方式(1为配送,2为自提)
        #以下自提点信息,收货方式为配送时全部为None
        pick_up_st_name:"sad"       O       str/None  自提点名称
        pick_up_st_principal:"hehe" O       str/None  自提点负责人
        pick_up_st_phone:"12314"    O       str/None  联系电话
        ...
        其余不变
    },...]
station/task/distribute/orders/get

接口描述:
    获取订单配送任务列表
请求:
    新增收货方式和自提点id
    receive_way:1            O       int      收货方式(1为配送,2为自提)
    pick_up_st_id:1          O       int      自提点id
    其余不变
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{}     M           dict            订单任务信息容器
        pagination:{
            limit: 20, 
            count: 1, 
            offset: 0
            }
    }
    在订单任务信息中新增收货方式、自提点名称、自提点地址
    示例:
    data:{
        address:[...]
        distribute_order: {,…}
        in_query: false
        order: [{
            receive_way:1            O       int      收货方式(1为配送,2为自提)
            pick_up_st_name:"sdsd"   O       str/None 自提点名称
            pick_up_st_phone:"23445" O       str/None 自提点地址
            ...
            其余不变
        },...]
        msg:"ok"
    }

添加相关权限

配送任务:查看自提点、编辑自提点、删除自提点

以下4个是ma相关接口

custommanage/list

接口描述:
    获取商户信息列表
Method:
    GET
请求:
    新增商户类型参数
    customer_type:1       O       int       商户类型(1为店铺,2为个人)
    ...
    其余不变
响应:
    {
        code:0      M           int             0为成功,其他为失败
        count:34    M           int             商户列表总数
        data:[]     M           list            订单信息容器
    }
    在data中新增商户类型信息
    示例:
    data:[{
        customer_type:1       M       int       商户类型(1为店铺,2为个人)
        ...
        其余不变
    },...]
restaurant/import
接口描述:
    商户导入
restaurant/add
接口描述:
    新建商户

逻辑变动,新建和导入商户默认为店铺类型
custommanage/edit

接口描述:
    获取单个商户详情
请求:
    不变
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{}     M           dict            商户信息容器
    }
    在data中的data中新增商户类型信息
    示例:
    data:{
        data:{
            customer_type:1       M       int       商户类型(1为店铺,2为个人)
            ...
        },
        ...
        其余不变
    }

以下7个是bshop相关接口

user/optional_info(新增接口)

接口描述:
    获取商户可选择注册类型
Method:
    GET
请求:
    无
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{      M           dict            商户信息容器
            customer_regist_type:1,      M      int      商户可选注册类型(1为店铺,2为个人,3为店铺+个人)        
            optional_receive_way,        M      int      可选收货方式(1为配送,2为自提,10为配送+自提)
            }     
    }
usr/account

接口描述:
    获取用户信息
Method:
    GET
请求:
    不变
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{}     M           dict            响应信息容器
    }
    在data中新增商户类型
    示例:
    data:{
        customer_type:         M         int         商户类型
        其余不变
    }
register

接口描述:
    用户注册
Method:
    POST
请求:
    新增商户类型
    customer_type:1       M       int       商户类型(1为店铺,2为个人)
响应:
    不变
user/address/set

接口描述:
    设置用户收货地址
method:
    POST
请求:
    新增自提点信息和收货方式
    receive_way:1         M        int      收货方式(1为配送,2为自提)
    pick_up_st_id         O        int      自提点id
    其余不变
响应:
    不变
order/confirm

接口描述:
    获取订单相关信息
请求:
    不变
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{}     M           dict            订单信息容器
    }
    在data中新增收货方式信息
    示例:
    data:{
        receive_way:1              M     int      收货方式(1为配送,2为自提)
        pick_up_st_address:"as"    O     str/None 自提点地址
        pick_up_st_name:"dasd"     O     str/None 自提点名称
        pick_up_st_phone:"214"     O     str/None 自提点电话
        pick_up_st_id:3            O     int      自提点id
        ...
        其余不变
    }
order/pick_up_station/list(新增接口)

接口描述:
    获取自提点信息
Method:
    GET
请求:
    无
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:[]     M           list            响应信息容器
    }
    data示例:
    data:[{
        id:1                     M     int     自提点id
        name:"as"                M     str     自提点名称
        address:"jia"            M     str     自提点地址
        phone:"22323"            M     str     负责人电话
    },...]

order/detail

接口描述:
    获取订单详情
Method:
    GET
请求:
    不变
响应:
    {
        code:0      M           int             0为成功,其他为失败
        msg:"ok"    M           str             错误提示信息
        data:{}     M           dict            响应信息容器
    }
    在data中新增收货方式、自提点名称、自提点地址、负责人联系方式信息
    示例:
    data:{
        receive_way:1            M     int      收货方式(1为配送,2为自提)
        pick_up_st_name:"as"     O     str/None 自提点名称
        pick_up_st_phone:"22323" O     str/None 负责人电话
        ...
        其余不变
    }

开发时间计划:

自提点的增删改查:3天
station/pick_up_station/get(新增接口)
station/pick_up_station/list(新增接口)
station/pick_up_station/create(新增接口)
station/pick_up_station/update(新增接口)
station/pick_up_station/delete(新增接口)
店铺运营设置新增可选收货方式:1.5天
station/customized
station/customized/update
系统设置新增商户注册类型:1.5天
station/new
station/profile/update
订单列表、单个详情和订单列表导出:3天
station/order/edit
station/orders
station/sales_analysis/orderdetail

配送单新增自提点信息:1天
station/distribute/get_order_by_id
配送任务新增搜索方式和自提点信息:1.5天
station/task/distribute/orders/get

MA接口1.5天
custommanage/list
custommanage/edit

bshop接口3天
user/address/add
order/confirm
order/pick_up_station/list(新增接口)
order/submit
order/detail
user/customer_regist_type

开发时间共计16天