AIjennings/aria-agent-blueprints

Vérificateur HMAC-SHA256 haute volume pour webhooks Shopify, validateur d'exonération fiscale pour associations à but non lucratif, gardien d'idempotence et moteur de création de factures provisoires QuickBooks Online.

Qu'est-ce que aria-agent-blueprints ?

Ce skill est conçu pour les opérateurs et auditeurs de passerelles serverless (Cloud Run) qui synchronisent les commandes Shopify B2B ou d'associations avec des certificats d'exonération fiscale et des journaux comptables. Il garantit une vérification HMAC à temps constant pour chaque webhook entrant, évitant les attaques temporelles, et déduplique les événements grâce à des clés d'idempotence basées sur (order_id, updated_at) pour éviter les doublons lors des tentatives de webhook. En cas de désaccord fiscal ou de nécessité d'un avoir exonéré, il crée les factures d'ajustement dans QuickBooks Online en tant que brouillons (sans envoi automatique) et notifie un opérateur humain pour approbation. Ce skill est indispensable pour sécuriser et fiabiliser l'intégration entre Shopify, les systèmes d'exonération fiscale et les logiciels comptables dans un environnement serverless.

Compatible avec~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 Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Pont d'exonération fiscale pour le commerce électronique à volume élevé

Utilisez ce skill lorsque vous exploitez ou auditez des passerelles serverless / Cloud Run qui réconcilient les commandes Shopify B2B ou d'associations avec des certificats d'exonération fiscale et des journaux comptables.

1. Garde-fous de sécurité et financiers

  1. Vérification HMAC à temps constant : Chaque webhook Shopify (X-Shopify-Hmac-Sha256) doit être vérifié avec hmac.compare_digest par rapport au corps brut de la requête avant d'analyser le JSON.
  2. Clés d'idempotence : Dédupliquez les événements orders/create et orders/updated entrants grâce à (order_id, updated_at) pour éviter les entrées en double dans le journal comptable lors des tentatives de webhook.
  3. Mise en attente comptable provisoire uniquement : Lorsqu'une commande présente un écart fiscal ou nécessite un avoir exonéré, créez la facture/ajustement QuickBooks Online en tant que Draft (send_email: false) et notifiez un opérateur pour approbation humaine.

Individual skills in this repo

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

Skills associés