Shoptet API a automatizace e-shopu: webhooky a limity

Shoptet je nejpoužívanější česká e-commerce platforma s více než 40 000 aktivními e-shopy a 24-28% podílem na trhu. Pokud provozujete e-shop na Shoptetu, automatizace je klíčem k úspoře času, snížení chybovosti a růstu tržeb. V tomto kompletním průvodci vám ukážeme, jak využít Shoptet API, webhooky, Make.com, n8n a nově i AI nástroje k automatizaci celého vašeho e-shopového workflow.

V roce 2026 se navíc ostře prosazují dvě nové vlny: generativní AI pro obsah (automatické produktové popisy, překlady pro expanzi do zahraničí, SEO optimalizace feedů) a AI agenti pro zákaznickou podporu včetně hlasových botů, kteří zvládají i telefonáty. Obojí dnes zvládnete napojit přímo na Shoptet API bez velkého vývoje.

Průvodce je určen jak pro majitele e-shopů, kteří chtějí začít s první automatizací, tak pro vývojáře, kteří hledají praktické příklady kódu a API integrace. Najdete zde hotové scénáře, ukázky v PHP i JavaScriptu a kompletní srovnání dostupných nástrojů na českém trhu.

01Proč automatizovat Shoptet v roce 2026?

Každý e-shopař zná ten pocit: ráno otevřete administraci a čeká vás desítka objednávek k ručnímu zpracování. Faktury, expedice, skladové pohyby, odpovědi zákazníkům — to vše zabírá hodiny, které byste mohli věnovat rozvoji podnikání. Automatizace tyto rutinní úkoly přebírá za vás a umožňuje vám soustředit se na strategii, marketing a růst.

Typické problémy bez automatizace:

• Ruční vystavování faktur pro každou objednávku (10-15 minut denně)
• Chybějící skladová synchronizace s ERP systémem
• Pomalé odpovědi zákazníkům mimo pracovní dobu
• Manuální export dat do účetnictví
• Neefektivní e-mail marketing bez personalizace
• Ruční přepisování objednávek do dopravců
• Psaní produktových popisů a překladů ručně, jeden po druhém

Co automatizací získáte:

• 10-20 hodin týdně navíc pro strategické úkoly
• Méně chyb v datech a fakturaci
• Rychlejší expedici objednávek
• Lepší zákaznickou zkušenost díky okamžitým odpovědím
• Vyšší tržby díky automatizovanému marketingu a kvalitnějšímu obsahu

02Shoptet API: Kompletní přehled endpointů 2026

Shoptet API je RESTful rozhraní, které umožňuje programový přístup k datům vašeho e-shopu. V roce 2026 nabízí Shoptet rozšířenou sadu endpointů pokrývající prakticky všechny oblasti správy e-shopu. API využívá standardní HTTP metody (GET, POST, PATCH, DELETE) a vrací data ve formátu JSON, takže s ním můžete pracovat v jakémkoliv programovacím jazyce. Autentizace probíhá přes přístupový token, který si vygenerujete v administraci.

Získání API klíče

1. Přihlaste se do Shoptet administrace
2. Přejděte do Nastavení → API přístupy
3. Klikněte na Vytvořit nový API klíč
4. Nastavte oprávnění podle potřeby (čtení/zápis pro produkty, objednávky, zákazníky)
5. Uložte si klíč na bezpečné místo — zobrazí se pouze jednou

Hlavní skupiny endpointů

Produkty a katalog:

GET  /api/products              - Seznam všech produktů
GET  /api/products/{id}         - Detail produktu
PATCH /api/products/{id}        - Aktualizace produktu
GET  /api/products/{id}/images  - Obrázky produktu
GET  /api/categories            - Kategorie e-shopu

Objednávky:

GET  /api/orders                - Seznam objednávek
GET  /api/orders/{code}         - Detail objednávky
PATCH /api/orders/{code}        - Aktualizace objednávky (stav, poznámky)
GET  /api/orders/{code}/items   - Položky objednávky

Zákazníci:

GET  /api/customers             - Seznam zákazníků
GET  /api/customers/{id}        - Detail zákazníka
POST /api/customers             - Vytvoření zákazníka

Sklad:

GET  /api/stocks                - Skladové zásoby
PATCH /api/stocks/{id}          - Aktualizace skladu

Příklad volání API v PHP

<?php
$apiKey = 'VÁŠ_API_KLÍČ';
$shopUrl = 'https://vas-eshop.shoptet.cz';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $shopUrl . '/api/orders?status=received');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Shoptet-Access-Token: ' . $apiKey,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$orders = json_decode($response, true);

foreach ($orders['data']['orders'] as $order) {
    echo "Objednávka: " . $order['code'] . " - " . $order['totalPrice'] . " Kč\n";
}
curl_close($ch);
?>

Příklad v JavaScriptu (Node.js)

const axios = require('axios');

const shoptetApi = axios.create({
  baseURL: 'https://vas-eshop.shoptet.cz/api',
  headers: {
    'Shoptet-Access-Token': process.env.SHOPTET_API_KEY,
    'Content-Type': 'application/json'
  }
});

// Získání nových objednávek
async function getNewOrders() {
  const { data } = await shoptetApi.get('/orders', {
    params: { status: 'received', limit: 50 }
  });
  return data.data.orders;
}

// Aktualizace stavu objednávky
async function updateOrderStatus(orderCode, statusId) {
  await shoptetApi.patch(`/orders/${orderCode}`, {
    statusId: statusId
  });
  console.log(`Objednávka ${orderCode} aktualizována`);
}

Limity Shoptet API: 429, leaky bucket a zámky

Shoptet API neomezuje počet dotazů ani celkový objem dat — rate limiting je především ochrana proti přetížení serveru (DDoS). Přesto existují tři limity, které musíte při automatizaci hlídat (stav k říjnu 2026 podle oficiální dokumentace):

Souběžná spojení. Z jedné IP adresy máte max 50 paralelních spojení, na jeden API token max 3. Při překročení dostanete HTTP 429. Některé endpointy (typicky hromadné operace) mají navíc vlastní limity uvedené přímo v dokumentaci.

Leaky bucket. Každá integrace (kombinace doplněk × e-shop) má vlastní „kbelík“ o kapacitě 200 kapek. Každé volání přidá kapky podle své složitosti — objemu vrácených dat a filtrů (cena se počítá až po vykonání dotazu). Kbelík se průběžně vyprazdňuje rychlostí 10 kapek za sekundu; pokud je plný a nové volání se do něj nevejde, přijdete opět o HTTP 429. Stav hlídáte v hlavičce X-RateLimit-Bucket-Filling, kterou API vrací v každé odpovědi (např. 200/200); plný kbelík oznámí hlavička Retry-After s časem, kdy můžete zkusit znovu.

Zámky write endpointů. Identické POST/PATCH/PUT/DELETE volání rychle za sebou skončí chybou HTTP 423 — zámek platí pro konkrétní URL a maximálně 5 sekund. Je to ochrana proti duplicitám při opakovaném odeslání (retry).

Prakticky: u dávkové synchronizace katalogu sledujte X-RateLimit-Bucket-Filling a na 429 čekejte podle Retry-After (ideálně s exponenciálním backoffem), u write operací dvojitému odeslání téhož požadavku zabraňte na své straně (idempotence).

03Webhooky: Real-time notifikace z objednávek

Webhooky jsou klíčovým prvkem moderní automatizace e-shopu. Místo neustálého dotazování API (tzv. polling), které zatěžuje server a přináší zpoždění, vám Shoptet okamžitě pošle HTTP notifikaci, když se v e-shopu něco stane. Webhook je vlastně HTTP POST požadavek, který Shoptet odešle na vámi definovanou URL adresu v momentě, kdy nastane daná událost. Díky tomu reagujete na objednávky, změny skladu nebo registrace zákazníků v reálném čase — často během několika sekund.

Dostupné webhook události

Registrace webhooku přes API

curl -X POST "https://vas-eshop.shoptet.cz/api/webhooks" \
  -H "Shoptet-Access-Token: VÁŠ_API_KLÍČ" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "order:create",
    "url": "https://vas-server.cz/webhook/shoptet-order"
  }'

Zpracování webhooku (Node.js)

const express = require('express');
const app = express();

app.post('/webhook/shoptet-order', express.json(), (req, res) => {
  const order = req.body;
  console.log('Nová objednávka:', order.code);

  // Automatické zpracování
  processOrder(order);

  res.status(200).send('OK');
});

async function processOrder(order) {
  // 1. Vystavit fakturu ve Fakturoidu
  await createInvoice(order);
  // 2. Odeslat potvrzení zákazníkovi
  await sendConfirmationEmail(order);
  // 3. Notifikace do Slacku
  await notifySlack(order);
}

04Make.com + Shoptet: 5 hotových automatizací

Make.com (dříve Integromat) je nejpopulárnější vizuální automatizační nástroj pro české e-shopy. Nabízí nativní Shoptet modul, takže propojení zvládnete bez programování. Poznámka k roku 2026: Make.com přešel z tarifu podle „operací" na kreditový systém — Core plán (~€9–12/měsíc při roční platbě) obsahuje 10 000 kreditů měsíčně, takže si počítejte spotřebu kreditů, nikoliv počet spuštění scénářů.

05n8n + Shoptet: Open-source alternativa

n8n je open-source automatizační platforma, kterou si můžete hostovat na vlastním serveru. Oproti Make.com nemá limity na počet spuštění a platíte pouze za hosting — vlastní VPS na Hetzneru dnes vyjde zhruba na €4,49/měsíc (více v našem průvodci n8n hostingem).

Výhody n8n oproti Make.com

Shoptet workflow v n8n

{
  "nodes": [
    {
      "name": "Shoptet Webhook",
      "type": "n8n-nodes-base.webhook",
      "parameters": {
        "path": "shoptet-order",
        "httpMethod": "POST"
      }
    },
    {
      "name": "Fakturoid",
      "type": "n8n-nodes-base.httpRequest",
      "parameters": {
        "url": "https://app.fakturoid.cz/api/v3/invoices.json",
        "method": "POST",
        "authentication": "genericCredentialType"
      }
    }
  ]
}

Pro podrobnější srovnání si přečtěte náš článek o n8n vs Make.com.

06AI chatbot pro Shoptet: Jak nastavit

Jedním z nejsilnějších trendů roku 2026 je nasazení AI chatbota přímo na e-shop. Moderní jazykové modely jako Claude Sonnet 5 nebo GPT-5 dokážou porozumět přirozenému jazyku zákazníka, vyhledat relevantní informace v databázi produktů a poskytnout přesnou odpověď — vše během několika sekund. Chatbot odpovídá na dotazy zákazníků 24/7, doporučuje produkty na základě preferencí a řeší reklamace nebo vrácení zboží automaticky, bez zásahu lidského operátora.

Proč AI chatbot na Shoptetu?

• 70 % dotazů zákazníků jsou opakující se otázky (doprava, vrácení, stav objednávky)
• Chatbot odpoví do 3 sekund místo hodin čekání na e-mail
• Zvýšení konverzního poměru o 15-25 % díky okamžité asistenci
• Snížení nákladů na zákaznickou podporu

Implementace AI chatbota

Krok 1: Připravte znalostní bázi (RAG) Exportujte FAQ, obchodní podmínky, informace o dopravě a vrácení a hlavně katalog produktů do vektorové databáze. Díky RAG (retrieval-augmented generation) chatbot odpovídá z vašich aktuálních dat, ne si nevymýšlí.

Krok 2: Vytvořte chatbota Můžete využít služby jako Claude, ChatGPT API nebo české řešení SupportBox AI. Chatbot se naučí z vašich dat a odpovídá v kontextu vašeho e-shopu. V roce 2026 už běžně využijete function calling — model může sám zavolat Shoptet API („zjisti stav objednávky", „doporuč produkt podle rozpočtu").

Krok 3: Integrace do Shoptetu Vložte chatbot widget do šablony e-shopu přes Shoptet doplňky nebo vlastní JavaScript kód:

<!-- AI Chatbot widget -->
<script>
  window.chatbotConfig = {
    apiKey: 'VÁŠ_KLÍČ',
    shoptetApiKey: 'SHOPTET_API',
    features: ['orderTracking', 'productRecommendation', 'faq'],
    language: 'cs'
  };
</script>
<script src="https://cdn.example.com/widget.js"></script>

Krok 4: Propojte s objednávkami Chatbot může přes Shoptet API vyhledat stav objednávky podle čísla nebo e-mailu zákazníka a poskytnout aktuální informace bez zásahu operátora.

Hlasoví AI agenti — trend 2026

Vedle textového chatu se prosazují i hlasoví AI agenti (Vapi, Retell AI a další), kteří zvládají příchozí i odchozí telefonáty — například ověření objednávky, domluvu náhradního termínu doručení nebo dotaz na spokojenost. Propojení přes Shoptet webhook + Twilio/Vapi vám dá funkční hlasovou linku bez call centra.

07AI pro obsah: produktové popisy, překlady a SEO

Kromě zákaznické podpory přinesl rok 2026 obrovskou úsporu času v oblasti obsahu. Tvoje konkurence už pravděpodobně generuje produktové popisy, překlady a SEO texty automaticky — ruční psaní stovek popisů je dnes zbytečná penalizace.

Praktické scénáře:

• Generování produktových popisů — webhook product:create spustí workflow, které z parametrů produktu (výrobce, vlastnosti, kategorie) vygeneruje prodejní popis přes Claude API a výsledek zapíše zpět přes PATCH /api/products/{id}.
• Hromadné překlady pro expanzi — rozšiřujete na Slovensko, do Polska nebo Německa? Stejný workflow přeloží celý katalog do cílového jazyka a lokalizuje i Heureka/Glami feed.
• SEO optimalizace — AI přepíše nadpisy a meta popisy tak, aby cílíly na konkrétní klíčová slova, a sleduje délku pro SERP.
• Doporučování „podobných produktů" — vektorové porovnávání popisů automaticky naplní sekci souvisejícího zboží.

Tyto workflow zvládnete v n8n i Make.com a ušetříte desítky hodin při každém naskladnění nové kolekce.

08Automatické zpracování objednávek: Kompletní flow

Nejcennější automatizací je kompletní zpracování objednávky od přijetí po doručení bez jakéhokoliv ručního zásahu. Toto end-to-end řešení kombinuje webhooky, API volání a integraci s externími službami do jednoho plynulého procesu. Jakmile zákazník dokončí objednávku, celý řetězec se spustí automaticky — od potvrzení přes fakturaci až po expedici. Zde je schéma celého procesu:

Nová objednávka → [Router]
  ├─ B2C zákazník:
  │   ├─ Potvrzení e-mailem (okamžitě)
  │   ├─ Faktura → Fakturoid (automaticky)
  │   ├─ Zásilka → Zásilkovna / PPL / DPD
  │   ├─ Tracking → zpět do Shoptetu
  │   ├─ Slack → #objednavky
  │   └─ Follow-up e-maily (5, 14, 30 dní)
  │
  └─ B2B zákazník:
      ├─ Faktura → Fakturoid (splatnost 14-30 dní)
      ├─ Zásilka → PPL Parcel / Toptrans
      ├─ Notifikace → Account manager
      └─ CRM → aktualizace zákazníka

Automatizace stavů objednávek

Shoptet umožňuje automaticky měnit stavy objednávek na základě událostí:

1. Přijatá → po vytvoření objednávky
2. Zaplacená → po potvrzení platby (platební brána webhook)
3. Expedovaná → po vytvoření zásilky u dopravce
4. Doručená → po potvrzení doručení od dopravce
5. Dokončená → po uplynutí lhůty pro vrácení

09Propojení s fakturačními systémy

Fakturoid

Nejpoužívanější fakturační služba v ČR s přímou podporou Shoptetu. Aktuální rozhraní je API v3.

Nastavení:

1. Zaregistrujte se na fakturoid.cz
2. Vygenerujte API klíč v nastavení
3. V Make.com nebo n8n propojte webhook z Shoptetu s Fakturoid API
4. Mapování polí: jméno, adresa, položky, DPH

Cena od 211 Kč/měsíc (plán Podnikatel)

iDoklad

Cloudový fakturační systém od Solitea, oblíbený u OSVČ.

Nastavení:

1. Vytvořte API přístup v iDoklad administraci
2. Použijte OAuth2 autentizaci
3. Endpoint pro vytvoření faktury: POST /api/v3/IssuedInvoices

Cena od 179 Kč/měsíc

Automatické párování plateb

Pro automatické párování plateb z bankovního účtu můžete využít:

• Fio Banka API — bezplatný přístup k pohybům na účtu
• ČSOB CEB API — pro firemní účty
• Make.com scénář: bank statement → párování s fakturami → aktualizace stavu

10Praktické příklady kódu

PHP: Kompletní webhook handler

<?php
// webhook-handler.php - zpracování Shoptet webhooků

$payload = file_get_contents('php://input');
$data = json_decode($payload, true);

// Ověření podpisu webhooku
$signature = $_SERVER['HTTP_X_SHOPTET_SIGNATURE'] ?? '';
$expectedSignature = hash_hmac('sha256', $payload, 'VÁŠ_WEBHOOK_SECRET');

if (!hash_equals($expectedSignature, $signature)) {
    http_response_code(401);
    die('Neplatný podpis');
}

$event = $data['event'] ?? '';

switch ($event) {
    case 'order:create':
        handleNewOrder($data['data']);
        break;
    case 'order:update':
        handleOrderUpdate($data['data']);
        break;
    case 'stock:update':
        handleStockUpdate($data['data']);
        break;
}

http_response_code(200);
echo 'OK';

function handleNewOrder($order) {
    // 1. Vytvoření faktury
    $invoice = createFakturoidInvoice($order);

    // 2. Notifikace
    sendSlackNotification(
        "#objednavky",
        "Nova objednavka {$order['code']}: {$order['totalPrice']} Kc"
    );

    // 3. Log
    error_log("Zpracována objednávka: " . $order['code']);
}

function createFakturoidInvoice($order) {
    $fakturoidSlug = 'vas-ucet';
    $apiKey = 'VÁŠ_FAKTUROID_API_KEY';

    $invoiceData = [
        'subject_id' => findOrCreateCustomer($order['customer']),
        'lines' => array_map(function($item) {
            return [
                'name' => $item['name'],
                'quantity' => $item['amount'],
                'unit_price' => $item['unitPrice'],
                'vat_rate' => 21
            ];
        }, $order['items'])
    ];

    $ch = curl_init("https://app.fakturoid.cz/api/v3/accounts/{$fakturoidSlug}/invoices.json");
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => json_encode($invoiceData),
        CURLOPT_HTTPHEADER => [
            'Content-Type: application/json',
            'Authorization: Bearer ' . $apiKey
        ],
        CURLOPT_RETURNTRANSFER => true
    ]);

    return json_decode(curl_exec($ch), true);
}
?>

JavaScript: n8n Custom Function

// n8n Function node - transformace Shoptet objednávky pro Fakturoid
const order = $input.first().json;

const invoice = {
  subject_name: order.customer.fullName,
  subject_email: order.customer.email,
  lines: order.items.map(item => ({
    name: item.name,
    quantity: item.amount,
    unit_price: item.unitPriceWithVat,
    vat_rate: 21
  })),
  payment_method: order.paymentMethod === 'bankTransfer' ? 'bank' : 'cash',
  currency: 'CZK',
  note: `Shoptet objednávka: ${order.code}`
};

return [{ json: invoice }];

11Nástroje pro Shoptet automatizaci: Srovnání 2026

12Jak začít s automatizací Shoptetu: Krok za krokem

1. Audit procesů — Zmapujte, kde trávíte nejvíce času. Fakturace? Expedice? Odpovídání zákazníkům? Psaní produktových popisů?
2. Prioritizace — Začněte nejbolestivějším procesem s nejvyšší úsporou času
3. Výběr nástrojů — Make.com pro většinu e-shopařů, n8n pro technicky zdatné
4. API klíč — Vygenerujte Shoptet API klíč s potřebnými oprávněními
5. Webhooky — Zaregistrujte webhooky pro události, které chcete automatizovat
6. Testování — Vždy testujte na sandbox nebo testovacích objednávkách
7. Monitoring — Sledujte chybové logy a úspěšnost automatizací
8. Škálování — Postupně přidávejte další automatizace včetně AI obsahu a podpory

13Často kladené otázky (FAQ)

14Závěr

Automatizace Shoptetu v roce 2026 není luxus — je to nutnost pro každý e-shop, který chce růst a zůstat konkurenceschopný. Trh s e-commerce v Česku roste meziročně o více než 10 % a s tím rostou i nároky zákazníků na rychlost expedice, kvalitu komunikace a bezchybnost fakturace. E-shopy, které tyto procesy neautomatizují, ztrácejí čas, peníze a zákazníky ve prospěch konkurence, která automatizaci již nasadila. Díky kombinaci Shoptet API, webhooků, nástrojů jako Make.com nebo n8n a nových AI řešení můžete automatizovat prakticky celý provoz e-shopu — od objednávky přes fakturu až po AI generovaný obsah a zákaznickou podporu.

Začněte jedním procesem — doporučujeme automatickou fakturaci přes Fakturoid jako nejrychlejší cestu k prvním výsledkům. ROI uvidíte typicky do jednoho měsíce.

Další kroky pro vaši automatizaci:

• Vygenerujte si Shoptet API klíč a otestujte první volání
• Vytvořte si účet na Make.com a propojte ho se Shoptelem
• Nastavte webhook pro nové objednávky
• Zvažte nasazení AI chatbota pro zákaznickou podporu i AI generování produktových popisů

Všechny AI nástroje pro e-shop na jednom místě: průvodce AI pro e-shopy.