Webhook alapú rendelés-behúzás

Miért kell a webhook?

A rendelések alapesetben egy periodikus szinkronnal kerülnek be: a rendszer a csomagod beállítása szerint naponta többször lefut, és mindig egy teljes időablakot kérdez le. Ez két szempontból nem ideális, ha egy konkrét rendelést azonnal be szeretnél húzni:

• Lassú – a rendelés a következő periodikus futásig várna.
• Pazarló – egy rendelés miatt is a teljes időablakot kérdezi le.

A webhook alapú behúzás ezt oldja meg: a webáruház szól, amikor rendelés érkezik, és a ShopLinker célzottan csak azt a rendelést kérdezi le.

Mely boltoknál elérhető?

Jelenleg Unas és Shoprenter boltnál. Az architektúra integráció-független, csak a webhook fogadás és hitelesítés módja tér el a két rendszer között.

Hogyan működik?

1. A webáruházban beállítod, hogy új rendelésnél hívja meg a ShopLinker webhook végpontját.
2. Rendelés esetén a webshop meghívja a végpontot, és átadja a rendelés azonosítóját.
3. A ShopLinker sorba állítja a rendelést, majd elindít egy célzott rendelésszinkront – ez csak az adott rendelést kérdezi le, nem a teljes időablakot.
4. A rendelés bekerül a rendszerbe, és onnantól a szokásos módon dolgozódik fel (pl. feladás az ERP-be).

Hitelesítés

A webhook végpont HMAC aláírással védett – a bolt beállításai között megadható a HMAC titok. Ez biztosítja, hogy csak a valódi webáruház tudjon rendelést behúzni.

Van egy külön beállítás arra az esetre, ha a webáruház oldalán nem tudsz HMAC-ot beállítani. Ezt csak akkor kapcsold be, ha máshogy nem megy – aláírás nélkül a végpontot bárki meghívhatja.

A periodikus szinkron nem szűnik meg

A webhook kiegészíti, nem helyettesíti a periodikus rendelésszinkront. Ez szándékos: ha egy webhook hívás elveszik (hálózati hiba, a webshop oldali hiba), a következő periodikus futás így is behúzza a rendelést. A két mechanizmus együtt ad gyorsaságot és biztonságot.

Jó tudni