Community程式設計與開發github.com

AIjennings/aria-agent-blueprints

高流量 Shopify 結帳 Webhook HMAC-SHA256 驗證器、州級非營利組織免稅資格驗證器、冪等性保護機制及 QuickBooks Online 草稿發票暫存引擎。

aria-agent-blueprints 是什麼?

此技能專為處理高流量 Shopify B2B/非營利訂單與免稅憑證及會計分類帳的同步作業而設計,特別適用於 Cloud Run 或無伺服器橋接架構。它提供硬體級安全守門機制,包括常數時間 HMAC 驗證(使用 `hmac.compare_digest` 防範計時攻擊)與基於 `(order_id, updated_at)` 的冪等性金鑰,確保在 webhook 重試期間不會產生重複分錄。當偵測到稅務不一致或需要稅務豁免貸項通知單時,該技能會將 QuickBooks Online 發票或調整項設為「草稿」狀態(`send_email: false`),並通知操作員進行人工審核。此整合方案支援 Shopify、QuickBooks Online 及任意雲端平台,並遵循安全會計流程,適合在結帳 webhook 事件中自動驗證州級非營利組織免稅資格。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AIjennings/aria-agent-blueprints/tree/HEAD/skills/ecom-tax-exemption-bridge

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

高流量電商稅務豁免橋接

當操作或稽核用於協調 Shopify B2B/非營利組織訂單與免稅憑證及會計分類帳的 Cloud Run / 無伺服器橋接時,請使用此技能。

1. 安全性與財務保護機制

  1. 常數時間 HMAC 驗證: 每個 Shopify webhook (X-Shopify-Hmac-Sha256) 必須在解析 JSON 前,使用 hmac.compare_digest 核對原始請求主體。
  2. 冪等性金鑰: 透過 (order_id, updated_at) 對傳入的 orders/create 和 orders/updated 事件進行去重,防止 webhook 重試時產生重複分類帳分錄。
  3. 僅草稿會計暫存: 當訂單出現稅務不一致或需要稅務豁免貸項通知單時,將 QuickBooks Online 發票/調整項設為「草稿」狀態(send_email: false),並通知操作員進行人工核准。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相關技能