Ugrás a tartalomra

3525 Miskolc, Bodótetői út 1. 3. em. 9.

2021 Lorz Kft.

Számlázás és NAV

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.

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ó

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.
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; a motoronkénti kész kapcsolatokat a webshop–számlázó áttekintés sorolja fel.

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

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

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

  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 az előfizetéstől független, sávos díjú szolgáltatás: a díj a havi bizonylatszámtól függ, 2026 novemberében 2 690 Ft-tól (1–50 bizonylat havonta, áfa nélkül). Ez a kapcsolat fejlesztésétől és az esetleges bővítmény díjától külön tétel. Az aktuális díjszabást a Számlázz.hu oldalán kell ellenőrizni.
Minden webshophoz egyedi Számlázz.hu integráció kell?
Nem. Előbb a webshophoz elérhető kész kapcsolatot érdemes megvizsgálni. Egyedi fejlesztés akkor indokolt, ha fontos üzleti lépés, belső jóváhagyás vagy adatkapcsolat hiányzik belőle. Ezt egy konkrét rendelés teljes menetével lehet eldönteni.
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.

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