Rendszerintegráció Miskolcon

01Mi az az API, és hogyan beszélnek egymással a programok?

Az API (alkalmazásprogramozási felület) egy program „ügyfélablaka”: rögzített szabályok szerint lehet rajta keresztül adatot kérni tőle vagy adatot átadni neki, emberi közreműködés nélkül. Amikor egy webshop a vásárló rendelése után automatikusan számlát kér a számlázótól, valójában az egyik program az API-n keresztül szól a másiknak — ugyanazokkal az adatokkal, amelyeket egy munkatárs különben kézzel gépelne be, csak gyorsabban, éjjel-nappal és elírás nélkül.

Ma a legtöbb felhőszolgáltatás és webes szoftver kínál ilyen felületet, jellemzően REST API formájában, JSON adatokkal. Az összekötés kétféleképpen indulhat: vagy a forrásrendszer szól azonnal, ha valami történt (ezt hívják webhooknak), vagy az integráció néz rá rendszeres időközönként, hogy van-e újdonság. Ha egy régebbi szoftvernek nincs API-ja, adatbázison, fájlcserén vagy exporton keresztül is kiépíthető a kapcsolat — ilyenkor egyedi fejlesztéssel építünk elé modern felületet.

02Tipikus hazai integrációk

A magyar kkv-k rendszerei sok hasonlóságot mutatnak, így a leggyakoribb összekötések jól ismert mintákat követnek. A számlázás szinte mindig érintett: a számlát a bevált online számlázó állítja ki, amely a NAV Online Számla felé is elvégzi az adatszolgáltatást, mi pedig gondoskodunk róla, hogy a számla a megrendelésből, a munkalapból vagy a CRM-ből automatikusan, a megfelelő adatokkal és a megfelelő pillanatban készüljön el.

A webshopok rendeléseit, termékeit és készletét a belső rendszerrel szinkronizáljuk, a futárszolgálatoknál a csomagcímke és a követési szám a feladáskor automatikusan jön létre, a levelezés, a naptár, a névjegyek és a megosztott dokumentumok pedig a Microsoft 365-ön keresztül kapcsolhatók be. Ha webshopot indítana, érdemes már a tervezésnél, nem utólag gondolni ezekre: Webshop indítása: fizetés, készlet, számlázás. A leggyakoribb kapcsolódási pontok egy kkv-nál:

• számlázók: Számlázz.hu, Billingo — számla a megrendelés vagy a munkalap adataiból;
• NAV Online Számla: beérkező számlák lekérdezése, partner-adószám ellenőrzése;
• webshopmotorok: Shopify, WooCommerce, Shoprenter, UNAS — rendelés, termék, készlet;
• futárszolgálatok (pl. GLS, MPL, Foxpost): csomagcímke, követési szám, státusz;
• Microsoft 365: levelezés, naptár, SharePoint-dokumentumok, Teams-értesítések;
• belső rendszerek: egyedi CRM, ügyviteli és raktárrendszer, táblázatok, régebbi helyi adatbázisok.

03Egyirányú vagy kétirányú szinkron — melyik rendszer a hiteles forrás?

Egyirányú szinkronnál az adat mindig csak egy irányba folyik: például a webshop rendelései átkerülnek az ügyviteli rendszerbe, de visszafelé semmi. Ez egyszerű, jól tesztelhető, könnyen felügyelhető, és sok esetben pontosan elég. Kétirányú szinkronra akkor van szükség, ha ugyanazt az adatot mindkét oldalon módosíthatják — például egy ügyfél címét a CRM-ben és a számlázóban is, vagy a készletet a webshopban és a raktárban egyszerre.

A kétirányú kapcsolat legfontosabb kérdése, hogy ütközéskor — ha két helyen egyszerre módosul ugyanaz az adat — melyik változás nyer. Ezért minden adattípusnál előre rögzítjük, melyik rendszer a hiteles forrás: a termékadatok jellemzően az ügyviteli rendszerben, a készlet a raktárnyilvántartásban, a számlák a számlázóban élnek. Ahol lehet, egyirányú kapcsolatokból építjük fel az egészet, mert ezek kiszámíthatóbbak, és egy hiba esetén is könnyebb pontosan kideríteni, mi történt.

04Hibakezelés és felügyelet: mi történik, ha valami elakad?

Az integráció nem attól jó, hogy ideális esetben működik, hanem attól, hogy mit csinál, ha valami hibára fut: a számlázó éppen nem érhető el, egy termék hiányos adattal érkezik, vagy a túloldali rendszer frissítése megváltoztat egy mezőt. A jól megépített kapcsolat ilyenkor nem dobja el az adatot, hanem sorba állítja, később újrapróbálja, és gondoskodik róla, hogy semmi ne kerüljön át kétszer.

Minden átadást naplózunk, így utólag is visszakereshető, mi ment át, mikor és milyen eredménnyel. A felügyelet riasztást küld, ha egy hiba nem oldódik meg magától, vagy ha szokatlanul sokáig nem érkezik új adat a megszokott forrásból. Igény szerint napi egyeztető kimutatás is készülhet, például a webshop rendeléseinek és a kiállított számláknak az összevetéséről. A futtatókörnyezetet és a felügyeletet IT-üzemeltetési szolgáltatásunk keretében is vállaljuk.

05Mikor elég a Zapier vagy a Make — és mikor kell egyedi integráció?

Az olyan no-code eszközök, mint a Zapier vagy a Make, kiválóak egyszerű, kis forgalmú, kevés szabályt tartalmazó folyamatokra: egy űrlapkitöltésből táblázatsor lesz, egy új rendelésből értesítés a csapatnak a megszokott csatornán. Gyorsan összerakhatók, programozás nélkül is módosíthatók, és ha a feladat ennyi, ezt is javasoljuk — nem kell mindenre egyedi fejlesztés. A felmérésen őszintén megmondjuk, melyik út éri meg jobban az Ön esetében.

Egyedi integráció akkor indokolt, ha nagy az adatmennyiség (ezeknél az eszközöknél a díj jellemzően a lefuttatott lépések számától függ), összetett üzleti szabályokra és ütközéskezelésre van szükség, egy rendszerhez nincs megbízható kész csatlakozó — ez a hazai és a régebbi helyi szoftvereknél gyakori —, vagy fontos, hogy az adatok ne egy további külső szolgáltatáson keresztül áramoljanak. Az egyedi integráció kódja verziókövetett és dokumentált.

06NAV Online Számla integráció: mit érdemes tudni?

A számlázó programmal kiállított számlák adatait automatikusan, emberi beavatkozás nélkül kell továbbítani a NAV Online Számla rendszerébe. Ha a cég bevált online számlázót használ, ezt a számlázó elvégzi — az integráció feladata ilyenkor az, hogy a számla a megfelelő adatokkal, a megfelelő pillanatban készüljön el. Saját számlázómodult csak indokolt esetben javaslunk, mert annak a jogszabályi és technikai követelményeknek is folyamatosan meg kell felelnie.

A NAV felülete nemcsak az adatszolgáltatásra jó, hanem lekérdezésekre is: elérhetők rajta a cégnek kiállított, beérkező számlák adatai, így a szállítói számlák rögzítése és a könyvelőnek szóló átadás előkészítése nagyrészt automatizálható; egy adószám alapján pedig ellenőrizhető a partner neve, címe és az adószám érvényessége. A lekérdezésekhez a cég Online Számla-fiókjában létrehozott technikai felhasználó szükséges; ennek beállításában és a jogosultságok helyes kiosztásában a bevezetéskor segítünk.