Hogyan beszél egymással a számlázó és a webshop?

Az API egy program hivatalos adatkapuja: rögzített szabályok szerint ad és fogad adatot, hogy egy másik program ember nélkül tudjon vele beszélgetni. Ezen át szól a webshop a számlázónak, hogy új rendelés jött.

Minta – szemléltető folyamat.

Röviden

Az API (alkalmazásprogramozási felület) egy program dokumentált adatkapuja. Ezen keresztül egy másik program ember nélkül kérdezhet le vagy küldhet be adatot, például rendelést, számlát vagy készletet. A felhős számlázóknak, webshopoknak és ügyfélkezelő programoknak jellemzően van ilyen kapuja, sokszor magasabb csomagban vagy külön díjért. A hazai telepített könyvelőprogramoknál inkább export, import vagy a gyártó saját modulja marad.

Frissítve:

Mit jelent az API a gyakorlatban?

Minden programnak megvan a saját jegyzetfüzete: a webshopnak a rendelések, a számlázónak a számlák, a raktárprogramnak a készlet. Ha nincs köztük kapcsolat, valakinek át kell írnia az adatot az egyikből a másikba. Az API az a kapu, amelyen át egy másik program szabályos formában beleolvashat a füzetbe, vagy beleírhat.

A kapu szabályait a program gyártója írja le. Megmondja, milyen kérdést lehet feltenni, például „add ide a tegnapi rendeléseket”, milyen formában jön a válasz, és ki kérdezhet egyáltalán. Ettől hivatalos: nem kerülőút, hanem dokumentált bejárat.

Egy hétköznapi recept így néz ki: ha a webshopban új rendelés jön, a számlázó állítsa ki a számlát, a raktárprogram pedig vonja le a készletet. A recept minden lépése egy-egy üzenet a kapun keresztül, ember nélkül.

Minta – szemléltető adat.

Milyen utakon köthető össze két program?

Az API a legkényelmesebb út, de nem az egyetlen. Négy út van, és a programjaitok döntik el, melyik járható.

Hivatalos adatkapu (API)

A gyártó által leírt kapu. Gyors és pontos, de sokszor magasabb csomagban vagy külön díjért érhető el.

Ütemezett export és import

Az egyik program fájlba menti az adatot, a másik beolvassa, például minden éjjel. Lassabb, de szinte minden programmal működik.

A program saját modulja

Sok hazai program magától fogad vagy küld adatot: NAV-letöltő, bankkivonat-import, átadás a könyvelőprogramnak. Ilyenkor nem kell mellé semmit építeni.

Olvasás a program adatbázisából

Ha nincs kapu, a program helyi adatbázisa sokszor olvasható. Ilyenkor jellemzően csak olvasni érdemes belőle, írni nem.

Honnan tudjátok, hogy a programotoknak van-e API-ja?

A kérdés nemcsak az, hogy van-e kapu, hanem az is, hogy melyik csomagban, és mit enged ki rajta a gyártó.

Jó jel, ha a programot böngészőből, havidíjért használjátok. A felhős számlázóknak, webshopprogramoknak, ügyfélkezelő és vállalatirányítási programoknak jellemzően van dokumentált kapuja: a Billingónak, a Számlázz.hu-nak, a WooCommerce-nek és a Shopifynak is.

A kapu viszont gyakran nincs benne az alapcsomagban. A Billingónál külön díjas kiegészítő, a Számlázz.hu kapuja díjköteles, és csak a kiállított számlákat kezeli, a bejövőket más úton adja tovább. Több webshopprogramnál és ügyfélkezelőnél csak magasabb csomagtól érhető el.

A hazai telepített könyvelőprogramoknál nyilvános kaput nem találtunk. Ott az export, az import, a gyártó saját modulja vagy a helyi adatbázis marad, és ez is működik, csak másképp kell hozzányúlni.

Két különleges kapu: a NAV és a bank

Így kérdezi le egy program a számlákat a NAV-tól

1. lépés

A cég elsődleges felhasználója létrehozza a technikai felhasználót a NAV felületén.

2. lépés

A belépési adatokat és a kulcsokat biztonságos úton kapja meg a program.

3. lépés

A program lekérdezi a számlák adatait, tételsorral együtt.

Eredmény

A lekérdezés csak olvas: adatot nem küld be a NAV-nak.

A NAV Online Számlának saját, nyilvános gépi kapuja van. A cég ezen kérdezheti le a kiállított és a kapott számlák adatait, tételsorral, egy technikai felhasználóval. Hogy ebből mi látszik, arról a bejövő számlákról szóló cikk szól.

A bankszámla kapuja szigorúbb: a bankok gépi kapuját csak engedéllyel rendelkező, az MNB-nél nyilvántartott szolgáltató használhatja. Egy cégnek ezért három útja marad: a netbanki export, egy engedéllyel működő szolgáltató, vagy a számlázó, illetve a könyvelőprogram saját bankkapcsolata.

A Billingo és a Számlázz.hu például maga köti be a bankszámlát, és csomagtól függően párosítja a befolyt utalásokat a kiállított számlákkal. Ha ez megvan, arra érdemes építeni.

Mennyire biztonságos, ha két program API-n beszélget?

Így kockázatos
  • Egy közös jelszó, amit öten ismernek.
  • Az összekötés mindent lát a programban.
  • Ha valami elakad, hetekig nem derül ki.
Így biztonságos
  • Kapcsolatonként saját kulcs, nem közös jelszó.
  • Csak azt éri el, ami a feladatához kell.
  • Napló és értesítés, ha valami elakad.

Annyira, amennyire a kapu beállítása. Egy jó összekötés csak azt éri el, ami a feladatához kell: ha a kimutatásnak elég olvasni a számlákat, akkor írni nem is tud.

Minden kapcsolat saját kulccsal lép be, nem egy kolléga jelszavával. Így látszik, melyik kapcsolat mihez fér hozzá, és egy kapcsolatot le lehet állítani úgy, hogy a többi tovább működik. Úgy érdemes beállítani, hogy hiba esetén megálljon és szóljon, ne találgasson.

Mivel érdemes kezdeni?

Ott, ahol ma a legtöbb kézi átmásolás történik. Ez jellemzően a számlázó és a webshop, a webshop és a raktár, vagy a NAV-ból letöltött számlaadat és a saját táblázatok között van.

Amit az API-ról kérdezni szoktak

Mi az az API, egyszerűen elmagyarázva?

Egy program hivatalos adatkapuja. Rögzített szabályok szerint ad és fogad adatot, így egy másik program ember nélkül tud vele beszélgetni: lekérdezheti a rendeléseket, vagy beküldhet egy számlát.

Minden programnak van API-ja?

Nem. A felhős számlázóknak, webshopoknak és ügyfélkezelőknek jellemzően van, de sokszor csak magasabb csomagban vagy külön díjért. A hazai telepített könyvelőprogramoknál nyilvános kaput nem találtunk: ott export, import, a gyártó saját modulja vagy a helyi adatbázis olvasása marad.

Mi a teendő, ha egy programnak nincs API-ja?

Akkor más úton kell hozzányúlni. Az adat mehet ütemezett exporttal és importtal, a program saját moduljával, vagy a helyi adatbázis olvasásával. Programot cserélni csak akkor kell, ha egyik út sem járható.

Biztonságos, ha két program API-n beszélget?

Igen, ha jól van beállítva. Minden kapcsolat saját kulccsal lép be, csak ahhoz fér hozzá, ami a feladatához kell, és a forgalomról napló készül. Ahol elég olvasni, ott írási jogot nem is kap.

Források

A programok kapuiról szóló állítások a gyártók saját dokumentációján alapulnak (megnézve: 2026. szeptember).

Kíváncsiak vagytok, a ti programjaitok mit engednek?

Egy rövid telefonon megnézzük, melyik programotoknak van kapuja, és hol marad az export vagy a program saját modulja.

Kérek egy rövid telefonos beszélgetést Előbb megnézem a példákat

Ha nálatok nem éri meg összekötni őket, azt is megmondjuk.