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 碎片現在會以正確的數量交付。

---

4. 自動釋放前的 escrow 提醒 新

如果買家未採取行動，escrow 付款會在 7 天後自動釋放給賣家。在此之前，買家沒有收到任何提醒——他們可能不知道截止日期即將到來。

新功能： 背景任務現在每小時執行一次，向 escrow 已超過 5 天（自動釋放前 2 天）的買家發送 SSE 通知 + 電子郵件。提醒內容為：

「您有一筆在 5 天前付款的訂單。如果您已收到商品，請確認收貨。如果有問題，請提出爭議。如果您不採取任何行動，escrow 將在 2 天後自動釋放給賣家。」

每筆訂單只會提醒一次（透過時間戳標記追蹤）。

---

5. 運費 新

商店現在可以收取運費。新的運費設定支援：

• 全球預設費率（適用於所有未特別設定的國家）
• 按國家覆蓋（可為特定國家設定專屬費率）

在結帳時，系統會查詢每個頻道針對買家所在國家的運費，並回退到全球預設值。如果找不到費率，則免運費。

---

6. 統一多幣別結帳 新

問題： 如果您的購物車同時有 CC 和 KC 商品，您需要進行兩次獨立結帳——每種幣別一次。

新功能： 新的統一結帳流程可同時處理所有幣別。它會為每種幣別建立一筆訂單，並在單一回應中全部回傳。前端現在可以並排顯示兩個付款 QR 碼——一個 CC，一個 KC。

原有的單一幣別結帳方式仍然可用，以保持向後相容性。

---

7. PDF 發票 新

買家和賣家現在可以為任何已付款的訂單下載 PDF 發票。

發票包含：

• 訂單參考編號、日期和狀態
• 賣家商店名稱 + 稅號
• 買家名稱 + 配送地址
• 商品明細，包含 SKU、名稱、數量、單價和小計
• 運費
• VAT 明細（如果商店已啟用 VAT）
• 總金額（wei）+ 歐元等值

PDF 使用手寫的 PDF 寫入器（無外部依賴）以 Helvetica 字型生成。買家和商店店主均可下載發票。

---

8. VAT 處理 新

商店現在可以設定 VAT（加值稅） 設定：

• VAT 稅率：百分比（0-100%，例如 20 表示 20% VAT）
• 含稅標記：標示價格是否已包含 VAT

運作方式：

• 如果價格已含稅：顯示的價格已包含 VAT。發票會拆分出淨額和 VAT 部分。
• 如果價格未含稅：顯示的價格為淨額。VAT 在結帳時加在上面。
• 如果 VAT 稅率為 0：不處理 VAT（預設值，向後相容）。

要求： 若要啟用 VAT，賣家必須在其帳戶上設定稅號。

賣家可在商店管理後台中設定 VAT 稅率和含稅標記。這些設定會顯示在商店資訊中。

---

部署

版本 V3n 現已在 MAAS（測試環境）上線。測試完成後，將推廣至所有區域（US、IN、EU2、SG）。

回饋

一如既往，如果您發現任何問題或對未來商店改進有任何建議，請告訴我們。商店系統正因您的回饋而不斷演進。