CommunityProgramación y desarrollogithub.com

AIjennings/aria-agent-blueprints

Verificador HMAC-SHA256 de webhooks de checkout de Shopify de alto volumen, validador de exención fiscal para organizaciones sin fines de lucro, guardián de idempotencia y motor de preparación de borradores de facturas en QuickBooks Online.

¿Qué es aria-agent-blueprints?

Este skill está diseñado para desarrolladores e ingenieros que operan o auditan puentes serverless (Cloud Run) que reconcilian pedidos B2B y de organizaciones sin fines de lucro de Shopify con certificados de exención fiscal y libros contables. Proporciona capas de seguridad críticas: verificación HMAC-SHA256 de tiempo constante para cada webhook de Shopify, validación de exención fiscal para organizaciones sin fines de lucro basada en el estado, guardián de idempotencia para evitar duplicados en el libro mayor durante reintentos de webhook, y un motor de preparación de borradores de facturas en QuickBooks Online que solo crea asientos como "Draft" para que un operador humano los apruebe. Soporta eventos `orders/create` y `orders/updated`, y garantiza que ninguna transacción fiscalmente sensible se registre automáticamente sin supervisión.

Compatible con~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 Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Puente de Exención Fiscal para Comercio Electrónico de Alto Volumen

Utilice este skill cuando opere o audite puentes serverless / Cloud Run que reconcilien pedidos B2B y de organizaciones sin fines de lucro de Shopify con certificados de exención fiscal y libros contables.

1. Barreras de Seguridad y Financieras

  1. Verificación HMAC de Tiempo Constante: Cada webhook de Shopify (X-Shopify-Hmac-Sha256) debe verificarse con hmac.compare_digest contra el cuerpo crudo de la solicitud antes de analizar el JSON.
  2. Claves de Idempotencia: Desduplicar eventos entrantes orders/create y orders/updated mediante (order_id, updated_at) para evitar entradas duplicadas en el libro mayor durante reintentos de webhook.
  3. Preparación de Borradores Contables: Cuando un pedido muestra una discrepancia fiscal o requiere un abono por exención fiscal, preparar la factura/ajuste en QuickBooks Online como Borrador (send_email: false) y notificar a un operador para aprobación humana.

Individual skills in this repo

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

Skills relacionados