etechflow/module-shipping-table-rates

# Magento 2 运费表费率 可视化费率管理。实时购物车模拟器。一键回滚。冲突检测。原生 MSI + Hyvä。旨在成为商家友好型替代方案，媲美 Amasty / MageWorx——功能覆盖相当，日常管理用户体验更优。 | | Amasty | MageWorx | **eTechFlow** | |---|---|---|---| | 社区/开源版 | $229/年 | $149/年 | **$129/年** | | Adobe Commerce | $529/年 | +$149/年 | **$299/年** | | Magento Cloud | $829/年 | 无 | **$399/年** | | 管理后台实时购物车模拟器 | ❌ | ❌ | ✅ | | 版本管理 + 一键回滚 | ❌ | ❌ | ✅ | | 保存时冲突检测 | ❌ | ❌ | ✅ | | 人类可读的CSV列名 | ❌ (PPP/FRPP/FRPUW) | 部分支持 | ✅ | | 原生MSI | 附加包 | 部分支持 | ✅ | | Hyvä Checkout | ✅ | 部分支持 | ✅ | | CLI冒烟测试命令 | ❌ | ❌ | ✅ | ## 功能说明 为您的 Magento 2 / Adobe Commerce 结账页面添加无限数量的运输方式，每种方式均由支持丰富条件的运费表驱动： - **目的地**：国家/地区、区域、城市、邮编范围（支持字母数字——适用于英国/加拿大/荷兰） - **购物车**：重量范围、数量范围、小计范围 - **客户**：客户组 - **商品**：`shipping_type` 属性（预设标准/易碎品/超大件/危险品/冷链——可扩展） - **费率公式**：基础费 + 单品费 + 每公斤费 + 小计百分比，可自由组合，并支持运输方式级别的最小/最大值限制以及多类型购物车汇总规则（求和/取最小值/取最大值） ## 要求 | | | |---|---| | **Magento** | 开源版 2.4.4+ 或 Adobe Commerce 2.4.4+ | | **PHP** | 8.1、8.2、8.3 或 8.4 | | **兼容主题** | Luma + Hyvä + Hyvä Checkout | | **MSI** | 通过标准运输承运商接口透明支持 | ## 安装 ### 选项 A — Composer（推荐） ``` composer require etechflow/module-shipping-table-rates:^1.0 bin/magento module:enable ETechFlow_ShippingTableRates bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush ``` ### 选项 B — 手动安装（从 zip 包） 1. 将 `etechflow-module-shipping-table-rates-1.0.0.zip` 解压到： /app/code/ETechFlow/ShippingTableRates/ **目录必须命名为 `ETechFlow`（大写 E、大写 T、大写 F）——在 Linux 服务器上区分大小写。** 2. 启用并设置： bin/magento module:enable ETechFlow_ShippingTableRates bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush 3. 验证： bin/magento module:status | grep ShippingTableRates ## 安装后 — 四步设置 ### 第一步 — 输入您的许可证密钥 后台 → **商店 → 配置 → eTechFlow → 运费表费率 → 许可证** 粘贴您购买邮件中的密钥。 ### 第二步 — 验证模块是否已激活 配置部分顶部的“模块状态”横幅将显示 ✅ **模块已激活**（或显示其他 5 种诊断状态之一，并附有操作指引）。 ### 第三步 — 创建您的第一个运输方式 后台 → **销售 → 操作 → 运费表费率 → 添加新方式** 填写： - **代码**：稳定的机器标识符（`uk_standard`、`eu_express`） - **名称**：结账时面向客户的标签 - **激活**：是 - **排序顺序**：10（值越小，在结账列表中位置越靠前） - **最小/最大费率**：可选的限制值 - **多类型处理**：`sum`（默认）/ `min` / `max` ——仅当费率针对特定 `shipping_type` 值时有意义 保存。下方将出现费率规则、版本管理、模拟器和CSV面板。 ### 第四步 — 添加费率规则 **选项 A — 内联编辑器**（适合少量规则）： 在方式编辑页面点击**添加费率规则**。填写您想要的条件（留空表示“任意”），设置费率组件，然后保存。 **选项 B — CSV导入**（适合批量操作）： 点击**下载CSV**获取列模板，在您的电子表格编辑器中编辑，通过**上传并导入**上传。选择**替换**或**追加**。 ## 关键管理功能（均在方式编辑页面上） | 面板 | 功能 | |---|---| | **费率规则** | 列表 + 添加 + 编辑 + 删除单个规则。每行以紧凑视图显示条件 + 公式 + 每行的编辑/删除按钮。 | | **CSV导入/导出** | 通过电子表格进行批量编辑。可往返编辑——导出、编辑、重新导入。逐行验证，在写入任何行之前会收集所有错误。 | | **实时购物车模拟器** | 输入假设的购物车信息（国家/重量/数量/小计/运输类型），点击模拟。精确查看匹配的运输方式、总费用、贡献费率行以及公式分解。替代“通过实际结账流程来调试”的工作流程。 | | **版本历史** | 列出最近的25个快照，支持一键恢复。每次保存/导入/删除都会创建快照。回滚操作本身也会先创建快照——支持撤销回滚操作。 | ## CLI 验证 ``` bin/magento etechflow:str:simulate \ --country=GB \ --postcode="SW1A 1AA" \ --weight=5 --qty=3 --subtotal=100 \ --customer-group=1 \ --shipping-types=fragile,standard ``` 打印结构化输出，显示匹配的运输方式、总费用、获胜费率ID、公式分解。匹配时退出代码为0，无匹配时为1——可集成到CI/CD或监控流程中。 ## 文档 | 文件 | 何时阅读 | |---|---| | `README.md`（本文件） | 首先阅读——概述 + 安装 + 四步设置 | | `docs/USER_GUIDE.md` | 完整参考：每个字段、每个条件、每个CSV列、故障排除 | | `CHANGELOG.md` | 每个版本的更新内容 | | `LICENSE.txt` | 许可证条款 | ## 组合定价 可与 **次日达资格** 和 **缺货到货时间显示** 模块组合，形成 **eTechFlow 3模块捆绑包**——一个许可证密钥激活所有三个模块。 ## 许可证 专有软件——详见 `LICENSE.txt`。按 Magento 安装实例授权，同一商业实体下的开发/测试环境数量不限。

标签：Adobe Commerce, CSV处理, ffuf, Hyvä, Magento 2, Magento扩展, OpenVAS, PHP, 冲突检测, 可视化规则构建, 商家友好, 多库存源, 安全可观测性, 实时购物车模拟, 开源, 版本控制, 物流优化, 电子商务, 表率运费, 运费管理, 运费表率, 运费计算