Community编程与开发github.com

AIjennings/aria-agent-blueprints

高流量 Shopify 结账 Webhook HMAC-SHA256 验证器、州级非营利组织免税资格验证器、幂等性防护与 QuickBooks Online 草稿发票暂存引擎。

aria-agent-blueprints 是什么?

该技能用于构建或审计运行在 Cloud Run / 无服务器架构上的桥接服务,以协调 Shopify B2B/非营利组织订单与免税证书及会计分类账之间的核对。它提供了三项关键财务安全护栏:恒定时间 HMAC 验证(使用 `hmac.compare_digest` 避免时序攻击)、基于 `(order_id, updated_at)` 的幂等性键来防止 webhook 重试导致的重复分录,以及将存在税务差异或需要免税贷项凭单的订单暂存为 QuickBooks Online 的“草稿”发票(`send_email: false`),等待人工审批。该技能适用于 Shopify、QuickBooks Online 和 Google Cloud Run 等平台,能显著减少税务对账错误和重复记账风险。

兼容平台~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 验证: 在解析 JSON 之前,必须使用 hmac.compare_digest 对每个 Shopify webhook(X-Shopify-Hmac-Sha256)的原始请求体进行验证。
  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.

相关技能