Integrácia skladov, ERP alebo transportných portálov nie je určená na to, aby každých pár sekúnd kontrolovala, či sa niečo nezmenilo v Time Slot Control. Odchádzajúce webhooky posielajú udalosť tak, ako nastane, pričom zachovávajú jasný výsledok každého pokusu o doručenie.

Od udalosti po doručenie bez pollingu

Keď sa rezervácia alebo objednávka zmení, TSC vytvorí udalosť a vyberie aktívne webhook odbery, ktoré sledujú daný typ. Každé predplatné dostane verziovaný JSON cez HTTP POST na svoju cieľovú adresu.

TSC detekuje zmenu a vytvára jedinečnú udalosť.
Aktívne predplatné sa porovnáva s jeho typom.
Pre každý príslušný príkaz bude vytvorená samostatná dodávka.
Odozva cieľového systému určuje výsledný stav alebo ďalší pokus.

Spracovanie je riadené udalosťami a prebieha asynchrónne. Pripojený systém nemusí zaťažovať API častými dotazmi a môže reagovať krátko po skutočnej zmene.

Tok doručenia odchádzajúceho webhooku od udalosti TSC cez podpísaný HTTP POST po stav Delivered, Failed alebo DeadLetter a ručný Resend

Delivery log nahrádza odhady

Administrátor vidí doručenie na jednom mieste a môže ho filtrovať podľa odberu webhooku aj stavu. Pre každý záznam je uvedený typ udalosti, počet pokusov, stav posledného HTTP, čas posledného pokusu a krátka informácia o chybe.

Stav	Čo to znamená
Pending	Doručenie čaká v rade na prvý alebo ďalší pokus.
Delivered	Cieľový systém vrátil úspešnú HTTP odpoveď.
Failed	Posledný pokus skončil dočasnou chybou a bude zopakovaný.
DeadLetter	Automatické pokusy skončili alebo by sa odpoveď nemala automaticky opakovať.

Čo sa stane, keď cieľový systém nie je dostupný

Sieťové chyby, odpovede HTTP 429 a chyby servera 5xx sa opakujú v čoraz dlhších intervaloch, maximálne v piatich pokusoch. Bežné chyby klienta 4xx okrem 429 idú priamo do stavu DeadLetter, pretože ďalší automatický pokus by zvyčajne skončil rovnako.

Po oprave prijímacieho systému môže oprávnený používateľ použiť Resend. TSC resetuje počet pokusov, odstráni poslednú chybu a vráti doručenie do fronty. Preto nie je potrebné vyvolávať pôvodnú obchodnú udalosť.

Udalosti, ktoré zodpovedajú skutočnej prevádzke

Katalóg nekončí generickým vytváraním, úpravami a vymazaním. Integrácia môže tiež odstrániť konkrétne body v životnom cykle rezervácie a objednávky, ako reservation.pendingnapríklad Bookreservation.vehicle.platechangedreservation.markedasarrivalreservation.approval.approvedreservation.processingstartedreservation.markedasdeparted, A alebo order.confirmedA.

Predplatné vyberá len tie udalosti, ktoré potrebuje. Cieľový systém nemusí spätne odvodzovať z všeobecnej zmeny to, čo sa skutočne stalo počas operácie.

Podpísané správy a bezpečné spracovanie

Webhook adresa používa HTTPS. TSC posiela JSON obal s schemaVersionpoliamieventeventIdoccurredAt tenantIda data. Telo požiadavky je podpísané pomocou HMAC-SHA256 a príjemca dostane podpis v hlavičke X-TSC-Signature spolu s časovou pečiatkou.X-TSC-Timestamp

Prijímajúci systém by mal overiť podpis a časovú pečiatku, spracovať eventId ich idempotentne a vrátiť úspešný stav 2xx až po bezpečnom prijatí správy. Tajomstvo je možné otočiť pri zmene bezpečnosti.

Čo prináša do integračných operácií

Menej prieskumov a menšia záťaž na oboch stranách integrácie.
čitateľný stav každej dodávky bez vyhľadávania v niekoľkých logovacích nástrojoch,
Automatické obnovenie z dočasných chýb
Kontrolované manuálne opakovanie po oprave cieľového systému.
overiteľný pôvod a integrita každej správy.

Výsledkom nie je len rýchlejší prenos udalostí, ale aj operačne predvídateľná integrácia: tím vidí, čo už bolo doručené, čo čaká na ďalší pokus a čo vyžaduje zásah.

Chcete prepojiť TSC s ERP, WMS alebo vlastnou integračnou platformou? Prezrite si možnosti integrácie alebo nám opíšte svoj scenár.