Kapcsolatfelvétel
Számlázás és NAV

Számlázz.hu integráció: automatikus számlázás a Számla Agenttel

A Számlázz.hu Számla Agentje 2010 óta a hazai automatikus számlázás egyik alapköve: webshopból, CRM-ből vagy ügyviteli rendszerből kérésre kiállítja a számlát, a nyugtát vagy a díjbekérőt, a NAV felé pedig a Számlázz.hu rendszere küldi be az adatokat.

Beszéljünk az integrációról
Automatizálás

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.
Hogyan működik?

Így működik a Számlázz.hu-integráció

01Hogyan 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 Számla Agent külön díjas kiegészítő, amely egyik csomagnak sem része; a díja a havi dokumentumszámtól függ. Webhookot a Számla Agent nem küld: a változásokat a kéréseink eredményéből és lekérdezésekkel követjük.

02Mi 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ó.

03Tesztelés

Fejlesztéshez ingyenes teszt fiók használható — ez azonban nem köthető a NAV-hoz. Élő fiókban tesztelni nem szabad: ott minden kiállított számla valódi, és díjat is generál.

Tipikus megoldások

Amit leggyakrabban építünk

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

  2. 02

    Fizetési kapu → fizetés rögzítése

    A bankkártyás fizetés sikeres visszaigazolásakor a rendszer rögzíti a fizetést a számlán, így a kintlévőségek listája mindig naprakész.

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

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

Buktatók

Amire egy Számlázz.hu-integrációnál figyelünk

  1. 01

    Dupla számla újrapróbálkozásnál

    Hálózati hiba után a vak újraküldés dupla számlát okozhat. A rendelésszám alapú duplikációszűrésre építünk, és az azonos kérést legfeljebb ötször ismételjük — a Számlázz.hu szabálya szerint utána a hívó le is tiltható.

  2. 02

    A kulcs teljes hozzáférést ad

    A Számla Agent kulcsnak nincs jogosultsági szintje, és nem jár le — ezért szigorúan titokként kezeljük: titkosított tárolás, a kódtól elkülönítve, és kulcscsere, ha valaki távozik.

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

  4. 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?
A Számla Agent külön díjas kiegészítő, amelynek havidíja a kiállított dokumentumok számától függ; az aktuális díjakat a Számlázz.hu tudástára tartalmazza.
Van JSON-alapú REST API-ja a Számlázz.hu-nak?
A Számla Agent XML-alapú. PHP-hoz hivatalos segédkönyvtár is elérhető, amely ugyanerre a felületre épül.
Ki küldi be a számlát a NAV-nak?
Bekötött NAV-kapcsolat esetén a Számlázz.hu. A felelősség a számlakibocsátóé marad, ezért a beküldések eredményét érdemes figyelni.

Kapcsolódó integrációk

Források

Utolsó szakmai ellenőrzés: 2026. október 4.

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.

Ajánlatot kérek