Számlázz.hu integráció webshophoz, CRM-hez és ügyvitelhez
A rendelés már megvan, mégis valaki újra beírja a számlázóba? A Számlázz.hu a Számla Agenten keresztül kapcsolható webshophoz, CRM-hez vagy ügyviteli rendszerhez. Az egyeztetett eseményből elindulhat a bizonylat készítése, kézi adatmásolás nélkül.
Először azt nézzük meg, mit tud a meglévő csatlakozó; hogy melyik webshopmotorhoz milyen kész kapcsolat van, a webshop–számlázó áttekintésünk mutatja. Egyedi fejlesztés akkor kerül elő, ha a saját jóváhagyási, fizetési vagy teljesítési folyamatotokhoz ez nem elég. Nem kell ehhez feltétlenül a webshopot vagy a CRM-et is lecserélni.
Mit lehet automatizálni egy Számlázz.hu-integrációval?
- Számla kiállítása rendeléskor vagy fizetéskor — normál, előleg-, vég- és helyesbítő számla, sztornóval.
- Fizetés rögzítése a számlán, amikor a bankkártyás fizetés vagy az átutalás beérkezik.
- Díjbekérő és szállítólevél készítése, a díjbekérő törlése.
- Nyugta kiállítása, sztornózása és kiküldése bolti vagy online eladásnál.
- A számla PDF- és XML-változatának letöltése és archiválása.
- Adószám-ellenőrzés a vevő adatainál.
Így működik a Számlázz.hu-integráció
01Kész összekötés vagy egyedi kapcsolat?
A használt webshopmotorhoz elérhető kész bővítmény jó kiindulópont lehet. A saját folyamaton ellenőrizzük: melyik állapotnál készít bizonylatot, kezeli-e a szükséges előleget, részfizetést, módosítást és sztornót. Ha ezt már megoldja, önmagában az automatizálás miatt nem indokolt új kapcsolatot fejleszteni.
Egyedi kapcsolat jöhet szóba például belső jóváhagyásra váró munkalapnál, több adatforrásnál vagy saját ügyviteli rendszernél. A felméréshez kell a forrásrendszer neve, egy rendelés vagy munkalap mintája, a kívánt bizonylat és a havi hozzávetőleges darabszám. Az adatmásolással töltött időt a számlázás és adatátadás kalkulátorral becsülheted meg.
02Mikor induljon a számlázás?
A rendelés beérkezése, a fizetés visszaigazolása és a teljesítés jóváhagyása eltérő esemény. Együtt rögzítjük, melyik indítson díjbekérőt vagy számlát, mely adat honnan érkezik, és ki kezeli az eltérést. A bizonylat típusát és időzítését a könyveléssel is egyeztetni kell.
Az összekötéshez visszakereshető rendelés- és bizonylatazonosító, látható feldolgozási állapot és kezelhető hibajelzés kell. Így a munkatárs meg tudja nézni, mi készült el, mi vár javításra, és melyik ügyet nem szabad újra elindítani.
03Hogyan kapcsolódunk?
A Számla Agent nem JSON-alapú REST API, hanem XML-alapú felület: a kérés egy XML-fájl, amelyet HTTPS-en küldünk a Számlázz.hu címére, és a mező neve dönti el, milyen műveletet kérünk. Az azonosítás a fiókban generált Számla Agent kulccsal történik — ez ajánlott a felhasználónév-jelszó helyett.
A kapcsolat a kérések válaszából és a szükséges lekérdezésekből követi a bizonylatok állapotát. A Számla Agent használati díja külön tétel: a dokumentumforgalomtól függ, nem egy fejlesztési díjba foglalt korlátlan szolgáltatás. A felhasznált kész bővítménynek vagy tárhelynek szintén lehet saját díja.
04Mi történik a NAV felé?
Ha a fiók össze van kötve a NAV Online Számla rendszerével (technikai felhasználó, aláíró- és cserekulcs, számlakezelési és -lekérdezési jogosultsággal), a Számlázz.hu központi rendszere küldi be a számlaadatokat, és sikertelen beküldésnél újrapróbálkozik. A felelősség ettől még a számlakibocsátóé — bővebben: NAV Online Számla integráció.
05Tesztelés
Fejlesztéshez ingyenes tesztfiók használható, amely nem köthető a NAV-hoz. Ebben próbáljuk ki az adatátadást, a hibás adatot és az ismételt feldolgozást. Az élesítés feltételeit külön egyeztetjük: élő fiókban a bizonylat valódi, és díjat is generálhat.
Az átadáskor ne csak egy sikeres számlát nézzetek meg: legyen próbája a megszakadt kapcsolatnak, a hiányos vevőadatnak, a módosításnak és a sztornónak is. Legyen kijelölt felelős a javításra váró ügyekhez, és rövid leírás arról, mit szabad újraküldeni.
06Fejlesztőknek: Számla Agent gyorsreferencia
A leggyakoribb technikai kérdések röviden, a Számlázz.hu hivatalos fejlesztői dokumentációja alapján (ellenőrizve: 2026. november 9.). A mezők teljes leírása és az XSD-sémák a docs.szamlazz.hu oldalon vannak.
- Végpont: https://www.szamlazz.hu/szamla/ — minden művelet ugyanide megy HTTPS POST kéréssel, multipart/form-data formában; az XML fájlként, a művelet mezőnevén utazik. Egy XML egyetlen számlát vagy nyugtát tartalmaz.
- Számla műveletei: számla, díjbekérő és szállítólevél készítése action-xmlagentxmlfile, sztornó action-szamla_agent_st, jóváírás rögzítése action-szamla_agent_kifiz, bizonylat lekérése PDF-ben action-szamla_agent_pdf, XML-ben action-szamla_agent_xml, díjbekérő törlése action-szamla_agent_dijbekero_torlese.
- Nyugta és adózó: nyugta készítése action-szamla_agent_nyugta_create, sztornója action-szamla_agent_nyugta_storno, lekérése action-szamla_agent_nyugta_get, kiküldése action-szamla_agent_nyugta_send; adózó lekérdezése action-szamla_agent_taxpayer.
- Azonosítás: a Számla Agent kulcs a szamlaagentkulcs XML-elembe kerül. A kulcs nem jár le, a fiók minden kulcsa azonos jogú, fiókonként legfeljebb 17 hozható létre, és csak az API-hoz használható, webes belépéshez nem.
- Válasz: a valaszVerzio 1-es értékénél szöveges vagy PDF-válasz jön, 2-esnél XML (sikeres, hibakod, hibauzenet, számlaszám, összegek, kérésre base64 PDF). Fejlécek: szlahu_szamlaszam, szlahu_nettovegosszeg, szlahu_bruttovegosszeg, hibánál szlahu_error és szlahu_error_code.
- Gyakori hibakódok: 3 — sikertelen bejelentkezés; 57 — XML-beolvasási vagy XSD-hiba; 71 és 152 — ismétlődő rendelésszám; 136 — böngészős belépés kell (például lejárt előfizetés miatt); 164 — a felhasználó több számlázási fiókhoz fér hozzá; 259–264 — a tétel nettó, áfa és bruttó értéke nem egyezik.
- Újraküldés: ugyanaz a kérés legfeljebb ötször küldhető el. A sikerig ismétlő automatikus ciklust a dokumentáció kifejezetten tiltja, az ismételt megsértés kitiltással járhat.
- Teszt és tűzfal: új fióknál a tulajdonos az irányítópult „Tesztüzem bekapcsolása” gombjával kapcsol tesztüzemre; élesre váltáskor a tesztbizonylatok törlődnek. Tesztkörnyezetben 10 percen belül legfeljebb 500 számla készíthető. Engedélylistás tűzfalnál a dokumentáció biztonsági oldalán közölt, 2025. augusztus 1-jétől érvényes IP-tartományok kellenek.
- Díj: a Számla Agent az előfizetéstől független, sávos szolgáltatás: 2026 novemberében havi 1–50 bizonylatig 2 690 Ft, 51–3 000 bizonylatig 9 990 Ft, 3 001–10 000 bizonylatig 14 990 Ft, áfa nélkül, az előző havi forgalom alapján utólag számlázva.
Amit leggyakrabban építünk
- 01
Webshop → számla → NAV
Rendeléskor vagy a fizetés beérkezésekor automatikusan elkészül a számla, a vevő e-mailben megkapja, a NAV-beküldést a Számlázz.hu végzi. Webshopot is így építünk; a motoronkénti kész kapcsolatokat a webshop–számlázó áttekintés sorolja fel.
- 02
Fizetési kapu → fizetés rögzítése
A bankkártyás fizetés ellenőrzött visszaigazolásából rögzíthető a kiegyenlítés. A visszatérítést, részfizetést és ismételten érkező értesítést is külön kezelni kell, hogy ne csak a sikeres alapeset működjön.
- 03
CRM vagy ügyviteli rendszer → számla
Az egyedi CRM vagy ügyviteli rendszer a lezárt ügyletből állítja ki a számlát, kézi átgépelés nélkül.
- 04
Pénzügyi adatok a könyvelés felé
A Számlázz.hu Pénzügyi adatkapcsolat szolgáltatásával a kimenő és bejövő számlák, nyugták és banki tranzakciók adatai automatikusan továbbíthatók a könyvelési vagy ügyviteli rendszer felé.
Amire egy Számlázz.hu-integrációnál figyelünk
- 01
Dupla számla újrapróbálkozásnál
Hálózati hiba után előbb ellenőrizni kell, elkészült-e a bizonylat. A hibás kérés változatlan ismétlése nem javítja az adatot. A hivatalos hibakezelési szabály legfeljebb öt próbálkozást enged egy kéréshez; utána leállítás és felelős beavatkozás kell, nem végtelen újraküldés.
- 02
A kulcsot szerveroldalon kell tartani
A Számla Agent kulcsokhoz nincs külön jogosultsági szint, és nem járnak le. Nem kerülhetnek böngészős kódba vagy nyilvános forrásba. Az átadásnál a tulajdonost és a visszavonás menetét is tisztázni kell; kiszivárgáskor az érintett kulcs törlése szükséges.
- 03
Teszt fiók és élő fiók
Élő fiókban tesztelni valódi számlákat és díjat jelent; a teszt fiók viszont nem köthető a NAV-hoz, így a NAV-oldali ellenőrzést külön tervezzük meg.
- 04
Tűzfal és IP-címek
Ha a szerver tűzfala engedélylistával dolgozik, a Számlázz.hu által közzétett IP-tartományokat kell engedélyezni — ezek 2025-ben változtak.
Gyakori kérdések
Mennyibe kerül a Számla Agent?
Minden webshophoz egyedi Számlázz.hu integráció kell?
Van JSON-alapú REST API-ja a Számlázz.hu-nak?
Ki küldi be a számlát a NAV-nak?
Kapcsolódó integrációk
Források
- Számlázz.hu — fejlesztői dokumentáció
- Számla Agent — alapok
- Számla Agent — azonosítás
- Számla Agent — hibakezelés
- Számla Agent — kérések küldése és műveletek
- Számla Agent — számlakészítés válasza
- Számla Agent — biztonság és IP-címek
- Számla Agent — termékoldal és díjsávok
- Tudástár — teszt API-hozzáférés
- Pénzügyi adatkapcsolat
- Tudástár — a Számla Agent használati díja
- Tudástár — teszt fiók és NAV-kapcsolat
Utolsó szakmai ellenőrzés: 2026. november 9.
Számlázz.hu-integráció: kérj ajánlatot
Írd meg, milyen rendszereket használsz és mit szeretnél automatizálni — egy rövid, ingyenes egyeztetés után írásos, tételes ajánlatot adunk.

