CommunityProgramação e Desenvolvimentogithub.com

AIjennings/aria-agent-blueprints

Verificador HMAC-SHA256 de webhooks do Shopify de alto volume, validador de isenção fiscal para organizações sem fins lucrativos estaduais, guarda de idempotência e mecanismo de preparação de faturas provisórias do QuickBooks Online.

O que é aria-agent-blueprints?

Esta skill fornece uma ponte serverless segura e auditável para reconciliação de pedidos B2B/sem fins lucrativos do Shopify com certificados de isenção fiscal e livros contábeis. Ela oferece três guardrails principais: verificação HMAC-SHA256 em tempo constante para webhooks (`X-Shopify-Hmac-Sha256`), deduplicação de eventos por chaves de idempotência e preparação de faturas provisórias no QuickBooks Online sempre que houver discrepância fiscal, permitindo aprovação humana antes do envio. Suporta ambientes Cloud Run, serverless e gateways de API, sendo ideal para operações de alto volume que exigem rastreabilidade financeira e conformidade com auditoria. A implementação em Python garante eficiência e segurança no tratamento de payloads JSON brutos, com proteção contra ataques de timing e duplicatas de lançamentos contábeis.

Funciona com~Claude Code~Codex CLI~Cursor

Part ofAgent Workflows

npx skills add https://github.com/AIjennings/aria-agent-blueprints/tree/HEAD/skills/ecom-tax-exemption-bridge

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Ver original→Navegar por todas as habilidades

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

ChatGPT Claude Gemini Grok Perplexity DeepSeek

Documentação

Ponte de Isenção Fiscal para E-Commerce de Alto Volume

Use esta skill ao operar ou auditar pontes serverless / Cloud Run que reconciliam pedidos B2B/sem fins lucrativos do Shopify com certificados de isenção fiscal e livros contábeis.

1. Guardrails de Segurança e Financeiros

Verificação HMAC em Tempo Constante: Todo webhook do Shopify (X-Shopify-Hmac-Sha256) deve ser verificado com hmac.compare_digest contra o corpo bruto da requisição antes de analisar o JSON.
Chaves de Idempotência: Desduplicar eventos orders/create e orders/updated recebidos por (order_id, updated_at) para evitar entradas duplicadas no livro durante retentativas de webhook.
Preparação de Faturas Apenas como Rascunho: Quando um pedido apresentar divergência fiscal ou exigir um crédito de isenção fiscal, preparar a fatura/ajuste do QuickBooks Online como Draft (send_email: false) e notificar um operador para aprovação humana.

Individual skills in this repo

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