Tři možnosti, jak Shoptet napojit#
Shoptet podporuje tři způsoby integrace s Margly:
- Autorizovaný doplněk Margly.io v Shoptet App Marketplace (doporučeno) — instalace na proklik, žádné ruční zadávání klíčů. Nejjednodušší a nejrychlejší cesta.
- API klíč (Privátní API) — okamžité načítání, webhooky pro aktualizace v reálném čase. Dostupné jen v tarifu Shoptet Premium.
- CSV feedy — funguje pro všechny tarify Shoptetu. Margly potřebuje 3 separátní URL feedů (objednávky, produkty, zákazníci). Data se načítají automaticky podle vašeho tarifu Margly (Starter 1×/den, Professional 2×/den, Business / Enterprise / Trial 4×/den).
Varianta A: Autorizovaný doplněk Margly.io (doporučeno)#
Doplněk Margly.io je schválený a dostupný v Shoptet App Marketplace. Je to nejjednodušší způsob napojení — instalace na proklik, bez ručního zadávání klíčů.
Otevřete doplněk Margly.io
Přejděte na doplnky.shoptet.cz/margly-io, nebo v administraci Shoptetu otevřete sekci Doplňky, najděte Margly.io a klikněte na Objednat doplněk.
Schvalte oprávnění
Potvrďte read-only přístup k produktům, objednávkám a zákazníkům. Doplněk si nikdy nevyžádá práva k zápisu.
Hotovo — Margly se postará o zbytek
Margly automaticky vytvoří účet, spustí 14denní zkušební dobu zdarma, zaregistruje webhooky pro data v reálném čase a stáhne historická data. Doplněk pak otevřete přímo ze Shoptet administrace (Manager doplňků → Margly) nebo z app.margly.io.
Varianta B: Napojení přes Privátní API klíč#
Privátní API klíč je nejrychlejší cesta k aktuálním datům — Margly dostává změny v e-shopu (nová objednávka, storno, změna ceny) v reálném čase přes webhooky, takže přehledy v aplikaci jsou prakticky okamžité.
Vygenerujte Privátní API token v Shoptetu
V administraci Shoptetu jděte na Propojení → Private API. Klikněte na Vygenerovat token, pojmenujte ho například „Margly" a zkopírujte vygenerovaný token (zobrazí se vám jen jednou — uložte si ho).
Tokenu zároveň povolte tyto skupiny endpointů:
Skupina endpointů Oprávnění K čemu ji Margly potřebuje Nastavení čtení i zápis Zápisem se registrují webhooky. Bez něj Margly nedostane změny v reálném čase. Objednávky čtení Tržby, marže, náklady na dopravu, návratnost zákazníků. Produkty čtení Nákupní ceny — bez nich Margly nespočítá marži. Zákazníci čtení Celoživotní hodnota zákazníka a jeho návratnost. Vložte token do Margly
Pokud Margly právě zakládáte, jste v průvodci registrací na kroku 3 ze 3 — Napojení. Pokud už účet máte, otevřete Napojení → Shoptet.
Vyplňte tři pole:
- Hlavní měna — měna, ve které chcete vidět všechna čísla.
- URL e-shopu — doména vašeho e-shopu, například
https://www.vas-eshop.cz. - Shoptet API klíč — sem vložte token z předchozího kroku.
Klikněte na Ověřit klíč. Margly token okamžitě ověří proti Shoptet API a vypíše datum ověření, typ tokenu Privátní API a název vašeho e-shopu.
Margly zaregistruje webhooky
Registrace proběhne automaticky během ověření tokenu — sami neděláte nic. Margly si zaregistruje odběr pro:
- životní cyklus objednávek (vytvoření, úprava, zaplacení, storno)
- dostupnost produktů a pohyby na skladě
- životní cyklus zákazníků (vytvoření, úprava)
Pod polem s klíčem najdete kartu Shoptet webhooky s tlačítkem Obnovit propojení. To budete potřebovat jen výjimečně — kdyby Shoptet přestal aktualizace posílat. Tlačítko vyrotuje podpisový klíč a zaregistruje všechny události znovu.
Potvrďte párování polí
Klikněte na Pokračovat na párování polí. Otevře se karta Párování polí se záložkami Objednávky, Produkty a Zákazníci a se sloupci Naše metrika, Pole z API a Stav.
Margly má vše předvyplněné automaticky — projděte to očima a neměňte nic, pokud k tomu nemáte důvod. Napoprvé je celý sloupec Stav žlutě „neuloženo"; to není chyba, znamená to jen „ještě nepotvrzeno". Hvězdička u metriky značí, že je povinná.
Klikněte na Uložit a potvrdit mapování. Stavy se přepnou na „auto" a Margly začne stahovat data.
Dokončete registraci a počkejte na data
Klikněte na Dokončit registraci. Margly stáhne historická data — typicky 5–30 minut podle velikosti e-shopu. Stav vidíte v Napojení → Aktualizace dat.
Varianta C: Napojení přes CSV feedy#
Pokud nemáte Shoptet Premium (a tím pádem ani Privátní API), vložte do Margly 3 URL feedů. Margly bez všech tří nemůže spočítat marže ani návratnost zákazníků — produktové ceny a zákaznická data jsou pro výpočty nezbytná.
Každý feed se v Shoptet administraci generuje v jiné sekci — viz oficiální nápověda Shoptetu k exportům. Postup pro každý feed shrnujeme níže.
Vygenerujte URL feedy ve formátu CSV v Shoptet admin
Produkty: v administraci Shoptetu jděte na Produkty → Export. Vytvořte vlastní export (např. „Data pro Margly") a v editoru polí zaškrtněte sloupce z tabulky níže.
Proč po vás chceme zrovna tyhle sloupce? Margly nevidí do vaší administrace — vidí jen to, co jí pošlete v exportu. Každý sloupec v seznamu odemyká konkrétní výpočet nebo doporučení. Co nepošlete, to Margly nespočítá; a u některých sloupců je to horší než mlčení — bez viditelnosti totiž Margly netuší, že jste zboží stáhli z prodeje, a počítá ho dál.
Sekce v Shoptet adminu Zaškrtněte Co díky tomu v Margly uvidíte Základní informace Viditelnost produktu, Viditelnost varianty Margly pozná, co máte stažené z prodeje. Bez toho vám skryté zboží leze do statistik a AI Poradce vám radí opravovat produkt, který už neprodáváte. Základní informace Popis, Krátký popis Umělá inteligence (ChatGPT, Perplexity) i vyhledávače čtou u produktu text. Margly vám vypíše zboží, kde text chybí nebo je moc krátký — proto vás AI nedoporučuje. Základní informace Krátký popis obsahu stránky Popisek, který se ukazuje ve výsledcích vyhledávání. Margly vám ukáže produkty, kde chybí, takže si Google i AI doplní vlastní text. Základní informace Výrobce Značka zboží. Nákupní asistenti podle ní produkt zařadí a porovnají s konkurencí. Základní informace Výchozí kategorie Margly spočítá, které kategorie vydělávají a které jen zabírají sklad. Ceny Nákupní cena, Nákupní cena v procentech DPH, Nákupní cena včetně DPH, Měna Bez nákupní ceny nespočítáme marži — ani u jednoho produktu, ani celkovou. Je to nejdůležitější položka seznamu. Sklad Stav skladu Obrátka zásob, rozdělení zboží na hvězdy a slabé kusy, a upozornění na zamrzlý sklad — tedy peníze, které vám leží ve zboží, co se neprodává. Sklad EAN Čárový kód. Podle něj vás srovnávače a nákupní asistenti spárují se stejným zbožím u konkurence. Bez něj vás nabídnou hůř nebo vůbec. Obrázky Obrázky produktu Margly pozná zboží bez fotky. To AI ani srovnávače prakticky nenabízejí. Sady Položky sady Margly pozná, že produkt už je sada nebo balíček, a nebude vám radit vytvořit ho znovu. Bez toho hádáme podle názvu a občas se spleteme. Důležité: „Povolit pouze z konkrétní IP adresy" nesmí být zaškrtnuté. Uložte a zkopírujte URL ze spodní části stránky.
Objednávky: jděte na Objednávky → Export. Vyberte systémový export Shoptet — CSV. U pole „Zahrnout objednávky" vyberte Vše. „Permanentní odkaz" nesmí být zaškrtnutý. Zkopírujte URL ze spodní části stránky.
Zákazníci: jděte na Zákazníci → Export. Vyberte typ exportu CSV. „Permanentní odkaz" nesmí být zaškrtnutý. Zkopírujte URL ze spodní části stránky.
Vložte všechny 3 URL do Margly
V Margly otevřete Napojení → Shoptet (CSV) a vložte:
- URL feedu objednávek
- URL feedu produktů
- URL feedu zákazníků
Margly všechny tři ověří — stáhne malý vzorek a otestuje, že umí přečíst kódování (UTF-8 nebo Windows-1250) a oddělovač sloupců (středník nebo tabulátor).
Frekvence načítání podle vašeho tarifu
CSV feedy Margly stahuje podle stejných pravidel jako API/doplněk — frekvence se řídí vaším tarifem Margly:
- Starter — 1×/den (ráno)
- Professional — 2×/den (ráno + večer)
- Business / Enterprise / Trial — 4×/den (ráno, poledne, večer, noc)
Detail v Aktualizace dat. Mezi načítáními jsou aktuální data viditelná až po dalším plánovaném načtení — pro reálný čas potřebujete Privátní API (Varianta B), které posílá webhooky okamžitě.
Časté chyby#
- „Feed nedostupný (403)" — privátní URL CSV feedu vyžaduje, aby v Shoptet nastavení nebyla zaškrtnutá „Povolit pouze z konkrétní IP adresy" (u produktů) nebo „Permanentní odkaz" (u objednávek a zákazníků). Zkontrolujte si to v administraci.
- „API klíč neověřen (401)" — token byl deaktivován nebo špatně zkopírovaný. V Shoptetu vygenerujte nový a vložte ho znovu.
- „API token nemá povolená potřebná oprávnění (403)" — token je v Shoptetu omezený na skupiny endpointů a některá Margly chybí. V Propojení → Private API mu povolte Nastavení (čtení i zápis), Objednávky, Produkty a Zákazníci (čtení).
- „Margly nenačítá data, i když je klíč ověřený" — pravděpodobně jste nedokončili poslední krok. Otevřete Napojení → Shoptet, sjeďte na kartu Párování polí a klikněte na Uložit a potvrdit mapování. Bez potvrzení se import přes API nespustí.
- „Webhooky se nezaregistrovaly" — některé Shoptet tarify neumožňují registraci webhooků. Margly pak bude fungovat, ale jen s pravidelným načítáním dat (podle vašeho tarifu).
- „Špatné kódování v CSV" — Margly podporuje UTF-8 a Windows-1250 (legacy Shoptet feedy). Pokud feed obsahuje jiné kódování (extrémně vzácné), napište podpoře.
- Špatná měna v objednávkách — Margly bere měnu z e-shop nastavení. Pokud máte vícejazyčný/vícemēnový e-shop, zkontrolujte v sekci Fakturace, že máte správnou výchozí měnu.
Co dál#
Po úspěšném napojení Shoptetu doporučujeme propojit i reklamní systémy a externí služby — bez nich Margly vidí jen tržby, ale ne návratnost reklamy ani návštěvnost:
- Google Ads — výdaje a konverze z Google reklamy
- Meta Ads — Facebook a Instagram reklama
- Sklik — seznam.cz a partnerská síť (CZ/SK, e-shop v CZK)
- Heureka — srovnávač zboží (CZ/SK)
- Google Analytics 4 — návštěvnost a konverzní poměr
- Google Search Console — organická návštěvnost a klíčová slova