고부하 전자상거래 세금 면제 브리지
이 스킬은 Cloud Run / 서버리스 브리지를 운영하거나 감사할 때 사용합니다. Shopify B2B/비영리 단체 주문을 세금 면제 증명서 및 회계 원장과 조정합니다.
1. 보안 및 재정 안전장치
- 상수 시간 HMAC 검증: 모든 Shopify 웹훅(
X-Shopify-Hmac-Sha256)은 JSON을 파싱하기 전에hmac.compare_digest를 사용하여 원시 요청 본문에 대해 반드시 검증되어야 합니다. - 멱등성 키:
order_id, updated_at쌍을 기준으로 들어오는orders/create및orders/updated이벤트의 중복을 제거하여 웹훅 재시도 중 중복 원장 항목을 방지합니다. - 초안 전용 회계 스테이징: 주문에 세금 불일치가 발생하거나 면세 크레딧 메모가 필요한 경우 해당 QuickBooks Online 인보이스/조정을
Draft(send_email: false) 상태로 스테이징하고 운영자에게 알려 담당자 승인을 받습니다.