Skip to content

采购APP迭代

station

purchase_assistant/task/daily_count/get(新接口)

接口描述
    首页采购金额统计
Method
    GET
request
    days      M        int       统计的天数
response
    {
        "msg": "ok",
        "code": 0,
        "data": {
            all_purchase_sheet_num       M      int          采购单据数
            all_purchase_price           M      float        采购金额
            daily_price:[
                {
                    date                 M      datetime     日期
                    purchase_price       M      float        对应日期采购金额
                }
            ]
        }
    }
### purchase_assistant/daily_work

```
接口描述
    首页任务询价记录
Method
    GET
request

response
    {
        "msg": "ok",
        "code": 0,
        "data": {
            purchase_sheets_created         M    int   今日已创建采购单
            purchase_tasks_todo             M    int   今日待完成任务
            spus_quoted                     M    int   今日已询价商品
        }
    }
```

purchase_assistant/task/supplier_count/get(新接口)

接口描述
    首页供应商统计
Method
    GET
request
    days      M        int       统计的天数
response
    {
        "msg": "ok",
        "code": 0,
        "data": {
            all_purchase_sheet_num        M     int          采购单据数
            all_purchase_price            M     float        采购金额
            supplier_price:[
                {
                    supplier_name         M     string       供应商名称
                    purchase_price        M     int          对应询供应商采购金额
                }
            ] 
        }
    }

purchase_assistant/task_count/get

接口描述
    采购任务列表汇总信息
Method
    GET
request
    q_type                  M     int         搜索类型,1为按下单时间,2为按运营周期, 3按收货时间
    time_config_id          O     string      运营周期ID(当搜索类型为运营周期2时,必须传该参数)
    begin_time              O     datetime    查询开始时间(当包含q_type(任何值),必须传开始时间) 
    end_time                O     datetime    查询结束时间(当包含q_type(任何值),必须传结束时间)
    settle_supplier_id      O     string      供应商ID 
    status                  O     int         采购任务状态,0未完成,1已完成,2全部
response
    {
        "msg": "ok",
        "code": 0,
        "data": {
            all_task_num                          int        总任务数
            unfinish_task_num                     int        未完成任务数
        }
    }

purchase_assistant/task/search(老接口)

接口描述
    获取采购任务
Method 
    GET
request 
    q_type                  M     int         搜索类型,1为按下单时间,2为按运营周期, 3按收货时间
    time_config_id          O     string      运营周期ID(当搜索类型为运营周期2时,必须传该参数)
    begin_time              O     datetime    查询开始时间(当包含q_type(任何值),必须传开始时间) 
    end_time                O     datetime    查询结束时间(当包含q_type(任何值),必须传结束时间) 
    settle_supplier_id      O     string      供应商ID
    status                  O     int         采购任务状态,0未完成,1已完成,2全部
    sort_type               O     int         任务排序方式,1为发布时间,2为供应商,3为按商品名
    search_text             O     string      要搜索的商品名

    page_obj                O     string      起始页
    reverse                 O     int         是否反向查询。1:是,0:不是。默认为否。
    limit                   O     int         返回条数,默认10。传0表示返回所有数据。
response
    {
        "msg": "ok",
        "code": 0,
        pagination:{
            more                                              是否还有更多数据
            page_obj
        }
        "data": [                                      list       采购任务列表
                    {
                        release_id                      M     int        发布任务ID
                        spec_id                         M     string     采购规格ID
                        purchase_unit_name              M     string     采购规格单位
                        spec_name                       M     string     采购规格名称
                        purchase_sheet_id               M     string     采购单号
                        status                          M     int        发布状态, 0为未完成, 1为已完成
                        stock                           M     float      当前库存
                        purchase_amount                 M     float      已采购数量
                        plan_amount                     M     float      计划采购数量
                        release_time                    M     datetime   发布时间
                        supplier_name                   M     string     供应商名

                        (以下为新增字段)     
                        sku_name                        M     string     sku名称
                        remark                          M     string     备注汇总
                        remarks:[                       M     list       采购规格对应备注列表
                        ]      
                        suggest_purchase_num            M     float      建议采购
                        stock_avg_price                 M     float      库存均价
                        last_in_stock_price             M     float      最近入库单价      
                        last_quote_price                M     float      最近询价   
                        last_purchase_price             M     float      最近采购单价      
                        details:[                       M        
                            {      
                                order_id                M     string     关联订单号
                                res_name                M     string     商户名
                                plan_purchase_amount    M     float      计划采购
                                remark                  M     string     商品备注
                            }
                        ]
                    }
            ]

purchase_assistant/purchase_sheets(老接口)

接口描述
    采购单据列表
Method
    GET
request 
    status                              O     int         单据状态, 2为已提交, 3为编辑状态
    settle_supplier_id                  O     list        供应商ID
    sort_type                           O     int         排序方式,1为采购时间,2为供应商,3为按状态
    begin_time                          O     datetime    开始时间
    end_time                            O     datetime    结束时间

    page_obj                            O     string      起始页
    reverse                             O     int         是否反向查询。1:是,0:不是。默认为否。
    limit                               O     int         返回条数,默认10。传0表示返回所有数据。
response
    {
        "msg": "ok",
        "code": 0,
        pagination:{
            more                                 否还有更多数据
            page_obj
        }

        "data": [
            create_time                 M  datetime    采购时间
            settle_supplier_name        M  string      供应商名称
            status                      M  int         单据状态, 2为已提交, 3为编辑状态
            spec_num                    M  float       采购商品数量
            spec_money                  M  flaot       采购金额
        ]
    }

purchase_assistant/purchase_sheet_count/get

接口描述
    采购单据列表汇总信息
Method
    GET
request
    begin_time                          O     datetime    开始时间
    end_time                            O     datetime    结束时间
    settle_supplier_id                  O     list        供应商ID
    status                              O     int         单据状态, 2为已提交, 3为编辑状态
response
    {
        "msg": "ok",
        "code": 0,
        "data": {
            all_purchase_sheet_num                      int        总单据
            edit_purchase_sheet_num                     int        未提交单据
        }
    }

purchase_assistant/purchase_sheet/details(老接口)

接口描述
    采购单详情
Method
    GET
request
    sheet_no        M    采购单据号
response
    {
        "msg": "ok",
        "code": 0,
        "data": {
            purchase_sheet:{
                status                          M    int         单据状态, 2为已提交, 3为编辑状态
                supplier_name                   M    string      供应商名
                sheet_id                        M    string      采购单据号
                sku_num                         M    int         商品数
                purchase_sheet_money            M    float       采购单据金额
            }

            tasks:[
                {
                    id                          M    string     采购规格id
                    spec_id                     M    string     采购规格ID
                    already_purchased_amount    M    float      已采购数量
                    plan_amount                 M    float      计划采购数量
                    std_unit_name               M    string     基本单位
                    purchase_price              M    float      采购单价
                    purchase_amount             M    float      采购数量
                    stock                       M    float      当前库存
                    ratio                       M    float      采购单位比率     
                    suggest_purchase_num        M    float      建议采购

                    (以下为新增字段)
                    remarks:[                   M    list       采购备注
                    ]
                    sku_name                    M    string     商品名
                    remark                      M    string     备注
                    name                        M    string     采购规格名称
                    stock_avg_price             M    float      库存均价
                    last_in_stock_price         M    float      最近入库单价     
                    last_quote_price            M    loat       最近询价  
                    last_purchase_price         M    float      最近采购单价     
                    details:[
                        order_id                M    string     关联订单号
                        res_name                M    string     商户名
                        plan_purchase_amount    M    float      计划采购
                        remark                  M    string     商品备注                        
                    ]
                }
            ]
        }
    }

purchase_assistant/purchase_sheet/modify(老接口)

接口描述
    修改采购单据草稿
Method
    POST
request
    purchase_sheet_id          M    采购单ID
    settle_supplier_id         M    供应商ID
    details:[
        {
            id                 O    采购规格id
            spec_id            M    采购规格ID
            purchase_price     M    采购单价
            purchase_amount    M    采购数量(基本单位)
            purchase_quantity  M    采购数量(采购规格)
        }
    ]
response
    {
        "msg": "ok",
        "code": 0,
        "data": null
    }

purchase_assistant/purchase_sheet/submit(老接口,不修改)

接口描述
    提交采购单
Method
    POST
request
    sheet_no          M    采购单ID
response
    {
        "msg": "ok",
        "code": 0,
        "data": null
    }

purchase_assistant/purchase_sheet/create(老接口, 不修改)

接口描述
    创建采购单
Method
    POST
request
    supplier_id                M    string    供应商ID
    data:[
        {
            spec_id            M    string    采购规格ID
            purchase_price     M    float     采购单价
            purchase_amount    M    float     采购数量
        }
    ]
response
    {
        "msg": "ok",
        "code": 0,
        "data": {
            sheet_no           M    string        采购单号
        }
    }

purchase_assistant/purchase_sheet/task_create (老接口, 不修改)

接口描述
    从任务创建采购单
Method
    POST 
request
    release_ids         M    list        任务发布ID
    cycle_start_time    M    datetime    周期开始时间
    time_config_id      O    string      运营时间ID

    q_type              M    int         搜索类型,1为按下单时间,2为按运营周期, 3按收货时间
    begin_time
    end_time
response
    {
        "msg": "ok",
        "code": 0,
        "data": [               list        
            'sheet_no'          string        采购单单号
        ]
    }

purchase_assistant/supplier/get_specs (老接口, 后台改成按商品排序)

接口描述
    询价获取供应商商品
Method
    POST 
request
    supplier_id             M    string        供应商ID
    with_task               M    int           查询类型,0为全部商品,1为任务商品
response
    {
        "msg": "ok",
        "code": 0,
        "data": [      
            ...             M    按spu拼音排好序的数据
        ]
    }

purchase_assistant/settle_supplier/supply_sku (老接口, 后台改成按商品排序)

接口描述
    编辑采购单添加商品
Method
    POST 
request
    settle_supplier_id      M   string        供应商ID
response
    {
        "msg": "ok",
        "code": 0,
        "data": [      
            ...                 按spu拼音排好序的数据
        ]
    }

purchase_assistant/logout (老接口)

接口描述
    退出登录
Method
    POST 
request
    reg_id      M   string        采购员设备标识符
response
    {
        "msg": "ok",
        "code": 0,
        "data": null
    }

purchase_assistant/login (老接口)

接口描述
    退出登录
Method
    POST 
request
    reg_id      M   string        采购员设备标识符
    username    M   string        用户名
    password    M   string        密码
response
    {
        "msg": "ok",
        "code": 0,
        "data": null
    }

purchase_spec/create (老接口,增加采购规格拼音)

接口描述
    新建采购规格
Method
    POST 
request
    。。。。(不变)
response
    {
        "msg": "ok",
        "code": 0,
        "data": null
    }

purchase_spec/update (老接口,增加采购规格拼音)

接口描述
    更新采购规格
Method
    POST 
request
    。。。。(不变)
response
    {
        "msg": "ok",
        "code": 0,
        "data": null
    }

/station/task/purchase/release (后台修改发布采购任务推送消息)

接口描述
    发布采购任务
Method
    POST 
request
    。。。。(不变)
response
    {
        "msg": "ok",
        "code": 0,
        "data": null
    }

接口

计划

-- 2019-04-09  (1天)

新接口
    首页采购金额统计
    首页供应商统计

-- 2019-04-10 (1天)

修改接口
    询价获取供应商商品
    编辑采购单添加商品
    新建采购规格
    更新采购规格
新脚本
    采购规格刷入拼音数据

-- 2019-04-11 (2天)

修改接口
    获取采购任务列表
    采购任务列表汇总信息

-- 2019-04-15 (1天)

修改接口
    采购单据详情

-- 2019-04-16 (2天)

修改接口
    采购员登录、退出
    采购任务发布推送消息