配送区域设置
商家配送要按区域收配送费,快递发货要判断哪些省市区能寄,前提都是先有一份行政区划字典。配送区域设置维护省 / 市 / 地区 / 街道四级区域树与各级配送费用,并提供按省市批量导入区县的入口——开一座新城时,不必逐个手工敲区县名称。
一、功能概述
菜单位置:O2O业务 → 微信商城 → 配送区域设置(页面地址 /admin/o2o/wxarea/)

| 用途 | 说明 |
|---|---|
| 建区域字典 | 省 / 市 / 地区 / 街道四级树,最多 4 级 |
| 批量导入区县 | 「导入」按省 → 市选择后勾选区县,一次写入缺失的区域行 |
| 定区域配送费 | 每个区域可单独填「配送费用」,作为区域维度的配送费口径 |
| 供快递模板勾选 | 快递发货设置 的「区域设置」树取本页省 / 市 / 地区三级数据 |
区域树默认全部展开,方便直接看到区县与街道。街道级不在批量导入范围内,需要时在表单里逐条新增。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 列表工具栏 | 新增、导入、导出、回收站、打印,树形列表另有 ▼ 展开全部 |
| 列表列 | 本级编号、区域名称、层级、配送费用、使用标志 |
| 树形结构 | 按「上级编号」挂父子,省级为根节点;默认展开全部层级 |
| 进入编辑 | 点「区域名称」打开编辑页 |
| 搜索与排序 | 搜索覆盖区域名称;列表按本级编号排序 |
| 分页 | 底部显示「共 N 条」「共 N 页」,每页可选 10 / 20 / 30 / 50 / 100 / 200 条 |
编辑页只有一个分组区域信息(三列排布):
| 字段 | 界面提示 |
|---|---|
| 本级编号 | 只读,「新增时自动发号;子级区域请填上级编号」 |
| 上级编号 | 「填上级区域的“本级编号”;留空或 0 为省级」 |
| 区域名称 | 必填 |
| 配送费用 | 金额,两位小数 |
| 层级 | 只读,「按上级区域自动计算」 |
| 助记码 | 辅助检索码 |
「导入」按钮按新增权限显示,点击后在新窗口打开导入区域页;顶部工具栏为返回、保存(下拉含「保存并继续编辑」「保存并新增下一个」「保存并返回列表」)、取消、刷新、上一行、下一行、历史版本、删除。
三、业务操作步骤
步骤 1:批量导入省市区县
- 点工具栏「导入」,新窗口标题为「导入区域」,提示语为「按省 / 市选择后勾选区县导入;已存在的区域编号自动跳过」。
- 「省份」下拉选省(未选时显示「请选择」),再选「城市」。
- 下方「区县(可多选)」列出该市的区县,勾选需要的项。
- 点「导入」,成功回显「已导入 N 个区域」;点「关闭」退出窗口,回列表刷新即可看到新行。
过程中的提示与空态:
- 未选省市就点导入:「请选择省份和城市」
- 未勾选区县:「请至少勾选一个区县」
- 只选了省、未选市时区县区显示「请先选择城市」;未选省时显示「请先选择省份和城市」
- 该市没有可导入数据:「该城市暂无可导入的区县」
- 未配置地图 Key 时页面给出警告:「未配置高德地图 Key,无法获取行政区划数据。请在系统选项 Opt_SysInfo / TWXOption / GaoDeJSAK_v2 中配置后重试。」
导入按省 → 市 → 区县的顺序写入,父级先落库;本级编号已存在的行自动跳过,因此重复导入不会产生重复区域,也不会覆盖已填的配送费用。导入行的配送费用为空,需要按区域另行填写。
步骤 2:手工新增一个区域(含街道)
- 点「新增」,「本级编号」由系统自动发号,不用填。
- 填上级编号:写上级区域的「本级编号」;留空或填 0 表示省级。
- 填区域名称,按需填配送费用。
- 保存后「层级」按上级自动算出:上级为省则本级为市,依此类推。
- 超过四级时保存被拦下,提示「区域层级超过 4 级(省/市/地区/街道),无法保存」。
步骤 3:维护区域配送费
打开区域记录,改「配送费用」后保存。填负数会提示「请输入大于等于0的值!」。区域维度的配送费与门店维度的配送费是两套口径:门店的「配送费」「阶梯配送费」在提货门店设置 维护,小程序端最终取哪一个以现场版本的结算逻辑为准,配置后建议下一单核对。
步骤 4:删除与还原
编辑页点「删除」,确认框为「确认删除该记录?此操作不可恢复。」;删除属于逻辑删除,记录进「回收站」,在回收站行尾「操作」列点「还原」并确认「确定要还原这条记录吗?」,成功提示「记录已还原」。已被快递模板勾选的区域删除后,模板侧的可配送区域需要重新核对。
四、字段详细说明
落库表 WX_Area。真实主键为区域ID(fSysId),新增时按当前最大值加一自动发号;界面与树形父子关系用的是本级编号(fCode)。
| 界面字段 | 落库字段 | 含义与取值 |
|---|---|---|
| 本级编号 | fCode | 只读,自动发号;子级区域的「上级编号」填的就是这个值 |
| 上级编号 | fParentId | 上级区域的本级编号;留空或 0 为省级 |
| 区域名称 | fName | 必填,长度 100 |
| 层级 | fLevel | 只读,按上级自动计算,取值见下表 |
| 配送费用 | fPost_fee | 区域维度配送费,两位小数,不小于 0 |
| 助记码 | ZJM | 辅助检索码 |
| 使用标志 | SignUsed | 档案使用状态,网页端只读,由框架维护 |
| 修改标志 | SignModify | 导入写入的行置 1,便于区分来源 |
| 删除标志 | SignDelete | 逻辑删除标志,为 1 的记录进回收站 |
层级取值:
| 代码 | 层级名称 |
|---|---|
| 1 | 省 |
| 2 | 市 |
| 3 | 地区 |
| 4 | 街道 |
五、典型使用场景
场景一:新城市开城。 先「导入」该省该市的区县,再按区县填配送费用;街道级只在需要精细划分时手工补,避免一开始就把树建得过深。
场景二:按区差异化配送费。 市中心各区填较低配送费,远郊区填较高值,会员在小程序选地址后按区域口径计费。
场景三:给快递模板准备可选区域。 快递发货设置只取省 / 市 / 地区三级,所以寄递范围要在这三级上建全;街道级不参与快递模板勾选。
场景四:区域名称写错要改。 直接改「区域名称」即可,本级编号不变,子级与快递模板的勾选关系不受影响。
六、权限控制与前置条件
- 本页属于网页端新增的商城配置菜单,权限映射表里没有对应的老 ERP 菜单项,登录网页后台即可进入;数据按当前账套隔离。
- 「导入」按钮按新增权限显示;批量导入依赖高德地图行政区划服务,需要先在系统选项
Opt_SysInfo的TWXOption中配置GaoDeJSAK_v2(及配套的GaoDeJS_safeSkey_v2安全密钥)。Key 由实施或系统管理员配置,不在本页填写,也不要把 Key 值写进对外资料。 - 区域字典是快递发货设置 的前置数据:没有区域行,模板的「区域设置」树就无可勾选项。
- 门店配送范围与坐标在提货门店设置 维护,与本页的区域字典是两件事。
七、常见问题
问:点「导入」后省市下拉是空的? 答:页面会给出未配置高德地图 Key 的警告。按警告里的选项名联系管理员配置后重试;已配置但仍为空时,检查网络能否访问高德服务。
问:重复导入同一批区县会不会重复建? 答:不会。本级编号已存在的行自动跳过,回显的「已导入 N 个区域」只统计本次新写入的行数。
问:填了上级编号,层级却显示为市? 答:上级编号要在字典里真实存在。找不到对应区域时,系统按第二级处理,因此保存后请核对「层级」列与树形挂载位置是否正确。
问:想建第五级细分片区? 答:层级上限为四级(省/市/地区/街道),超出会提示「区域层级超过 4 级(省/市/地区/街道),无法保存」。更细的划分建议用门店配送范围的多边形区域实现,见提货门店设置。
问:配送费用填了,小程序运费没变? 答:区域配送费与门店配送费、快递运费模板是不同口径。先确认订单走的是商家配送还是快递发货,再核对门店侧配送费与模板运费;快递运费在快递发货设置 维护。
