促销模块接口整理

1. 促销列表

1.1 促销列表查询

入参

• 活动开始日期（e.g: '2018/12/24 16:30:01'） dateStart: string
• 活动结束日期（e.g: '2018/12/24 16:30:01'） dateEnd: string
• 经销商id did: string
• 关键字类型 keyWordName: string
• 关键字内容 keyWordContent: string
• 订单状态（状态码目前有三种——0：全部，1：正常，2：停用） status: string

出参
返回促销列表（[item_1, item_2, ... , item_n]） : array。数组每个元素对应一个促销活动，以下是一个促销活动包含的字段。

• 活动开始日期 begin_date: string
• 活动结束日期 end_date: string
• 促销编码 cx_id: string
• 促销名称 cx_name: string
• 促销模板（当前促销分类标签：套餐赠送（'mz'）、买套餐赠任选、买套餐满减、自由套餐组赠任选。） cx_cate: string
• 促销状态（1：正常，2：停用） status
• 创建时间（e.g: "2018/12/24 16:30:01"） insdt: string
• 备注 remark: string

2. 促销详情展示页面

2.1 促销详情数据查询

入参

{
    cx_id: 'xxx' // 促销活动id
}

出参
暂定：返回促销创建页面提交所有数据字段

2.2 促销核销政策查询

入参

{
    cx_id: 'xxx' // 促销活动id
}

出参

// 返回该促销活动对应的核销政策 e.g:
{
    hxzc_id: 'xxxxx',
    hxzc_name: '核销政策1'
}

2.3 促销核销政策修改

入参

{
    cx_id: 'xxx', // 促销活动id
    hxzc_id: 'xxxxx', // 新的核销政策id
}

出参

{
    code: 200, // 状态码
    msg: '修改成功'
}

2.4 选择门店-分页查询

入参

{
    cx_id: 'xxx', // 促销活动id
    customer_cate: ['xxx_1', ... , 'xxx_n'], // 门店类型数组，
    keywords: 'xxxx_key', // 查询输入的关键字
    pageNum: '1', // 请求页码
    pageSize: '20', // 分页尺寸
}

出参

{
    total: '851',
    rows: [
        {
            'customer_id': 'xxxx', // 客户编号
            'customer_name': '上市里百货', // 门店名称
            'linkman': '张三', // 联系人
            'tel': '15123456677', // 联系电话
            'addr': '烟台开发区中信大厦4楼', // 地址
        },
        ...

    ]
}

2.5 选择门店-选中客户类型下全部门店列表查询

入参

{
    cx_id: 'xxx', // 促销活动id
    customer_cate: ['xxx_1', ... , 'xxx_n'], // 门店类型数组，
}

出参

{
    total: '851',
    rows: ['xxx_1_id', ... , 'xxx_n_id'] // 选中门店类型下所有门店id组成的列表
}

2.6 选择门店-客户类型查询

入参

{
    cx_id: 'xxx', // 促销活动id
}

出参

[
    {
        cate_id: 'xxx', // 客户类型id
        cate_name: 'A_大卖场', // 客户类型名称
    },
    ...

]

2.7 促销详情-促销活动信息查询

入参

{
    cx_id: 'xxx', // 促销活动id
}

出参

{
    hxzc_id: 'xxxx', // 核销政策id
    hxzc_name: '欣和味达美周年庆', // 核销政策名称
    cx_name: '味达美贺新年', // 促销名称
    customer_checked_type: '2', // 选择门店方式，1-表示全部门店，2-表示选择自定义门店
    customer_checked_cates: ['cate_1_id', ... , 'cate_n_id'], // 已选中门店类型
    customer_checked: ['customer_1_id', ... , 'customer_n_id'], // 已选中门店列表
    cx_date_begin: '2018/12/24 16:30:01', // 活动开始时间
    cx_date_end: '2018/12/30 16:30:01', // 活动结束时间
    cx_apps: [
        {
            label: 'app_1_label', // 推送应用名字
            id: 'app_1_id', // 推送应用id
        }
        ...

    ],
    cx_description: '这是一个年末的促销活动', // 促销活动备注
    mainpro_groups: [
        // 一个主品商品组信息
        [
            {
                matnr: "MM10459555", // 商品编码
                maktx: "1.8L味达美冰糖老抽酱油/1×6", // 商品名称
                i_count: 1, // 本促销主品组中该商品数量
                f_unit: "箱", // 促销单位
                fixed_price: "94.02", // 促销价格
            },
            ...

        ],
        ...

    ],
    
    

}