Appearance
Release Notes (2026-09-27)
✨ 重点 Feature
欧盟包裹固定关税计入账单（QuoteGo / QuickPoint / droppilot 联动）
- QuickPoint：系统设置新增「其他」分组，组织所有者可填写「欧盟包裹固定关税金额(USD)」并保存；留空表示不收取关税。创建账单时，弹窗金额摘要新增「关税」一行，并按「原始金额 − 各项减免 − 库存抵扣 + 人工调整 + 关税」实时预览最终应付；账单详情中也会展示关税金额。
- QuoteGo：出账单时按每笔订单当前的包裹数量 × 该固定金额计算关税，仅对收货国家属于欧盟的订单计收；计算结果（合计、出账时费率、按订单的明细）随账单一起保存为快照。另提供创建账单前的关税预览，与正式出账使用同一套计算口径，确保预览金额与实际入账一致。
- droppilot：商家端账单详情新增「关税」金额展示。
- 组织未配置金额时，本功能不产生任何费用。
系统设置 — 其他（欧盟关税）
欧盟包裹固定关税金额(USD)：3.5
如 3.5，留空则不收关税。发往欧盟国家的包裹按包裹数 × 该金额自动计入账单（仅收货国家属于欧盟的包裹）。
保存设置
创建账单 — 金额摘要
| 项目 | 金额 |
|---|---|
| 原始金额 | $ 1,280.00 |
| 挂号费减免 | − $ 20.00 |
| 库存抵扣 | − $ 35.00 |
| 关税 | + $ 14.00 |
| 最终金额 | $ 1,239.00 |
关税仅在组织已配置金额、且订单收货国家属于欧盟时显示。
澳洲偏远订单自动打标（QuoteGo / QuickPoint 联动）
- QuickPoint：系统设置「其他」分组新增开关「自动标记澳洲偏远订单」，默认关闭。
- QuoteGo：开启后，收货地址为澳大利亚偏远地区（云途分区 3/4 区）的订单，在创建或更新（含同步）时自动追加系统标签「澳洲偏远」，供内部标识；该标签为系统标签，用户不可编辑或删除。
- 开启开关时系统会创建对应的标签记录；存量订单在下次更新或同步时补打，不做一次性批量回填。
系统设置 — 其他（澳洲偏远打标）
自动标记澳洲偏远订单 已开启
启用后，收货地址为澳大利亚偏远地区（云途分区 3/4 区）的订单会自动打上系统标签「澳洲偏远」，供内部标识。
🚀 其他 Feature
报价保存失败时展示具体原因
- 保存报价单失败时，提示会直接显示后端返回的具体原因（例如「请填写业务员名称」），不再只显示通用的失败提示；后端未返回具体原因时仍回退为通用提示。
报价保存失败提示
保存报价单失败：请填写业务员名称
无具体原因时提示「保存报价单失败，请稍后重试。」
目的地冲突原因提示浮层
- 订单列表中，目的地无法自动匹配时，「目的地冲突」或「错误」标记可点击，弹出浮层说明原因：订单收货国家、哪些商品的报价不包含该国家、各商品当前已有的目的地，以及处理建议（为该商品补充对应目的地的报价，或在「物流配置 → 目的地别名」配置别名后重试）。
- 若订单缺少收货国家，则提示先补全订单收货国家，或手动选择目的地。
订单列表 — 目的地冲突
目的地无法自动匹配 订单国家：DE(德国)
订单中以下商品的报价不包含 DE(德国)
| 商品 | 已有目的地 |
|---|---|
| 无线蓝牙耳机 | 已有: US(美国), GB(英国) |
| 便携充电宝 | 未选择目的地 |
请为缺少该目的地的商品补充报价，或在「物流配置 → 目的地别名」配置别名后重试。
🐛 重大 Bug Fix
同目的地多路线报价匹配修复
- 当同一目的地下存在多个运输线路时，订单费用计算改为遍历该目的地的全部线路结果：任一线路包含该商品即按对应报价计费。此前可能只取第一个线路结果，导致漏计费用或误报「同一运输线路下未找到对应产品的报价项」。
变体图片地址变更后重新加载
- 变体图片地址发生变化后，会清除此前的加载失败状态并重新加载，避免图片已更新但仍显示占位或失败图。
历史订单归档稳定性修复
- 修复订单归档时因归档表结构发生变化而失败的问题：归档前补齐目标表的新增列，并按共有列复制数据，避免结构不一致导致归档中断。
♻️ 重构 / 移除
- 移除前端未使用的订单新建与删除方法：订单的新建、删除统一由后端接口与店铺同步流程处理，前端不再保留可直接创建或删除订单的入口代码。
🧱 数据库 Schema 变更（需执行迁移）
本版共 1 个迁移脚本，按时间戳顺序执行，命令：./quotepilot migrate
1788744584_customs_duty.js- 组织新增「杂项设置」，用于存放每包裹固定关税金额等组织级配置。
- 账单新增关税合计、出账时费率与按订单的关税快照明细。
⚠️ 部署注意
- 需执行数据库迁移：部署前运行
./quotepilot migrate，执行上述脚本；迁移在后端启动时执行，完成后需重启后端。 - 前后端需同时发布 v5.3.0：欧盟关税为三端联动功能（QuickPoint 配置与预览、QuoteGo 出账、droppilot 展示），旧前端或旧后端会导致接口不可用或金额不一致。
- 关税默认不收取：需组织在「系统设置 → 其他」配置金额后生效；仅对收货国家属于欧盟的订单按包裹数计收。请提醒运营在正式出账前核对费率。
- 澳洲偏远打标默认关闭：需在「系统设置 → 其他」开启；开启后订单在创建或更新（含同步）时打标，存量订单在下次更新时补打，不做一次性批量回填。
- droppilot 需与后端同版本发布，否则商家端账单详情无法展示关税金额。
本版涉及的提交（技术信息）
- QuoteGo（6 commits，head
851fc5b）：e1d936f欧盟固定关税计入账单（迁移1788744584_customs_duty.js）、3f60b03账单前预览关税接口、4415324澳洲偏远订单自动打标、a926636合并 dev_eur_duty、1904f18归档补齐新增列并按共有列复制避免结构漂移失败、851fc5bMerge tag 'v5.3.0' - QuickPoint（10 commits，head
573ec92）：b4b5499欧盟关税展示与配置、8789ac9创建账单预览欧盟关税并计入应付、19f4efd澳洲偏远订单自动标记开关、482ec7c5.3.0、a73fd71修复同目的地多路线产品报价匹配、42d1397变体图片地址变更后清除失败状态并重新加载、9d5128b订单目的地冲突原因提示浮层、0f20347保存报价失败展示后端具体错误信息、3b64320合并 dev_eur_duty、573ec92Merge tag 'v5.3.0' - droppilot（2 commits，head
4db9cc8）：304ceb4账单详情新增关税金额展示、4db9cc8Merge tag 'v5.3.0'