Shop V3n：8 项重大更新 — 运费、发票、VAT 及更多
Enlightenment Shop 迎来了迄今为止最大的一次更新。V3n 版本带来了 8 项重大改进：3 个缺陷修复和 5 个新功能，让买卖流程更顺畅、更安全、更专业。
概览
| # | 类型 | 更新内容 |
|---|---|---|
| 1 | 缺陷修复 | 取消订单时恢复库存 |
| 2 | 缺陷修复 | 多渠道配送区域检查 |
| 3 | 缺陷修复 | 数字商品发货数量修复 |
| 4 | 新功能 | 自动释放前 escrow 提醒 |
| 5 | 新功能 | 按渠道和国家的运费设置 |
| 6 | 新功能 | 统一多币种结算 |
| 7 | 新功能 | PDF 发票 |
| 8 | 新功能 | VAT 处理 |
1. 取消订单时恢复库存 修复
问题： 当卖家取消已付款订单时，实物商品的库存没有恢复增加。在结算时预留的商品数量永久保持扣减状态——即使订单已取消，卖家仍然损失了库存。
修复： 系统现在会在订单取消时自动为所有实物商品恢复库存。数字商品会被跳过（它们不使用库存）。如果某个商品在此期间已被删除，则会静默跳过。
当你取消订单时，实物商品库存会自动恢复。不再有库存丢失的问题。
2. 多渠道配送区域检查 修复
问题： 在结算时，系统只检查购物车中第一个店铺的配送区域。如果你的购物车中有来自多个店铺的商品，其他店铺的配送区域从未被验证过。
修复： 结算现在会遍历所有包含实物商品的唯一店铺，并逐一检查其配送区域是否匹配买家的所在国家。如果任何店铺不向你所在的国家配送，结算将被阻止并显示清晰的错误信息。
如果购物车中有任何店铺不向你所在的国家配送，你现在会在付款前就收到清晰的错误提示——而不是付款后。
3. 数字商品发货数量修复 修复
问题： 当你购买 5 个碎片时，只发货了 1 个。数字发货代码读取数量字段时使用了错误的名称，导致数量始终为 0，回退逻辑只发货了 1 个——无论你实际支付了多少个。
修复： 新的统一发货逻辑现在会正确读取订单中的商品数量，同时兼容新旧两种数量字段格式。碎片和 CTTC 碎片现在会按正确数量发货。
如果你买了 10 个碎片，你就会收到 10 个碎片。就这么简单。
4. 自动释放前 escrow 提醒 新
escrow 付款会在买家未操作的情况下 7 天后自动释放给卖家。在此之前，买家没有任何提醒——他们可能不知道截止日期即将到来。
新功能： 一个后台任务现在每小时运行一次，向 escrow 已超过 5 天（即自动释放前 2 天）的买家发送 SSE 通知 + 邮件。提醒内容如下：
“您有一笔 5 天前支付的订单。如果您已收到商品，请确认收货。如果有问题，请发起争议。如果您不做任何操作，escrow 将在 2 天后自动释放给卖家。”
每笔订单只会提醒一次（通过时间戳标记跟踪）。
你会在自动释放截止日期前 2 天收到提醒，有充足时间确认收货或发起争议。
5. 运费 新
店铺现在可以收取运费了。新的运费配置系统支持：
- 全球默认费率（适用于所有国家）
- 按国家覆盖（为特定国家设置专属费率）
在结算时，系统会查找每个店铺对应买家所在国家的运费，如果找不到则回退到全球默认费率。如果没有任何费率配置，则免运费。
店主可以在店铺管理后台中创建、更新和删除运费配置。
运费会加到订单总额中，并显示给买家。
你现在可以按国家设置运费。例如：全球 5 欧元，但德国境内 2 欧元。
6. 统一多币种结算 新
问题： 如果你的购物车中同时有 CC 和 KC 商品，你需要进行两次单独结算——每种货币各一次。
新功能： 新的统一结算功能可以一次性处理所有货币。它会为每种货币创建一个订单，并在单个响应中返回所有订单。前端现在可以并排显示两个付款二维码——一个用于 CC，一个用于 KC。
系统会为购物车中的每种货币生成一个独立的订单，每个订单包含应付金额和收款地址。如果某些商品无法结算，错误信息会单独返回，不影响其他订单。
原有的单货币结算方式仍然可用，以保持向后兼容性。
一键结算整个购物车，即使其中混合了 CC 和 KC 商品。两个二维码，两次付款，搞定。
7. PDF 发票 新
买家和卖家现在可以为任何已付款订单下载 PDF 发票。
发票包含：
- 订单编号、日期和状态
- 卖家店铺名称 + 税号
- 买家姓名 + 配送地址
- 商品明细，包含 SKU、名称、数量、单价和小计
- 运费
- VAT 明细（如果店铺已启用 VAT）
- 总金额（wei）+ 欧元等值
PDF 发票由内置的生成器创建（无外部依赖），采用 Helvetica 字体。买家和店铺所有者都可以下载发票。
专业的 PDF 发票，可用于存档、税务申报或费用报告。不再需要手动制作发票。
8. VAT 处理 新
店铺现在可以配置 VAT（增值税） 设置：
- 增值税率：百分比（0-100%，例如 20 表示 20% VAT）
- 价格是否含税：标记显示的价格是否已包含 VAT
工作原理：
- 如果价格已含税：显示的价格已包含 VAT。发票会分别列出净额和 VAT 部分。
- 如果价格不含税：显示的价格为净价。VAT 在结算时额外加收。
- 如果增值税率为 0：不进行 VAT 处理（默认值，向后兼容）。
前提条件： 要启用 VAT，卖家必须在其账户上设置税号。
店主可以在店铺管理后台中设置增值税率和含税标记。这些设置会显示在店铺信息中。
如果你是已注册的企业并拥有税号，你现在可以生成符合 VAT 规范的发票。设置你的 VAT 税率，并标记价格是含税还是不含税。
部署
V3n 版本现已上线 MAAS（测试环境）。测试通过后，将逐步推广到所有区域（US、IN、EU2、SG）。
反馈
一如既往，如果你发现任何问题或对未来店铺改进有建议，请告诉我们。得益于你的反馈，店铺系统在不断进化。