Shoptet API 2026: průvodce, limity, webhooky a automatizace

Stručně: Shoptet API je REST rozhraní na api.myshoptet.com. Na tarifech Free–Enterprise ho smí volat jen schválené doplňky z marketplace; vlastní integraci postavíte až na Shoptet Premium (od 12 000 Kč/měs) přes privátní token. Zátěž řídí leaky bucket o 200 kapkách a webhook musí odpovědět do 4 sekund.

Kdo na Shoptet API vůbec má nárok

Nejčastější omyl, který šíří i starší články (včetně dřívější verze téhle stránky): věta „Shoptet API je dostupné od tarifu Profi“ neplatí. Realita má dvě větve:

• Free až Enterprise – API existuje, ale klíč nedostanete vy, nýbrž schválený doplněk z marketplace. Nainstaluje se u vás, dostane OAuth token a přes něj sahá na vaše data. Vlastní skript ani cron tu postavit nelze.
• Shoptet Premium – dostanete privátní REST API a tokeny, které si generujete sami v administraci. Teprve tady píšete vlastní integraci bez schvalování Shoptetem.

Shoptet to má přímo v podmínkách pro vývojáře: „zakázková implementace proto není možná pro klienty, kteří využívají tarify Free až Enterprise“ (zdroj), a ceník uvádí „Privátní REST API“ jako funkci výhradně u Premium (zdroj).

Ceny podle ceníku Shoptetu k 24. 9. 2026; rozbor máme v článku Shoptet ceník 2026.

Čtyři cesty, jak dostat data ven i dovnitř

Kdo nechce programovat, často vystačí s hromadnými importy a exporty nebo hotovým doplňkem – v katalogu na EshopRadaru evidujeme 428 doplňků (stav k 9. 10. 2026), část z nich je určená přímo pro Shoptet Premium.

Registrace a autentizace krok za krokem

A) Doplněk (tarify Free–Enterprise)

Nejdřív musíte být partnerem: návrh, posouzení (Shoptet odpovídá do 4 týdnů), smlouva a technická kontrola. Při instalaci do e-shopu dostanete OAuth access token reprezentující konkrétní instalaci; ten vyměníte za krátkodobý API access token:

curl -X GET "https://123456.myshoptet.com/action/ApiOAuthServer/getAccessToken" \
  -H "Authorization: Bearer VAS_OAUTH_ACCESS_TOKEN"

# {"access_token":"123456-a-...","expires_in":1800}

Token platí 1800 sekund (30 minut). Uložte si čas expirace a kontrolujte ho před voláním; po vypršení vrací API 401 s kódem invalid-token (zdroj). Ověření, který administrátor si otevřel nastavení doplňku, řeší samostatný flow proti /action/OAuthServer/authorize a /token se scope basic_eshop (zdroj).

B) Privátní token (Shoptet Premium)

V administraci jděte na Propojení → Privátní API, klikněte na Přidat a zadejte popis. Token vznikne s přístupem ke všem skupinám endpointů – oprávnění zúžíte odebráním těch, které integrace nepotřebuje. Vygenerovat můžete až 10 tokenů, bez omezené platnosti (zdroj).

curl -X GET "https://api.myshoptet.com/api/orders?itemsPerPage=50" \
  -H "Shoptet-Private-API-Token: VAS_PRIVATNI_TOKEN" \
  -H "Content-Type: application/json"

Pro každou integraci dělejte samostatný token s minimem skupin. Když token unikne, zneplatníte jen jeden. Od září 2026 lze k tokenu zadat i kontaktní e-mail – upozornění rate limiteru a přehled problémových webhooků pak dostane přímo vývojář, který integraci spravuje (zdroj).

Klíčové endpointy

Základní URL je https://api.myshoptet.com, hlavička podle typu přístupu Shoptet-Access-Token, nebo Shoptet-Private-API-Token (zdroj).

Tři detaily, na kterých integrace nejčastěji padají. Stránkování produktů zvládne až 1000 položek na stránku (zdroj), takže nemusíte posílat desetkrát víc requestů, než je nutné. Kód objednávky není číslo – dokumentace varuje, že „this might also include letters, dash, etc.“ (zdroj), a parsování na integer rozbije párování v ERP. A sklad se mění pohybem, ne přepsáním absolutního čísla u produktu (zdroj) – jinak přemažete rezervace z rozpracovaných košíků. Dál existují skupiny endpointů pro zákazníky, účetní doklady, marketing, nastavení, obsah i platební brány (tudy se do Shoptetu dostávají brány typu Stripe – vždy jako schválený doplněk, ne jako vlastní napojení).

Rate limity: zapomeňte na „600 requestů za minutu“

Shoptet nepoužívá prosté počítadlo za minutu, ale leaky bucket plus tvrdé limity na souběžná spojení:

Většina integrací přehlíží zásadní detail: cena požadavku v kapkách se počítá až po jeho vykonání, podle objemu vrácených dat. Velký výpis produktů stojí víc než detail objednávky. Aktuální stav najdete v každé odpovědi v hlavičce X-RateLimit-Bucket-Filling ve tvaru aktuální/maximum (např. 200/200); při plném kbelíku přibude Retry-After (zdroj). Od 10. 8. 2026 se Retry-After vrací v UTC/GMT místo lokálního CET/CEST – kdo ho parsuje jako lokální čas, čeká špatně dlouho (zdroj).

Prakticky: po každé odpovědi si rozparsujte X-RateLimit-Bucket-Filling, a jakmile klesnete pod 20 % rezervy, zpomalte sami. Na 429 nečekejte pevný interval, ale hodnotu z Retry-After – a parsujte ji jako UTC.

Webhooky: události, podpis, retry

Webhook je jediný způsob, jak reagovat na dění v e-shopu bez pollingu, a pravidla jsou přísnější, než se traduje (dokumentace):

• Timeout 4 sekundy na potvrzení kódem 200 – ne 30.
• Retry: při neúspěchu znovu za 15 minut, nejvýš dvakrát (celkem maximálně tři pokusy).
• Podpis v hlavičce Shoptet-Webhook-Signature: hash_hmac('sha1', $messageBody, $signatureKey).
• Payload: eshopId, event, eventCreated, eventInstance; při sendPayload: "full" přibude celá entita.

$body = file_get_contents('php://input');
$expected = hash_hmac('sha1', $body, $signatureKey);

if (!hash_equals($expected, $_SERVER['HTTP_SHOPTET_WEBHOOK_SIGNATURE'] ?? '')) {
    http_response_code(401);
    exit;
}

http_response_code(200);       // 1) potvrdit do 4 s
fastcgi_finish_request();
Queue::push(new ProcessShoptetWebhook(json_decode($body, true))); // 2) zpracovat na pozadi

Schéma je tedy jediné: webhook zařadí zprávu do fronty a hned odpoví 200. Volání ERP nebo generování PDF uvnitř webhooku je koledování o ztracenou událost.

Kompletní seznam je v číselníku událostí. Novinka, která bolí: od 20. 4. 2026 Shoptet hlídá spolehlivost webhooků – při víc než 50 % neúspěšných doručení za 7 dní přijde e-mail a automatické odhlášení webhooku je v plánu (zdroj). Od 18. 9. 2026 navíc platí, že webhook jde zaregistrovat jen pro skupinu endpointů, ke které má doplněk nebo privátní token oprávnění (např. order:create vyžaduje skupinu Objednávky); webhooky bez odpovídajícího oprávnění Shoptet automaticky odhlásil (zdroj).

Asynchronní a batch operace

Dlouhé operace běží asynchronně: požadavek se ověří, přijme a zařadí do fronty, vy dostanete {"data":{"jobId":"3ax1844"}}. Stav zjistíte přes GET /api/system/jobs/{jobId}, po dokončení přijde webhook job:finished s eventInstance rovným jobId. Stavy jsou pending, running, completed, failed, expired a killed. Výsledek na resultUrl se drží 24 hodin (validUntil), metadata a logy 30 dní (zdroj).

Co se ve Shoptet API změnilo v letech 2025–2026

Hlavní důvod, proč staré návody přestaly fungovat – release notes vycházejí zhruba každé dva týdny. Výběr toho, co se vás nejspíš dotkne:

Zdroje – release notes 11/2025, 4/2026, 5/2026, 6/2026, 24. 7. 2026, 29. 7. 2026, 6. 8. 2026, 20. 8. 2026, 4. 9. 2026 a 17. 9. 2026.

Pokud vaše integrace vznikla před rokem 2025 a nikdo ji od té doby neotevřel, je slušná šance, že už tiše selhává na zamykání dokladů nebo na limitu variant – a od poloviny září místo mazání cen ukládá nulové ceny, pokud k mazání posílá 0.

Shoptet MCP: AI asistent nad živými daty

Novinka z července 2026: doplněk propojí e-shop s AI asistentem (Claude, ChatGPT, Codex, Cursor, Gemini, Copilot a další) přes protokol MCP, takže se místo exportu do Excelu ptáte přirozeným jazykem nad živými daty. Je zdarma pro Shoptet Premium (platíte jen za AI nástroj), propojení má tři kroky – instalace doplňku, vložení adresy serveru do AI nástroje, přihlášení přes OAuth. Umí číst i zapisovat, ale „nevratné operace, jako je hromadné mazání dat, nejsou podporovány“ (zdroj).

Typické scénáře automatizace

ERP a účetnictví

Nejčastější důvod, proč lidé po API sáhnou. Na tarifech Free–Enterprise to řešíte hotovým doplňkem – Pohoda, Pohoda by ShopSync, Money ERP, Helios iNuvio nebo ABRA Flexi by Dativery; vlastní obousměrnou synchronizaci postavíte až na Premium. Srovnání konektorů a cen máme v článku Shoptet napojení na ERP.

Osvědčená architektura: webhook order:create a order:paid → fronta → zápis do ERP → zpětný PATCH /api/orders/{code}/status. Pozor na nové optimistické zamykání – když doklad mezitím upraví operátor v administraci, PATCH vrátí konflikt a vy musíte načíst aktuální verzi a opakovat.

Sklad

Stavy měňte skladovým pohybem. Události stock:soldOut a stock:minStockSupplyReached využijete pro automatické objednávky u dodavatele. Bez vývoje pomůže Synchronizace skladů, Skladové hospodářství nebo Hlídání skladu; přehled máme v článku Shoptet skladové hospodářství.

Automatizace objednávek a cen

Když chcete jen přepínat stavy podle pravidel, API nepotřebujete. Doplněk Automatizace objednávek stojí 100 Kč měsíčně (1 152 Kč ročně) a kontroluje objednávky každých 5–10 minut: přepíná stavy podle dopravy, platby, stáří objednávky, skladu, hodnoty i historie zákazníka, posílá upomínky a ruší dlouho nezaplacené objednávky (zdroj). Proti tomu stojí desítky tisíc za vlastní vývoj plus údržba přes všechny breaking changes výše – vlastní řešení má smysl až tam, kde pravidla doplňku nestačí.

Pro dynamické a akční ceny slouží Automatizace akčních cen, Cenový automat nebo Slevy správně (hlídá nejnižší cenu za 30 dní). Vlastní cenotvorba přes API znamená PATCH /api/pricelists/{id} plus batch PATCH /api/products – a od 14. 9. 2026 (postupně podle e-shopu) pozor, nula už neznamená „smaž cenu“.

Marketplace

Napojení na Allegro, Kaufland nebo Mall běží typicky přes prostředníka, který data tahá z API nebo z XML feedu; postup a ceny rozebíráme v článku Shoptet napojení na marketplace.

No-code: Make, Zapier, n8n

Make, Zapier ani n8n nemají nativní Shoptet konektor – stránka Shoptetu v katalogu integrací ani jedné z platforem neexistuje (kontrola 24. 9. 2026). Co funguje:

• Make – obecný modul HTTP a Webhooks jako trigger; hlavičky, tokeny i ověření podpisu si řešíte sami.
• n8n – oficiální node neexistuje, použijete HTTP Request a Webhook node; výhodou je self-hosting.
• Zapier – přímá integrace není; obvyklé je obejití přes prostředníka, který data ze Shoptetu čte z XML feedu.
• Dativery – česká platforma se scénáři přímo pro Shoptet. Propojení e-shopu s účetnictvím stojí měsíčně od 340 Kč podle počtu objednávek (do 50 objednávek), instalace od 4 490 Kč (přenos faktur), u propojení se skladem 22 490 Kč; ceny bez DPH (zdroj).

Klíčové omezení platí i tady: bez Premium nemáte token, takže HTTP modul v Make nemá čím se autorizovat. No-code na běžných tarifech stojí na feedech a doplňcích, ne na API.

Limity API a jak je obejít

• Žádný GraphQL, žádný přímý přístup do databáze ani vlastní SQL. Obejití: data si stáhněte přes REST (produkty až 1000 položek na stránku) nebo asynchronním exportem a dotazujte se nad vlastní kopií; nad živými daty se na Premium ptáte přes Shoptet MCP.
• Vlastní integrace na běžných tarifech – Free až Enterprise znamená jen schválené doplňky. Obejití: hotový doplněk z katalogu, hromadné importy a exporty a XML feedy pokryjí většinu zadání; vlastní kód nad vlastními daty otevře Shoptet Premium s privátním tokenem.
• Neomezené varianty – strop je 512 na produkt. Obejití: extrémní kombinace rozpadněte do víc produktových karet a spojte je propojením produktů.
• Veřejný sandbox pro vývojáře – k dispozici je Postman kolekce, openapi.yaml a oficiální PHP SDK (composer require shoptet/api-sdk-php) (zdroj), samostatné veřejné testovací API prostředí ale dokumentace neuvádí. Sandbox prostředí pro testování má v ceníku jen Shoptet Premium (zdroj). Obejití: testujte na zkušebním e-shopu – zkušební doba je 30 dní se všemi funkcemi tarifu Enterprise.

Pravidlo palce: co neumíte zavolat přes API, jde přes doplněk nebo feed; co má reagovat okamžitě, řešte webhookem místo pollingu; a co skutečně vyžaduje vlastní kód nad vlastními daty, řešte na Premium.

Náklady: doplněk vs. vlastní vývoj

U vlastní integrace není hlavní položkou první nasazení, ale údržba: release notes za rok 2026 obsahují řadu breaking changes (viz tabulka výše). Vlastní veřejný doplněk pro marketplace navíc znamená schvalovací kolečko (odpověď do 4 týdnů) a smlouvu se Shoptetem.

Sedm chyb, kterým se vyhnout

1. Polling místo webhooků. Cyklus každou minutu zbytečně žere kapky z kbelíku.
2. Synchronní práce uvnitř webhooku. Přes čtyři sekundy = neúspěch, tři pokusy a událost je pryč.
3. Neověřený podpis. Bez kontroly Shoptet-Webhook-Signature vám kdokoli podstrčí falešnou objednávku.
4. Kód objednávky jako číslo. Může obsahovat písmena i pomlčky – vždy string.
5. Přepis skladu místo pohybu. Přemaže rezervace z košíků a vznikne přeprodej.
6. Ignorování X-RateLimit-Bucket-Filling. Náklad se počítá podle objemu dat, ne podle počtu volání.
7. Fixní retry místo Retry-After – od srpna 2026 navíc pozor, že hodnota je v UTC.

Související články

• Shoptet napojení na ERP: Pohoda, ABRA, Helios a Money
• Shoptet skladové hospodářství: kompletní průvodce
• Shoptet napojení na marketplace
• Shoptet vs. Shoptet Premium: kdy se vyplatí přejít
• Shoptet ceník a tarify 2026
• Katalog Shoptet doplňků

Časté otázky

Je Shoptet API zdarma?

Samotné API se zvlášť neplatí, ale přístup k němu je vázaný na tarif. Na tarifech Free až Enterprise ho využívají jen schválené doplňky z marketplace, které mají vlastní ceny. Vlastní integraci přes privátní token dostanete až se Shoptet Premium, který startuje na 12 000 Kč měsíčně bez DPH.

Na kterém tarifu můžu psát vlastní integraci?

Pouze na Shoptet Premium. Shoptet to má výslovně v podmínkách pro vývojáře: zakázková implementace není možná pro klienty na tarifech Free až Enterprise. Na běžných tarifech vám zbývají hotové doplňky, hromadné importy a exporty a XML feedy. Starší návody tvrdící „API od tarifu Profi“ jsou nepřesné.

Jaký je skutečný rate limit Shoptet API?

Není to pevný počet požadavků za minutu. Běží leaky bucket s kapacitou 200 kapek a odtokem 10 kapek za sekundu, přičemž cena požadavku se počítá až po jeho vykonání podle objemu vrácených dat. K tomu platí limit 50 souběžných spojení z jedné IP a 3 na jeden token. Při překročení přijde HTTP 429.

Jak dlouho musí webhook odpovědět a co když nestihne?

Váš endpoint musí vrátit HTTP 200 do čtyř sekund. Pokud to nestihne, Shoptet notifikaci pošle znovu za 15 minut, maximálně dvakrát – celkem tedy nejvýš tři pokusy. Proto webhook jen zařaďte do fronty a odpovězte okamžitě; veškeré zpracování dělejte asynchronně na pozadí.

Jak ověřím, že webhook opravdu poslal Shoptet?

V hlavičce Shoptet-Webhook-Signature přijde HMAC-SHA1 podpis těla zprávy vypočítaný vaším signature klíčem. Spočítejte hash_hmac('sha1', $body, $key) a porovnejte časově konstantní funkcí, například hash_equals. Bez tohoto kroku může kdokoli, kdo zná vaši URL, podstrčit falešnou událost.

Existuje Shoptet konektor pro Make nebo Zapier?

Nativní aplikace Shoptet v katalozích Make ani Zapier není. V Make se Shoptet napojuje přes obecný HTTP modul a modul Webhooks, v n8n přes HTTP Request a Webhook node. Alternativou jsou české integrační platformy typu Dativery se scénáři přímo pro Shoptet, kde provoz propojení začíná na 340 Kč měsíčně bez DPH.

Co je Shoptet MCP a k čemu je?

Doplněk zveřejněný v červenci 2026, který propojí e-shop s AI asistentem (například Claude, ChatGPT, Cursor, Gemini nebo Copilot) přes protokol MCP. Umožňuje ptát se přirozeným jazykem nad živými daty a provádět i vybrané zápisy. Je zdarma pro Shoptet Premium, nevratné operace jako hromadné mazání podporované nejsou.

Data a ceny ověřeny 24. 9. 2026 z veřejných zdrojů.