自提点
数据库变动:
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天