Shoptet webhooky s daty 2026: Co se změnilo 29. září a co to znamená pro napojení účetnictví, skladu a automatizací

Shoptet od 29. září 2026 umí posílat ve webhooku rovnou kompletní data objednávky, faktury, produktu nebo zákazníka. Dosud webhook jen oznámil, že se něco změnilo, a napojený systém si musel data dotáhnout dalším voláním API. Od 1. října 2026 k tomu přibyly další novinky v API: úprava dopravních metod a asynchronní nahrávání obrázků produktů.

Pro majitele e-shopu to zní technicky, ale dopad je praktický: napojení účetnictví, skladu, CRM nebo automatizací může být rychlejší a spolehlivější. V tomhle návodu vysvětlíme, co se změnilo, koho se to týká a na co se zeptat vývojáře nebo dodavatele doplňku.

Ve zkratce

• Novinka je volitelná. Stávající napojení fungují dál beze změny.
• Data ve webhooku se zapínají parametrem "sendPayload": "full" u konkrétního webhooku.
• Funguje pro události create a update, ne pro delete a hromadné (mass) události.
• Shoptet nově při registraci webhooku kontroluje oprávnění doplňku nebo tokenu.
• Zdroj: Shoptet Developers, 29. 9. 2026 a API Release News 1. 10. 2026.

Co je webhook a proč na tom záleží

Webhook je automatická zpráva, kterou Shoptet pošle na adresu vašeho systému, když se v e-shopu něco stane, třeba vznikne nová objednávka (order:create) nebo se změní produkt (product:update). Díky tomu se napojené systémy nemusí každých pár minut ptát, jestli je něco nového.

Až do konce září ale webhook nesl jen „metadata“: e-shop, typ události, čas a identifikátor. Napojení si pak muselo zavolat API a data načíst. U jedné objednávky to byly dva kroky, u stovek objednávek v sezóně stovky dalších dotazů.

Co se změnilo 29. září 2026

Podle oficiálního oznámení Shoptetu může notifikace nově obsahovat pole payload se stejnými daty, jaká vrací detailní endpoint API (včetně všech rozšiřujících parametrů include). Napojený systém tak může objednávku nebo fakturu zpracovat hned, bez dalšího dotazu.

Shoptet uvádí tři přínosy:

• zpracování objednávek, faktur, produktů a zákazníků hned po doručení notifikace,
• méně dotazů do Shoptet API,
• synchronizace téměř v reálném čase.

Pro které události data přijdou

Bez dat zůstávají události typu delete a hromadné události *:massCreate, *:massUpdate a *:massDelete. Hromadné změny (třeba import ceníku) se tedy dál zpracovávají postaru.

V plánu Shoptet uvádí doplnění dat i pro pohyby skladu (stock:movement), ceníky a prodejní kanály. Sám ale upozorňuje, že plán se může změnit, takže na něm zatím nestavte.

Jak se novinka zapíná

Nic se nezapne samo. Vývojář nebo dodavatel doplňku musí u konkrétního webhooku při registraci nebo úpravě nastavit parametr sendPayload na hodnotu full:

{
  "data": [
    {
      "event": "order:create",
      "url": "https://vase-aplikace.cz/objednavky",
      "sendPayload": "full"
    }
  ]
}

Když parametr chybí nebo je null, webhook se chová jako dřív. Podrobnosti jsou v dokumentaci webhooků Shoptetu.

Tři věci, které se mění pro všechna napojení

1. Kontrola oprávnění při registraci

Registrace webhooku (POST /api/webhooks i PATCH /api/webhooks/{id}) nově ověřuje, že doplněk nebo privátní token má oprávnění ke skupině endpointů, ze které data pro danou událost pocházejí. Bez oprávnění Shoptet registraci odmítne.

2. Automatické odhlášení při ztrátě oprávnění

Když token o oprávnění přijde, Shoptet webhooky pro dotčené události automaticky odregistruje. A pozor: obnovení oprávnění je znovu nevytvoří. Webhook je potřeba zaregistrovat znovu. Pokud tedy upravujete práva privátního API tokenu (u Shoptet Premium) nebo doplňku, ověřte potom, že napojení dál dostává události.

3. Data nemusí přijít vždy

Pokud Shoptet nedokáže data v okamžiku odeslání načíst, pošle notifikaci bez pole payload. Shoptet proto doporučuje mít v napojení záložní dotaz na detailní endpoint. Dobré napojení s tím počítá.

Pravidla, která platí dál (a často se na ně zapomíná)

Z dokumentace webhooků:

• Napojení musí notifikaci potvrdit kódem HTTP 200 do 4 sekund.
• Jinak Shoptet zprávu zopakuje po 15 minutách, nejvýš dvakrát (celkem 3 pokusy). Pokud ani poslední pokus neprojde, webhook označí jako neaktivní.
• Doporučení Shoptetu: notifikaci jen rychle uložit a další zpracování (čtení detailu, e-maily, interní operace) dělat asynchronně.
• Pravost zprávy ověříte hlavičkou Shoptet-Webhook-Signature (HMAC SHA1 z těla zprávy). Podpis se počítá z celého těla včetně payloadu.

Pro majitele e-shopu z toho plyne jednoduchá otázka na dodavatele: „Co se stane, když vaše aplikace na webhook nestihne odpovědět?“ Pokud odpověď nezní jako „máme frontu a záložní načítání“, je to riziko ztracených objednávek ve špičce, třeba na Black Friday.

Další novinky v API od 1. října 2026

Podle API Release News:

• Úprava dopravních metod: nový endpoint PATCH /api/shipping-methods/{guid} upraví existující dopravní metodu včetně ceníků. Doplněk ale může upravit jen dopravní metody, které sám vytvořil.
• Asynchronní vkládání obrázků produktů: hromadný endpoint vrátí jobId (HTTP 202), chybné řádky zaloguje a přeskočí, aniž by zastavil celou dávku. Hodí se pro velké importy katalogu.
• GUID rodičovského produktu u webhooků variant (productVariant:*): variantu jde přiřadit k produktu bez dalšího dotazu.

Shoptet zároveň uvádí, že v tomto sprintu nejsou žádné zpětně nekompatibilní změny (breaking changes).

Co to znamená v praxi: tři typické scénáře

Účetnictví a fakturace

Napojení na účetní systém může nově převzít fakturu nebo dobropis rovnou z webhooku (invoice:create, creditNote:create). Méně dotazů znamená menší riziko, že napojení narazí na limity API ve chvíli, kdy přijde hodně objednávek najednou.

Sklad a expedice

Externí sklad nebo fulfillment může objednávku převzít hned po vzniku (order:create) i se všemi položkami a adresou. Pohyby skladu (stock:movement) zatím data neposílají, ty jsou teprve v plánu.

Automatizace přes Make nebo Zapier

Pokud máte scénář postavený na webhooku Shoptetu, data v notifikaci mohou ušetřit krok „načti detail objednávky“ a tím i operace, které se v těchto nástrojích platí. Jestli to konkrétní napojení podporuje, záleží na tom, jak je webhook zaregistrovaný. Základ propojení popisujeme v návodu Jak propojit Make se Shoptetem.

Checklist pro majitele e-shopu

• ☐ Sepište si všechna napojení, která používají webhooky (účetnictví, sklad, CRM, automatizace).
• ☐ Zeptejte se dodavatelů, jestli plánují přechod na sendPayload: "full" a jestli mají záložní načtení detailu.
• ☐ Ověřte, že napojení odpovídá do 4 sekund a zpracovává data až potom.
• ☐ Po každé změně oprávnění doplňku nebo privátního tokenu zkontrolujte, že webhooky dál chodí.
• ☐ Před sezónou otestujte nárazové zatížení (desítky objednávek za minutu).
• ☐ U hromadných importů počítejte s tím, že mass události data neposílají.

Privátní přístup k Shoptet API mají jen e-shopy na Shoptet Premium; kdy se tento přechod vyplatí, popisuje článek o ceně a obsahu Shoptet Premium.

Webhooky doplňují čtení a zápis přes REST — Private API token a první volání shrnuje Shoptet API 2026.

Webhook při změně stavu dává smysl až když máte čistou mapu stavů — prakticky v Shoptet stavy objednávek 2026.

Časté otázky

Musím teď něco udělat? Ne. Novinka je volitelná a stávající napojení fungují beze změny. Jen pozor na novou kontrolu oprávnění při registraci nebo úpravě webhooku.

Týká se to i běžných tarifů, nebo jen Premium? Webhooky používají doplňky z Doplňků Shoptetu na všech tarifech. Privátní API s vlastními tokeny je určené pro Shoptet Premium. Shoptet uvádí, že data ve webhooku mohou dostávat všichni uživatelé API.

Kde najdu seznam všech událostí? V přehledu typů webhook událostí v API dokumentaci Shoptetu.

Další čtení na BizTools: AI funkce v administraci Shoptetu 2026 a Shoptet Pokladna 2026.

Zdroje: Shoptet Developers: Webhooks with payload in Shoptet API (29. 9. 2026), Shoptet Developers: API Release News from October 1, 2026, Shoptet: dokumentace webhooků. Ověřeno 8. 10. 2026.