Skip to content

云管家销售经理版(代客下单)

云管家销售经理版(代客下单)

有关订单的创建编辑删除的逻辑以及返回的数据都参考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天