# 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://www.kasszajs.hu/llms-full.txt

## Bevezetés

- [Dokumentáció](https://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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.
- [Nyugta vagy számla?](https://www.kasszajs.hu/docs/alapok/nyugta-vagy-szamla.md): Mikor adható Számla Agent nyugta, mikor kell számla, ki online pénztárgép-köteles, és hogyan dönt a kassza chooseDocument függvénye. A nyugta utólagos számlává alakítása is.
- [Telepítés](https://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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.
- [Pontosan egyszer](https://www.kasszajs.hu/docs/alapok/pontosan-egyszer.md): Számla és nyugta pontosan egyszer a createOnce metódusokkal, egyidejű hívások és elosztott zár, védelem a fiók kitiltása ellen folyamatok között (attemptLedger), karbantartási szünet, az onDocument hook és a figyelmeztetések.
- [Munkamenet (session cookie)](https://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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.
- [Áttérés a szamlazz.js-ről](https://www.kasszajs.hu/docs/alapok/migracio-szamlazz-js.md): Lépésről lépésre áttérés a szamlazz.js csomagról a kasszára - megfeleltetési táblázat, viselkedésbeli különbségek és őszinte összehasonlítás.

## Számla létrehozás

- [Számla létrehozás](https://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/docs/szamla-sztorno/keres.md): Az invoices.reverse() bemenete, a Számla Agent xmlszamlast XML elemeivel és alapértékekkel.
- [Válasz](https://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/docs/nyugta-sztorno/keres.md): A receipts.reverse() bemenete, a Számla Agent xmlnyugtast XML elemeivel és alapértékekkel.
- [Válasz](https://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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.

## Fizetésből bizonylat

- [Fizetésből bizonylat](https://www.kasszajs.hu/docs/fizetesek.md): Stripe, SimplePay, Barion, Revolut és PayPal fizetésből automatikusan nyugta vagy számla, nulla függőséggel. Aláírás-ellenőrzés, a nyugta vagy számla döntése, pontosan egyszeri kiállítás és sztornó visszatérítéskor.
- [Stripe](https://www.kasszajs.hu/docs/fizetesek/stripe.md): Stripe Checkout és Payment Intent fizetésből nyugta vagy számla, visszatérítésből sztornó a kassza/payments/stripe webhookkezelővel, Stripe SDK nélkül.
- [SimplePay](https://www.kasszajs.hu/docs/fizetesek/simplepay.md): OTP SimplePay v2 IPN-ből nyugta vagy számla a kassza/payments/simplepay kezelővel. Aláírás-ellenőrzés, aláírt IPN-visszaigazolás, tranzakció-lekérdezés, több kereskedői fiók és a visszairányítás ellenőrzése.
- [Barion](https://www.kasszajs.hu/docs/fizetesek/barion.md): Barion fizetésből nyugta vagy számla a kassza/payments/barion callback-kezelővel. A fizetés állapotát a kassza a Barion API-tól kérdezi le, így hamis callback nem állít ki bizonylatot.
- [Revolut](https://www.kasszajs.hu/docs/fizetesek/revolut.md): Revolut Business (Merchant API) fizetésből nyugta vagy számla a kassza/payments/revolut webhookkezelővel. Aláírás- és időbélyeg-ellenőrzés, a rendelés lekérése, visszatérítésből sztornó.
- [PayPal](https://www.kasszajs.hu/docs/fizetesek/paypal.md): PayPal capture-ből nyugta vagy számla, visszatérítésből sztornó a kassza/payments/paypal webhookkezelővel. Aláírás-ellenőrzés a PayPal API-val, tételek a rendelésből.

## NAV nyugta-adatszolgáltatás

- [NAV nyugta-adatszolgáltatás](https://www.kasszajs.hu/docs/nav-nyugta.md): 2026. szeptember 1-jétől a kézi és a számítógéppel előállított nyugtákról napi összesítőt kell küldeni a NAV-nak. Mit vállal ebből a Számlázz.hu, és miben segít a kassza.
- [Mi a teendő december 31. előtt?](https://www.kasszajs.hu/docs/nav-nyugta/hatarido.md): A NAV nyugta-adatszolgáltatás türelmi ideje 2026. december 31-én lejár. Döntési fa három forgatókönyvre, és hogy mit kell addig a kasszával előkészíteni.
- [Napi összesítő](https://www.kasszajs.hu/docs/nav-nyugta/napi-osszesito.md): A NAV nyugta-adatszolgáltatás napi összesítője a kiállított nyugtákból a navDailyReports függvénnyel, és napi pénztárzárás a dailyClose függvénnyel.
- [NAV kliens](https://www.kasszajs.hu/docs/nav-nyugta/nav-kliens.md): A NAV nyugta-adatszolgáltatás gépi interfészének (receipt-if) kliense a kassza/nav modulban. Technikai felhasználó, lekérdezés, beküldés, javítás, érvénytelenítés, kiállító szoftver és hibakezelés.
- [Egyeztetés](https://www.kasszajs.hu/docs/nav-nyugta/egyeztetes.md): Ellenőrzés, hogy a NAV-hoz minden nap nyugta-összesítője megérkezett-e, és egyezik-e a kiállított nyugtákkal. reconcileNavReports a helyi összesítő és a NAV lista összevetésére.
- [Kézi nyugtatömb](https://www.kasszajs.hu/docs/nav-nyugta/kezi-nyugtatomb.md): Tartalék papír nyugtatömb napi NAV-összesítője a paperReceiptReport függvénnyel, ha a Számlázz.hu nem érhető el, és beküldése a NAV klienssel.

## Megbízotti számlázás

- [Megbízotti számlázás](https://www.kasszajs.hu/docs/megbizott-szamlazas.md): Platformoknak, amelyek sok cég nevében állítanak ki számlát vagy nyugtát. A megbízói fiók csatlakoztatása, a kapcsolat állapotának ellenőrzése és megbízónkénti kassza kliensek a kassza/delegation modulban.
- [Csatlakozás](https://www.kasszajs.hu/docs/megbizott-szamlazas/csatlakozas.md): Megbízói Számlázz.hu fiók létrehozása vagy összekapcsolása a connectPrincipal függvénnyel. A négy lehetséges kimenet, az adószám ellenőrzése és az előtagok.
- [A kapcsolat állapota](https://www.kasszajs.hu/docs/megbizott-szamlazas/allapot.md): A probeDelegation ellenőrzi, hogy a dedikált felhasználó be tud-e már lépni a megbízó fiókjába, és ha nem, miért nem.
- [Kliensek megbízónként](https://www.kasszajs.hu/docs/megbizott-szamlazas/kliensek.md): Kiállítás a megbízó nevében a createDelegateKassza klienssel, és sok megbízó kiszolgálása egy folyamatból a createKasszaPool LRU poollal.

## Pénzügyi adatkapcsolat

- [Pénzügyi adatkapcsolat](https://www.kasszajs.hu/docs/adatkapcsolat.md): A Számlázz.hu pénzügyi adatkapcsolat (PUSH) fogadása a kassza/data-link kezelővel. Kimenő és bejövő számlák, banki tranzakciók és nyugták, azonosító kulcsok, iktatószám és helyes válasz XML.

## Kiegészítők

- [Kiegészítők](https://www.kasszajs.hu/docs/kiegeszitok.md): A kassza alcsomagjai a számlázás körüli munkához. Mock kliens és hamis Számla Agent tesztekhez, validátorok, pénzszámítás, PDF tárhely, serverless futtatás, parancssor, MCP szerver és AI asszisztensek.
- [Tesztelés](https://www.kasszajs.hu/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.
- [Hamis Számla Agent](https://www.kasszajs.hu/docs/kiegeszitok/hamis-agent.md): createFakeAgentFetch a kassza/testing modulból. Egy fetch, amely a valódi kérés-XML-t dolgozza fel, sorszámoz, a Számlázz.hu szabályai szerint hibát ad, és elveszett választ, karbantartást vagy részleges sikert szimulál.
- [Validátorok](https://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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.
- [Parancssor](https://www.kasszajs.hu/docs/kiegeszitok/parancssor.md): A kassza parancs (npx kassza). Környezetellenőrzés a doctor paranccsal, Agent kulcs ellenőrzése, a küldendő XML előnézete supportjegyhez, bizonylat lekérdezése és napi NAV nyugta-összesítő.
- [MCP szerver](https://www.kasszajs.hu/docs/kiegeszitok/mcp-szerver.md): A kassza MCP szervere Claude, Cursor és más MCP kliensek számára. Számla, nyugta és sztornó előnézettel és megerősítéssel, lekérdezések, adószám-ellenőrzés és napi NAV-összesítő. Alapból csak olvas.
- [Tárolók](https://www.kasszajs.hu/docs/kiegeszitok/tarolok.md): A kassza/stores alkönyvtár közös kulcs-érték tárolói (Redis, Upstash, Cloudflare KV, Durable Object), az atomikus műveletek, és hogy melyik tároló mire alkalmas.
- [Bizonylatnapló](https://www.kasszajs.hu/docs/kiegeszitok/bizonylatnaplo.md): A kassza/journal megbízható bizonylatnaplója a NAV napi nyugta-összesítőhöz és a napi záráshoz, befejezetlen tételek kezelésével és az adatkapcsolat archívumával való egyeztetéssel.
- [Node.js, Express, NestJS](https://www.kasszajs.hu/docs/kiegeszitok/node-express.md): A kassza webhook-kezelőinek (fizetések, IPN, adatkapcsolat) bekötése Express, NestJS és Fastify alá a kassza/node adapterrel, a nyers törzs megőrzésével.
- [Tömeges és ismétlődő számlázás](https://www.kasszajs.hu/docs/kiegeszitok/tomeges-szamlazas.md): Havi díjak, tagdíjak, bérleti díjak biztonságos kiállítása a kassza/batch modullal - idempotens kulcsok, sebességkorlát, próbafuttatás, leállás a Számlázz.hu korlátjánál, és hónap végét helyesen kezelő időszakok.
- [Megfigyelhetőség](https://www.kasszajs.hu/docs/kiegeszitok/megfigyelhetoseg.md): Strukturált napló, OpenTelemetry-kompatibilis tracing és Prometheus metrikák a kassza/observe modullal - függőség nélkül, titokmentesen, és semmit nem küld haza.

## Hibakódok

- [Hibakódok](https://www.kasszajs.hu/docs/hibakodok.md): A Számlázz.hu Számla Agent hibakódjai egyenként, magyarázattal és kassza-példával.
- [1-es hibakód: Rendszerkarbantartás, kérem próbálja meg pár perc múlva.](https://www.kasszajs.hu/docs/hibakodok/1.md): A Számlázz.hu Számla Agent 1-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [3-as hibakód: Sikertelen bejelentkezés.](https://www.kasszajs.hu/docs/hibakodok/3.md): A Számlázz.hu Számla Agent 3-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [7-es hibakód: Hiányzó adat: ismeretlen számlaszám, rendelésszám vagy külső azonosító.](https://www.kasszajs.hu/docs/hibakodok/7.md): A Számlázz.hu Számla Agent 7-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [8-as hibakód: Nincs jogosultság vagy megfelelő díjcsomag a művelet elvégzéséhez.](https://www.kasszajs.hu/docs/hibakodok/8.md): A Számlázz.hu Számla Agent 8-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [17-es hibakód: Nem megengedett művelet.](https://www.kasszajs.hu/docs/hibakodok/17.md): A Számlázz.hu Számla Agent 17-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [49-es hibakód: A tanúsítvány használatához jelszó szükséges.](https://www.kasszajs.hu/docs/hibakodok/49.md): A Számlázz.hu Számla Agent 49-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [52-es hibakód: Az áfakulcs nem értelmezhető.](https://www.kasszajs.hu/docs/hibakodok/52.md): A Számlázz.hu Számla Agent 52-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [53-as hibakód: Hiányzó XML fájl.](https://www.kasszajs.hu/docs/hibakodok/53.md): A Számlázz.hu Számla Agent 53-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [54-es hibakód: E-számla készítés nincs engedélyezve.](https://www.kasszajs.hu/docs/hibakodok/54.md): A Számlázz.hu Számla Agent 54-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [55-ös hibakód: E-számla aláírása sikertelen.](https://www.kasszajs.hu/docs/hibakodok/55.md): A Számlázz.hu Számla Agent 55-ös hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [56-os hibakód: A bizonylat elkészült, de az értesítő e-mail kiküldése sikertelen.](https://www.kasszajs.hu/docs/hibakodok/56.md): A Számlázz.hu Számla Agent 56-os hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [57-es hibakód: XML beolvasási hiba.](https://www.kasszajs.hu/docs/hibakodok/57.md): A Számlázz.hu Számla Agent 57-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [68-as hibakód: Már létezik cég ezzel az adószámmal és számlaszám-előtaggal.](https://www.kasszajs.hu/docs/hibakodok/68.md): A Számlázz.hu Számla Agent 68-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [71-es hibakód: Már létező rendelésszám.](https://www.kasszajs.hu/docs/hibakodok/71.md): A Számlázz.hu Számla Agent 71-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [101-es hibakód: A bejelentkezési név már foglalt.](https://www.kasszajs.hu/docs/hibakodok/101.md): A Számlázz.hu Számla Agent 101-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [135-ös hibakód: Számla Agent futtatásához lépj ki a Számlázz.hu rendszerből a böngészőben.](https://www.kasszajs.hu/docs/hibakodok/135.md): A Számlázz.hu Számla Agent 135-ös hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [136-os hibakód: Bejelentkezési hiba, lépj be a Számlázz.hu rendszerébe böngészőn keresztül.](https://www.kasszajs.hu/docs/hibakodok/136.md): A Számlázz.hu Számla Agent 136-os hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [137-es hibakód: Nincs engedély számlázási fiók létrehozására Számla Agenten keresztül.](https://www.kasszajs.hu/docs/hibakodok/137.md): A Számlázz.hu Számla Agent 137-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [152-es hibakód: Már létező rendelésszám.](https://www.kasszajs.hu/docs/hibakodok/152.md): A Számlázz.hu Számla Agent 152-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [164-es hibakód: A funkciót csak egyetlen fiókhoz hozzáférő felhasználó használhatja.](https://www.kasszajs.hu/docs/hibakodok/164.md): A Számlázz.hu Számla Agent 164-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [167-es hibakód: A tesztfiókban túllépted a rövid idő alatt kiállítható bizonylatok számát.](https://www.kasszajs.hu/docs/hibakodok/167.md): A Számlázz.hu Számla Agent 167-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [200-as hibakód: Ezt az előtagot ugyanezzel az adószámmal egy másik számlázási fiók használja.](https://www.kasszajs.hu/docs/hibakodok/200.md): A Számlázz.hu Számla Agent 200-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [202-es hibakód: A megadott számlaszám előtag nem megfelelő.](https://www.kasszajs.hu/docs/hibakodok/202.md): A Számlázz.hu Számla Agent 202-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [250-es hibakód: A fiók nem használható, mert a fiókgazda még nem vette birtokba, vagy a meghatalmazás nincs elfogadva.](https://www.kasszajs.hu/docs/hibakodok/250.md): A Számlázz.hu Számla Agent 250-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [259-es hibakód: A tétel nettó értéke nem megfelelő.](https://www.kasszajs.hu/docs/hibakodok/259.md): A Számlázz.hu Számla Agent 259-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [260-as hibakód: A tétel áfa értéke nem megfelelő.](https://www.kasszajs.hu/docs/hibakodok/260.md): A Számlázz.hu Számla Agent 260-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [261-es hibakód: A tétel bruttó értéke nem megfelelő.](https://www.kasszajs.hu/docs/hibakodok/261.md): A Számlázz.hu Számla Agent 261-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [262-es hibakód: A tétel nettó értéke nem megfelelő.](https://www.kasszajs.hu/docs/hibakodok/262.md): A Számlázz.hu Számla Agent 262-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [263-as hibakód: A tétel áfa értéke nem megfelelő.](https://www.kasszajs.hu/docs/hibakodok/263.md): A Számlázz.hu Számla Agent 263-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [264-es hibakód: A tétel bruttó értéke nem megfelelő.](https://www.kasszajs.hu/docs/hibakodok/264.md): A Számlázz.hu Számla Agent 264-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [309-es hibakód: Érvénytelen adat.](https://www.kasszajs.hu/docs/hibakodok/309.md): A Számlázz.hu Számla Agent 309-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [335-ös hibakód: A hivatkozott díjbekérő nem található.](https://www.kasszajs.hu/docs/hibakodok/335.md): A Számlázz.hu Számla Agent 335-ös hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [336-os hibakód: A nyugta előtag már számlákhoz használatban van.](https://www.kasszajs.hu/docs/hibakodok/336.md): A Számlázz.hu Számla Agent 336-os hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [337-es hibakód: A nyugta előtag formátuma hibás.](https://www.kasszajs.hu/docs/hibakodok/337.md): A Számlázz.hu Számla Agent 337-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [338-as hibakód: A hívásazonosító már létezik.](https://www.kasszajs.hu/docs/hibakodok/338.md): A Számlázz.hu Számla Agent 338-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [339-es hibakód: A nyugtaszám nem létezik.](https://www.kasszajs.hu/docs/hibakodok/339.md): A Számlázz.hu Számla Agent 339-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [340-es hibakód: A kifizetett összeg eltér a bruttó végösszegtől.](https://www.kasszajs.hu/docs/hibakodok/340.md): A Számlázz.hu Számla Agent 340-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [352-es hibakód: A számla kelte csak a mai nap lehet.](https://www.kasszajs.hu/docs/hibakodok/352.md): A Számlázz.hu Számla Agent 352-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [353-as hibakód: Nincs egyetlen érvényes számlaszám-előtag sem.](https://www.kasszajs.hu/docs/hibakodok/353.md): A Számlázz.hu Számla Agent 353-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [354-es hibakód: Ez a számlaszám-előtag nem használható.](https://www.kasszajs.hu/docs/hibakodok/354.md): A Számlázz.hu Számla Agent 354-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [356-os hibakód: A megadott számlaszám-előtag helyett másikat kell használni.](https://www.kasszajs.hu/docs/hibakodok/356.md): A Számlázz.hu Számla Agent 356-os hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [357-es hibakód: Add meg a számlaszám-előtagot.](https://www.kasszajs.hu/docs/hibakodok/357.md): A Számlázz.hu Számla Agent 357-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [358-as hibakód: Ezt a számlát csak a fiók tulajdonosa sztornózhatja.](https://www.kasszajs.hu/docs/hibakodok/358.md): A Számlázz.hu Számla Agent 358-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [359-es hibakód: Ez a számla megbízott számlakibocsátás keretében készült, a sztornót a megbízott végezheti.](https://www.kasszajs.hu/docs/hibakodok/359.md): A Számlázz.hu Számla Agent 359-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [360-as hibakód: Az előtag nem módosítható, mert már készült vele bizonylat.](https://www.kasszajs.hu/docs/hibakodok/360.md): A Számlázz.hu Számla Agent 360-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [362-es hibakód: Ezt az előtagot ez az adószám korábban már használta.](https://www.kasszajs.hu/docs/hibakodok/362.md): A Számlázz.hu Számla Agent 362-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [363-as hibakód: A tétel bruttó értékének egész számnak kell lennie.](https://www.kasszajs.hu/docs/hibakodok/363.md): A Számlázz.hu Számla Agent 363-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [364-es hibakód: A tétel nettó értéke maximum 2 tizedes jegyet tartalmazhat.](https://www.kasszajs.hu/docs/hibakodok/364.md): A Számlázz.hu Számla Agent 364-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [365-ös hibakód: A tétel áfa értéke maximum 2 tizedes jegyet tartalmazhat.](https://www.kasszajs.hu/docs/hibakodok/365.md): A Számlázz.hu Számla Agent 365-ös hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [395-ös hibakód: Érvénytelen áfakulcs.](https://www.kasszajs.hu/docs/hibakodok/395.md): A Számlázz.hu Számla Agent 395-ös hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [396-os hibakód: A megadott dátum túl korai.](https://www.kasszajs.hu/docs/hibakodok/396.md): A Számlázz.hu Számla Agent 396-os hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [489-es hibakód: Ez a számla megbízott számlakibocsátás keretében készült, az ismétlést a megbízott végezheti.](https://www.kasszajs.hu/docs/hibakodok/489.md): A Számlázz.hu Számla Agent 489-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [491-es hibakód: Új kata adónem mellett vállalkozás felé nem állítható ki bizonylat.](https://www.kasszajs.hu/docs/hibakodok/491.md): A Számlázz.hu Számla Agent 491-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [493-as hibakód: Ezt a számlát csak a fiók tulajdonosa helyesbítheti.](https://www.kasszajs.hu/docs/hibakodok/493.md): A Számlázz.hu Számla Agent 493-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [494-es hibakód: Ez a számla megbízott számlakibocsátás keretében készült, a helyesbítést a megbízott végezheti.](https://www.kasszajs.hu/docs/hibakodok/494.md): A Számlázz.hu Számla Agent 494-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [506-os hibakód: A jelszó túl rövid.](https://www.kasszajs.hu/docs/hibakodok/506.md): A Számlázz.hu Számla Agent 506-os hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [507-es hibakód: A jelszó túl hosszú.](https://www.kasszajs.hu/docs/hibakodok/507.md): A Számlázz.hu Számla Agent 507-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [520-as hibakód: Nincs elegendő törlőkódod, kérlek tölts fel újat.](https://www.kasszajs.hu/docs/hibakodok/520.md): A Számlázz.hu Számla Agent 520-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [521-es hibakód: Jelenleg csak a Számlázz.hu ajánlott számlaképpel használható a törlőkód.](https://www.kasszajs.hu/docs/hibakodok/521.md): A Számlázz.hu Számla Agent 521-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [524-es hibakód: A nyugtaszám-előtag nincs engedélyezve.](https://www.kasszajs.hu/docs/hibakodok/524.md): A Számlázz.hu Számla Agent 524-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [537-es hibakód: Egy tételhez legfeljebb 400 adattörlő kód adható.](https://www.kasszajs.hu/docs/hibakodok/537.md): A Számlázz.hu Számla Agent 537-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [538-as hibakód: Adattörlő kód demo- és tesztfiókban nem használható.](https://www.kasszajs.hu/docs/hibakodok/538.md): A Számlázz.hu Számla Agent 538-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [539-es hibakód: Nincs bekapcsolva az adattörlő kód használata.](https://www.kasszajs.hu/docs/hibakodok/539.md): A Számlázz.hu Számla Agent 539-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [551-es hibakód: Egyszerűsített számlakép OSS vagy nem magyar adószám mellett nem használható.](https://www.kasszajs.hu/docs/hibakodok/551.md): A Számlázz.hu Számla Agent 551-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [552-es hibakód: Egyszerűsített számlaképen legfeljebb két tétel adható meg.](https://www.kasszajs.hu/docs/hibakodok/552.md): A Számlázz.hu Számla Agent 552-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [553-as hibakód: Egyszerűsített számlakép esetén érvénytelen adókulcs.](https://www.kasszajs.hu/docs/hibakodok/553.md): A Számlázz.hu Számla Agent 553-as hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [554-es hibakód: Egyszerűsített számlaképű számla nem helyesbíthető.](https://www.kasszajs.hu/docs/hibakodok/554.md): A Számlázz.hu Számla Agent 554-es hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [555-ös hibakód: Egyszerűsített számlaképen a tételek áfakulcsai nem különbözhetnek.](https://www.kasszajs.hu/docs/hibakodok/555.md): A Számlázz.hu Számla Agent 555-ös hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.
- [556-os hibakód: Egyszerűsített számlakép szállítólevélen és helyesbítő számlán nem használható.](https://www.kasszajs.hu/docs/hibakodok/556.md): A Számlázz.hu Számla Agent 556-os hibakódja: mit jelent, mikor jön elő, és hogyan kezeld a kasszával.

## Receptek

- [Receptek](https://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/docs/receptek/penztari-nyugta.md): Nyugta egy food truck pénztárprogramjából a receipts.createOnce metódussal, a dupla nyugta kezelésével és e-mail kiküldéssel, Next.js route handlerben. Ki adhat így nyugtát, és mi a teendő, ha a Számlázz.hu nem érhető el.
- [PDF mentése S3-ba vagy R2-be](https://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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://www.kasszajs.hu/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.20.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/)