Skip to content

配送区域设置 ​

商家配送要按区域收配送费,快递发货要判断哪些省市区能寄,前提都是先有一份行政区划字典。配送区域设置维护省 / 市 / 地区 / 街道四级区域树与各级配送费用,并提供按省市批量导入区县的入口——开一座新城时,不必逐个手工敲区县名称。

一、功能概述 ​

菜单位置:O2O业务 → 微信商城 → 配送区域设置(页面地址 /admin/o2o/wxarea/)

配送区域设置列表:表格列为本级编号、区域名称、层级、配送费用、使用标志、_parent

用途说明
建区域字典省 / 市 / 地区 / 街道四级树,最多 4 级
批量导入区县「导入」按省 → 市选择后勾选区县,一次写入缺失的区域行
定区域配送费每个区域可单独填「配送费用」,作为区域维度的配送费口径
供快递模板勾选快递发货设置 的「区域设置」树取本页省 / 市 / 地区三级数据

区域树默认全部展开,方便直接看到区县与街道。街道级不在批量导入范围内,需要时在表单里逐条新增。

二、界面布局说明 ​

区域内容
列表工具栏新增、导入、导出、回收站、打印,树形列表另有 ▼ 展开全部
列表列本级编号、区域名称、层级、配送费用、使用标志
树形结构按「上级编号」挂父子,省级为根节点;默认展开全部层级
进入编辑点「区域名称」打开编辑页
搜索与排序搜索覆盖区域名称;列表按本级编号排序
分页底部显示「共 N 条」「共 N 页」,每页可选 10 / 20 / 30 / 50 / 100 / 200 条

编辑页只有一个分组区域信息(三列排布):

字段界面提示
本级编号只读,「新增时自动发号;子级区域请填上级编号」
上级编号「填上级区域的“本级编号”;留空或 0 为省级」
区域名称必填
配送费用金额,两位小数
层级只读,「按上级区域自动计算」
助记码辅助检索码

「导入」按钮按新增权限显示,点击后在新窗口打开导入区域页;顶部工具栏为返回、保存(下拉含「保存并继续编辑」「保存并新增下一个」「保存并返回列表」)、取消、刷新、上一行、下一行、历史版本、删除。

三、业务操作步骤 ​

步骤 1:批量导入省市区县 ​

  1. 点工具栏「导入」,新窗口标题为「导入区域」,提示语为「按省 / 市选择后勾选区县导入;已存在的区域编号自动跳过」。
  2. 「省份」下拉选省(未选时显示「请选择」),再选「城市」。
  3. 下方「区县(可多选)」列出该市的区县,勾选需要的项。
  4. 点「导入」,成功回显「已导入 N 个区域」;点「关闭」退出窗口,回列表刷新即可看到新行。

过程中的提示与空态:

  • 未选省市就点导入:「请选择省份和城市」
  • 未勾选区县:「请至少勾选一个区县」
  • 只选了省、未选市时区县区显示「请先选择城市」;未选省时显示「请先选择省份和城市」
  • 该市没有可导入数据:「该城市暂无可导入的区县」
  • 未配置地图 Key 时页面给出警告:「未配置高德地图 Key,无法获取行政区划数据。请在系统选项 Opt_SysInfo / TWXOption / GaoDeJSAK_v2 中配置后重试。」

导入按省 → 市 → 区县的顺序写入,父级先落库;本级编号已存在的行自动跳过,因此重复导入不会产生重复区域,也不会覆盖已填的配送费用。导入行的配送费用为空,需要按区域另行填写。

步骤 2:手工新增一个区域(含街道) ​

  1. 点「新增」,「本级编号」由系统自动发号,不用填。
  2. 填上级编号:写上级区域的「本级编号」;留空或填 0 表示省级。
  3. 填区域名称,按需填配送费用。
  4. 保存后「层级」按上级自动算出:上级为省则本级为市,依此类推。
  5. 超过四级时保存被拦下,提示「区域层级超过 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 级(省/市/地区/街道),无法保存」。更细的划分建议用门店配送范围的多边形区域实现,见提货门店设置。

问:配送费用填了,小程序运费没变? 答:区域配送费与门店配送费、快递运费模板是不同口径。先确认订单走的是商家配送还是快递发货,再核对门店侧配送费与模板运费;快递运费在快递发货设置 维护。