Due librerie TypeScript: subkit per abbonamenti e fatture, shopkit per lo shop online. Girano nella tua app, con fattura QR, IVA e quattro lingue. I pagamenti passano da zahls.ch con TWINT e carta, i dati restano nel tuo database.
Nessuna commissione per transazione · dati nel tuo database
import { createSubscriptions } from '@agentkit.ch/subkit'; const billing = createSubscriptions({ database: drizzleAdapter(db), provider: zahlsProvider({ instance: 'acme', }), plans: [basic, pro], tax: { rateBps: 810 }, });
POST /api/billing/webhook
waiting_
Basic
attivoCHF 9.00 / mese
Pro
CHF 19.00 / mese
Fatture
2026-0142
15.10.2026 · TWINT
2026-0141
15.09.2026 · QR
billing_subscriptions
billing_invoices
select * from billing_invoices join teams on …
In uso presso
I kit
Ogni kit funziona da solo, ed entrambi condividono un unico adapter, un unico cliente e un unico fornitore di pagamento.
Abbonamenti e fatture
Per SaaS, affiliazioni e quote associative
I tuoi clienti scelgono un piano e pagano con TWINT, carta o fattura QR. subkit rinnova, calcola il pro rata, invia i promemoria e riconcilia i pagamenti con la banca.
Pro
CHF 19.00
/ mese
Commercio
Per shop di associazioni, PMI, merchandising e buoni
Prodotti con varianti, carrello e checkout con TWINT o su fattura. shopkit riserva il magazzino, calcola spedizione e IVA per prodotto e invia la conferma d’ordine.
Carrello
Novità in shopkit 0.2 · Ordinare tramite agente IA
Il tuo shop diventa un server MCP. L’agente delle tue clienti e dei tuoi clienti – Claude, ChatGPT o Cursor – cerca i prodotti, calcola l’ordine con IVA e spedizione e ordina. Si paga con un link zahls.ch o direttamente con il TWINT salvato. Per ogni shop shopkit, senza servizi aggiuntivi.
import { createShopCustomerMcpHandler } from '@agentkit.ch/shopkit/mcp'Guida nel READMEDue volte la miscela della casa e un decalcificante, per posta.
search_productsmiscela della casa, decalcificante
quote_order
2 × Miscela della casa 500 g37.00
Decalcificante12.90
PostPac Priority9.00
TotaleCHF 58.90
Pagare CHF 58.90 con il tuo TWINT salvato?
Sì, grazie.
place_orderexpectedAmount: 5890
Novità in shopkit 0.2 · Per panetterie
Per panetterie e pasticcerie con WaWiAssist: i prodotti arrivano da WaWiAssist, ogni ordine vi entra – con il giorno di ritiro come data dell’ordine. Che sia ordinato nello shop online o tramite agente.
import { createHsSoftSync } from '@agentkit.ch/shopkit/hssoft'Guida nel READMEArticoli → prodotti
WaWiAssist
shopkit
Ordine → WaWiAssist
shopkit
#2187 · CHF 18.80
Ritiro il 31.10.2026
WaWiAssist
—
Novità in shopkit 0.4 · La Posta
Un clic nell’ordine e l’etichetta con codice a barre è pronta – con la modalità di spedizione dell’ordine, fatturata sulla tua licenza d’affrancatura. Nel checkout la Posta propone NPA, località, via e numero e verifica l’indirizzo prima dell’ordine.
import { createSwissPost } from '@agentkit.ch/shopkit/swisspost'Guida nel README<Checkout />
Via e numero
NPA e località
Indirizzo confermato dalla Posta
#1044
A6 · PRI
1.2 kg
Rösterei Aare
Aarstrasse 12
3011 Bern
Anna Muster
Bahnhofstrasse 12
8001 Zürich
99.60.123456.00000001
Niente vibe coding
Un agente di coding ti scrive una fattura QR e un checkout TWINT in un’ora. Gli errori emergono solo in produzione: pagamenti registrati due volte, differenze di centesimi, fatture rifiutate dalla banca. Meglio lasciare che il tuo agente integri codice già collaudato.
Fatturazione vibe-coded6 ✗
Errori tipici che emergono solo in produzione.
Con agentkit
Codice collaudato.
Il tuo agente di coding non reinventa la fatturazione, integra un kit. Il codice viene da Membear, dove gira in produzione, e copre proprio questi casi.
Aggiungi abbonamenti con fattura QR e TWINT usando @agentkit.ch/subkit. Leggi prima https://agentkit.ch/llms.txt.
Funzioni
Cosa c’è in entrambi i kit: un agente di coding che li integra, webhook che contano una volta sola, e-mail in quattro lingue e schermate pronte.
llms.txt, opzioni tipizzate ed errori con codici fissi. Un prompt fino al checkout funzionante.
Webhook idempotenti e aggiornamenti compare-and-set: se lo stesso pagamento arriva due volte, viene registrato comunque una sola volta.
Quando
Arriva un pagamento TWINT
CHF 19.00 · 2026-0143
Allora
Componenti React pronti per le schermate noiose, più un client tipizzato. Hook headless se vuoi la tua interfaccia.
I kit scrivono nel tuo database tramite adapter. Collegali con un JOIN – senza sincronizzazione, senza silo.
Ricevute, promemoria e conferme d’ordine in HTML e testo, con il tuo servizio di invio.
Deine Quittung für Pro
Acme AG
Votre commande #1042 est confirmée
Boutique Léman
Promemoria: fattura 2026-0142
FC Lugano Nord
Svizzero per impostazione
Le librerie di fatturazione generiche ragionano in Stripe, centesimi e una sola lingua. La clientela svizzera paga con fattura QR e TWINT, si aspetta l’IVA su ogni fattura e la legge in tedesco, francese o italiano. agentkit parte da qui.
Ricevuta
Conto / Pagabile a
Riferimento
Pagabile da
Valuta
Importo
Sezione pagamento
Valuta
Importo
Conto / Pagabile a
Riferimento
Informazioni supplementari
Pagabile da
Per sviluppatori
Montata come route in Next.js, Hono, SvelteKit, Remix o Express – su Node.js, Bun, Deno o all’edge. In TypeScript, utilizzabile anche da JavaScript.
Il tuo agente di coding legge llms.txt, riconosce il tuo framework e il tuo database, scrive lo schema e configura la route.
> Aggiungi abbonamenti con subkit▍
Piani, fornitore di pagamento e IVA in un unico file. Nessuna dashboard da tenere sincronizzata.
import { createSubscriptions } from '@agentkit.ch/subkit';
import { drizzleAdapter } from '@agentkit.ch/subkit/drizzle';
import { zahlsProvider } from '@agentkit.ch/subkit/zahls';
import { db, env } from './db';
export const billing = createSubscriptions({
// your Postgres, your tables
database: drizzleAdapter(db),
provider: zahlsProvider({ instance: 'acme', apiKey: env.ZAHLS_KEY }),
plans: [
{ id: 'free', name: 'Free', features: [], limits: {}, prices: {} },
{
id: 'pro',
name: 'Pro',
features: ['export'],
limits: {},
prices: { month: { amount: 1900, currency: 'CHF' } },
},
],
defaultPlanId: 'free',
tax: { rateBps: 810 }, // Swiss VAT 8.1 %
});MIT
Leggere, modificare, gestire in proprio.
Il tuo database
Postgres tramite Drizzle – o un adapter tuo.
Nessun nostro backend
Niente «chiama casa».
Centesimi interi
Il denaro non è mai un numero in virgola mobile.
Perché agentkit
Per Membear, il nostro software di gestione per associazioni, abbiamo costruito fatture QR, TWINT tramite zahls.ch, IVA, riconciliazione bancaria e fatture in quattro lingue. Gli ostacoli raramente erano nel codice, ma nei dettagli: numeri di riferimento, arrotondamenti, scadenze, traduzioni.
Poi ci siamo accorti che ogni prodotto svizzero ricostruisce esattamente questo. Gli strumenti di fatturazione generici ragionano in Stripe, centesimi e inglese – la Svizzera arriva, se va bene, come plugin.
Per questo estraiamo il codice dalla produzione e ne facciamo kit che ogni app TypeScript può usare. Gratis e open source con licenza MIT.
Il team di siebenberge
Open source
subkit e shopkit sono su GitHub con licenza MIT, i pacchetti su npm. Puoi leggere il codice, adattarlo e gestirlo in proprio – senza commissioni per transazione e senza dipendere da noi.
Licenza MIT
Utilizzabile commercialmente, anche in software proprietario.
Nessun lock-in
Il codice gira nella tua app, i dati restano nel tuo database. Basta un fork per proseguire in modo indipendente.
Sviluppo aperto
Roadmap, issue e pull request sono pubbliche – i contributi sono benvenuti.
Roadmap
Ogni kit nasce da codice già in produzione e viene estratto solo quando ha dato prova di sé.
subkit + shopkit
su npm
subkit 0.2 e shopkit 0.4 come @agentkit.ch/subkit e @agentkit.ch/shopkit, il codice con licenza MIT su GitHub: fattura QR, riconciliazione bancaria (camt.053 / camt.054), IVA, zahls.ch con TWINT, adapter Drizzle per Postgres. Novità in shopkit: ordini tramite agente IA (MCP), collegamento a HS-Soft (WaWiAssist), il back office da integrare e le etichette della Posta con verifica dell’indirizzo.
core + CLI
in seguito
Un nucleo comune con suite di test degli adapter, una CLI per schema e route, la documentazione anche in tedesco. In shopkit: tariffe in tempo reale della Posta e rimborsi tramite zahls.ch.
Solleciti e adapter
2027
1°, 2° e 3° sollecito con spese e PDF di sollecito con nuova fattura QR. Adapter Prisma e Kysely.
Domande
Qualcosa non è chiaro? Le demo mostrano i kit con le loro vere opzioni.
subkit fattura i pagamenti ricorrenti: piani, abbonamenti, periodi di prova e fatture – per SaaS, affiliazioni o quote associative. shopkit vende prodotti: catalogo, carrello, checkout, ordini e buoni regalo. Entrambi condividono i dati dei clienti, il fornitore di pagamento e la fattura QR.
No. Ogni kit funziona da solo. Un’associazione con quote sociali e fan shop li prende entrambi, un SaaS di solito solo subkit.
Sì, da shopkit 0.2. createShopCustomerMcpHandler trasforma il tuo shop in un server MCP: l’agente della cliente – Claude, ChatGPT o Cursor – cerca i prodotti, calcola l’ordine con IVA e spedizione e ordina. Si paga con un link zahls.ch o con il metodo di pagamento salvato, e viene addebitato solo l’importo confermato. Chi ordina lo decide il tuo login (OAuth o chiave API).
Sì. @agentkit.ch/shopkit/hssoft importa gli articoli di WaWiAssist come prodotti e vi invia ogni ordine, con il giorno di ritiro come data dell’ordine. Ti serve solo la chiave API del tuo WaWiAssist, fornita da HS-Soft.
Sì, da shopkit 0.4. @agentkit.ch/shopkit/swisspost crea l’etichetta con codice a barre dall’ordine – nel back office, tramite API o MCP – e invia alla cliente il numero d’invio con Track & Trace. Nel checkout propone gli indirizzi della Posta e li verifica. Ti servono una licenza d’affrancatura e un accesso alla Digital Commerce API della Posta. Le etichette per l’estero e le tariffe in tempo reale sono previste.
Sì. subkit e shopkit sono su github.com/siebenberge/agentkit con licenza MIT, i pacchetti su npm. Issue e pull request sono benvenute.
Nel tuo database. I kit girano come libreria nella tua app e scrivono nelle tue tabelle tramite adapter. Non c’è nessun backend agentkit e nessun responsabile del trattamento aggiuntivo.
TWINT e carte di credito tramite zahls.ch, oltre alla fattura con fattura QR svizzera. Altri fornitori si collegano tramite l’interfaccia PaymentProvider.
I kit sono gratuiti. Non prendiamo commissioni per transazione – paghi solo il tuo fornitore di pagamento.
TypeScript, utilizzabile anche da JavaScript. I kit si collegano come route in Next.js, Hono, SvelteKit, Remix o Express e girano su Node.js, Bun, Deno o all’edge. Scrivono i dati in Postgres tramite l’adapter Drizzle; adapter per Prisma e Kysely sono previsti.
Sì: npm i @agentkit.ch/subkit o npm i @agentkit.ch/shopkit. subkit nasce da codice in produzione; shopkit è in anteprima. Provali senza installare: sub.agentkit.ch e shop.agentkit.ch.
Copia il prompt di setup nel tuo agente di coding – oppure prova prima i kit nel browser.
Aggiungi abbonamenti con fattura QR e TWINT usando @agentkit.ch/subkit. Leggi prima https://agentkit.ch/llms.txt.