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 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.

Hibakezelés, hibakódok

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

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