kassza

Üdvözlünk a kassza dokumentációjában#

A kassza a Számlázz.hu Számla Agent TypeScript kliense. Számlát, díjbekérőt és nyugtát állít ki, sztornóz, befizetést rögzít, lekéri a PDF-et és a számla adatait, a NAV-tól pedig az adószámhoz tartozó cégadatokat. Nincs futásidejű függősége, így Node.js-en, Bunon, Denón, Cloudflare Workersen és Vercel Edge-en is ugyanúgy fut.

A Számla Agent műveletein túl is segít: fizetési webhookból pontosan egyszer állít ki bizonylatot, megbízottként más cégek nevében számláz, elkészíti a NAV napi nyugta-összesítőjét, és fogadja a Számlázz.hu pénzügyi adatkapcsolatát.

A dokumentáció a Számlázz.hu hivatalos Agent dokumentációjának felépítését követi. Minden műveletnél három oldalt találsz: a kérést (mit adsz át a kasszának), a választ (mit kapsz vissza, és milyen hibák jöhetnek), és a mintát a kóddal, a ténylegesen elküldött XML-lel és a Számlázz.hu válaszával. A hivatalos leírás bármelyik oldala mellé így odateheted a megfelelő kassza oldalt.

Ha kérdésed van, vagy hibát találtál, nyiss egy issue-t a GitHubon.

Hol kezdjem?#

Hogyan működik a kassza?

Mi történik a kódod és a vevő postafiókja között, amikor kiállítasz egy számlát.

Telepítés és az első számla

Telepítés, Agent kulcs, és egy működő számla néhány sorból.

Nyugta vagy számla?

Ki adhat számítógéppel előállított nyugtát, és mikor kell mégis számla.

Hibakezelés, hibakódok

A Számlázz.hu összes ismert hibakódja, kategóriával és magyar javítási tippel.

Pontosan egyszer

Dupla számla és kitiltás nélkül, webhookból és várólistából is.

Sandbox

Futtasd a példákat a böngészőben Agent kulcs nélkül, és nézd meg az elküldött XML-t.

A 11 Számla Agent művelet#

Művelet	kassza metódus	Hivatalos leírás
Számla létrehozás	`invoices.create()`, `invoices.preview()`	Számla létrehozás
Számla sztornó	`invoices.reverse()`	Számla sztornó
Befizetés rögzítése	`invoices.registerPayment()`, `invoices.clearPayments()`	Befizetés rögzítése
Bizonylat lekérése PDF-ben	`invoices.getPdf()`	PDF lekérés
Számla adatainak lekérése	`invoices.get()`, `invoices.find()`	XML lekérés
Díjbekérő törlése	`invoices.deleteProforma()`	Díjbekérő törlése
Nyugta létrehozás	`receipts.create()`	Nyugta létrehozás
Nyugta sztornó	`receipts.reverse()`	Nyugta sztornó
Nyugta lekérdezés	`receipts.get()`, `receipts.find()`	Nyugta lekérdezés
Nyugta kiküldés	`receipts.send()`	Nyugta kiküldés
Adószám lekérdezése	`taxpayer.query()`	Adószám lekérdezés

További modulok#

Terület	Modul	Mire jó
Fizetésből bizonylat	`kassza/payments`	Stripe, SimplePay, Barion, Revolut és PayPal fizetésből nyugta vagy számla, aláírás-ellenőrzéssel, pontosan egyszer, visszatérítéskor sztornóval.
NAV nyugta-adatszolgáltatás	`kassza/reports`, `kassza/nav`	A 2026. szeptember 1-jétől kötelező napi összesítő, egyeztetés a NAV-val, és a kézi tartalék nyugtatömb beküldése.
Megbízotti számlázás	`kassza/delegation`	Platformoknak: a megbízói fiók csatlakoztatása (az Agent `action-agent_ceg_mb` hívása), majd kiállítás sok cég nevében, a saját Számlázz.hu fiókjukban.
Pénzügyi adatkapcsolat	`kassza/data-link`	A Számlázz.hu által átküldött számlák, banki tranzakciók és nyugták fogadása egy könyvelő- vagy ERP-rendszerben.
Hamis Számla Agent	`kassza/testing`	Tesztek a valódi kassza kódon, elveszett válasszal, karbantartással és részleges sikerrel.
Parancssor	`npx kassza`	Környezetellenőrzés, a küldendő XML előnézete supportjegyhez, lekérdezések.
MCP szerver	`npx kassza mcp`	Számla és nyugta AI asszisztensből, előnézettel és megerősítéssel.