高トラフィック E コマース税控除ブリッジ
このスキルは、Shopify B2B/非営利団体の注文を税控除証明書や会計元帳と連携させる、Cloud Run / サーバーレスブリッジの運用・監査時に使用します。
1. セキュリティおよび金融ガードレール
- 定数時間 HMAC 検証: すべての Shopify Webhook (
X-Shopify-Hmac-Sha256) は、JSON をパースする前に、生のリクエストボディに対してhmac.compare_digestを使用して検証する必要があります。 - 冪等性キー:
(order_id, updated_at)の組み合わせでorders/createおよびorders/updatedイベントを重複排除し、Webhook の再送信時に元帳エントリが重複しないようにします。 - ドラフト限定会計ステージング: 注文に税額不一致がある場合や税控除クレジットメモが必要な場合、QuickBooks Online の請求書/調整を
Draft状態 (send_email: false) でステージングし、オペレーターに通知して人間による承認を仰ぎます。