高流量電商稅務豁免橋接
當操作或稽核用於協調 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 發票/調整項設為「草稿」狀態(
send_email: false),並通知操作員進行人工核准。