台湾のEコマースでは、すべての注文に対して電子インボイスを発行する必要があります。この拡張機能は、SmilePayの電子インボイスサービスをYS CARTに接続し、注文成立後に自動でインボイスを発行、ステータスを書き戻し、無効にして再発行することで、すべてバックエンドで処理します。SmilePayのバックエンドで手動で注文を補完する必要はなくなります。

自動開設、ルールは自分で決める

「注文が処理中に自動的に請求書を発行する」などのタイミングを設定でき、完全に手動にすることも可能です。チェックアウトページでは、個人／法人請求書の選択ができ、携帯電話バーコードキャリア、自然人証明書、愛の寄付をサポートしています。YS CARTコアで全サイトの請求書ルールが設定されている場合、コアのルールが優先され、複数ベンダー間での競合を防ぎます。

テストモードとフルログ

テストモード提供（クイックショッピングテストエンドポイントとの連携、実際の請求書は生成されません）、本番稼働前に請求書の発行・無効化プロセスを完全に実施できます。すべてのAPIのやり取りにはログが記録されるため、問題発生時の推測が不要です。請求書の明細とステータスはYS CARTの請求書リストで一元管理されます。

機能特徴

自動開立時機

注文ステータス（処理中に変更など）に基づいて自動で発行するか、完全に手動に変更します。

個人／会社請求書

お会計ページで請求書種別を選択してください。法人請求書は統一コードと名称に対応しています。

運搬具と寄付

携帯電話バーコード、マイナンバーカード認証、愛心コード寄付をすべてサポートします。

廢止管理

バックエンドで直接無効な請求書を破棄して再発行し、ステータスをリアルタイムで書き戻します。

テストモード

串接速買配（Pay-easy）的測試端點完整演練，不產生真實發票。

請求書リストとログ

請求明細を一元管理し、APIのやり取りのログを完全に確認できます。

スクリーンショット

更新日誌 (最新)

v1.0.6

修正済み

空白ストレージは、「解けない」検証コードを削除しなくなりました：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` がクリアされても引き続き表示されます。

テスト

リグレッション v108；ローカル3シナリオ実証：blank-save 保持 + notice 継続 / 真空→未設定ガイド / 通常→誤報なし；dev 通常キー誤報なし。

変更点全般については `CHANGELOG.md` を参照してください。

よくある質問

アカウントは必要ですか？

Su-mai peiに電子インボイスサービスを申請し、インボイスアカウント（Grvc）と検証コードを取得した後、設定ページに入力してください。公式の試用アカウントを使用して、テストモードで練習することができます。

請求書はいつ発行されますか？

設定したタイミングで自動的に発行（例：注文が「処理中」に変わったとき）することも、注文ページで手動で発行することもできます。

間違って開いたものは無効にできますか？

はい、可能です。バックエンドでワンクリックで無効化し、再発行できます。ステータスと番号はすべて記録されます。

他の請求書発行業者と競合しますか？

いいえ。YS CART は「請求書発行ベンダー」のフレームワークで一元管理されており、複数のベンダーがインストールされていても、有効なルールのみによって発行されます。