Számlázz és nyugtázz a saját rendszeredből, néhány sor kóddal
A kassza egy ingyenes, nyílt forráskódú fejlesztői könyvtár (SDK) a Számlázz.hu Számla Agenthez. Nem kész webshop bővítmény, hanem építőelem: a fejlesztőd ezzel köti össze a Számlázz.hu fiókodat a webshopoddal, alkalmazásoddal vagy belső rendszereddel. Elég megadni a vevőt és a tételeket, a kassza elkészíti a hibátlan XML kérést, kiszámolja az összegeket, és nem enged dupla számlát kiállítani.
Ami a nyers API használatánál a fejlesztő dolga, az itt már kész:
• Nincs dupla számla. Ha kiállítás közben megszakad a kapcsolat, a rendelésszám alapján kideríti, hogy elkészült a számla. Nem kell találgatni, és nem kell sztornózni.
• Nincs kitiltás. Üzleti hibára soha nem küldi újra a kérést, ahogy a Számlázz.hu előírja.
• Fillérre pontos összegek. A hivatalos kerekítési szabályokkal számol, számlára és nyugtára külön.
• Mindig magyar idő. A dátumokat Europe/Budapest szerint adja meg, így éjfél után sem csúszik el a számla kelte.
• Érthető hibaüzenetek. Minden dokumentált hibakódhoz magyar üzenet és javítási tipp tartozik.
• Ott fut, ahol te. Nincs futásidejű függősége: Node.js, Bun, Deno, Cloudflare Workers és Vercel Edge alatt ugyanúgy működik.
Mesterséges intelligenciával is használható: a kassza MCP (Model Context Protocol) szerverként is működik, így AI asszisztensek és minden, az MCP protokollt támogató szoftver tud vele kommunikálni.
Ezt kell tudnod a kapcsolatról
Mind a 11 Számla Agent műveletet kezeli:
• Számla kiállítása: díjbekérő, előlegszámla, végszámla, helyesbítő számla és szállítólevél is
• Számla sztornózása
• Befizetés rögzítése
• Számla PDF lekérése
• Számla XML lekérése
• Díjbekérő törlése
• Nyugta létrehozása
• Nyugta sztornózása
• Nyugta lekérdezése
• Nyugta kiküldése
• Adószám lekérdezése
A működést több mint 1400 automatizált teszt ellenőrzi.
Az integrációhoz szükséges Számla Agent szolgáltatás díjszabásáról itt olvashatsz részleteket.