简介：ZenCart作为开源电商平台，多地区多运费配置是跨境运营的关键环节。这份Word文档面向店铺管理员和开发人员，系统讲解基于分区（shp1、shp2）的国家指定、阶梯重量运费规则（如0.5:20,1:30,2:40）及默认“世界其他地区”兜底策略，并附后台路径与结算测试建议，帮助读者快速落地区域化运费方案。包内共1个doc文件，整体大小仅102KB，内容精炼、步骤分明，适合按图索骥操作。目前已有78人学习，可作为配置ZenCart运费模块的速查手册。文档从分区创建到前端展示均给出可执行细节，还涵盖固定金额与按价值百分比的计算逻辑，便于后续按物流费率或季节活动灵活调整，兼顾成本控制与购物体验。
1. 多地区多运费是“拆区域”，不是“多装几个运费插件”
站点只对接一家快递，按国家却要分出国内、港澳台、欧美三套价格。后台翻遍 Flat、Table、Item 三个运费模块，发现每个模块只有一个 Shipping Zone 下拉，填了 A 区就照顾不到 B 区。ZenCart 的运费体系其实从来没被限制成“一个模块一种价格”，它提供的是地理区域定义与运费表的组合：先在 Zone 里把地区拆干净，再让 Zone Rates 这类模块按命中地区加载对应费率。下面按这条链路走：先讲 Zone 定义和模块的绑定模型，再落到 Zone Rates 的配置操作，然后处理多模块并存与兜底，最后给一套上线前校验费率的方法。适合不想改 PHP 的运营，也适合准备二次开发的工程师先画清地图。
2. 先把地区拆干净：ZenCart Zone 定义与运费模块的对应关系
2.1 ZenCart 的 Zone 是什么：国家+州的集合
ZenCart 的 Zone（官方叫 Geo Zone）在中文文档里经常被误当成“州/省”理解。它实际是“国家+州”的集合：把一个或多个国家，甚至某个国家下的部分州/省组合起来，形成一组交货地址。后台入口固定在 Locations/Taxes → Zones，页面里先添加 Zone Definition（名称和描述），再把这个 Zone 里包含的国家逐个加进去。勾选国家后还可以进一步限定州，粒度足以覆盖“中国大陆”“港澳台”这类按行政区或按地区自定义的配送范围。
运费模块里那个 Shipping Zone 下拉引用的正是这套定义。模块设置成“Domestic CN”之后，只有收货地址落进该 Zone 的订单，才会在本模块内计费；地址不匹配时模块静默跳过，不报错，不参与运费展示。理解这个机制之后就明白，多地区多运费的实现思路不是到处写 if 判断国家，而是先建好“地址集合”，再把计费规则挂上去。
2.2 最小操作：在后台建出两个可用的运费 Zone
业务上通常至少维护三个 Zone：一个是默认国家（国内件），一个是高成本地区（国际件），一个是兜底区域。下面以“国内”“国际”两个 Zone 为例，走一遍后台完整流程：
- 登录 ZenCart 管理后台，打开 Locations/Taxes → Zones。
- 点击 New Zone（部分版本叫 Add Zone），填写 Zone Name，例如 CN Domestic，Description 写“国内订单区域”，保存。
- 回到 Zones 列表打开刚建的记录，点击 Add Country，先勾选中国；如果要按州细分，再勾选该国家下对应的州或省。
- 按同样方式创建 Overseas 国际区域，选择其它需要覆盖的国家列表。
- 记录列表里显示出的 Zone ID（geo_zone_id），后面写校验 SQL、配置第三方运费模块时都会用到。
提示：运费 Zone 与税务 Zone 可以共用定义。税务模块里已经在用的“国内”Zone，运费模块可以直接引用，不必重复创建。
建好的 Zone 只代表“地址集合”，不含价格。价格由运费模块在地址命中后，从各自费率表里读取。所以第 2.3 节先看模块和 Zone 之间到底有哪几种组合关系，再动手配置。
2.3 模块与 Zone 的四种绑定形态
ZenCart 对模块与 Zone 的绑定比多数新版电商系统宽松：一个模块可以绑定一个 Zone，一个 Zone 也可以同时被多个模块命中。先看清这四种形态，容易在画方案时少绕弯：
| 形态 | 后台操作 | 命中后的表现 | 典型场景 |
|---|---|---|---|
| 单模块限定单区 | 模块的 Shipping Zone 选 CN Domestic | 只对该区客户显示 | 国内用 Flat，海外用 Table |
| 单模块多费率 | Zone Rates 内为多个 Zone 各写费率行 | 各 Zone 按自身费率出价 | 所有区域共用一个模块 |
| 多模块命中同区 | 两个模块都指向同一 Zone | 结账时展示多个运费选项 | 让客户选平邮或快邮 |
| 模块不限区 | Shipping Zone 留空/--none-- | 所有地址参与计算 | 兜底运费，防止无运费可算 |
第二行适用于“同一个计费逻辑管所有地区”，用第 3 章的 Zone Rates 实现；第一行适合不同地区用不同计费逻辑（比如按件与按重），在第 4 章展开。第四行的兜底位置很重要：Zone 匹配一旦漏掉某个地区，没有 --none-- 模块兜底时购物车会直接提示无可用配送方式。用一段 SQL 先查一遍 Zone 的国家覆盖：
-- 查看指定 Zone 下覆盖的国家与州，zone_id 为 0 表示整国 SELECT z.geo_zone_id, z.geo_zone_name, c.countries_name, ztg.zone_id FROM geo_zones z LEFT JOIN zones_to_geo_zones ztg ON ztg.geo_zone_id = z.geo_zone_id LEFT JOIN countries c ON c.countries_id = ztg.zone_country_id WHERE z.geo_zone_id = 1 ORDER BY c.countries_name;这段查询把 Zone 的名称、覆盖国家、是否细化到州一次性列出来。如果结果出现大片空白国家名，说明 Zones 页面里的国家没有加全；重点看 zone_id，0 代表整个国家都属于该 Zone，非 0 则代表只包含指定州的集合，这是后面排查“某地不出运费”的第一处检查点。
3. 用 Zone Rates 给不同地区挂上各自的运费表
3.1 启用内置 Zone Rates 模块
ZenCart 自带一个运费模块，后台名称显示为 Zone Rates（模块目录里常简写为 zones），位置在 Admin → Modules → Shipping。安装入口是列表里的 Install 按钮，点击后生成一组基础配置项，常见参数如下：
- Enable Zone Rates：Yes/No 全局开关；
- Handling Fee：整张订单附加的操作费；
- Handling Per Box：按包装箱数加收的费用；
- Max Weight：快递可接受的最大重量；
- Tax Class / Tax Basis：运费是否计税，通常沿用默认。
这里不要把费率直接写进 Handling Fee。Handling Fee 是加法项，作用于所有命中订单；费率表才是按重量或价格分档的运费本体。安装完成后先别急着编辑费率，回到 Zones 页面确认至少有两个 Zone 处于可用状态，否则编辑页里没有可绑定的区域对象。
如果你的版本在 Zone Rates 编辑页找不到 Zone 列表，常见原因是 PHP 版本低于模块要求，模块只读取到了数据库里已有的 Zone 配置，但页面渲染失败。先查服务器 PHP 版本，再看 includes/modules/shipping/zones.php 是否与当前小版本匹配，多数旧站点升级 PHP 后即可显示。
3.2 为 Zone 写入费率表：语法与参数
Zone Rates 的费率表与 Table Rate 模块同源，格式是“计费边界:运费”然后用逗号串联，例如：
0:12.00,2:18.00,5:28.00,10:45.00上面的表按订单总重量计费：0~2kg（含）收 12 元，2~5kg（含）收 18 元，依此类推。计费基准是什么，取决于模块配置里选择的模式——常见是总重量；如果版本允许改为按订单价格，则边界值含义变为金额，例如0:0,50:8,100:12代表订单满 50 元前免运费，满 50 元收 8 元，满 100 元收 12 元。写费率前先到 Module Settings 里确认计费基准，名称通常叫 Calculation Method 或类似选项，别把重量和价格混在同一张表里。
写表时注意三点：边界值严格递增、同表内不出现重复边界、费用保留两位小数。保存后，结账程序按“第一个满足 计费量 <= 边界值 的档位”返回结果。后台手填长字符串容易数错逗号，常见做法是用脚本把 Excel/CSV 里的区间表直接转成费率表文本，例如 CSV 第二列是重量边界、第三列是运费：
awk -F, 'NR>1 {if (NR>2) printf ","; printf "%s:%s", $2, $3} END{print ""}' rates.csv这个 awk 命令跳过表头，从第二行起读取数据行，第一行数据前不加逗号，后续每行先补一个逗号再接下一段区间，最后输出整串费率。把结果粘贴进 Zone Rates 配置即可，避免手动输入漏掉分隔符。
提示：费率表以
0:开头不表示免费。0:12,2:18的实际效果是“0~2kg 收 12 元，2~5kg 收 18 元”。想给首重区间免费，应写成0:0,0.01:0或直接启用免运模块控制，不要留下 0 元档位给所有订单命中。
3.3 模块级 Zone 与模块内费率 Zone 的分工
Zone Rates 顶层配置里也有一个 Shipping Zone 下拉，这一层和费率表内引用的 Zone 含义不同，需要分开理解：
模块级 Shipping Zone 决定“这个模块整体对哪些地区开启”；费率表内引用的 Zone 决定“某一条费率表绑定的地址范围”。如果模块级选择 CN Domestic，即使费率表里写了 Overseas 的价格，海外订单也走不进来，因为模块在入口处就已经被过滤掉了。
多地区多运费的标准落地方式，是把模块级 Shipping Zone 保持为 --none--（或留空），让所有地区都能进入模块，再由费率记录逐条绑定各自 Zone。这样“一个模块、多条费率、多个地区”就成形了：国内命中 CN Domestic 记录，港澳台命中港澳台记录，海外命中 Overseas 记录。模块级 Zone 更适合第 4 章的多模块拆分场景，两者使用时机不同，不要同时用两套 Zone 去限制同一个模块，否则会因为条件叠加而出现“明明有费率却匹配不上”的结果。
3.4 同一 Zone 不要写两条费率记录
同一个 Zone 在 Zone Rates 里写多条费率记录不会报错，但会引入匹配顺序问题。ZenCart 对模块内 Zone 的匹配一般按配置顺序执行，先匹配到的记录生效，而不是自动选价格低的一条。两条记录同时覆盖国内时，客户看到的运费可能就是其中固定的某一条，改价格时另一条还被当成干扰项留在配置里。
建议每个 Zone 在 Zone Rates 内只保留一条记录。同一地区想要两档时效价格，正确做法是新建独立运费模块（如下面章节的 Flat Rate），让两个模块在同一客户地址下同时出现，选择权交给客户。这样每条配置的语义单一，后台不会出现改半天不知道哪条生效的情况。
4. 多模块并存与兜底策略：一个地区一套价格之外的事
4.1 不同计费逻辑的模块各管一摊
Zone Rates 只能在同一计费基准下管理多个地区；当地区之间计费逻辑差异大（比如国内按件、海外按重），更靠谱的做法是启用多个内置模块，为每个模块指定专属 Shipping Zone。常见组合如下：
| 模块 | Shipping Zone | 计费方式 | 示例参数 |
|---|---|---|---|
| Item | CN Domestic | 按件数 | 首件 6 元，每多一件 2 元 |
| Zone Rates | Overseas | 按重量 | 0:60,2:90,5:150 |
| Flat | --none-- | 固定价 | 30 元兜底 |
在 Modules → Shipping 中分别安装并编辑三个模块：Item 模块的 Shipping Zone 选 CN Domestic，计费参数按件数填写；Zone Rates 的模块级 Zone 留空，在费率记录里绑定 Overseas；Flat 模块选 --none--，作为任何地区都可用但费用最高的兜底。结账时程序把所有启用的模块扫一遍，筛出地址匹配的选项展示给客户。
这种做法的维护点在于模块命名。后台列表默认显示 Flat、Item、Zones 等通用名，模块一多就分不清。部分版本允许在模块设置里改 Display Name（展示名），建议都带上地区前缀，例如 Item-CN、Flat-Rest；改名后前端购物车也会显示对应文案，客户能看懂是哪一种配送。
4.2 兜底模块与无运费死胡同
客户地址不属于任何 Zone，又不存在 --none-- 模块时，结算页会出现“无可用配送方式”的报错，这是多地区配置里最常见的上线事故。避免办法是永远保留一个不限区的兜底模块，它不参与最优价格计算，只在所有地区型模块都没命中时兜住订单。
兜底模块推荐用 Flat（固定价）或 Free Options（免运费条件开关）。Flat 设计成“最不可能被选中”的贵价即可，比如常规国内运费 8 元时，兜底设 30 元，不引导客户主动选。Free Options 则适合给新用户或指定最低消费额度做免运：它的 Free Shipping Options Total >= 参数表示订单金额达到多少后免运，Free Shipping Options Minimum Order 表示免运活动的最低订单额。配置时把 Shipping Zone 设为 --none--，则所有地址都能参与免运判断。
注意：免运费不要直接在现有费率表里追加
0:0，那样只会让重量为零的订单命中，普通包裹全部落在下一档。正确方式是单独启用 Free Options，用订单金额门槛控制免运范围。
4.3 同一国家内按州拆分的手工做法
地区粒度不是只能到国家。ZenCart 的 Zone Definition 支持在国家下勾选州/省，因此“中国大陆”与“港澳台”可以分成两个 Zone。创建“大陆”Zone 时，在 Add Country 中选中国后勾选内地省份；创建“港澳台”Zone 时，把中国香港、中国澳门、中国台湾的州记录分别加进去。两个 Zone 再分别绑定到 Item 和 Zone Rates 的费率行。
需要留意的是，一个 Zone 内如果选择了某国的部分州，则该国其余未勾选部分不再属于这个 Zone。比如把大陆省份全部放进 Zone A，只漏了新疆，那么新疆订单既不属于 Zone A，也不属于 Zone B，最终只能落到兜底模块。核对州覆盖时，可用下面这条 SQL 快速统计每个 Zone 里有多少国家是整国覆盖、多少国家是部分州覆盖：
SELECT z.geo_zone_id, COUNT(DISTINCT ztg.zone_country_id) AS country_cnt, SUM(CASE WHEN ztg.zone_id = 0 THEN 1 ELSE 0 END) AS full_country_cnt FROM geo_zones z LEFT JOIN zones_to_geo_zones ztg ON ztg.geo_zone_id = z.geo_zone_id GROUP BY z.geo_zone_id;country_cnt 是 Zone 内的国家数量，full_country_cnt 是整国覆盖的数量。两者相等，说明该 Zone 没有做州级细分；full_country_cnt 明显小于 country_cnt，就要回去逐个展开国家记录，确认漏掉的是哪些州。
4.4 免运活动放在哪个模块层
免运活动不要直接改 Zone Rates 费用表为 0。正确落点是 Free Options：把它的 Shipping Zone 设置为活动覆盖的地区（比如国内），再通过金额门槛控制资格。当 Free Options 与正常计费模块命中同一客户地址时，前端会同时显示 0 元与有运费的选项，客户自然选免运。想强制某地区免运、不让客户看到其他选项，需要把其他计费模块的 Shipping Zone 排除该地区，或把 Free Options 的模块排序提前，让结算页面优先展示它。
模块排序在 Modules → Shipping 列表中可以调整，部分版本支持鼠标拖动，旧版本则通过列表上方的排序整数控制。改排序后要回到前台清掉购物车会话再测，因为已生成的报价缓存不会立刻更新，测到的可能还是旧排序下的结果。
5. 上线前校验与踩坑排查：Zone 命中与费率表的实测
5.1 用 SQL 检查 Zone 和模块配置是否齐全
先把 Zone 覆盖的国家和州拉出来核对（类似 2.3 的查询），再把运费模块的持久化配置读出来，确认配置值形态。重点查 configuration 表：
SELECT configuration_key, configuration_value FROM configuration WHERE configuration_key LIKE 'MODULE_SHIPPING%' ORDER BY configuration_key;返回值里会看到模块启用开关、费率表、Handling Fee、Max Weight 等键值。检查费率表字符串中是否混入中文逗号、空格或不可见字符——这类字符会让档位解析失败，表现是后台能显示模块但前台运费为 0 或不出现。SQL 结果顺手存成 CSV，和当前线上报价单做对比，能快速发现“多了一档价格”或“漏了某重量区间”。
5.2 用脚本和真实重量批量核对费率区间
手工下单验证只能覆盖部分重量点，不如把费率表抽出来跑一批边界值。用 PHP 模拟档位匹配逻辑，直接验证阈值两侧的费用：
function lookup_rate($charge_value, $rate_table) { $parsed = []; foreach (explode(',', str_replace(' ', '', $rate_table)) as $entry) { [$boundary, $price] = array_pad(explode(':', $entry), 2, 0); $parsed[(float)$boundary] = (float)$price; } ksort($parsed); foreach ($parsed as $boundary => $price) { if ($charge_value <= $boundary) { return $price; } } return end($parsed); } var_dump(lookup_rate(1.8, '0:12,2:18,5:28'));函数先把字符串按逗号拆段，冒号拆出边界与价格，ksort 排序后逐个比较，返回第一个满足“计费量 <= 边界”的档位。1.8kg 在0:12,2:18,5:28里会得到 18 元；即使后台把费率表写成2:18,0:12，排序逻辑也保证结果仍是 18，不会因书写顺序产生两种费率。测边界值时，记得同时传 2.0、5.0、5.1 这类落点，分别看档位切换是否在预期位置。
5.3 三个最该先排查的线上现象
运费完全不显示，先确认三个开关同时满足：模块 Enable 为 Yes、Shipping Zone 命中、费率表值非空。其中 Shipping Zone 命中最容易被后台名称误导——下拉框里显示的是 Zone 名，但对应的州覆盖情况得回到 SQL 查询里核对，尤其当 Zone 只包含部分州时，漏州订单会直接走不到该模块。
运费比预期翻倍，基本是 Handling Fee 与 Handling Per Box 叠加导致，拆箱订单尤其明显。先确认 Handling Per Box 是否为 0，再检查 Max Weight 是否过小；超出最大重量时模块直接不参与展示，并不会提示“超重”。运费显示相同，说明费率表里只写了一条 Zone 记录，或模块级 Shipping Zone 被锁定在单个 Zone 上，把“费率表覆盖全部”误当成“模块覆盖全部”。验证时把测试地址依次切到国内、港澳台和海外，每次清空购物车重跑 5.2 的校验脚本再各结算一次，归档结果后这套配置就能放心发布了。
本文还有配套的精品资源，点击获取
