Kiegészítők
A fő kassza modul a Számla Agent hívásait intézi. A körülötte lévő feladatokra külön alcsomagok vannak, amelyeket csak akkor importálsz, ha kellenek. Egyiknek sincs futásidejű függősége, és a kassza/storage/fs kivételével egyik sem használ Node.js API-t.
| Alcsomag | Mire való? |
|---|---|
kassza/testing | Mock kliens és hamis Számla Agent hálózat és Agent kulcs nélküli tesztekhez |
kassza/validators | Adószám, bankszámla, IBAN, EU adószám, e-mail és cím ellenőrzése |
kassza/money | A számlán használt kerekítés és összegzés a saját kódodban |
kassza/storage, kassza/storage/fs | A bizonylat PDF mentése S3-ba, R2-be, Vercel Blobba, Supabase-be vagy lemezre |
kassza/cookie-stores | Közös munkamenet-tároló serverless és edge környezethez |
kassza/ipn | A Számlázz.hu fizetési értesítéseinek fogadása |
kassza/payments és szolgáltatónként kassza/payments/stripe, …/simplepay, …/barion, …/revolut, …/paypal | Fizetésből bizonylat: webhookok és issueForPayment |
kassza/reports, kassza/nav | NAV nyugta-adatszolgáltatás: napi összesítő, NAV kliens, egyeztetés |
kassza/delegation | Megbízotti számlázás sok cég nevében |
kassza/data-link | A pénzügyi adatkapcsolat fogadása |
kassza/mcp | MCP szerver AI asszisztenseknek, saját átvitellel |
A csomag egy kassza parancsot is ad (npx kassza), lásd Parancssor.
createMockKassza: hívásnapló, szimulált hibák és Vitest példák valódi API nélkül.
Hamis Számla AgentcreateFakeAgentFetch: a valódi kliens tesztje elveszett válasszal, karbantartással és a Számlázz.hu szabályaival.
ValidátorokAdószám CDV, bankszámla, IBAN, EU adószám, e-mail és magyar cím feldolgozása.
PénzszámításTételösszegek, áfabontás és kerekítés pontosan úgy, ahogy a számlára kerül.
PDF tárhelystorePdf, dátum szerinti kulcsok és adapterek S3-hoz, R2-höz, Vercel Blobhoz és társaikhoz.
Serverless és edgeVercel, Cloudflare Workers, Deno, Bun és AWS Lambda: munkamenet, időkorlát, webhookok.
AI asszisztensekAz agents mappa és az llms.txt használata Claude Code, Cursor és Copilot mellett.
Parancssorkassza doctor, verify, xml preview, lekérdezések és napi NAV-összesítő.
MCP szerverSzámla és nyugta AI asszisztensből, előnézettel és megerősítéssel.