Billingo integráció: a rendeléstől a számláig
Még egyszer begépeled a rendelés adatait a számlázóba, aztán kézzel jelölöd, ki fizetett? A Billingo integrációnál ezeket a lépéseket kötjük össze a webshopoddal vagy a belső rendszereddel. Előbb tisztázzuk, mikor és miből készüljön bizonylat; utána választunk hozzá technikai megoldást.
A Billingo REST/JSON alapú API-t (v3) kínál: a számlák, díjbekérők, fizetések, partnerek és termékek programból kezelhetők, a NAV-beküldést pedig — összekötött fiók esetén — a Billingo intézi.
Mit lehet automatizálni egy Billingo-integrációval?
- Számla és díjbekérő kiállítása rendeléskor; díjbekérőből végszámla, módosító számla, sztornó.
- Fizetés rögzítése a számlán, amikor a pénz beérkezik.
- A számla NAV-státuszának lekérdezése, és az elakadt beküldések jelzése.
- Partnerek és termékek (cikkszám, EAN) szinkronizálása a CRM-mel vagy a webshoppal.
- Számla-PDF letöltése, kiküldése vagy nyilvános link előállítása.
- Adószám-ellenőrzés a partner felvitelekor.
Így működik a Billingo-integráció
01Elég egy kész bővítmény, vagy egyedi kapcsolat kell?
Egy általános webshopos számlázási feladathoz először a meglévő összekötéseket érdemes megnézni. Ha a bővítmény kezeli a szükséges fizetési módokat, bizonylatokat és rendelésállapotokat, nem kell ugyanazt újra lefejleszteni. A beállítás és egy valódi működést lefedő próba ettől még fontos.
Egyedi API-kapcsolat akkor kerül elő, ha saját CRM-ből indul a munka, több rendszer között kell adatot egyeztetni, vagy a szokásos rendelés–számla menetből kilógó jóváhagyás, részfolyamat van. A rendszerintegráció tervezésekor a meglévő lehetőségeket is összevetjük az igénnyel.
02Előbb a számlázási szabályokat írjuk le
Mi indítsa a bizonylatot: a rendelés, a fizetés vagy egy jóváhagyás? Mi történjen lemondásnál, módosításnál és hibás vevőadatnál? Ezeket a vállalkozás számlázási rendjével és szükség szerint a könyvelővel kell egyeztetni. Egy sikeres API-hívás önmagában nem dönti el, melyik bizonylat helyes.
Minden külső rendelés mellé eltesszük a hozzá tartozó bizonylatazonosítót. Ha a válasz elvész vagy újraindul a feldolgozás, előbb az állapotot kell tisztázni, nehogy ugyanarra az eseményre két számla készüljön. Az elakadt tételekhez legyen értesítés és kijelölt felelős.
- Ki a vevő- és tételadatok gazdája?
- Melyik rendszerben javítjátok a hibát?
- Ki kezeli a megszakadt feldolgozást és a számlakorrekciót?
03Hogyan kapcsolódunk?
A Billingo API v3 REST/JSON felület; az azonosítás a fiókban létrehozott API-kulccsal történik, amely csak olvasási vagy olvasási-írási jogot kaphat. A korábbi v2 API-t már nem fejlesztik.
Az API használatához az API+Tömeges kiegészítő szükséges, amely bármelyik csomaghoz hozzáadható — enélkül a hívások hibát adnak. Elektronikus számlázáshoz fizetős csomag kell; az ingyenes csomag papíralapú számlákat állít ki.
04Mi történik a NAV felé?
Összekötött NAV-fiók esetén a Billingo jelenti a számlákat, a beküldés eredménye pedig számlánként lekérdezhető. A „létrehozva” még nem jelenti azt, hogy a NAV be is fogadta — ezért a NAV-státuszt is figyeljük. A felelősségről bővebben: NAV Online Számla integráció.
05Korlátok és változáskövetés
A lekérdezések és az ismétlések ütemezését az API aktuális korlátaihoz igazítjuk. Az események követésének módját a használt rendszerek elérhető felületei alapján választjuk ki. A külső rendelés és a számla közös nyilvántartása teszi visszakövethetővé a folyamatot.
06Mit próbáljunk ki élesítés előtt?
A Billingo külön tesztkörnyezetet biztosít az integráció fejlesztéséhez. Ne csak a hibátlan rendelést próbáljuk ki: legyen hibás adat, ismételt esemény és megszakadt kapcsolat is a tesztlistán. Azt is ellenőrizzük, ki látja az elakadást és hogyan folytathatja a munkát.
Az integrációs kalkulátorral megbecsülheted a kézi adatmásolás időigényét. Az ott kapott eredmény tervezési segítség, nem a fejlesztés ára és nem garantált megtakarítás. Az egyeztetéshez a jelenlegi rendszerek neve és a havi rendelésszám jó kiindulás.
07Fejlesztőknek: Billingo API v3 gyorsreferencia
A leggyakoribb technikai kérdések röviden, a Billingo hivatalos fejlesztői dokumentációja és OpenAPI-leírása alapján (ellenőrizve: 2026. november 3.). A részletes végpontlista és a mezők a SwaggerHubon közzétett specifikációban vannak.
- Alapcím: https://api.billingo.hu/v3 — REST/JSON felület, OpenAPI (Swagger) specifikációval.
- Azonosítás: az API-kulcs az X-API-KEY fejlécben megy. A kulcsot a fiók Beállítások menüjében, az API-kulcsoknál lehet létrehozni: V3 kulcs, csak olvasási vagy olvasási-írási joggal.
- Fő erőforrások: bizonylatok (számla, nyugta, sztornó, másolat, letöltés, kiküldés, fizetések), partnerek, termékek, bankszámlák, bizonylattömbök, pénznemek, bizonylatexport, szervezet és költségek.
- Korlátozás: a válasz X-RateLimit-Limit (percenkénti keret), X-RateLimit-Remaining, X-RateLimit-Reset és Retry-After fejlécet ad; túllépéskor 429-es válasz jön. Konkrét számokat a dokumentáció nem közöl, ezért a fejlécek alapján ütemezünk.
- Hibakódok: 401 — hiányzó vagy hibás kulcs; 402 — az előfizetésben nincs API-hozzáférés; 403 — nem engedélyezett művelet; 422 — validációs hiba a küldött adatban.
- Csomag és teszt: az API az „API + Tömeges számlagenerálás” fizetős kiegészítővel használható, havi bizonylatszám szerinti sávokkal. Fejlesztéshez külön tesztfiók (sandbox) kérhető.
Amit leggyakrabban építünk
- 01
Webshop → számla → e-mail
A megbeszélt rendelés- vagy fizetési állapot indítja a számlázást. A számlaküldés és a NAV-visszajelzés követése külön ellenőrzött lépés; hibánál a tétel azonosítóval kerül a javítandó listára. Az ismételt feldolgozás nem indíthat új bizonylatot állapotellenőrzés nélkül.
- 02
Díjbekérő → fizetés → végszámla
Az egyeztetett bizonylati rend alapján indul a díjbekérő, a fizetési visszajelzés és a következő bizonylat. Külön tisztázzuk a részfizetést, a lemondást és azt, melyik rendszer adata alapján tekinthető rendezettnek a tétel.
- 03
CRM → számlázás
Az egyedi CRM jóváhagyott ügyletéből átadhatók a számlázási adatok. A kolléga a CRM-ben láthatja a kapcsolódó bizonylatot és az egyeztetett státuszt; a hibás adat javításának helyét előre meghatározzuk.
- 04
Bejövő számlák
A Billingo a NAV-ból a bejövő számlákat is letöltheti; ezek továbbíthatók a könyvelés vagy a kifizetési jóváhagyás felé.
Amire egy Billingo-integrációnál figyelünk
- 01
Létrehozva még nem beküldve
A számla létrehozása és a NAV-visszajelzés külön állapot. Mindkettőt követni kell, és egyértelműen jelezni, ha a beküldés elakadt vagy további intézkedést kér.
- 02
Kézi kikapcsolás
A felhasználó számlánként kikapcsolhatja a NAV-beküldést — ilyenkor a jelentésről neki kell gondoskodnia. Az így kiállított számlákat a folyamat külön jelzi.
- 03
Kvóta és csomag
Az API-kiegészítő mennyiségi kerettel jár; ha a forgalom nő, magasabb fokozat kell — ezt a tervezéskor számoljuk.
- 04
Ismételt esemény, elveszett válasz
Időtúllépés után nem indulhat vakon új számlakiállítás. A rendelés és a bizonylat összerendelését, valamint a korábbi kérés eredményét előbb ellenőrizni kell.
Gyakori kérdések
Mikor elég egy kész Billingo-bővítmény?
Melyik Billingo-csomag kell az API-hoz?
Ki küldi be a számlákat a NAV-nak?
Működik a régi, v2-es Billingo API?
Kapcsolódó integrációk
Források
- Billingo — fejlesztői dokumentáció
- Billingo — fejlesztői GYIK
- Billingo — API-változásnapló
- Billingo — API v3 OpenAPI-specifikáció (SwaggerHub)
- Billingo — API + Tömeges számlagenerálás csomag
Utolsó szakmai ellenőrzés: 2026. november 3.
Billingo-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.

