Base samo o sobě reaguje na změny jen tehdy, když mu to sami nastavíte. K tomu slouží Automatické akce — pravidla typu „POKUD nastane X, PAK udělej Y”, která se konfigurují přímo v Base panelu (obecně, i v nastavení konkrétní integrace, např. Integrace → Allegro → Stavy objednávek).
Tři způsoby, jak zachytit změnu na objednávce
- Automatická akce přímo v Base — např. pravidlo „pokud přijde žádost o storno z marketplace, nastav status Zrušeno”. Řešení je nejjednodušší na údržbu, protože běží celé na straně Base a nepotřebuje žádnou logiku navíc ve vašem systému.
- Periodické volání
getJournalList — vrací seznam událostí na objednávkách za poslední 3 dny, včetně potvrzení a stornování. Metoda je ve výchozím stavu neaktivní, zapíná se v Base panelu pod Profil → API.
- Webhook — akce typu „Call URL” v Automatických akcích. Base zavolá vaši definovanou adresu (URL) v okamžiku, kdy nastane sledovaná událost, a předá jí ID objednávky, případně další parametry (např.
&cancel=1) nebo proměnné přímo z objednávky (dostupné podobně jako v mailových šablonách). Bývá to nejrychlejší cesta, jak zachytit událost v reálném čase, aniž byste museli cokoliv periodicky pollovat.
Nejčastější use case: zachycení storna
Zákazník požádá o zrušení objednávky na marketplace → Base o tom ví → potřebujete se to dozvědět dřív, než objednávku zbytečně vyexpedujete. Řešení je kombinace výše uvedeného: buď automatická akce rovnou nastaví status Zrušeno/Zamítnuto (viz konkrétní pravidla v Statusy), nebo vás na to upozorní webhook, případně si to všimnete při pravidelném volání getJournalList.
Doručování trackovacích čísel a faktur do marketplace
Přenos trackovacího čísla nebo faktury do zdroje objednávky se často váže na konkrétní status a neprobíhá instantně — Base to zpracovává v dávkách, typicky kolem 9:00, 10:00, 13:00, 16:00 a 23:00 (± pár minut). U Alza integrace navíc hraje roli nastavení uzávěrky (COT — cut-off time). Podrobněji v Přepravní štítky a Faktury.
Pro nové integrace doporučujeme kombinovat webhooky (pro rychlou reakci na kritické události jako storno) s pravidelným getOrders/getJournalList pollingem jako pojistkou pro případ, že by webhook z nějakého důvodu selhal.