# kassza

> Nem hivatalos, nulla függőségű TypeScript kliens a Számlázz.hu Számla Agenthez: számla, díjbekérő, nyugta, sztornó, befizetés, PDF és adószám-lekérdezés.

A kassza nem hivatalos, nyílt forráskódú projekt, a Számlázz.hu (KBOSS.hu Kft.) nem áll mögötte. Telepítés: `npm install kassza`. A Számla Agent hivatalos leírása: https://docs.szamlazz.hu/hu/agent/

Minden dokumentációs oldal Markdownként is elérhető, ha az oldal URL-jéhez hozzáadod a `.md` kiterjesztést (a kezdőlapé `/docs/index.md`). A teljes dokumentáció egyetlen fájlban: https://kassza-amber.vercel.app/llms-full.txt

## Bevezetés

- [Dokumentáció](https://kassza-amber.vercel.app/docs/index.md): A kassza dokumentációja. TypeScript kliens a Számlázz.hu Számla Agenthez, kérés, válasz és XML minta minden művelethez.

## Alapok

- [Mi a kassza?](https://kassza-amber.vercel.app/docs/alapok/mi-a-kassza.md): A kassza TypeScript kliens a Számlázz.hu Számla Agenthez. Mit old meg a nyers Agent API-hoz képest, és mit nem.
- [Hogyan működik a kassza?](https://kassza-amber.vercel.app/docs/alapok/hogyan-mukodik.md): Egy számla útja a kódodtól a vevő postafiókjáig, lépésről lépésre, a kassza szemszögéből.
- [Telepítés](https://kassza-amber.vercel.app/docs/alapok/telepites.md): A kassza telepítése, az Agent kulcs beállítása és az első számla kiállítása.
- [Hitelesítés (Agent kulcs)](https://kassza-amber.vercel.app/docs/alapok/hitelesites.md): Az Agent kulcs beállítása, a régi felhasználónév és jelszó, több fiók kezelése és a kulcs ellenőrzése.
- [Kliens beállítása](https://kassza-amber.vercel.app/docs/alapok/kliens-beallitasa.md): A createKassza() összes opciója, az alapértelmezések, az időkorlát, az újrapróbálás és a hookok.
- [Hibakezelés, hibakódok](https://kassza-amber.vercel.app/docs/alapok/hibakezeles.md): A SzamlazzError felépítése, a hibakategóriák, a bizonytalan kimenetű hibák kezelése és a Számla Agent összes ismert hibakódja.
- [Munkamenet (session cookie)](https://kassza-amber.vercel.app/docs/alapok/munkamenet.md): Hogyan menti és küldi vissza a kassza a Számlázz.hu munkameneti sütijét, és hogyan oszd meg serverless és edge környezetben.
- [Hálózat és biztonság](https://kassza-amber.vercel.app/docs/alapok/halozat-es-biztonsag.md): Tűzfalszabályok a Számlázz.hu felé és felől, időkorlát, újrapróbálás, naplózás hookokkal és az Agent kulcs védelme.
- [Kérések küldése](https://kassza-amber.vercel.app/docs/alapok/keresek-kuldese.md): A Számla Agent egyetlen végpontja, a műveletek form mezői, a multipart kérés felépítése és amit a kassza ebből elvégez helyetted.

## Számla létrehozás

- [Számla létrehozás](https://kassza-amber.vercel.app/docs/szamla-letrehozas.md): Számla, díjbekérő, előleg-, vég- és helyesbítő számla, szállítólevél kiállítása a kassza invoices.create() metódusával.
- [Kérés](https://kassza-amber.vercel.app/docs/szamla-letrehozas/keres.md): Az invoices.create() bemenete mezőről mezőre, a Számla Agent XML elemeivel, alapértékekkel és a kassza által ellenőrzött szabályokkal.
- [Válasz](https://kassza-amber.vercel.app/docs/szamla-letrehozas/valasz.md): A CreatedInvoice mezői, honnan jönnek a Számlázz.hu válaszából, a PDF mentése, és a számlakészítésnél jellemző hibák.
- [Minta](https://kassza-amber.vercel.app/docs/szamla-letrehozas/minta.md): Futtatható számlakészítési példák a kassza kódjával, a ténylegesen elküldött xmlszamla XML-lel és a Számlázz.hu válaszával.
- [Számlázási beállítások és szabályok](https://kassza-amber.vercel.app/docs/szamla-letrehozas/beallitasok-es-szabalyok.md): Bizonylattípusok, áfakulcsok, kerekítés, devizák, számlakép és nyelv, rendelésszám, kedvezmény, e-mail értesítő, adattörlő kód és előnézet.
- [Bizonylattípusok](https://kassza-amber.vercel.app/docs/szamla-letrehozas/beallitasok-es-szabalyok/bizonylattipusok.md): Számla, díjbekérő, előlegszámla, végszámla, helyesbítő számla és szállítólevél kiállítása a type mezővel, valamint e-számla vagy papírszámla.
- [Egyszerűsített számlakép utazásszervezőknek](https://kassza-amber.vercel.app/docs/szamla-letrehozas/beallitasok-es-szabalyok/utazasszervezok.md): A simpleItems mező, amellyel az utazásszervezők ár- és áfaadatok nélküli számlaképet állíthatnak ki, a korlátaival és hibakódjaival.
- [Áfakulcsok](https://kassza-amber.vercel.app/docs/szamla-letrehozas/beallitasok-es-szabalyok/afakulcsok.md): A vat mezőben megadható számszerű áfakulcsok és áfakódok, a VatRate típus, és a közösségi áfát jelző euVat mező.
- [Kerekítés](https://kassza-amber.vercel.app/docs/szamla-letrehozas/beallitasok-es-szabalyok/kerekites.md): Hogyan számolja a kassza a tételek nettó, áfa és bruttó értékét forintos és devizás számlán, nettó és bruttó alapon, interaktív kalkulátorral.
- [Támogatott devizanemek](https://kassza-amber.vercel.app/docs/szamla-letrehozas/beallitasok-es-szabalyok/penznemek.md): A currency mezőben megadható pénznemkódok, az árfolyam és az árfolyamot jegyző bank megadása devizás számlán.
- [Számlasablon és nyelvek](https://kassza-amber.vercel.app/docs/szamla-letrehozas/beallitasok-es-szabalyok/szamlasablon-es-nyelvek.md): A számlakép kiválasztása a template mezővel, és a számla, az értesítő e-mail és a vevői fiók nyelvének beállítása a language mezővel.
- [Rendelésszám és duplikáció-ellenőrzés](https://kassza-amber.vercel.app/docs/szamla-letrehozas/beallitasok-es-szabalyok/rendelesszam.md): Az orderNumber mező, a Számlázz.hu „Rendelésszám ismétlődés tiltása” beállítása, és hogyan véd a dupla számla ellen a kasszával.
- [Kedvezmény feltüntetése a számlán](https://kassza-amber.vercel.app/docs/szamla-letrehozas/beallitasok-es-szabalyok/kedvezmeny.md): Kedvezmény megadása negatív egységárú tételként, a hozzá tartozó áfakulccsal, százalékos kedvezmény kiszámolása a kasszával.
- [Számlaértesítő küldés](https://kassza-amber.vercel.app/docs/szamla-letrehozas/beallitasok-es-szabalyok/ertesito-email.md): Mikor küld e-mailt a Számlázz.hu a vevőnek, hogyan kapcsold ki, hogyan szabd testre a tárgyat és a szöveget, és hogyan csatolj fájlokat.
- [Adattörlő kód](https://kassza-amber.vercel.app/docs/szamla-letrehozas/beallitasok-es-szabalyok/adattorlo-kod.md): A tételek dataDeletionCode mezője (torloKod), a fiókbeállítás, a korlátok és a kapcsolódó hibakódok.
- [Előnézet](https://kassza-amber.vercel.app/docs/szamla-letrehozas/beallitasok-es-szabalyok/elonezet.md): Számla PDF előnézet kiállítás nélkül az invoices.preview() metódussal, például megrendelés jóváhagyásához vagy sablon teszteléséhez.

## Számla sztornó

- [Számla sztornó](https://kassza-amber.vercel.app/docs/szamla-sztorno.md): Kiállított számla érvénytelenítése sztornó számlával a kassza invoices.reverse() metódusával.
- [Kérés](https://kassza-amber.vercel.app/docs/szamla-sztorno/keres.md): Az invoices.reverse() bemenete, a Számla Agent xmlszamlast XML elemeivel és alapértékekkel.
- [Válasz](https://kassza-amber.vercel.app/docs/szamla-sztorno/valasz.md): A ReversedInvoice mezői, amelyeket az invoices.reverse() visszaad, és a sztornózásnál jellemző hibák.
- [Minta](https://kassza-amber.vercel.app/docs/szamla-sztorno/minta.md): Számla kiállítása, sztornózása és a sztornózott állapot ellenőrzése, a ténylegesen elküldött xmlszamlast XML-lel.

## Befizetés rögzítése

- [Befizetés rögzítése](https://kassza-amber.vercel.app/docs/befizetes-rogzitese.md): Befizetés (jóváírás) rögzítése és törlése kiállított számlán az invoices.registerPayment() és clearPayments() metódussal, és a fizetési értesítés (IPN) fogadása.
- [Kérés](https://kassza-amber.vercel.app/docs/befizetes-rogzitese/keres.md): Az invoices.registerPayment() és clearPayments() bemenete, a Számla Agent xmlszamlakifiz XML elemeivel, alapértékekkel és az újrapróbálás szabályával.
- [Válasz](https://kassza-amber.vercel.app/docs/befizetes-rogzitese/valasz.md): A RegisteredPayment mezői, amelyeket a registerPayment() és a clearPayments() visszaad, és a befizetés rögzítésénél jellemző hibák.
- [Minta](https://kassza-amber.vercel.app/docs/befizetes-rogzitese/minta.md): Számla kiállítása, egy és több befizetés rögzítése, majd a befizetések törlése, a ténylegesen elküldött xmlszamlakifiz XML-lel.
- [IPN fizetési értesítés](https://kassza-amber.vercel.app/docs/befizetes-rogzitese/ipn.md): A Számlázz.hu kifizetési értesítésének (IPN) fogadása a kassza/ipn modullal, a beállítással, az újraküldés szabályaival, idempotens feldolgozással és a küldő IP-címek ellenőrzésével.

## Bizonylat lekérése PDF-ben

- [Bizonylat lekérése PDF-ben](https://kassza-amber.vercel.app/docs/bizonylat-pdf.md): Egy korábban kiállított bizonylat PDF-jének letöltése számlaszám, rendelésszám vagy külső azonosító alapján a kassza invoices.getPdf() metódusával.
- [Kérés](https://kassza-amber.vercel.app/docs/bizonylat-pdf/keres.md): Az invoices.getPdf() bemenete, a bizonylat azonosítása számlaszámmal, rendelésszámmal vagy külső azonosítóval, a Számla Agent xmlszamlapdf XML elemeivel.
- [Válasz](https://kassza-amber.vercel.app/docs/bizonylat-pdf/valasz.md): Az InvoicePdf mezői, amelyeket az invoices.getPdf() visszaad, a PDF letöltése Next.js route-ból, mentése tárhelyre, és a PDF lekérésnél előforduló hibák.
- [Minta](https://kassza-amber.vercel.app/docs/bizonylat-pdf/minta.md): Számla kiállítása PDF nélkül, majd a PDF lekérése rendelésszám alapján, a ténylegesen elküldött xmlszamlapdf XML-lel.

## Számla adatainak lekérése

- [Számla adatainak lekérése](https://kassza-amber.vercel.app/docs/szamla-adatai.md): Egy kiállított számla teljes adattartalma típusos objektumként a kassza invoices.get() és invoices.find() metódusával.
- [Kérés](https://kassza-amber.vercel.app/docs/szamla-adatai/keres.md): Az invoices.get() és invoices.find() bemenete, a bizonylat azonosítása, a PDF kérése és a Számla Agent xmlszamlaxml XML elemei.
- [Válasz](https://kassza-amber.vercel.app/docs/szamla-adatai/valasz.md): Az InvoiceDetails teljes szerkezete, amelyet az invoices.get() visszaad, a Számlázz.hu szamla XML elemeivel, és a lekérésnél előforduló hibák.
- [Minta](https://kassza-amber.vercel.app/docs/szamla-adatai/minta.md): Számla kiállítása, az adatai lekérése rendelésszám alapján, és a find egy nem létező rendelésre, a ténylegesen elküldött xmlszamlaxml XML-lel.

## Díjbekérő törlése

- [Díjbekérő törlése](https://kassza-amber.vercel.app/docs/dijbekero-torlese.md): Ki nem fizetett díjbekérő törlése díjbekérőszám vagy rendelésszám alapján a kassza invoices.deleteProforma() metódusával.
- [Kérés](https://kassza-amber.vercel.app/docs/dijbekero-torlese/keres.md): Az invoices.deleteProforma() bemenete, a díjbekérő három hivatkozási formája és a Számla Agent xmlszamladbkdel XML elemei.
- [Válasz](https://kassza-amber.vercel.app/docs/dijbekero-torlese/valasz.md): Mit ad vissza az invoices.deleteProforma(), milyen hibák fordulnak elő díjbekérő törlésekor, és mi a teendő hálózati hiba után.
- [Minta](https://kassza-amber.vercel.app/docs/dijbekero-torlese/minta.md): Díjbekérő kiállítása, törlése rendelésszám alapján és a második törlés 335-ös hibája, a ténylegesen elküldött xmlszamladbkdel XML-lel.

## Nyugta létrehozás

- [Nyugta létrehozás](https://kassza-amber.vercel.app/docs/nyugta-letrehozas.md): Nyugta kiállítása a kassza receipts.create() metódusával, hívásazonosítóval, forintos kerekítéssel és vegyes fizetéssel.
- [Kérés](https://kassza-amber.vercel.app/docs/nyugta-letrehozas/keres.md): A receipts.create() bemenete mezőről mezőre, az xmlnyugtacreate XML elemeivel, alapértékekkel, a hívásazonosító szerepével és a kassza által ellenőrzött szabályokkal.
- [Válasz](https://kassza-amber.vercel.app/docs/nyugta-letrehozas/valasz.md): A Receipt mezői, honnan jönnek az xmlnyugtavalasz válaszból, a PDF mentése, és a nyugtakészítésnél jellemző hibák.
- [Minta](https://kassza-amber.vercel.app/docs/nyugta-letrehozas/minta.md): Futtatható nyugtakészítési példa a kassza kódjával, a ténylegesen elküldött xmlnyugtacreate XML-lel és a Számlázz.hu válaszával, valamint az XSD séma.
- [Nyugta beállítások és szabályok](https://kassza-amber.vercel.app/docs/nyugta-letrehozas/beallitasok.md): Tételösszegek és kerekítés, PDF sablon, rendelésszám és hívásazonosító, NAV adatszolgáltatás és adattörlő kód a nyugtán.
- [Tételösszegek és kerekítés](https://kassza-amber.vercel.app/docs/nyugta-letrehozas/beallitasok/tetelosszegek.md): Forintos nyugtán a bruttó egész, a nettó és az áfa legfeljebb 2 tizedes, és az összegük pontosan a bruttó. Így számol a kassza, és ezt jelentik a 261-es és a 363–365-ös hibák.
- [PDF sablon](https://kassza-amber.vercel.app/docs/nyugta-letrehozas/beallitasok/pdf-sablon.md): A nyugta PDF sablonjának kiválasztása a template mezővel ('A', 'N', 'J', 'L'), és a PDF letöltése a downloadPdf opcióval.
- [Rendelésszám és hívásazonosító](https://kassza-amber.vercel.app/docs/nyugta-letrehozas/beallitasok/rendelesszam.md): Az orderNumber mező a nyugtán, a nyugtákra vonatkozó „Rendelésszám ismétlődés tiltása” beállítás, és a callId, amely a dupla nyugta ellen véd.
- [NAV adatszolgáltatás](https://kassza-amber.vercel.app/docs/nyugta-letrehozas/beallitasok/nav-adatszolgaltatas.md): A nyugták kötelező NAV adatszolgáltatása 2026. szeptember 1-jétől, a 2026. december 31-ig tartó türelmi idő, és mit jelent ez a kassza használatakor.
- [Adattörlő kód](https://kassza-amber.vercel.app/docs/nyugta-letrehozas/beallitasok/adattorlo-kod.md): A nyugtatételek dataDeletionCode mezője (torloKod), a szükséges fiókbeállítás, a korlátok és a kapcsolódó hibakódok.

## Nyugta sztornó

- [Nyugta sztornó](https://kassza-amber.vercel.app/docs/nyugta-sztorno.md): Kiállított nyugta érvénytelenítése sztornó nyugtával a kassza receipts.reverse() metódusával.
- [Kérés](https://kassza-amber.vercel.app/docs/nyugta-sztorno/keres.md): A receipts.reverse() bemenete, a Számla Agent xmlnyugtast XML elemeivel és alapértékekkel.
- [Válasz](https://kassza-amber.vercel.app/docs/nyugta-sztorno/valasz.md): A sztornó nyugta Receipt objektuma, amelyet a receipts.reverse() visszaad, és a sztornózásnál jellemző hibák.
- [Minta](https://kassza-amber.vercel.app/docs/nyugta-sztorno/minta.md): Nyugta kiállítása és sztornózása hívásazonosítóval, a ténylegesen elküldött xmlnyugtast XML-lel.

## Nyugta lekérdezés

- [Nyugta lekérdezés](https://kassza-amber.vercel.app/docs/nyugta-lekerdezes.md): Kiállított nyugta adatainak és PDF-jének lekérése nyugtaszám vagy rendelésszám alapján a kassza receipts.get() és receipts.find() metódusával.
- [Kérés](https://kassza-amber.vercel.app/docs/nyugta-lekerdezes/keres.md): A receipts.get() és a receipts.find() bemenete, a Számla Agent xmlnyugtaget XML elemeivel és alapértékekkel.
- [Válasz](https://kassza-amber.vercel.app/docs/nyugta-lekerdezes/valasz.md): A Receipt mezői, amelyeket a receipts.get() és a receipts.find() visszaad, a Számlázz.hu xmlnyugtavalasz elemeivel, és a lekérdezésnél jellemző hibák.
- [Minta](https://kassza-amber.vercel.app/docs/nyugta-lekerdezes/minta.md): Nyugta kiállítása és lekérdezése nyugtaszám és rendelésszám alapján, a find() nem létező nyugtára, a ténylegesen elküldött xmlnyugtaget XML-lel.

## Nyugta kiküldés

- [Nyugta kiküldés](https://kassza-amber.vercel.app/docs/nyugta-kikuldes.md): Kiállított nyugta elküldése e-mailben a vevőnek a kassza receipts.send() metódusával.
- [Kérés](https://kassza-amber.vercel.app/docs/nyugta-kikuldes/keres.md): A receipts.send() bemenete, a Számla Agent xmlnyugtasend XML elemeivel, alapértékekkel és a kliensoldali ellenőrzéssel.
- [Válasz](https://kassza-amber.vercel.app/docs/nyugta-kikuldes/valasz.md): Mit jelent, ha a receipts.send() hiba nélkül visszatér, hogyan olvassa a kassza az xmlnyugtasendvalasz választ, és milyen hibák fordulnak elő.
- [Minta](https://kassza-amber.vercel.app/docs/nyugta-kikuldes/minta.md): Nyugta kiállítása és kiküldése két címzettnek, a ténylegesen elküldött xmlnyugtasend XML-lel.

## Adószám lekérdezés

- [Adószám lekérdezés](https://kassza-amber.vercel.app/docs/adoszam-lekerdezes.md): Magyar adózó adatainak lekérdezése a NAV-tól törzsszám vagy adószám alapján, a kassza taxpayer.query() metódusával.
- [Kérés](https://kassza-amber.vercel.app/docs/adoszam-lekerdezes/keres.md): A taxpayer.query() bemenete, az elfogadott adószám formátumok, a Számla Agent xmltaxpayer XML-je és az előellenőrzés a kassza/validators modullal.
- [Válasz](https://kassza-amber.vercel.app/docs/adoszam-lekerdezes/valasz.md): A TaxpayerInfo és a TaxpayerAddress mezői, a valid false eset, a számla vevőjének kitöltése a válaszból, és az adószám lekérdezésnél előforduló hibák.
- [Minta](https://kassza-amber.vercel.app/docs/adoszam-lekerdezes/minta.md): Adószám előellenőrzése, lekérdezése és a számla vevőjének kitöltése a sandboxban, a ténylegesen elküldött xmltaxpayer XML-lel és a NAV válaszával.

## Kiegészítők

- [Kiegészítők](https://kassza-amber.vercel.app/docs/kiegeszitok.md): A kassza alcsomagjai a számlázás körüli munkához. Mock kliens tesztekhez, validátorok, pénzszámítás, PDF tárhely, serverless futtatás és AI asszisztensek.
- [Tesztelés](https://kassza-amber.vercel.app/docs/kiegeszitok/teszteles.md): Mock kliens a kassza/testing modulból. Hívásnapló, memóriában tárolt bizonylatok, szimulált hibák, Vitest példák és a kliens injektálása.
- [Validátorok](https://kassza-amber.vercel.app/docs/kiegeszitok/validatorok.md): A kassza/validators modul. Magyar adószám CDV ellenőrzéssel, bankszámla, IBAN, EU adószám, e-mail, irányítószám, Agent kulcs és cím feldolgozása űrlap-validációhoz.
- [Pénzszámítás](https://kassza-amber.vercel.app/docs/kiegeszitok/penzszamitas.md): A kassza/money modul. Tételösszegek számla és nyugta kerekítési szabályai szerint, áfabontás, kosár végösszeg, pénzügyi kerekítés és áfakulcs ellenőrzés.
- [PDF tárhely](https://kassza-amber.vercel.app/docs/kiegeszitok/pdf-tarhely.md): A kassza/storage modul. A számla és a nyugta PDF-jének mentése S3-ba, Cloudflare R2-be, Vercel Blobba, UploadThingre, Supabase-be vagy lemezre, dátum szerinti kulcsokkal és lejáró letöltési linkkel.
- [Serverless és edge](https://kassza-amber.vercel.app/docs/kiegeszitok/serverless-es-edge.md): A kassza futtatása Vercelen, Cloudflare Workersen, Denón, Bunon és AWS Lambdán. Közös munkamenet-tároló, környezeti változók, időkorlát és webhook minták.
- [AI asszisztensek](https://kassza-amber.vercel.app/docs/kiegeszitok/ai-asszisztensek.md): A kassza csomagban szállított agents mappa és az llms.txt használata Claude Code, Cursor és GitHub Copilot mellett, hogy az AI jó Számlázz.hu integrációt írjon.

## Receptek

- [Receptek](https://kassza-amber.vercel.app/docs/receptek.md): Teljes, bemásolható integrációs minták a kasszához. Webshop számlázás, Stripe és IPN webhook, díjbekérő, nyugta, PDF tárolás, adószám-kitöltés, devizás számla, Cloudflare Workers és egységtesztek.
- [Közös kliens](https://kassza-amber.vercel.app/docs/receptek/kozos-kliens.md): Egyetlen szerveroldali kassza kliens alapbeállításokkal, hibanaplózással és közös munkamenettel, amelyet a többi recept importál.
- [Fizetett rendelés számlája](https://kassza-amber.vercel.app/docs/receptek/fizetett-rendeles-szamla.md): Idempotens számlázás rendelésszámmal. Egy rendelésről akkor is csak egy számla készül, ha a fizetési webhook többször érkezik, vagy a kérés időtúllépéssel ér véget.
- [Stripe webhook](https://kassza-amber.vercel.app/docs/receptek/stripe-webhook.md): Számla a Stripe Checkout checkout.session.completed eseményéből. Aláírás-ellenőrzés, idempotencia rendelésszámmal, lekérdezés a kiállítás előtt, és korlátozott újrapróbálás.
- [Nevezés díjbekérővel](https://kassza-amber.vercel.app/docs/receptek/nevezes-dijbekerovel.md): Versenynevezés vagy rendezvényjelentkezés átutalásos fizetéssel. Díjbekérő a jelentkezéskor, számla a befizetés után, díjbekérő törlése lemondáskor.
- [IPN webhook](https://kassza-amber.vercel.app/docs/receptek/ipn-webhook.md): A Számlázz.hu fizetési értesítésének (IPN) fogadása Next.js route handlerben, IP-ellenőrzéssel, a számla állapotának visszaellenőrzésével és idempotens mentéssel.
- [Pénztári nyugta](https://kassza-amber.vercel.app/docs/receptek/penztari-nyugta.md): Nyugta egy pénztári eladásról hívásazonosítóval, a dupla nyugta kezelésével és e-mail kiküldéssel, Next.js route handlerben.
- [PDF mentése S3-ba vagy R2-be](https://kassza-amber.vercel.app/docs/receptek/pdf-mentes-s3-r2.md): A számla PDF-jének mentése saját Amazon S3 vagy Cloudflare R2 tárhelyre AWS SDK nélkül, stabil kulccsal és rövid ideig érvényes letöltési linkkel.
- [Adószám alapú kitöltés](https://kassza-amber.vercel.app/docs/receptek/adoszam-urlap.md): Számlázási űrlap, amely a beírt adószám alapján a NAV adataiból tölti ki a cégnevet és a székhely címét. Route handler és kliens komponens.
- [Devizás számla EU-s cégnek](https://kassza-amber.vercel.app/docs/receptek/devizas-eu-szamla.md): Euróban kiállított, angol nyelvű számla másik tagállambeli cégnek, közösségi adószámmal, MNB árfolyammal és angol értesítő e-maillel.
- [Cloudflare Workers](https://kassza-amber.vercel.app/docs/receptek/cloudflare-workers.md): Cloudflare Worker, amely a kasszával lekérdezi a számlákat, a munkamenetet KV-ben tartja, a számla PDF-eket pedig R2-ben gyorsítótárazza.
- [Egységtesztek](https://kassza-amber.vercel.app/docs/receptek/egysegtesztek.md): Vitest tesztek a receptek kódjához mock klienssel. Idempotencia, időtúllépés utáni lekérdezés, díjbekérő és számla, dupla nyugta, budapesti dátum és egy route handler teszt.

## Optional

- [Sandbox](https://kassza-amber.vercel.app/sandbox): A kassza példái a böngészőben futtathatók, Agent kulcs nélkül, egy szimulált Számlázz.hu ellen.
- [GitHub](https://github.com/futozs/kassza): Forráskód, hibabejelentés.
- [npm](https://www.npmjs.com/package/kassza): A kassza csomag, jelenlegi verzió: 0.9.0.
- [Változásnapló](https://github.com/futozs/kassza/blob/main/CHANGELOG.md)
- [Számlázz.hu Számla Agent (hivatalos dokumentáció)](https://docs.szamlazz.hu/hu/agent/)