Ugrás a tartalomra

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

2021 Lorz Kft.

Számlázás és NAV

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.

Automatizálás

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

Í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ő.
Tipikus megoldások

Amit leggyakrabban építünk

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

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

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

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

Buktatók

Amire egy Billingo-integrációnál figyelünk

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

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

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

  4. 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?
Ha lefedi a webshop számlázási szabályait, fizetési módjait és szükséges bizonylatait, először ezt érdemes beállítani és kipróbálni. Egyedi kapcsolat saját rendszer vagy eltérő üzleti folyamat esetén lehet indokolt.
Melyik Billingo-csomag kell az API-hoz?
Az API-hoz az API+Tömeges kiegészítő szükséges, amely bármelyik csomaghoz hozzáadható; elektronikus számlázáshoz fizetős csomag kell.
Ki küldi be a számlákat a NAV-nak?
Összekötött fiók esetén a Billingo. A felelősség a számlakibocsátóé marad, ezért a NAV-státuszt érdemes figyelni.
Működik a régi, v2-es Billingo API?
A v2-t a Billingo már nem fejleszti; új integrációt a v3-ra építünk, a régieket érdemes átállítani.

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.

Ajánlatot kérek