微信会员及商城通告
新店开业、充值有礼、大促预告这类消息,需要在小程序里按时间段挂给会员看。微信会员及商城通告就是这份通告台账:写内容、定起止时间、控发布状态,还能指定哪些分店参与,让总部统一发声、门店按范围露出。
一、功能概述
菜单位置:O2O业务 → 微信商城 → 微信会员及商城通告(页面地址 /admin/o2o/wxannounce/)

| 用途 | 说明 |
|---|---|
| 写通告内容 | 一段文字,最多 250 个汉字 |
| 定生效区间 | 开始时间、结束时间成对维护,区间外不展示 |
| 控发布状态 | 状态分「未发布」「已发布」,可先写好再发布 |
| 指定参与分店 | 「参与分店」页签按门店挑选,通告只在所选门店范围内生效 |
| 留发布痕迹 | 新增时自动记录发布人与创建时间 |
本页是主从结构:主记录是通告本身,从表记录参与分店。通告类型沿用老 ERP 的口径,现场可选代码以实际版本为准(见第四章说明)。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 列表工具栏 | 新增、导出、回收站、打印(打印为分裂按钮,下拉里有「打印模板管理」) |
| 列表列 | 通告类型、通告内容、状态、开始时间、结束时间、发布人 |
| 进入编辑 | 点「通告内容」打开编辑页 |
| 搜索与排序 | 搜索覆盖通告内容、发布人;列表按通告ID排序 |
| 分页 | 底部显示「共 N 条」「共 N 页」,每页可选 10 / 20 / 30 / 50 / 100 / 200 条 |
编辑页只有一个分组通告内容(两列排布):通告类型、状态、开始时间、结束时间,以及整行的多行文本「通告内容」。
主表单下方是「明细」区块里的参与分店页签:列为分店编号(下拉选择)、编号(只读)、名称(只读);按钮为「添加行」「保存」,行尾有「删除」,没有数据时显示「暂无明细」。顶部工具栏为返回、保存(下拉含「保存并继续编辑」「保存并新增下一个」「保存并返回列表」)、取消、刷新、上一行、下一行、历史版本、删除。
三、业务操作步骤
步骤 1:新增一条通告
- 点「新增」,在「通告内容」里写消息文字。
- 设开始时间与结束时间(日期时间选择器)。
- 按需填通告类型与状态;留空时系统按默认值处理:类型 1、状态 1、开始时间为当天 00:00、结束时间为同年 12 月 31 日。
- 点「保存」。发布人自动取当前登录用户,创建时间自动取当前时间。
内容与时段的校验提示:
- 内容为空:「[消息内容]不能为空!」
- 内容超长:「不能超过250个汉字」
- 时间不合法:「开始时间不能大于等于截止时间!」
步骤 2:指定参与分店
- 先保存主记录——未保存时页签提示「请先保存修改内容,再修改参与分店。」。
- 在「参与分店」页签点「添加行」,「分店编号」下拉里选门店,选项显示为「编号 名称」,编号与名称两列自动带出且只读。
- 下拉候选只包含未删除、且尚未添加到本通告的分店,因此不会重复选到同一家。
- 点页签里的「保存」,成功回显「保存成功」;读取异常时提示「读取明细失败」。
页签校验提示:未选门店「请选择参与分店」;同一门店重复添加「不允许重复添加同一分店」。不需要的行点行尾「删除」后再保存。
步骤 3:发布与下线
- 先写后发:新增时把状态置为未发布(代码 0),内容与时段核对好再改为已发布(代码 1)。
- 到期自动结束:结束时间过后通告不再处于生效区间,无需手工删除。
- 提前下线:把状态改为未发布,或把结束时间提前到当前时间之前。
步骤 4:删除与还原
编辑页点「删除」,确认框为「确认删除该记录?此操作不可恢复。」;删除属于逻辑删除,记录进「回收站」,在回收站行尾「操作」列点「还原」并确认「确定要还原这条记录吗?」,成功提示「记录已还原」。
四、字段详细说明
落库表 WX_Announce,主键为通告ID(fAnnounceId);参与分店落 WX_AnnounceFiliale。
| 界面字段 | 落库字段 | 含义与取值 |
|---|---|---|
| 通告类型 | fAnnounceType | 按代码填写,列表显示代码;档案中登记的名称为「商城通告」(代码 1),新增留空默认 1 |
| 通告内容 | fContent | 字段长度 500,但保存校验按不超过 250 个汉字执行 |
| 状态 | fState | 0 未发布 / 1 已发布;新增留空默认 1 |
| 开始时间 | fBeginTime | 生效起点,新增留空默认当天 00:00 |
| 结束时间 | fEndTime | 生效终点,必须晚于开始时间;新增留空默认同年 12 月 31 日 |
| 发布人 | fDefManName | 新增时自动取当前登录用户姓名 |
| 创建时间 | fCreateTime | 新增时自动写入当前时间 |
| 参与分店 | WX_AnnounceFiliale.fFilialeID | 按通告ID归属,关联分店档案带出编号与名称 |
关于通告类型:老 ERP 的类型枚举未在迁移资料中给全,网页端按代码录入与展示,现场数据里存在代码 1 以外的取值。新增时建议参照现场已有同类通告的代码填写,具体代码含义以现场版本为准;状态列在列表里显示中文(未发布 / 已发布),编辑页按代码填写。
五、典型使用场景
场景一:新店开业通告。 写开业与充值有礼的消息,开始时间设开业当天 00:00,结束时间设活动末日,参与分店只勾新店,其他门店不受影响。
场景二:大促预告定时上下线。 提前写好预告并置为未发布,活动开始前改为已发布;大促结束由结束时间自动收尾,不必人工守着删。
场景三:总部统一话术、分店分别露出。 同一条消息按门店范围发布,避免各店自行编写造成口径不一致;需要调整范围时改「参与分店」页签即可。
场景四:临时公告快速撤回。 消息有误时把状态改为未发布或提前结束时间,比删除更稳妥,历史记录与发布人仍可追溯。
六、权限控制与前置条件
- 本页属于网页端新增的商城配置菜单,权限映射表里没有对应的老 ERP 菜单项,登录网页后台即可进入;数据按当前账套隔离。
- 参与分店依赖分店档案:门店需先在分店管理 建好且未删除,才会出现在下拉候选里;门店的商城接入见提货门店设置。
- 维护「参与分店」前必须先保存主记录。
- 发布人取当前登录账号,建议用专人账号发布,便于追溯;账号维护见用户管理。
七、常见问题
问:提示「不能超过250个汉字」,但字段看起来还能写更多? 答:字段长度与校验口径不同,保存按 250 个汉字上限执行。长消息建议拆成多条通告,或精简为要点加活动时间。
问:保存提示「开始时间不能大于等于截止时间!」? 答:结束时间必须晚于开始时间,两者相等也不行。跨天活动把结束时间设到末日较晚的时刻即可。
问:通告类型该填什么代码? 答:类型枚举沿用老 ERP 口径,资料未给全。参照现场已有同类通告的代码填写,或留空按默认值 1 处理;含义以现场版本为准。
问:「参与分店」页签点不动? 答:主记录还没保存。先点顶部「保存」,再回到页签添加行;页签会提示「请先保存修改内容,再修改参与分店。」。
问:通告保存了,小程序里看不到? 答:按三处核对——状态是否为已发布、当前时间是否落在开始与结束时间之间、参与分店是否包含该门店。都正常时退出重进小程序刷新一次,展示时机以现场小程序版本为准。
问:同一家门店能加两次吗? 答:不能。下拉候选已排除添加过的门店,手工重复提交会提示「不允许重复添加同一分店」。
