Számlázd a szamlazz.hu-t Claude Code-ból
Miért tart 15 percig egy számla kiállítása?
A magyar KKV-k többsége a szamlazz.hu webes felületén állít ki számlát. Ez minden egyes alkalommal ugyanazt jelenti: bejelentkezés, vevő kikeresése vagy begépelése, tételsorok kitöltése, ÁFA kulcs kiválasztása, nettó/bruttó számolgatás, előnézet, kiállítás gomb. Számlánként 5-15 perc, havi 20-50 számla mellett ez havi 2-12 munkaóra — csak adminisztrációra.
Egy számla kiállítása a szamlazz.hu webes felületen — bejelentkezéstől a PDF letöltésig.
Számlázásra fordított munkaidő havi 20-50 számla esetén, manuális workflow-val.
Ugyanaz a számla a plugin promptjával — egy mondat, megerősítés, kiállítás.
3 kérdés, 30 másodperc, egy natural language prompt
A plugin az első futás során 3 kérdéssel beállítja magát — API kulcs, adószám (NAV auto-kitöltéssel), bankszámlaszám (bank auto-detektálással). Ezután bármely számlázási feladat egyetlen természetes nyelvi prompt:
Hogyan dolgozza fel a plugin?
Megérti a kérést
A Claude Code a promptodból kinyeri a vevőt, összeget, ÁFA kulcsot és a tétel leírását. Ha valami hiányzik, visszakérdez.
Ellenőriz és megerősít
Mutat egy összefoglaló blokkot a nettó/ÁFA/bruttó értékekkel — semmit nem küld el, amíg nem hagyod jóvá.
Kiállít
Kiküldi a számlát a szamlazz.hu Agent API-nak, visszakapod a számlaszámot és letöltheted a PDF-et.
Megérti a kérést
A Claude Code a promptodból kinyeri a vevőt, összeget, ÁFA kulcsot és a tétel leírását. Ha valami hiányzik, visszakérdez.
Ellenőriz és megerősít
Mutat egy összefoglaló blokkot a nettó/ÁFA/bruttó értékekkel — semmit nem küld el, amíg nem hagyod jóvá.
Kiállít
Kiküldi a számlát a szamlazz.hu Agent API-nak, visszakapod a számlaszámot és letöltheted a PDF-et.
Mit tud a plugin?
Számla kiállítás promptból
Természetes nyelven kérd: „állíts ki 150 000 Ft-os számlát webfejlesztésről". A plugin kiszámolja nettó/ÁFA/bruttót és kiküldi.
Sztornó és díjbekérő
Egy prompt: „sztornózd a SOC-2026-0042-t" vagy „díjbekérő Acme Ltd-nek 500 EUR-ról". Megerősítés után azonnal végrehajt.
NAV adószám lookup
Írd be az adószámot, a plugin a NAV-ból visszaadja a cégnevet, irányítószámot, települést és pontos címet.
Automatikus partner cache
Egyszer megadott vevőt a plugin megjegyzi adószám alapján. Legközelebb elég a nevét mondani.
Teljes magyar ÁFA kezelés
27%, 18%, 5%, 0% és AAM ÁFA kulcsok, KATA (kisadózó) támogatás. Decimal kerekítés 2 tizedesre, ROUND_HALF_UP.
PDF és XML letöltés
Bármely kiállított számla PDF-jét vagy XML-jét letöltheted a számlaszám alapján egyetlen prompttal.
Cross-platform
Natívan fut macOS, Linux és Windows alatt. Csak Python 3.9+ és PyYAML kell, nincsenek bonyolult függőségek.
Biztonságos credential kezelés
Az API kulcs az OS credential store-jában (macOS Keychain, Windows Credential Manager, Linux Secret Service). Semmi nem megy felhőbe.
Hogyan telepítheted a plugint?
A plugin a GitHub-on érhető el MIT licenc alatt. Két parancs, 30 másodperc:
Telepítéskor a Claude Code be fogja kérni a szamlazz.hu Agent API kulcsod. Ha átugrod, az első futásnál interaktívan bekéri — nem akadsz el.
Első futás — 3 kérdés, semmi YAML szerkesztés
Az első számlázási promptnál a plugin felismeri, hogy még nincs beállítva, és 3 interaktív kérdéssel végigvezet. Minden válasz ellenőrzött, a NAV-ból automatikusan kitölti a cégadatokat.
Agent API kulcs
„Szamlazz.hu Agent API kulcsod?" — beírod vagy jelzed, hogy már beállítottad a shell-ben. Nem tudod hol van? A plugin megmutatja a lépéseket.
Adószám + NAV auto-kitöltés
„A saját céged adószáma?" — beírod (pl. 12345678-2-42), a plugin a NAV-ból visszaadja a cégnevet, irszámot, várost, utcát. Jóváhagyod vagy javítasz.
Bankszámlaszám + bank detektálás
„Bankszámlaszámod?" — beírod, a plugin a giro prefixből auto-detektálja a bankot (pl. „Ez egy UniCredit Bank számla, ugye?"). Kész, számlázhatsz.
Agent API kulcs
„Szamlazz.hu Agent API kulcsod?" — beírod vagy jelzed, hogy már beállítottad a shell-ben. Nem tudod hol van? A plugin megmutatja a lépéseket.
Adószám + NAV auto-kitöltés
„A saját céged adószáma?" — beírod (pl. 12345678-2-42), a plugin a NAV-ból visszaadja a cégnevet, irszámot, várost, utcát. Jóváhagyod vagy javítasz.
Bankszámlaszám + bank detektálás
„Bankszámlaszámod?" — beírod, a plugin a giro prefixből auto-detektálja a bankot (pl. „Ez egy UniCredit Bank számla, ugye?"). Kész, számlázhatsz.
Példa promptok — írd be Claude Code-ba
állíts ki egy számlát Példa Kft.-nek 150 000 Ft-ról webfejlesztésről sztornózd a SOC-2026-0042 számlát díjbekérő Acme Ltd-nek 500 EUR-ról konzultációért töltsd le a SOC-2026-0042 PDF-jét ki ez a cég: 12345678-2-42 macOS, Linux és Windows — natívan
A plugin Python 3.9+ stdlib-re épül és egyetlen külső függőséget (PyYAML) használ. Nincs Docker, nincs bonyolult build pipeline. Az API kulcsot az operációs rendszered natív credential store-ja tárolja.
Keychain · ~/Library/Application Support/szamlazz/
Secret Service · ~/.config/szamlazz/
Credential Manager · %APPDATA%\szamlazz\
Biztonság — minden a saját gépeden marad
Az adatok soha nem mennek felhőbe. A konfigurációs fájlok (seller.yaml, partners.yaml) kizárólag a saját gépeden léteznek. Az API kulcsot a Claude Code a userConfig sensitive mechanizmusán keresztül az operációs rendszered credential store-jába menti — nem plaintext fájlba. A plugin nem gyűjt analitikát, nem küld telemetriát, nincs tracking. A teljes forráskód nyílt és auditálható a GitHub-on.
Enterprise szintű biztonsági integrációra van szükséged?
A SocialPro egyedi integrációkat és biztonsági auditokat is készít magyar vállalatok számára.
Gyakran ismételt kérdések
Mi a különbség a szamlazz.hu webes felülete és a Claude Code plugin között?
A webes felületen minden számlát manuálisan töltesz ki: belépsz, megkeresed a vevőt, kitöltöd a tételeket, ellenőrzöd az ÁFA-t, kattintasz a kiállításra. Ez számlánként 5-15 perc. A plugin ezt egyetlen természetes nyelvi promptra redukálja — mondod mit szeretnél, a Claude Code kiszámolja az értékeket, mutat egy megerősítő blokkot, és kiküldi. Ugyanazt a szamlazz.hu Agent API-t használja, tehát jogilag és technikailag azonos a végeredmény. A SocialPro üzleti automatizáció szolgáltatása hasonló hatékonyságnövelő megoldásokat épít más workflow-okhoz is.
Hogyan szerzek szamlazz.hu Agent API kulcsot?
Jelentkezz be a szamlazz.hu fiókodba, navigálj a Beállítások → Számla Agent kulcsok menüpontra, kattints az „Új kulcs" gombra, válaszd a „Számla kiállítás" jogosultságot, és generáld le a kulcsot. A kulcsot csak egyszer látod — másold ki azonnal. Ha elveszik, generálj újat. A plugin az első futásnál interaktívan bekéri, nem kell konfigfájlokat szerkesztened.
Több céggel dolgozom (könyvelőként). Hogyan kezeljem?
Projektenként külön .szamlazz/ mappát hozhatsz létre a projekt gyökerében. A plugin automatikusan a legközelebbi projekt-lokális konfigot használja. Ha rendszeresen váltasz cégek között, a SocialPro technikai csapata segít az egyedi multi-tenant beállításban.
Biztonságos a sztornózás CLI-ből?
Igen. A plugin minden sztornó előtt megerősítő blokkot mutat a számlaszámmal, összeggel és vevővel — nem küld ki semmit, amíg explicit nem hagyod jóvá. A szamlazz.hu Agent API-ja ugyanazt a NAV-validációt alkalmazza, mint a webes felület. A sztornó visszafordíthatatlan, de ez a szamlazz.hu platformtól független szabály (NAV).
Kell fizetnem a plugin használatáért?
A plugin ingyenes és nyílt forráskódú (MIT licenc). A szamlazz.hu fiókodhoz szükséges aktív előfizetés nem a plugintől függ — ha van érvényes szamlazz.hu előfizetésed és Agent API kulcsod, a plugin költségmentesen használható. Ha vállalati szintű automatizációt vagy egyedi integrációt szeretnél, a SocialPro ingyenes konzultációján megbeszélhetjük.
Telepítsd a plugint és számlázz 30 másodperc alatt
Ingyenes, nyílt forráskódú, MIT licenc. Ha egyedi számlázási automatizációra, vállalati integrációra vagy más AI workflow-ra van szükséged, foglalj ingyenes konzultációt.
30 perc, kötöttség nélkül