高流量电商免税桥接
在运行或审计用于核对 Shopify B2B/非营利组织订单与免税证书及会计分类账的 Cloud Run / 无服务器桥接服务时,请使用此技能。
1. 安全与财务护栏
- 恒定时间 HMAC 验证: 在解析 JSON 之前,必须使用
hmac.compare_digest对每个 Shopify webhook(X-Shopify-Hmac-Sha256)的原始请求体进行验证。 - 幂等性键: 通过
(order_id, updated_at)对传入的orders/create和orders/updated事件进行去重,以防止 webhook 重试期间产生重复的分类账分录。 - 仅草稿会计暂存: 当订单出现税务差异或需要免税贷项凭单时,将 QuickBooks Online 发票/调整项暂存为“草稿”(
send_email: false),并通知操作员进行人工审批。