Skip to content

售后重构

售后重构

数据库

新增权限

manage tbl_permission新增权限
id          name                name_en                         content_type_id     codename                                                pm_can_see  level2_id
189         打印售后单       Print AfterSaleOrder        16                      print_aftersaleorder        null                25

接口

/ordermanage/daily/search 搜索每日订单

接口描述
  拉取每日订单
Method
    GET
request
    date                            string          M           日期
    search_text             string          O           搜索字符
    search_area             string          O           地理位置信息(格式: 城市_区域_街道, 参照 station)
    num                             int                 O           数量(默认20)
    page                            int                 O           页码
response
    不变

/ordermanage/daily/export 导出每日订单

接口描述
  导出每日订单
Method
    GET
request
    date                            string          M           日期
    search_text             string          O           搜索字符
    search_area             string          O           地理位置信息(格式: 城市_区域_街道, 参照 station)
    num                         int                 O           数量(默认20)
    page                        int                 O           页码
response
    不变

/ordermanage/lkorder/search 搜索站点订单异常

接口描述
  拉取站定订单异常
Method
    GET
request
  date_from             string          M           起始时间
    date_end                string          M           结束时间
    search_text         string          O           搜索字符
    num                         int                 O           数量(默认20)
    page                        int                 O           页码
response
  不变

/ordermanage/salemenus 拉取用户所有可见站点的报价单

接口描述
    拉取用户所有可见站点的报价单信息
Method
    GET
request
    station_id          string          O           站点ID
response
    {
    "code": 0,
    "msg": "ok",
    "data": [{
      "station_id": "T7442",        string      M       站点ID
      "station_name": "cxk",        string      M       站点名
      "salemenus": [{
        "salemenu_id": "S123",  string      M       报价单ID
        "salemenu_name": "测试", string        M   报价单名
        }...]
    }...]
    }

/ordermanage/areas 获取地理标签信息

接口描述
    拉取地理标签信息
Method
    GET
request
    无
response
    {
    "code": 0,
    "msg": "ok",
    "data": [{
      "city_name": "深圳",                    string          M           城市名
      "city_id": 12304,                         int                 M           城市ID
      "areas": [{
        "area_id": 1233,                        int                 M           区域ID
        "area_name": "福田",              string          M            区域名
        "streets": [{
            "street_id": 123,                   int                 M           街道ID
            "street_name": "华强北",       string          M           街道名
            }, ...]
        }, ...]
    }, ...]
    }

/ordermanage/order_new/search 搜索订单

接口描述
    拉取订单列表
Method
  GET
request
    start_date          string          M           起始日期
    end_date                string          M           结束日期(最长2个月)
    search_text         string          O           搜索字符
    station_id          string          O           搜索站点ID
    salemenu_id         string          O           报价单ID
    search_area         string          O           地理位置信息(格式: 城市_区域_街道)
    order_status        int                 O           订单状态(1:等待出库, 5:正在分拣, 10:正在配送, 15:已签收, 100:已支付, 不传拉除删除外的所有状态)
    carrier_id          int             O           承运商ID
    driver_id               int                 O           司机ID
    is_exception        int                 O           是否异常(0: 否, 1: 是, 不传都拉)
    limit                       int                 O           条数(默认20)
    offset                  int                 O           偏移量
response
    {
        "code": 0,
        "msg": "ok",
        "data": {
            "in_query": false,                                              bool            M           搜出的订单是否在搜索条件里
            "orders": [{
        "order_id": "PL123456",                                 string      M           订单ID
        "order_time": "2019-04-26 12:00:00",        string      M           下单时间
        "customer": {
          "address_id": "11441",                                string      M           商户ID
          "resname": "商户名",                                     string      M           商户名
          "uid": "73232",                                               string      M           账户号
          "username": "测试",                                      string     M            账号
        },
        "station_name": "去采购",                              string      M           站点名
        "station_receiver_name": "tony",                string      M           站点联系人
        "station_receiver_phone": "110",                string      M           站点联系人电话
        "driver_name": "cxk",                                       string    M         司机名
        "order_status": 1,                                          int             M           订单状态(1:等待出库, 5:正在分拣, 10:正在配送, 15:已签收, 100:已支付)
        "pay_status": 1,                                                int             M           支付状态(1:未支付 5:部分支付 10:已支付)
        "pay_method": 1,                                                int             M           付款方式(1:到付, 2:线上支付)
        "area": "南山-蛇口"                                         string          M           地理标签star
        "refunds": [{                                                   array               M           退货信息
            "id": 12122,                                            int             O           退货ID
            "type_id": 1,                                           int             O           退货类型ID
            "type_text": "未按用户时间到达",         string      O       退货原因
            "request_amount": 3,                            float           O           退货数
            "text": "123",                                      string      O           描述
            "real_amount": 1.00,                            float           O           实退数
            "state": 2                                              int             O           退货状态(1: 待安排, 2:取货中, 3:已取货, 4:已入库, 5:已退货)(状态为4的不能修改)
        }, ...]
      }, ...],
      "pagination": {
        "page_obj": "123",
        "more": False,                              
        }
    },
    }

/ordermanage/order_sku 拉取订单商品

接口描述
    拉取订单商品
Method
    GET
resquest
    start_date                      string              M               起始日期
    end_date                            string              M               结束日期(最长2个月)
    search_text                     string              O               搜索字符
    station_id                      string              O               站点ID
    salemenu_id                     string              O               报价单ID
    limit                                   string              O               条数(默认20)
    offset                              string              O               偏移量(默认0)
response
    {
    "code": 0,
    "msg": "ok",
    "data": {
      "skus": [{
        "order_time": "2019-04-26 12:00:00",        string      M           下单时间
        "order_id": "PL123445",                                 string      M           订单ID
        "sku_id": "D1234123",                                       string      M           skuID
        "sku_name": "大白菜",                                      string      M           sku名
        "station_id": "T7442",                                  string      M           站点ID
        "station_name": "唱跳rap🏀",                        string      M       站点名
        "salemenu_id": "S12345",                                string      M           报价单ID
        "salemenu_name": "去采购",                             string      M           报价单名
        "sale_price": 123.00,                                       float           M           销售价(元)
        "quantity": 1.01,                                               float           M           下单数(含损耗)
        "sale_unit_name": "斤",                                  string   M          销售单位
        "address_id": 115892,                                       int             M           商户ID
        "resname": "cxk",                                               string      M           商户名
        "abnormal": {
            "final_amount": 9,                              float           O           记账数
            "money_delta": -200,                            int             O           金额变动
            "id": 123,                                              int             O           异常ID
            "type_id": 1,                                           int             O           异常原因ID
            "type_text": "未按用户时间到达",         string      O       异常原因
            "text": "123",                                      string      O           描述
        }
                "refund": {
            "id": 12122,                                            int             O           退货ID
            "type_id": 1,                                           int             O           退货原因ID
            "type_text": "未按用户时间到达",         string      O       退货原因
            "request_amount": 3,                            float           O           退货数
            "text": "123",                                      string      O           描述
            "real_amount": 1.00,                            float           O           实退数
            "state": 2                                              int             O           退货状态(1: 待安排, 2:取货中, 3:已取货, 4:已入库, 5:已退货)(状态为4的不能修改)
            }
        }, ...]
        },
        "pagination": {
        "count": 1,
        "offset": 0,
        "limit": 20
    }
  }

/ordermanage/exception/constants 拉取常量信息

接口描述
    拉取异常常量信息
Method
    GET
resquest
无
response
    {
    "code": 0,
    "msg": "ok",
    "data": {
      "sku_exception": {                        dict                    M           异常
        "reason": {                                 dict                    M           异常理由    
          "1": "未按用户时间到达",
            ...
        },
            "solution": {                                   dict                M           异常解决方法
          "2": "货品减免(质量问题)",
          ...
        }
      },
            "unsku_exception": {                        dict                M           非商品异常   
        "reason": {                                     dict                M           非商品异常理由 
          "64": "补贴",
            ...
        },
            "solution": {                                   dict                M           非商品异常解决方法
          "16": "客户沟通",
          ...
        }
      },
            "refund": {                                         dict            M           退货
        "solution": {                                   dict            M           退货解决方法
          "157": "放弃取货"
        }
      }
            "order_remark": {                               dict                M           备注
        "59": "客户沟通"
      }
    }
  }

/ordermanage/order_sku/exception 更新订单商品异常

接口描述
    更新订单商品
Method
    POST
resquest
    sku_id                      string                  M               skuID
    order_id                    string                  M               订单ID
    exception_type      int                         M               异常类型(0:无异常, 1: 商品异常, 2:商品退货)
    final_amount            float                       O               记账数(如果为商品异常必须传这个字段)
    request_amount      float                       O               退货数(如果为商品退货必须传这个字段)
    station_store_id    string                  O               入库仓ID(如果为商品退货必须传这个字段)
    exception_reason    int                         M               异常/退货原因ID   
    solution                    int                         M               处理方式ID
response
    {
    "code": 0,
    "msg": "ok",
    "data": ""
  }

/ordermanage/order_sku/exceptions 批量更新订单商品异常

接口描述
    批量更新订单商品异常
Method
    POST
request
    {
    "exception_type": 1,                        int                         M           异常类型(0:无异常, 1: 商品异常, 2:商品退货)
        "exception_reason": 1,                  int                         M           异常/退货原因ID(无异常是不传)
        "solution": 1,                                  int                         M           异常/退货解决方法ID
        "department_blame_name": "12",  string                  M           责任部门
        "department_to_name": "12",         string                  M           跟进部门
        "description": "123",                       string                  M           描述
        "orders": [
      "order_id": "PL123",                  string                  M           订单ID
      "station_store_id": "T7442",      string                  O           入库仓ID(如果为商品退货必须传这个字段)
      "skus": [
        "sku_id": "D123",                       string                  M           skuID
        ]
    ]
  }

/ordermanage/skus/print 商品打印

接口描述
    商品打印
Method
    GET
request
    {
    "orders": [
      "order_id": "PL123",          string                  M               订单ID
      "skus": [{                                
        "sku_id": "D123",               string                  M               skuID
      }]
    ]
  }
response
    {
    "code": 0,
    "msg": "ok",
    "data": [{
      "sku_id": "D12341",                                           string                      M               skuID
      "sku_name": "练习生",                                        string                      M               sku名
      "station_id": "T7442",                                    string                      M               站点ID
      "station_name": "去采购",                                string                      M               站点名
      "salemenu_id": "S123",                                    string                      M               报价单ID
      "salemenu_name": "1",                                     string                      M               报价单名
      "category_1": "水果",                                       string                          M           一级分类名
      "category_2": "进口水果",                              string                         M           二级分类名
      "pinlei": "瓜果",                                               string                          M           品类名
      "std_unit_name": "斤",                                  string                         M           基本单位
      "sale_unit_name": "斤",                                 string                         M           销售单位
      "settle_supplier_id": "T1234",                  string                        M               默认供应商ID
      "settle_supplier_name": "时长2点半",          string                      M           默认供应商
      "station_name": "去采购",                                string                      M               站点名
      "quantity": 12.09,                                            float                           M               下单数
      "real_quantity": 12.00,                                   float                           M               出库数
      "real_price": 12.00,                                      float                           M               出库金额
      "tax": "12",                                                    string                        M           商品税额
      "abnormal_money": "-12.00",                           string                      M               异常金额
      "request_refund_money": "12.00",              sring                           M               应退金额
      "real_refund_money": "12.00",                     string                      M               实退金额
      "tax": "12.00",                                                   string                      O               商品税率(有权限才有这个字段, 否则没有)
      "orders": [{
        "order_id": "PL1234",                                   string                      M               订单ID
        "order_time": "2019-04-12 03:12:11",    string                      M               下单时间
        "resname": "ceshi",                                     string                      M               商户名
        "quantity": 12.09,                                      float                           M               下单数
        "real_quantity": 12.00,                                 float                           M           出库数
        "real_item_price": "12.00",                         string                      M           出库金额
        "abnormal_money": "-12.00",                         string                      M           异常金额
        "request_refund_money": "12.00",                sring                           M           应退金额
        "real_refund_money": "12.00",                       string                      M           实退金额
        "tax": "12",                                                      string                        M           商品税额
        "abnormal": {
          "final_amount": 9,                                    float           O           记账数
          "money_delta": -200,                              int             O           金额变动
          "id": 123,                                                    int             O           异常ID
          "type_id": 1,                                             int             O           异常类型ID
          "type_text": "未按用户时间到达",           string      O       异常原因
          "text":   "123",                                          string      O           描述
        },
                "refund": {
          "id": 12122,                                          int             O           退货ID
          "type_id": 1,                                         int             O           退货类型ID
          "type_text": "未按用户时间到达",       string      O       退货原因
          "request_amount": 3,                          float           O           退货数
          "text": "123",                                        string      O           描述
          "real_amount": 1.00,                          float           O           实退数
          "state": 2                                                int             O           退货状态(1: 待安排, 2:取货中, 3:已取货, 4:已入库, 5:已退货)(状态为4的不能修改)
        }
        }, ...]
        }, ...]
  }

/ordermanage/orders/print 整单打印

接口描述
    商品打印
Method
    GET
request
  order_ids                                                                 list                        M               订单ID
response
    {
    "code": 0,
    "msg": "ok",
    "data": {
      "orders": [{
        "order_id": "PL123",                                                        string                  M               订单ID
        "order_time": "2019-09-21 12:00:00",                        string                  M               下单时间
        "station_receiver_name": "tony",                                string                  M           站点联系人
                "station_receiver_phone": "110",                                string                  M           站点联系人电话
        "driver_name": "打光",                                                        string                  M       配送司机
        "station_id": "T7442",                                                      string                  M           站点ID
        "station_name": "去采购",                                                  string                  M           站点名
        "customer": {
            "resname": "测试",                                                            string                   M      商户名
            "address_id": "12345",                                                  string                  M           商户ID
            "pay_method": 1,                                                                int                     M           商户结款方式(1:日结, 2:周结, 3:月结, 4:自定义结算)   
                "receiver_name": "123",                                                 string                  M           收货人
            "receiver_phone": "123",                                                string                  M           收货电话
            "receive_begin_time": "2019-09-12 12:00:00",        string                  M           收货起始时间
            "receive_end_time": "2019-09-12 12:00:00",          string                  M           收货结束时间
            "area": "南山区-科苑路",                                                  string                  M           地理标签
            },
        "total_price": "123.21",                                                    string                      M           下单金额(执行价)
                "origin_total_price": "123.21",                                     string                      M           下单金额(原价)
                "real_price": 12.00,                                                            string                      M           出库金额
                "sale_money_with_freight": "12.32",                             string                      M           销售额(包含运费)
                "real_refund_money": "123,32",                                      string                      M           实退金额
                "abnormal_money": "123.21",                                             string                      M           异常金额
                "request_refund_money": "1.21",                                     string                      M           应退金额
                "order_remark": [{                                                              list                            M           备注
            "allowance": "10.00",                                                       string                      M           补贴金额
            "sku_name": "白菜",                                                           string                      M           商品名
            "remark_type_id": 59,                                                       int                             M           备注类型(59: 客户沟通, 60: 补贴)
                    "text": "mi",                                                                       string                      M           描述
        }, ...]
                "abnormals": [{                                                                 string                          M           非商品异常
          "final_amount": 9,                                                        float           O           记账数
            "money_delta": "2.00",                                              string              O           金额变动
            "id": 123,                                                                      int             O           异常ID
            "type_id": 1,                                                                   int             O           异常类型ID
            "type_text": "付款问题",                                string       O       异常原因
            "text": "123",                                                              string      O           描述
        }]
                "skus": [{
            "sku_id": "D123",                                                               string                  M           skuID
            "sku_name": "白菜",                                                               string                  M           商品名
            "sku_abnormals": {
            "final_amount": 9,                                                      float           O           记账数
            "money_delta": "2.00",                                              string              O           金额变动
            "id": 123,                                                                      int             O           异常ID
            "type_id": 1,                                                                   int             O           异常类型ID
            "type_text": "未按用户时间到达",                                string       O       异常原因
            "text": "123",                                                              string      O           描述
            },
                    "refunds": {
            "id": 12122,                                                                int             O           退货ID
            "detail_id": "D123",                                                string      O           商品ID
            "type_id": 1,                                                               int             O           退货类型ID
            "type_text": "未按用户时间到达",                            string       O       退货原因
            "request_amount": 3,                                                float           O           退货数
            "text": "123",                                                          string      O           描述
            "real_amount": 1.00,                                                float           O           实退数
            "state": 2                                                                  int             O           退货状态(1: 待安排, 2:取货中, 3:已取货, 4:已入库, 5:已退货)(状态为4的不能修改)
            }
        }, ...]
        }, ...]
        }
  }