账期时间维度扩展

账期时间维度

Head

Author: GuLong
Status: create
Type: Standards
Created: 2019-02-20

数据库相关

mysql
`management`.`tbl_user_pay_method`  新增字段 settle_date_type
ALTER TABLE `management`.`tbl_user_pay_method` ADD COLUMN `settle_date_type` int(11) NOT NULL DEFAULT '1' COMMENT '商户结算的账期时间维度，1 按下单日期 2按收货日期';

MA接口改动

/custommanage/edit （修改已有接口）

接口描述
    拉取店铺和店铺账号等信息
Method
    GET
请求
    不变
响应
{
    "code":0,
    "data":{
        "timereceive":Array[28],
        "station_salemenu":Object{...},
        "data":{
            ...
            "settle_date_type":1,   # 新增字段，账期结算的日期维度， 1 按下单日期  2按收货日期
            ...
        },
        "create_employee":Object{...},
        "city":Object{...},
        "sale_employee":Object{...},
        "area":Object{...}
    },
    "msg":"ok"
}

/custommanage/edit （修改已有接口）

接口描述
    修改店铺和店铺账号等信息
    原接口 https://doc.guanmai.cn/模块文档/management模块/接口/#custommanageedits-
Method
    POST
请求
    ...
    # 新增参数
    settle_date_type    M   string  日期维度， 1 按下单日期  2按收货日期。      
                                        当status=modifyPayMethod有效
响应
    {
        "msg": "success",
        "code": 0
    }

/custommanage/customer/search （修改已有接口）

接口描述
    店铺搜索接口（MA-新建商户-选择已有账户）
Method
    GET
请求
    不变
响应
    {
      "msg": "ok",
      "code": 0,
      "data": [
        {
          "begin_day": null,
          "company_name": "",
          "settle_way": 1,
          "settle_remind": -1,
          "district_code": "440300",
          "payer_name": "xbs123",
          "username": "1233211234567",
          "payer_telephone": "17777777777",
          "is_credit": 0,
          "credit_limit": 0,
          "KID": "K080144",
          "whitelist": 0,
          "settle_day": null,
          "check_out": 1,
          "pay_method": 1,
          "finance_status": 0,
          "effective_date": "2018-04-03",
          "settle_date_type":1, # 新增字段，账期结算的日期维度， 1 按下单日期  2按收货日期
        }
      ]
    }

/custommanage/restaurant/add (修改已有接口)

接口描述
    新增账户
Method
    POST
请求
    ...
    # 新增参数
    settle_date_type    M   string  日期维度， 1 按下单日期  2按收货日期
响应
    不变

/custommanage/restaurant/import (修改已有接口)

接口描述
    批量新建商户
Method
    POST
请求
    [
    ...
    #数组元素新增结款方式、账期方式、时间维度3个字段
    settle_way  M   int     结算方式（1：先货后款，2：先款后货）
    account_period_way  M   int     账期方式， 1:按周期，2：按额度
    pay_method  M   int     结款周期， 1:日结，2：周结
    settle_date_type    M   int     日期维度， 1 按下单日期  2按收货日期
    ...
    ]
响应
    不变
逻辑
    在原有逻辑上，增加对新增的列进行效验检查

Station接口改动

/station/check_unpay (修改已有接口)

接口描述
    检查商户支付状态（Station-订单列表-新建订单-选择商户后的检查）
Method
    GET
请求
    不变
响应
   不变
逻辑
    在原有逻辑上，新增部分逻辑：
    账期方式是否按周期？是则判定f，否则展示E（E中两种情况另再判定，此处不赘述）
    f、判定当前日期是否超过结算日？是则判定g，否则展示展示F
    g、（新增逻辑）时间维度是否按下单日期？是则展示G，否则展示H

    msg：
    F、正常
    G、欠款￥XX.XX（该商户下单时间在「结算日+1天」0点~当前时间之内的订单销售额加总）
    H、（新增逻辑）欠款￥YY.YY（该商户收货时间在「结算日+1天」0点~当前时间之内的订单销售额加总）

BShop接口改动

/user/bill_info/get (修改已有接口)

接口描述
    拉取账期信息
Method
    GET
请求
    不变
响应
    {
      "code": 0,
      "data": {
        "begin_day": 7,
        "bill_end_date": "02-16",
        "history_pay_price": 0,
        "id": 198562,
        "pay_price": 0,
        "pay_method": 2,
        "settle_day": 5,
        "bill_begin_date": "02-10",
        "paid_price": 0,
        "total_price": 0,
        "bill_settle_date": "02-22",
        "settle_remind": -1,
        "settle_date_type":1    # 新增字段，账期结算的日期维度， 1 按下单日期  2按收货日期
      },
      "msg": "ok"
    }
逻辑
    根据settle_date_type的值， 按照下单时间或收货时间搜索未完成支付的订单，计算当期未支付、晚期未支付的金额

/order/unpaid_list (修改已有接口)

接口描述
    拉取账期内未支付的订单列表
Method
    GET
请求
    不变
响应
    不变
逻辑
    在原有逻辑上，根据settle_date_type的值来按下单日期或收货日期，获取未支付的订单数据