Skip to content

报价单

报价单

/salemenu/sale/list 获取报价单列表1

接口:
    /salemenu/sale/list
class:
    website/salemenu/views/salemenu.py/SalemenuSaleGetView
方法:
    GET
请求:
    time_config_id          O    String        运营时间id
    type                    O    Int           报价单类型(2 代售单  4 自售单)
    is_active               O    Int           报价单状态(1 以激活  0 未激活)
    q                       O    String        搜索关键字(报价单id/报价单名称)
    has_cms_key_salemenu    O    Bool          获取当前 cms_key 所绑定的所有激活的报价单
响应:
    code              M    Int           状态码
    msg               M    String        状态消息
    data              M    List<Dict>    响应数据
        [
            {
                desc               M    String    报价单描述
                id                 M    String    报价单id
                is_active          M    Int       报价单状态
                name               M    String    报价单名称
                sku_num            M    Int       商品数量
                supplier_name      M    String    报价单名称(对外)
                time_config_name   M    String    运营时间名称
                type               M    Int       报价单类型
            },
            ...
        ]

示例:
    请求:
        {
            time_config_id: ST1748
            type: 4
            is_active: 1
            q: 
        }
    响应:
        {
            code: 0,
            msg: "ok",
            data:
                [
                    {
                        desc: ""
                        id: "S18317"
                        is_active: true
                        name: "zqltest"
                        sku_num: 4
                        supplier_name: "小东家"
                        time_config_name: "午市"
                        type: 4
                    },
                    ...
                ]
        }
说明:
    参数 has_cms_key_salemenu 获取station对应的cms_key下对应的所有的station的激活状态的销售报价单

/salemenu/list 获取报价单列表2 待补充

接口:
    /salemenu/list
class:
    website/salemenu/views/salemenu.py/SalemenuListGetView
方法:
    POST
请求:

响应:

示例:
    请求:

    响应:

说明:
    这个接口和上面那个接口都是获取报价单,但是需求的参数和返回的响应不同,现在页面的调用的是上面的接口,并未找到此接口的调用

/salemenu/sale/detail 获取销售单详情

接口:
    /salemenu/sale/detail
class:
    website/salemenu/views/salemenu.py/SalemenuSaleDetailView
方法:
    GET
请求:
    id      M    Int       活动id
响应:
    code    M    Int       状态码
    msg     M    String    状态消息
    data    M    Dict      响应数据
        {
            id                  M    String        报价单id
            type                M    Int           报价单类型
            is_active           M    Bool          是否处于激活状态
            name                M    String        报价单名称
            supplier_name       M    String        报价单名称(对外)
            targets             M    List<Dict>    销售对象
                [
                    {
                        id      M    String        站点id     
                        name    M    String        站点名称
                    }
                ]
            time_config         M    Dict          运营时间
                {
                    id                            M    String    运营时间id 
                    name                          M    String    运营时间名称
                    final_distribute_time         M    String    最晚配送时间
                    final_distribute_time_span    M    Int       最晚配送时间是否跨天
                    order_time_limit              M    Dict      可下单时间段
                        {
                            e_span_time           M    Int       结束时间是否跨天
                            end                   M    String    结束时间
                            start                 M    String    开始时间
                        }
                    receive_time_limit            M    Dict      收货时间限制
                        {
                            e_span_time           M    Int       结束时间是否跨天
                            end                   M    String    结束时间
                            receiveEndSpan        M    Int       收货时间的跨天数
                            receiveTimeSpan       M    String    收获时间选项的时间间隔(分钟)
                            s_span_time           M    Int       开始时间是否跨天
                            start                 M    String    开始时间
                            weekdays              M    Int       收货星期
                        }
                }
        }
示例:
    请求:
        {
            id: S21757
        }
    响应:
        {
            code: 0,
            msg: "ok",
            data:
                {

                    about: ""
                    id: "S21757"
                    is_active: true
                    name: "2323"
                    supplier_name: "23232"
                    targets: 
                        [
                            {
                                id: "T7453"
                                name: "[去采购报价单] 分仓一"
                            }
                        ]                    
                    time_config: 
                        {
                            final_distribute_time: "23:30"
                            final_distribute_time_span: 0
                            id: "ST662"
                            name: "预售运营时间"
                            order_time_limit:
                                {
                                    e_span_time: 0
                                    end: "23:30"
                                    start: "03:30"
                                }
                            receive_time_limit:
                                {
                                    e_span_time: 1
                                    end: "09:30"
                                    receiveEndSpan: 1
                                    receiveTimeSpan: "15"
                                    s_span_time: 0
                                    start: "09:30"
                                    weekdays: 127
                                }
                        }         
                    type: 4
                }
        }
说明:
    final_distribute_time_span, e_span_time,s_span_time 这三个字段的是否跨天的比较基准是下单时间

/salemenu/sale/targets 获取销售对象

接口:
    /salemenu/sale/targets
class:
    website/salemenu/views/salemenu.py/SalemenuSaleTargetsView
方法:
    GET
请求:
    无
响应:
    code    M    Int             状态码
    msg     M    String          状态消息
    data    M    List<Dict>      销售对象列表   
        [
            {
                id      M    String    站点id
                name    M    String    站点名称
            },
            ...
        ]
示例:
    请求:
        无
    响应:
        {
            code: 0,
            msg: "ok",
            data:
                [
                    {
                        id: "T26768"
                        name: "喵test分仓"
                    },
                    ...
                ]
        }
说明:

/salemenu/sale/create 新建报价单

接口:
    /salemenu/sale/create
class:
    website/salemenu/views/salemenu.py/SalemenuSaleCreateView
方法:
    POST
请求:
    name                   M    String          报价单名称
    supplier_name          M    String          报价单名称(对外)
    about                  M    String          报价单喵上
    is_copy_salemenu       M    Bool            是否复制现有销售单
    time_config_id         M    Int             运营时间id
    is_active              M    Bool            是否激活
    targets                M    List<String>    销售对象列表
        [
            id             M    String          站点id
        ]
    copy_salemenu_id       O    String          复制报价单id
响应:
    code                   M    Int             状态码
    msg                    M    String          状态消息
    data                   M    Dict            响应数据
        {
            async          M    Int             是否异步复制 0 否 1 是
            salemenu_id    M    String          报价单id
        }
示例:
    请求:
        {
            name: 11223344
            supplier_name: 556677
            about: 这是一个测试
            is_copy_salemenu: true
            time_config_id: ST980
            is_active: 1
            targets: ["T40279"]
            copy_salemenu_id: S13144
        }
    响应:
        {
            code: 0,
            msg: "ok"
            data:
                {
                    async: 0
                    salemenu_id: "S22004"
                }
        }
说明:

/salemenu/sale/update 更新报价单基础数据

接口:
    /salemenu/sale/update
class:
    website/salemenu/views/salemenu.py/SalemenuSaleUpdateView
方法:
    POST
请求:
    id                M    Int            报价单id
    name              M    String         报价单名称
    supplier_name     M    String         报价单名称(对外)
    about             O    String         报价单描述
    time_config_id    M    String         运营时间id
    targets           O    List<String>   销售目标列表
        [
            id        O    String         销售目标id
        ]
    is_active         M    Int            报价单状态
响应:
    code    M    Int       状态码
    msg     M    String    状态消息
    data    M              响应数据    
示例:
    请求:
        {
            id: S18317
            name: zqltest
            supplier_name: 小东家
            about: aaaaaaa
            time_config_id: ST1748
            targets: ["T26768","T27803"]
            is_active: 1
        }
    响应:
        {
            code: 0,
            msg: "ok",
            data: null
        }
说明:

/salemenu/sale/delete 删除报价单

接口:
    /salemenu/sale/delete
class:
    website/salemenu/views/salemenu.py/SalemenuSaleDeleteView
方法:
    POST
请求:
    id               M    Int       报价单id
响应:
    code             M    Int       状态码
    msg              M    String    状态消息
    data             M    Dict      响应数据 
        {
            async    M    Int       是否异步删除
        }
示例:
    请求:
        {
            id: S22004
        }
    响应:
        {   
            code: 0,
            msg: "ok",
            data:
                {
                    async: 1    
                }
        }
说明:
    删除按钮在详情页面

/salemenu/sale/default 获取默认报价单

接口:
    /salemenu/sale/default
class:
    website/salemenu/views/salemenu.py/SalemenuDefaultSaleView
方法:
    GET
请求:
    无
响应:
    code    M    Int       状态码
    msg     M    String    状态消息
    data    M    Dict      响应数据  
        {
            default_salemenu_id      M   String    默认报价单id
            default_salemenu_name    M   String    默认报价单名称
            station_id               M   String    站点id
            station_name             M   String    站点名称
        }
示例:
    请求:
        无
    响应:
        {
            code: 0,
            msg: "OK",
            data: 
                {
                    default_salemenu_id: "S10043"
                    default_salemenu_name: "蔬菜报价单"
                    station_id: "T17188"
                    station_name: "喵test"
                }
        }
说明:

/salemenu/settle_suppliers 获取当前站点的结算供应商

接口:
    /salemenu/settle_suppliers
class:
    website/salemenu/views/salemenu.py/SalemenuPurchaseUpdateView
方法:
    GET
请求:
    无
响应:
    code    M    Int             状态码
    msg     M    String          状态消息
    data    M    List<Dict>      响应数据   
        [
            {
                id      M    String    供应商站点id
                name    M    String    站点名称
            },
            ...
        ]
示例:
    请求:
        无
    响应:
        {
            "code": 0,
            "msg": "ok",
            "data": 
                [
                    {
                        "name": "肉类报价单CV",
                        "id": "T10885"
                    },
                    ...
                ]
        }
说明:
    页面上未找到调用,上述示例为 postman 的数据(应该也是被弃用的接口)

采购报价单 -- 弃用接口

采购报价单目前已不再使用,代码中虽有保留,但不再更新接口信息

一共包含 4 个接口,具体如下:
    /salemenu/purchase/list      采购报价单列表
    /salemenu/purchase/detail    采购报价单详情
    /salemenu/purchase/create    创建采购报价单
    /salemenu/purchase/update    更新采购报价单
以前的接口文档位置:
    模块文档 -> station模块 -> 接口 -> 销售单接口