Ugrás a tartalomra
Rainforge

API-integráció: kösse össze a programokat, amelyeket már használ

Egy API integrációval két program magától adja át egymásnak az adatot, így senki nem másol át egy rendelést, egy címet vagy egy számlát egyik képernyőről a másikra.

Egyedi API integrációt olyan cégeknek építünk, amelyeknek a programjaihoz nincs kész összekötő, vagy az összekötő egy lépéssel azelőtt áll meg, ami a napot elviszi. Az oldal példája a saját alkatrész-kereskedésünk rendelési rendszere: nyolc bekötés, egy képernyő a csomagolóknak.

Az Invent, a rendelési rendszerünkegy képernyő a csomagolásra, a szállításra, a számlákra és a pénzre
  • eBayötpercenként új rendelések be, követési számok vissza
  • FedExélő árak, címke, futárrendelés, vámszámla
  • Csomagküldő közvetítőGLS, DPD, UPS és más futárcégek árai egymás mellett
  • Számlázz.hua számla, vevőnként kiszámolt áfasorral
  • Uniós áfa-nyilvántartása vevő adószáma ellenőrizve, mielőtt használjuk
  • A bankbanki tételek szabályok szerint, kifizetett számlák párosítva
  • ICE, a listázó alkalmazásminden új hirdetés, és hogy mely dobozokba került
  • A Kakapo Press webshopkifizetett könyvrendelések, ugyanabba a csomagolásba
Minden vonal egy külön integráció, saját szabályokkal. Együtt viszik végig az eBay-rendelést a vevő kattintásától a könyvelő havi csomagjáig, átgépelés nélkül.

Integrációk, amelyeket építettünk és futtatunk

A másik oldalon álló rendszer fajtája szerint. Mindegyik élesben fut, a saját cégeinkben vagy egy ügyfélnél.

Piacterek

Az Invent magától hozza be az eBay-rendeléseket. Ha egy hirdetésben „lot of 6” áll, kiszámolja, hány darab az, és a rendelést ahhoz a dobozhoz rendeli, amelyben vannak. A követési szám magától megy vissza az eBay-re.

A Kakapo Press webshop együtt tartja a könyveit az AbeBooks-szal. Mindig a teljes rekordot küldi, mert ott egy részleges frissítés kitörli a kihagyott mezőket, és egy könyvet csak akkor vesz le a piactérről, ha a könyv saját hirdetésoldalán megerősítette az eladást.

Futárcégek és vám

Egy magyar csomagküldő közvetítő egy bekötéssel adta meg az európai futárcégeket. A fő FedEx-útvonalakhoz néhány héttel később közvetlen kapcsolatot is építettünk, mert azon megy az elektronikus vámpapír és a futárrendelés.

Fél egy előtt foglalt csomagért a FedEx még aznap jön; a későbbi foglalás a következő munkanapra kerül, hétvégét és magyar ünnepnapot kihagyva, a mozgó húsvétiakat is.

Számlázás és adó

A számlák a Számlázz.hu-n keresztül mennek ki, vevőnként kiszámolt áfakezeléssel: belföldön magyar áfa, érvényes adószámú uniós cégnek fordított adózás, az EU-n kívülre 0%-os export. Ha a vevő a rendelési megjegyzésbe írja az adószámát, előbb az uniós nyilvántartásban ellenőrizzük.

Az antikvárium számlái a használt könyvekre vonatkozó különbözeti adózással készülnek. Egy gomb egyszer állítja ki a számlát, és tesztrendelésre nem hajlandó. Számlázz.hu, Billingo és NAV bekötés

Fizetés

A Kakapo pénztára a vevőt egy kártyás fizetési oldalra küldi. A fizetési szolgáltató aláírt üzenete pontosan egyszer jelöli fizetettnek a rendelést, és ha az üzenet elveszik, egy ütemezett feladat megkérdezi a szolgáltatót, és helyreállítja a rendelést.

Az Iron Rainbow piacterén minden fizetés megoszlik a porfestő műhely, az Iron Rainbow, egy marketingkeret és a munkában részt vevő partner között. A szabályok egy helyen vannak, tesztekkel, amelyek az összegeket ellenőrzik.

Google, hirdetések, közösségi platformok

Az antikvárium a Google Merchant Centernek minden fotózott könyvről termékfeedet küld, országonkénti szállítási díjjal. A hirdetési kódok csak a látogató hozzájárulása után töltődnek be.

Az Iron Rainbow tartalommotorja hét platformra publikál, követett rövid linkekkel, amelyekből látszik, melyik poszt hozott látogatót, és behozza az új hozzászólásokat.

E-mail, telefon, csevegő

Az Iron Rainbow-nak épített CRM-ben a megkeresésekre jött válaszok maguktól visszakerülnek, és aki STOP-ot ír, annak soha többé nem írunk. Ha egy műhely kitölti a weboldal űrlapját, a rendszer hozzárendeli a már ismert műhelyhez, és jelez a csapat csevegőjében.

Az üzleti vonal hívásait a saját szervereinken írjuk át szöveggé, és a bevezető hívás válaszai egyenesen a műhely adatlapjára kerülnek.

Az Invent számlázási képernyője fordított adózással és a Számlázz.hu számla előnézetével (mintaadatok)
Az Invent számlázási sora: áfasor vevőnként, ellenőrzött adószám, és előnézet arról, mit állít ki a Számlázz.hu.
Az Invent rendelési listája nyitott eBay-rendelésekkel (mintaadatok)
Az eBay-rendelések, ahogy beérkeznek az Inventbe, a legrégebbi elöl, az alkatrész fotójával és a vevő országával.
Kakapo könyvoldal, amely szerint a könyv él a kakapopress.com-on és frissült az AbeBooks-on
Egy mentés a Kakapóban felteszi a könyvet az antikvárium saját boltjába, és ugyanazt a rekordot sorba állítja az AbeBooks felé.

Mit kötünk össze

Webshopok, piacterek, futárcégek és számlázók, amelyeket a saját cégeinknek és ügyfeleinknek már bekötöttünk.

Webshopok és weboldalak
Shopify, WooCommerce, WordPress, UNAS, ShopRenter
Piacterek és árösszehasonlítók
Jófogás, eMAG, Árukereső, eBay, Etsy, AbeBooks
Ügyviteli programok
MiniCRM, Kulcs-Soft, Google Sheets
Cég- és árfolyamadatok
Opten cégadatok, MNB árfolyamok
AI és üzenetek
OpenAI (ChatGPT), Facebook, Viber, SMS

Webshop: Shopify, WooCommerce

A rendelés a webshopból magától indul tovább: számla a Számlázz.hu-n vagy a Billingón át, címke a futárnál, a követési szám vissza a vevőnek. A készlet a raktárból frissül, nem kézzel.

Jófogás és más piacterek

Ha a webshop mellett Jófogáson, eBayen vagy Etsyn is árul, a hirdetéseket ugyanabból a készletből kezeljük, hogy egy eladott darab ne maradjon fenn a másik helyen.

További API-k, amelyeket bekötünk

Ezekre is van kereslet, és ezeket is bekötöttük már. Ha a mi rendszere nincs itt, a hívásban a dokumentációját nézzük meg.

Fizetés és bank

Barion, SimplePay, Stripe és PayPal a pénztárban, Revolut és Wise a banki oldalon; a rendelés pontosan egyszer lesz fizetett. Fizetési kapu bekötése

UNAS és ShopRenter

A hazai webshopmotorok rendelései és készlete a futárhoz, a számlázóhoz és a piacterekhez kötve. UNAS és ShopRenter API

Árukereső és eMAG

A termékek, az árak és a készlet a webshopból kerülnek az árösszehasonlítóba és a piactérre, nem kézzel.

Cégadat, adószám, árfolyam

A vevő cégadatai az Opten adataiból, az adószám ellenőrizve, a deviza a számlához az MNB árfolyamán.

MiniCRM, Kulcs-Soft, Google Sheets

Az ügyfél, a rendelés és a készlet összhangban a CRM-mel, az ügyviteli programmal vagy azzal a táblázattal, amelyből ma dolgoznak.

ChatGPT és OpenAI API

Az AI a saját rendszerében olvas, besorol és vázlatot ír, egy ember pedig jóváhagy. ChatGPT API bekötés

Facebook, Viber, SMS

Értesítés a vevőnek a rendelés állapotáról, és a beérkező üzenetek egy helyen, a rendelés mellett.

Hogyan építünk egy integrációt

A munka nagy része azokra az esetekre megy, amikor valami félremegy: hiányzó mező, meg nem érkező üzenet, lejárt kulcs.

  1. 1Végigmegyünk a lépésen ÖnnelMelyik képernyőről másol valaki, hova, és mit ellenőriz közben. Ezekből az ellenőrzésekből lesznek az integráció szabályai.
  2. 2Elolvassuk a másik oldal szabályaitA dokumentációt, a kéréskorlátokat, és hogy mit kezd egy félig kitöltött rekorddal. Az AbeBooks megtanított rá, hogy mindig a teljeset küldjük.
  3. 3Tesztfiókon építjükAhol a szolgáltatásnak van ilyen. Élesben csak az éles szerver küldhet, mióta a rendelési rendszerünk egy tesztpéldánya valódi üzeneteket küldött vevőknek.
  4. 4Sorba tesszük, hogy semmit ne küldjünk el kétszerA CRM-ben minden e-mail és emlékeztető egy sor, amelyet le kell foglalni, mielőtt elküldjük. Így semmi nem megy el kétszer, és semmi nem marad ki.
  5. 5Jelentjük, ami nem történt megNapi lista arról, ami számla nélkül ment ki, melyik csomag akadt fenn a vámon, melyik kulcs állt le. Egy ember még aznap látja a hiányt.

Lehet, hogy egy kész összekötő is elég

Ha két népszerű alkalmazás között egyetlen egyszerű lépés kell, havonta néhány tucatszor, a Zapier vagy a Make havidíjért, fejlesztés nélkül megoldja. Ezt a hívásban meg is mondjuk.

Egyedi integráció akkor éri meg, ha a lépéshez a saját szabályai kellenek, ha a szolgáltatás nincs az összekötő listáján, vagy ha egy dupla küldés pénzbe kerül. WooCommerce-webshophoz a Számlázz.hu bekötésére kész bővítmény is létezik: mikor elég ez, és mikor nem.

Kérdések az API integrációról

Mi az egyedi API-integráció?

A cégére írt kód, amely két vagy több rendszert köt össze az API-jukon át, és közben a saját szabályait alkalmazza: melyik futár, melyik áfasor, melyik doboz. Egy kész összekötő átviszi az adatot; egy egyedi integráció a döntéseket is meghozza, amelyeket ma a kollégái hoznak.

Mi a különbség a rendszerintegráció és az API-integráció között?

A rendszerintegráció a tágabb fogalom: a cég programjainak összehangolása, akár API nélkül is (például fájlcserével vagy egy hatósági felületre előkészített adatokkal). Az API-integráció ennek az a része, ahol a programok közvetlenül, az API-jukon keresztül beszélnek egymással.

Mennyi ideig tart egy API integráció?

A másik oldaltól függ. A rendelési rendszerünket 2026 májusában kötöttük az eBay-hez, és ugyanakkor foglaltuk az első éles címkét a csomagküldő közvetítőn át; a közvetlen FedEx-kapcsolat néhány héttel később jött.

Mennyibe kerül?

Hívás után, mérföldkövenként árazzuk, miután elolvastuk a másik oldal dokumentációját. A legtöbb integráció egy nagyobb fejlesztés része; lásd: mennyibe kerül az egyedi szoftver.

Mi történik, ha a másik szolgáltatás megváltoztatja az API-ját?

Ezt fedi az üzemeltetés: a szolgáltatások változtatnak, mi pedig követjük. Az antikvárium most egy új AbeBooks hozzáférési kulcsra vár; addig a Kakapo sorban tart minden változást, és a bolt kétóránkénti ellenőrzése közben is együtt tartja a kettőt.

Össze tudják kötni a Shopify-t, a WooCommerce-t vagy a Jófogást?

Igen. Bekötünk Shopify-, WordPress- és WooCommerce-webshopot, a Jófogást, az eBayt és az Etsyt, a futárcégeket (GLS, Foxpost, MPL, DPD, Packeta, Express One, Sameday, DHL, TNT, UPS, FedEx), a Bariont, a SimplePayt, a Stripe-ot, a PayPalt, a Revolutot és a Wise-t, valamint a Számlázz.hu-t, a Billingót és a NAV Online Számlát.

És ha a mi rendszerünk nincs a listán?

A legtöbb üzleti szoftver közzéteszi az API-ját. A hívásban a dokumentációját az automatizálandó lépése mellett nézzük meg, mielőtt árat mondunk. Ugyanígy egy könyvelőprogram vagy egy ERP esetén.

Olvasson tovább

Elég a képernyők közti másolásból

Egy 30 perces hívás. Mutassa meg a két képernyőt, amelyek között a csapata másol, mi pedig megmondjuk, megoldható-e az API-jukkal, mit építenénk, és mennyibe kerül.

Ingyenes hívás: 30 perc