Rendszerintegráció: hogyan kösd össze a számlázót, a webshopot és az ERP-t?

Hogyan köthető össze API-n a számlázó, a webshop és az ERP? Tipikus adatfolyamok, a számlázó API-k működése, buktatók, költség és időigény.

Pethe Bálint1 perc olvasás
Elérhető más nyelven is: EN
Rendszerintegráció: hogyan kösd össze a számlázót, a webshopot és az ERP-t?

Röviden: a rendszerintegráció azt jelenti, hogy a cég különböző programjai (számlázó, webshop, ERP, CRM) automatikusan cserélnek adatot egymással, így nem kell kézzel átmásolni. Általában API-kon keresztül történik, és a legtöbb időt és hibát itt lehet megspórolni.

Sok cégnél a rendszerek „szigetek”: a webshop külön él, a számlázó külön, a készlet külön. A köztük lévő hidat a kollégák töltik be, kézi adatbevitellel. Ez lassú, drága és hibára hajlamos. Ebben a cikkben végigmegyek azon, hogyan működik egy számlázó API integráció, milyen adatfolyamokat érdemes összekötni, hol szokott elcsúszni a dolog, és mikor elég egy kész összekötő.

Mi az az API?

Az API (Application Programming Interface) egy kapu, amelyen keresztül egy program megengedi, hogy másik program adatot kérjen tőle, vagy adatot küldjön neki. Például a webshop az API-n keresztül adja át a megrendelést a számlázónak, amely számlát készít, és visszaküldi a számla adatait.

Két alapvető működési mód van, és a legtöbb integráció mindkettőt használja:

  • Lekérdezés (polling): az egyik rendszer időnként megkérdezi a másikat, hogy van-e új adat. Egyszerű, de mindig van némi késés, és feleslegesen terheli a rendszert, ha nincs változás.
  • Értesítés (webhook): a forrásrendszer szól, amikor történik valami, például beérkezett egy rendelés vagy kifizettek egy számlát. Gyorsabb, de fel kell készülni arra, ha egy értesítés elvész vagy kétszer érkezik meg.

Tipikus integrációk

  • Webshop → számlázó: a rendelésből automatikusan számla készül.
  • Webshop ↔ készlet: a készlet valós időben frissül mindkét irányban.
  • CRM → ERP: a lezárt üzletből automatikusan megrendelés lesz.
  • ERP → könyvelés: a számlák és tételek automatikusan átkerülnek.
  • Szállító / futár rendszerek: csomagfeladás és követés automatizálva.
  • E-mail és értesítések: állapotváltozásokra automatikus levelek.

Számlázó API integráció a gyakorlatban

A hazai online számlázók többsége, köztük a Számlázz.hu és a Billingo, kínál API-t, amelyen keresztül egy másik rendszer számlát állíthat ki, sztornózhat, díjbekérőt készíthet, és lekérdezheti, hogy egy számlát kifizettek-e. A NAV felé történő adatszolgáltatást (Online Számla) ilyenkor jellemzően maga a számlázóprogram intézi, tehát az integrációnak ezt nem kell külön megoldania, elég jól átadnia az adatokat.

Egy tipikus folyamat így néz ki:

  • a vevő lead egy rendelést a webshopban, vagy a kolléga lezár egy megrendelést az ügyviteli rendszerben;
  • a rendszer összeállítja a számla adatait: vevő, tételek, áfakulcsok, fizetési mód, határidő;
  • az API-n keresztül elküldi a számlázónak, amely kiállítja a számlát, és visszaadja a számlaszámot és a PDF-et;
  • a számlaszám visszakerül a rendeléshez, a vevő megkapja a számlát e-mailben;
  • amikor a fizetés beérkezik, a státusz mindkét rendszerben frissül.

Ami papíron öt lépés, az a gyakorlatban a részleteken múlik. Ezekre érdemes előre választ adni:

  • Áfa és kerekítés. A két rendszer ugyanúgy számol-e? Néhány forintos eltérés is elég ahhoz, hogy a könyvelő visszadobja a számlát.
  • Vevőadatok. Mi történik, ha a vevő adószáma hiányzik vagy hibás? Céges és magánszemély vevőt másképp kell kezelni.
  • Sztornó és módosítás. Ha a rendelést visszamondják, ki indítja a sztornót, és hogyan kerül vissza az információ?
  • Előleg és végszámla. Ha díjbekérővel vagy előlegszámlával dolgoztok, a folyamat több lépésből áll, és mindegyiket le kell képezni.
  • Deviza és nyelv. Külföldi vevőnél más pénznem, más áfaszabály és idegen nyelvű számla kellhet.

ERP és webáruház integráció

A webshop és az ügyviteli rendszer összekötésénél négy adatkör szokott mozogni: termékek, készlet, árak és rendelések. A legfontosabb kérdés mindegyiknél ugyanaz: melyik rendszer a gazdája az adatnak.

  • Termékadatok: jellemzően az ERP a forrás, a webshop csak megjeleníti. Ha mindkét helyen szerkeszthető, előbb-utóbb eltérnek egymástól.
  • Készlet: az ERP a forrás, de a webshopnak gyorsan kell értesülnie a változásról, különben olyan terméket ad el, ami nincs raktáron.
  • Árak: ha vevőcsoportonként eltérő árak vagy akciók vannak, ezt a logikát egy helyen érdemes tartani.
  • Rendelések: a webshop a forrás, az ERP-ben lesz belőlük teljesítendő megrendelés, szállítólevél és számla.

A népszerű webshopmotorok (például a Shoprenter, az UNAS, a WooCommerce vagy a Shopify) rendelkeznek API-val, de mindegyik mást tud, és másképp korlátozza a hívások számát. Ezért az integráció tervezése mindig azzal kezdődik, hogy megnézem, a konkrét rendszerek API-ja mit enged meg.

Hogyan épül fel egy jó integráció?

  • Adatmodell egyeztetése. Melyik rendszer az „igazság forrása” melyik adatra?
  • Hitelesítés és biztonság. API-kulcsok, titkosított kapcsolat, minimális jogosultság.
  • Hibakezelés. Mi történik, ha a másik rendszer épp nem elérhető? Újrapróbálkozás, sorba állítás, értesítés.
  • Ismételhetőség. Ha ugyanaz az üzenet kétszer érkezik meg, ne készüljön belőle két számla. Ezt a rendszernek kell kivédenie, nem a kollégának észrevennie.
  • Naplózás. Minden átvitel nyomon követhető legyen.
  • Tesztelés. Éles adatokhoz hasonló tesztkörnyezetben.
  • Monitorozás. Ha megáll az integráció, azonnal tudj róla.

Kész összekötő vagy egyedi integráció?

Ha a két rendszernek van kész összekötője, az gyakran elég, és érdemes azzal kezdeni. A kész beépülő modulok és a no-code automatizációs eszközök (például a Zapier vagy a Make) jól működnek, amíg a folyamat egyszerű és a forgalom kicsi.

Egyedi integráció akkor kell, ha:

  • nincs kész összekötő, vagy az nem fedi le a folyamatodat;
  • összetett szabályok vannak (árazás, kivételek, jóváhagyások);
  • nagy a volumen, és megbízhatóság kell;
  • több rendszert kell egyszerre összekötni;
  • a kész megoldás havidíja a forgalommal együtt nő, és egy ponton drágább lesz, mint a saját megoldás.

A döntéshez az egyedi vagy dobozos megoldásról szóló útmutató ad keretet.

A leggyakoribb buktatók

  • Dupla adatbevitel marad, mert nem tisztázták, melyik rendszer a főnök.
  • Nincs hibakezelés, ezért egy kimaradt szinkron csendben adathibát okoz.
  • Az API változik, és nincs, aki karbantartsa az integrációt.
  • Nincs monitorozás, és napokig nem derül ki, hogy leállt.
  • Nincs tesztkörnyezet, ezért minden módosítás éles számlákon derül ki.
  • A kivételeket nem tervezték meg, így a ritka esetek (részszállítás, visszáru, jóváírás) kézi munkát igényelnek, és pont ezek viszik el a legtöbb időt.

Mennyi idő és mibe kerül?

Egy egyszerű integráció néhány napos munka, egy összetett, több rendszert érintő megoldás heteket is igénybe vehet. Az időt jellemzően nem a „boldog út” viszi el, hanem a kivételek, a hibakezelés és a tesztelés.

Általában a költségek jelentős része az integrációkban van, erről a költségcikkben is írtam. Számolj azzal is, hogy az integrációt karban kell tartani: a külső rendszerek API-ja időnként változik, és valakinek követnie kell.

Hogyan indulj el?

  • Írd össze, mely rendszerek között másoltok ma kézzel adatot, és ez heti hány órát visz el.
  • Minden adatkörre döntsd el, melyik rendszer a gazdája.
  • Nézd meg, van-e kész összekötő, és az lefedi-e a kivételeket is.
  • Kezdd egyetlen adatfolyammal (például rendelésből számla), és csak utána bővítsd.

Ha szeretnéd összekötni a rendszereidet, nézd meg, mit építek, vagy kérj konzultációt. Az adminisztráció automatizálásáról is érdemes elolvasnod.

Mennyit hozna vissza az Ön cégénél?Három csúszka, és látja, mennyibe kerül most a kézi munka.
Kalkulátor
Pethe BálintEgyedi üzleti rendszereket építek kis- és középvállalkozásoknak. Korábban a Trust Group Kft. CTO-ja voltam.Bővebben rólam →
Hasznos volt a cikk?

Gyakori kérdések

Mi az az API-integráció?

Az a megoldás, amellyel két program automatikusan cserél adatot egymással, például a webshop átadja a megrendelést a számlázónak, így nem kell kézzel átmásolni.

Hogyan működik a számlázó API integráció?

A webshop vagy az ügyviteli rendszer az API-n keresztül elküldi a számla adatait a számlázóprogramnak, amely kiállítja a számlát, és visszaadja a számlaszámot és a PDF-et. A NAV felé történő adatszolgáltatást jellemzően a számlázóprogram végzi.

Mikor kell egyedi integrációt építeni?

Ha nincs kész összekötő, az nem fedi le a folyamatodat, összetett szabályok vannak, nagy a volumen, vagy több rendszert kell egyszerre összekötni.

Mennyi ideig tart egy integráció elkészítése?

Egy egyszerű, kétrendszeres integráció néhány napos munka, egy összetett, több rendszert és sok kivételt kezelő megoldás több hetet is igénybe vehet.

Mik a leggyakoribb problémák integrációnál?

A tisztázatlan adatgazda, a hibakezelés és a monitorozás hiánya, valamint az, hogy az API változik, és nincs, aki karbantartsa.