台灣電商每一筆訂單都要開電子發票。這支擴充把速買配（SmilePay）電子發票服務接進 YS CART，訂單成立後自動開立、狀態回寫、作廢重開，全部在後台完成，不用再去速買配後台手動補單。

自動開立，規則自己訂

可設定「訂單轉為處理中自動開立」等時機，也可完全手動；結帳頁提供個人／公司發票選擇，支援手機條碼載具、自然人憑證與愛心捐贈。若 YS CART 核心已設定全站發票規則，會以核心規則為準，多供應商不打架。

測試模式與完整日誌

提供測試模式（串接速買配測試端點，不產生真實發票），上線前可完整演練開立、作廢流程；所有 API 往來都有日誌可查，出問題不用瞎猜。發票明細與狀態整合在 YS CART 發票列表統一管理。

依訂單狀態（如轉為處理中）自動開立，或改為全手動。

結帳頁選擇發票類型，公司發票支援統編與抬頭。

手機條碼、自然人憑證載具與愛心碼捐贈全支援。

後台直接作廢發票並重新開立，狀態即時回寫。

串接速買配測試端點完整演練，不產生真實發票。

發票明細集中管理，API 往來日誌完整可查。

空白儲存不再清掉「解不開」的驗證碼：v1.0.5 fail-closed 後，使用者進設定頁但未重填即按儲存時，password 留空 retain 會用解密後的空字串覆寫 raw 加密 blob → 引導提示靜默消失、provider 不可用卻無提示。本版 `preserve_unusable_verify_key()` 在留空時保留 raw 信封、`encrypt_verify_key()` 不重複加密既有信封；admin fallback `decrypt_verify_key()` 一致 fail-closed。

後台引導提示改以「解密後 verify_key 是否為空」為總判準，涵蓋「解不開（搬站）」與「缺失（未設定）」兩情形，訊息各自客製，即使 raw 被清也持續顯示。

Regression v108；本地三情境實證：blank-save 保留+notice 持續 / 真空→未設定引導 / 正常→無誤報；dev 正常 key 無誤報。

完整變更見 `CHANGELOG.md`。

需要什麼帳號？

需向速買配申請電子發票服務，取得發票帳號（Grvc）與驗證碼後填入設定頁；可先用官方試用帳號在測試模式演練。

什麼時候會開立發票？

依你設定的時機自動開立（例如訂單轉為「處理中」時），也可以在訂單頁手動開立。

開錯了可以作廢嗎？

可以。後台一鍵作廢並可重新開立，狀態與號碼都會完整記錄。

和其他發票供應商會衝突嗎？

不會。YS CART 以「發票供應商」框架統一管理，同時安裝多家供應商也只會由啟用中的規則開立。