Business Central webshop integráció: mi, merre, milyen gyakran

Röviden: mit csinál egy Business Central webshop integráció?

A Business Central webshop integráció összhangban tartja a WooCommerce-t (vagy az egyedi webáruházat) és a Microsoft Dynamics 365 Business Centralt. A cikkek, a készlet és az árak az ERP-ből mennek a webshopba, a rendelések és az új vevők vissza az ERP-be, a számla és a szállítási státusz pedig megjelenik a vevő fiókjában. Senki nem gépel be újra rendelést, és a webshop nem ad el olyat, ami nincs a raktárban.

Technikailag a Business Central API v2.0 (OData REST) adja az alapot, néha saját API-oldalakkal bővítve. Nem az API hívása a nehéz, hanem annak eldöntése, melyik rendszer a gazdája az egyes adatoknak, és milyen gyakran mozognak.

Miért nem működik sokáig a kézi átvezetés?

Integráció nélkül valaki Excelbe exportálja a készletet, feltölti a WooCommerce-be, aztán minden rendelést kézzel rögzít értékesítési rendelésként. Heti 20 rendelésnél ez megy. Napi 50-nél már késő kiszállítást, rossz készletet és a fizetett összeggel nem egyező számlát jelent.

A magyar webshopoknál ehhez jön a NAV. Minden számla adatai valós időben mennek az Online Számla rendszerbe, ezért ha egy rendelés hibás vevőadattal vagy rossz árral kerül a Business Centralba, a hiba a NAV-ig jut, és csak módosító vagy sztornó számlával javítható.

A tipikus fájdalompontok:

• Túlértékesítés: a webshop készlete órákkal le van maradva, a vevő megveszi azt, amit reggel eladtak a bemutatóteremben.
• Árcsúszás: a pénzügy átírja az árat vagy a vevői kedvezményt a Business Centralban, a webshop a régit mutatja.
• Dupla rögzítés: rendelések, vevők, fizetések kétszer begépelve, elírt cikkszámmal és adószámmal.

Milyen integrációs lehetőségeid vannak?

Megoldás	Mikor elég	Mire figyelj
Külső csatoló (AppSource vagy WooCommerce-plugin)	Szabványos katalógus, egy cég, egyszerű árak	Fix mezőleképezés; vevői árak, telephelyek, változatok gyakran korlátozottak
Integrációs platform (iPaaS) vagy Power Automate	Néhány egyszerű folyamat, kis forgalom	A Power Automate csatoló nem dolgozza fel a tömeges „collection” értesítéseket
Egyedi integráció az API v2.0-ra	Több telephely, B2B árak, változatok, egyedi webshop	Kell egy csapat, amely a WooCommerce-t és a Business Centralt is ismeri
Egyedi integráció saját API-oldalakkal (AL-bővítmény)	Olyan adatok, amelyeket a szabványos API nem ad ki (árlista-sorok, telephelyenkénti készlet)	A bővítményt Business Central fejlesztő vagy partner telepíti

Ha egy raktárad, néhány száz terméked és vevőnként egyforma árad van, egy jó csatoló kiszolgál. Az egyedi integráció akkor térül meg, amikor az üzleti szabályaid a Business Centralban élnek, és a csatoló nem látja őket.

Mi szinkronizál, milyen irányban és milyen gyakran?

Adat	Irány	Gyakoriság	A Business Central oldalán
Cikkek (név, cikkszám, kategória, mértékegység, EAN)	BC → webshop	15–60 percenként vagy webhook az items entitásra	items, itemCategories, unitsOfMeasure
Változatok (méret, szín)	BC → webshop	A cikkekkel együtt	itemVariants
Készlet	BC → webshop	5–15 percenként, plusz foglalás rendeléskor	inventory mező az items entitáson; telephelyenként saját API-val vagy queryvel
Listaárak	BC → webshop	Óránként vagy éjjel	unitPrice az items entitáson
Vevői árak és kedvezmények (B2B)	BC → webshop	Éjjel és változáskor	Árlisták, jellemzően saját API-oldallal
Vevők	Webshop → BC (új), BC → webshop (B2B fiókok)	Első rendeléskor / éjjel	customers
Rendelések	Webshop → BC	Fizetés után egy percen belül	salesOrders, salesOrderLines
Fizetés és utánvét	Webshop → BC	A rendeléssel vagy beérkezéskor	Fizetési mód a rendelésen vagy customerPaymentJournals
Szállítások, követési szám	BC → webshop	15–30 percenként	salesShipments
Számlák (státusz és PDF)	BC → webshop	15–60 percenként vagy webhook a salesInvoices entitásra	salesInvoices, pdfDocument
Jóváírások, visszáru	BC → webshop	Naponta	salesCreditMemos

Két szabály nélkül a táblázat nem működik. Minden adatnak pontosan egy gazdája van. És az integráció elmenti a Business Central azonosítót (a GUID id mezőt) a WooCommerce termékére, vevőjére és rendelésére, így a frissítés soha nem név alapján párosít.

Hogyan kösd össze lépésről lépésre?

1. Hitelesítés

A Business Central online OAuth 2.0-t használ a Microsoft Entra ID-n keresztül. Regisztrálj egy alkalmazást az Entrában, add meg neki a Business Central API-jogosultságot, majd vedd fel a Business Central Microsoft Entra Applications oldalán, csak a szükséges jogosultságkészletekkel. A webszolgáltatás-hozzáférési kulcs (alapszintű hitelesítés) a Business Central online-ban már nem támogatott, ezért ha egy plugin felhasználónevet és kulcsot kér, elavult.

A hívások a https://api.businesscentral.dynamics.com/v2.0/{tenant}/{environment}/api/v2.0/companies({id})/... címre mennek. Mindent először sandbox környezetben építs és tesztelj.

2. Adattisztítás a Business Centralban

Minden online eladott cikknek legyen egyedi cikkszáma, értékesítési mértékegysége, ára és lehetőleg EAN-kódja. A vevőknek kell vevőkönyvelési csoport, áfa üzleti könyvelési csoport és fizetési feltétel kód. A hiányzó beállítás okozza a könyvelési hibák többségét.

Céges vevőnél kérd be és ellenőrizd az adószámot, mielőtt vevőt hozol létre; a NAV Online Számlában a belföldi céges vevő adószáma kötelező adat. Magánszemélyeknél döntsd el a könyvelővel, hogy egy gyűjtő „webes magánszemély” vevőt használsz, vagy mindenkit külön veszel fel.

3. A rendelési folyamat

Határozd meg, mikor megy át a rendelés (fizetés után, vagy utánvétnél és átutalásnál azonnal), melyik vevőre kerül, és hogyan jelenik meg a szállítási díj és a kupon. A szállítási díj általában főkönyvi vagy erőforrás-sor, a kedvezmény a termék során szerepeljen, ne negatív cikként, különben a NAV-nak küldött számla furcsán néz ki.

4. API-korlátok

A Microsoft dokumentálja a Business Central online korlátait. Felhasználónként 5 perces csúszó ablakban 6000 OData-kérés, 5 egyidejű kérés, legfeljebb 20 000 entitás oldalanként és 100 művelet egy $batch kérésben. A korlát felett 429 Too Many Requests jön, hosszú sorban állásnál 503. Használj $batch-et, $filter=lastModifiedDateTime gt ... alapú inkrementális szinkront és visszalépéses újrapróbálást. Részletek a Microsoft korlátokról szóló oldalán.

5. Webhookok, de nem csak azok

A webhook-előfizetés POST kéréssel jön létre a /api/v2.0/subscriptions végponton, validationToken-es kézfogást igényel, és három nap után lejár, ha nem újítod meg PATCH-csel. Ha 30 másodpercen belül több mint 1000 rekord változik, egyetlen collection értesítés érkezik. A támogatott entitások a webhook-dokumentációban vannak; a telephelyenkénti készlet nincs köztük, ezért a készlethez maradjon ütemezett feladat.

6. Hibák, amelyekkel találkozni fogsz

• The field No. of table Sales Line contains a value (...) that cannot be found in the related table (Item). A webshop cikkszáma nem létezik vagy zárolt a Business Centralban.
• 429 Too Many Requests teljes katalógusszinkronnál. Csoportosíts és lassíts.
• 412 Precondition Failed, ha az If-Match fejlécben nincs aktuális @odata.etag. Olvasd újra a rekordot és próbáld újra.
• 401 Unauthorized, amikor lejár az Entra-alkalmazás titkos kulcsa. Tedd be a lejárati dátumot a naptárba.
• Könyvelési hiba új webes vevőnél hiányzó könyvelési csoport vagy áfabeállítás miatt. A vevősablont javítsd, ne rendelésenként.

Minden sikertelen hívás jelenjen meg a WooCommerce rendelésen, újraküldés gombbal.

7. Élesítés és az első hét

Az élesítés előtti napon futtass egy teljes szinkront a sandboxból éles környezetbe másolt adatokkal, és hasonlítsd össze a webshop és a Business Central készletét és árait legalább ötven véletlenszerű cikknél. Ha eltérés van, most még olcsó javítani.

Az első héten naponta nézd át a sikertelen hívások listáját, és jegyezd fel, melyik hibatípus ismétlődik. A tapasztalatunk szerint a hibák többsége az első napokban hiányzó törzsadatból (cikkszám, könyvelési csoport, mértékegység) jön, nem az integráció kódjából. Ha a könyvelő és a raktár is látja ezt a listát, a hibák gyorsan elfogynak.

Tervezz egy egyszerű ellenőrző riportot is: naponta egy lista azokról a webshoprendelésekről, amelyekhez nincs Business Central rendelés, és azokról a számlákról, amelyek nem jelentek meg a vevő fiókjában. Ez a két szám mutatja meg a leggyorsabban, ha valahol elakad a folyamat.

Indulás előtti ellenőrzőlista

• Entra-alkalmazás regisztrálva, minimális jogosultság, kulcslejárat feljegyezve
• Minden teszt sandboxban
• Minden mezőnek kijelölt gazdája (cikk, ár, készlet, vevő, rendelés)
• Business Central id elmentve termékre, vevőre, rendelésre
• Cikkszám, mértékegység és ár minden online cikknél
• Magánszemély és céges vevősablon könyvelési csoportokkal és fizetési feltétellel
• Céges vevők adószáma ellenőrizve
• Szállítási díj és kedvezmény leképezése egyeztetve a könyvelővel
• NAV-adatszolgáltatás a Business Central lokalizációján keresztül tesztelve
• Inkrementális szinkron lastModifiedDateTime alapján, éjszakai teljes ellenőrzéssel
• Újrapróbálás 429 és 503 esetén
• Webhook-megújítás ütemezve a háromnapos lejárat előtt
• Terheléses teszt teljes katalógusszinkronnal Black Friday előtt

A szállítási oldalról külön írtunk: a GLS, Foxpost WooCommerce integrációról szóló cikk megmutatja, hogyan mozog a szállítási adat a webshop, a futár és az ERP között.

Mennyibe kerül egy Business Central integráció?

Terjedelem	Jellemző idő	Becsült költség
Külső csatoló beállítása	1–2 hét	Csatolólicenc plusz 1 000–3 000 € beállítás
Egyedi szinkron: cikkek, készlet, árak, vevők, rendelések	4–8 hét	5 000–12 000 € (kb. 1,8–4,4 millió Ft)
Teljes kétirányú szinkron telephelyekkel, B2B árakkal, számlákkal, szállítással, visszáruval	2–4 hónap	12 000–30 000 €+

Ezek tipikus projektekből vett becslések ÁFA nélkül, nem árlista; a forintösszeg kb. 365 Ft/€ árfolyammal, kerekítve készült.¹ A Business Central partnered saját API-oldalakra és a magyar lokalizáció beállítására fordított ideje ezen felül jön. A Raao-nál az ERP-integráció az Enterprise csomag része, vagy modulként kerül egy meglévő webshophoz. A nagyobb projektek fizetős felmérő workshoppal indulnak, amelyből specifikáció és fix ajánlat lesz. Minden egy ingyenes, 30 perces beszélgetéssel kezdődik, amelyet itt foglalhatsz. A Business Centralra épülő CRM- és működési alkalmazásokról az egyedi szoftver oldalon és egy kiskereskedelmi csoportnak épített CRM- és ERP-központ esettanulmányában olvashatsz.

Hogyan csináltuk egy Miele-partner webshopjánál?

A Miele-partner áruházban a Business Central a működés közepe, nem csak egy exportcél:

• Kétirányú Business Central integráció termékekre, telephelyenkénti készletre, rendelésekre, számlákra és szállításokra.
• A rendelések, számlák és hűségkedvezmények a Business Centralon keresztül futnak, így a webshop és a pénzügy ugyanazt látja.
• Szállítási becslések a készleten nem lévő tételekre a Tradeplace-en keresztül.
• Egy platform az online, üzleti és B2B értékesítéshez, ajánlatkéréses Miele Professional B2B áruházzal.

Az ügyfél szemével az eredmény: minden vevő pontos készletet és szállítási dátumot lát, a rendelések és számlák pedig újragépelés nélkül jutnak az ERP-be. Ugyanezt az elvet alkalmazzuk a Kuiba bútoráruháznál, ahol a rendelések az ügyfél CRM-rétegén keresztül kerülnek automatikusan a Business Centralba.