Tri možnosti, ako Shoptet napojiť#
Shoptet podporuje tri spôsoby integrácie s Margly:
- Autorizovaný doplnok Margly.io v Shoptet App Marketplace (odporúčame) — inštalácia na preklik, žiadne ručné zadávanie kľúčov. Najjednoduchšia a najrýchlejšia cesta.
- API kľúč (Privátne API) — okamžité načítanie, webhooky pre aktualizácie v reálnom čase. Dostupné len v tarife Shoptet Premium.
- CSV feedy — funguje pre všetky tarify Shoptetu. Margly potrebuje 3 separátne URL feedov (objednávky, produkty, zákazníci). Dáta sa načítavajú automaticky podľa vášho tarifu Margly (Starter 1×/deň, Professional 2×/deň, Business / Enterprise / Trial 4×/deň).
Variant A: Autorizovaný doplnok Margly.io (odporúčame)#
Doplnok Margly.io je schválený a dostupný v Shoptet App Marketplace. Je to najjednoduchší spôsob napojenia — inštalácia na preklik, bez ručného zadávania kľúčov.
Otvorte doplnok Margly.io
Prejdite na doplnky.shoptet.cz/margly-io, alebo v administrácii Shoptetu otvorte sekciu Doplnky, nájdite Margly.io a kliknite na Objednať doplnok.
Schváľte oprávnenia
Potvrďte read-only prístup k produktom, objednávkam a zákazníkom. Doplnok si nikdy nevyžiada práva na zápis.
Hotovo — Margly sa postará o zvyšok
Margly automaticky vytvorí účet, spustí 14-dňovú skúšobnú dobu zadarmo, zaregistruje webhooky pre dáta v reálnom čase a stiahne historické dáta. Doplnok potom otvoríte priamo zo Shoptet administrácie (Manažér doplnkov → Margly) alebo z app.margly.io.
Variant B: Napojenie cez Privátny API kľúč#
Privátny API kľúč je najrýchlejšia cesta k aktuálnym dátam — Margly dostáva zmeny v e-shope (nová objednávka, storno, zmena ceny) v reálnom čase cez webhooky, takže prehľady v aplikácii sú prakticky okamžité.
Vygenerujte Privátny API token v Shoptete
V administrácii Shoptetu choďte na Prepojenie → Private API. Kliknite na Vygenerovať token, pomenujte ho napríklad „Margly" a skopírujte vygenerovaný token (zobrazí sa vám len raz — uložte si ho).
Tokenu zároveň povoľte tieto skupiny endpointov:
Skupina endpointov Oprávnenie Na čo ju Margly potrebuje Nastavenia čítanie aj zápis Zápisom sa registrujú webhooky. Bez neho Margly nedostane zmeny v reálnom čase. Objednávky čítanie Tržby, marže, náklady na dopravu, návratnosť zákazníkov. Produkty čítanie Nákupné ceny — bez nich Margly nespočíta maržu. Zákazníci čítanie Celoživotná hodnota zákazníka a jeho návratnosť. Vložte token do Margly
Pokiaľ Margly práve zakladáte, ste v sprievodcovi registráciou na kroku 3 z 3 — Napojenie. Pokiaľ už účet máte, otvorte Napojenia → Shoptet.
Vyplňte tri polia:
- Hlavná mena — mena, v ktorej chcete vidieť všetky čísla.
- URL e-shopu — doména vášho e-shopu, napríklad
https://www.vas-eshop.sk. - Shoptet API kľúč — sem vložte token z predchádzajúceho kroku.
Kliknite na Overiť kľúč. Margly token okamžite overí proti Shoptet API a vypíše dátum overenia, typ tokenu Privátne API a názov vášho e-shopu.
Margly zaregistruje webhooky
Registrácia prebehne automaticky počas overenia tokenu — sami nerobíte nič. Margly si zaregistruje odber pre:
- životný cyklus objednávok (vytvorenie, úprava, zaplatenie, storno)
- dostupnosť produktov a pohyby na sklade
- životný cyklus zákazníkov (vytvorenie, úprava)
Pod poľom s kľúčom nájdete kartu Shoptet webhooky s tlačidlom Obnoviť prepojenie. To budete potrebovať len výnimočne — keby Shoptet prestal aktualizácie posielať. Tlačidlo vyrotuje podpisový kľúč a zaregistruje všetky udalosti znova.
Potvrďte párovanie polí
Kliknite na Pokračovať na párovanie polí. Otvorí sa karta Párovanie polí so záložkami Objednávky, Produkty a Zákazníci a so stĺpcami Naša metrika, Pole z API a Stav.
Margly má všetko predvyplnené automaticky — prejdite to očami a nemeňte nič, pokiaľ na to nemáte dôvod. Prvýkrát je celý stĺpec Stav žlto „neuložené"; to nie je chyba, znamená to len „ešte nepotvrdené". Hviezdička pri metrike značí, že je povinná.
Kliknite na Uložiť a potvrdiť mapovanie. Stavy sa prepnú na „auto" a Margly začne sťahovať dáta.
Dokončite registráciu a počkajte na dáta
Kliknite na Dokončiť registráciu. Margly stiahne historické dáta — typicky 5–30 minút podľa veľkosti e-shopu. Stav vidíte v Napojenia → Aktualizácia dát.
Variant C: Napojenie cez CSV feedy#
Pokiaľ nemáte Shoptet Premium (a tým pádom ani Privátne API), vložte do Margly 3 URL feedov. Margly bez všetkých troch nemôže spočítať marže ani návratnosť zákazníkov — produktové ceny a zákaznícke dáta sú pre výpočty nevyhnutné.
Každý feed sa v Shoptet administrácii generuje v inej sekcii — pozri oficiálnu nápovedu Shoptetu k exportom. Postup pre každý feed zhrňujeme nižšie.
Vygenerujte URL feedy vo formáte CSV v Shoptet admin
Produkty: v administrácii Shoptetu choďte na Produkty → Export. Vytvorte vlastný export (napr. „Dáta pre Margly") a v editore polí zaškrtnite stĺpce z tabuľky nižšie.
Prečo od vás chceme práve tieto stĺpce? Margly nevidí do vašej administrácie — vidí len to, čo jej pošlete v exporte. Každý stĺpec odomyká konkrétny výpočet alebo odporúčanie. Čo nepošlete, to Margly nespočíta; a pri niektorých stĺpcoch je to horšie než mlčanie — bez viditeľnosti totiž Margly netuší, že ste tovar stiahli z predaja, a počíta ho ďalej.
Sekcia v Shoptet admine Zaškrtnite Čo vďaka tomu v Margly uvidíte Základné informácie Viditeľnosť produktu, Viditeľnosť variantu Margly spozná, čo máte stiahnuté z predaja. Bez toho vám skrytý tovar lezie do štatistík a AI Poradca vám radí opravovať produkt, ktorý už nepredávate. Základné informácie Popis, Krátky popis Umelá inteligencia (ChatGPT, Perplexity) aj vyhľadávače čítajú pri produkte text. Margly vám vypíše tovar, kde text chýba alebo je príliš krátky — preto vás AI neodporúča. Základné informácie Krátky popis obsahu stránky Popisok, ktorý sa ukazuje vo výsledkoch vyhľadávania. Margly vám ukáže produkty, kde chýba, takže si Google aj AI doplnia vlastný text. Základné informácie Výrobca Značka tovaru. Nákupní asistenti podľa nej produkt zaradia a porovnajú s konkurenciou. Základné informácie Východisková kategória Margly spočíta, ktoré kategórie zarábajú a ktoré len zaberajú sklad. Ceny Nákupná cena, Nákupná cena v percentách DPH, Nákupná cena vrátane DPH, Mena Bez nákupnej ceny nespočítame maržu — ani pri jednom produkte, ani celkovú. Je to najdôležitejšia položka zoznamu. Sklad Stav skladu Obrátka zásob, rozdelenie tovaru na hviezdy a slabé kusy, a upozornenie na zamrznutý sklad — teda peniaze, ktoré vám ležia v tovare, čo sa nepredáva. Sklad EAN Čiarový kód. Podľa neho vás porovnávače a nákupní asistenti spárujú s rovnakým tovarom u konkurencie. Bez neho vás ponúknu horšie alebo vôbec. Obrázky Obrázky produktu Margly spozná tovar bez fotky. Ten AI ani porovnávače prakticky neponúkajú. Sady Položky sady Margly spozná, že produkt už je sada alebo balíček, a nebude vám radiť vytvoriť ho znovu. Bez toho hádame podľa názvu a občas sa pomýlime. Dôležité: „Povoliť iba z konkrétnej IP adresy" nesmie byť zaškrtnuté. Uložte a skopírujte URL zo spodnej časti stránky.
Objednávky: choďte na Objednávky → Export. Vyberte systémový export Shoptet — CSV. Pri poli „Zahrnúť objednávky" vyberte Všetko. „Permanentný odkaz" nesmie byť zaškrtnutý. Skopírujte URL zo spodnej časti stránky.
Zákazníci: choďte na Zákazníci → Export. Vyberte typ exportu CSV. „Permanentný odkaz" nesmie byť zaškrtnutý. Skopírujte URL zo spodnej časti stránky.
Vložte všetky 3 URL do Margly
V Margly otvorte Napojenia → Shoptet (CSV) a vložte:
- URL feedu objednávok
- URL feedu produktov
- URL feedu zákazníkov
Margly všetky tri overí — stiahne malú vzorku a otestuje, že vie prečítať kódovanie (UTF-8 alebo Windows-1250) a oddeľovač stĺpcov (bodkočiarka alebo tabulátor).
Frekvencia načítania podľa vášho tarifu
CSV feedy Margly sťahuje podľa rovnakých pravidiel ako API/doplnok — frekvencia sa riadi vaším tarifom Margly:
- Starter — 1×/deň (ráno)
- Professional — 2×/deň (ráno + večer)
- Business / Enterprise / Trial — 4×/deň (ráno, poludnie, večer, noc)
Detail v Aktualizácia dát. Medzi načítaniami sú aktuálne dáta viditeľné až po ďalšom plánovanom načítaní — pre reálny čas potrebujete Privátne API (Variant B), ktoré posiela webhooky okamžite.
Časté chyby#
- „Feed nedostupný (403)" — privátna URL CSV feedu vyžaduje, aby v Shoptet nastavení nebola zaškrtnutá „Povoliť iba z konkrétnej IP adresy" (pri produktoch) alebo „Permanentný odkaz" (pri objednávkach a zákazníkoch). Skontrolujte si to v administrácii.
- „API kľúč neoverený (401)" — token bol deaktivovaný alebo zle skopírovaný. V Shoptete vygenerujte nový a vložte ho znova.
- „API token nemá povolené potrebné oprávnenia (403)" — token je v Shoptete obmedzený na skupiny endpointov a niektoré z tých, ktoré Margly potrebuje, chýbajú. V Prepojenie → Private API mu povoľte Nastavenia (čítanie aj zápis), Objednávky, Produkty a Zákazníci (čítanie).
- „Margly nenačítava dáta, aj keď je kľúč overený" — pravdepodobne ste nedokončili posledný krok. Otvorte Napojenia → Shoptet, zíďte na kartu Párovanie polí a kliknite na Uložiť a potvrdiť mapovanie. Bez potvrdenia sa import cez API nespustí.
- „Webhooky sa nezaregistrovali" — niektoré Shoptet tarify neumožňujú registráciu webhookov. Margly potom bude fungovať, ale len s pravidelným načítaním dát (podľa vášho tarifu).
- „Zlé kódovanie v CSV" — Margly podporuje UTF-8 a Windows-1250 (legacy Shoptet feedy). Pokiaľ feed obsahuje iné kódovanie (extrémne vzácne), napíšte podpore.
- Zlá mena v objednávkach — Margly berie menu z e-shop nastavení. Pokiaľ máte viacjazyčný/viacmenový e-shop, skontrolujte v sekcii Fakturácia, že máte správnu východiskovú menu.
Čo ďalej#
Po úspešnom napojení Shoptetu odporúčame prepojiť aj reklamné systémy a externé služby — bez nich Margly vidí len tržby, ale nie návratnosť reklamy ani návštevnosť:
- Google Ads — výdavky a konverzie z Google reklamy
- Meta Ads — Facebook a Instagram reklama
- Sklik — seznam.cz a partnerská sieť (CZ/SK, e-shop v CZK)
- Heureka — porovnávač tovaru (CZ/SK)
- Google Analytics 4 — návštevnosť a konverzný pomer
- Google Search Console — organická návštevnosť a kľúčové slová