Margly
Napojení

Napojení Shoptet e-shopu

Tři způsoby, jak připojit Shoptet — autorizovaný doplněk Margly.io (připravujeme), API klíč, nebo 3 CSV feedy.

5 min čtení

Tři možnosti, jak Shoptet napojit#

Shoptet podporuje tři způsoby integrace s Margly:

  1. Autorizovaný doplněk Margly.io v Shoptet Doplňky (připravujeme — brzy dostupný) — instalace na proklik, žádné ruční zadávání klíčů. Po vydání to bude doporučená cesta.
  2. API klíč (Privátní API) — okamžité načítání, webhooky pro aktualizace v reálném čase. Dostupné jen v tarifu Shoptet Premium.
  3. 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 (připravujeme)#

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é.

  1. Vygenerujte Privátní API token v Shoptetu

    V administraci Shoptetu jděte na Nastavení → Privátní 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).

  2. Vložte token do Margly

    V Margly otevřete Napojení → Shoptet a vložte Privátní API token. Klikněte na Ověřit a uložit — Margly token okamžitě ověří proti Shoptet API.

  3. Margly automaticky zaregistruje webhooky

    Po ověření tokenu Margly na pozadí zaregistruje sadu webhooků pro:

    • životní cyklus objednávek (vytvoření, úprava, zaplacení, storno)
    • dostupnost produktů a pohyby na skladě
    • životní cyklus zákazníků (vytvoření, úprava)

    Registrace trvá pár sekund a uvidíte stav „Webhooky aktivní" v sekci Napojení.

  4. Počkejte na první načtení dat

    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.

  1. 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í přidejte tyto sloupce (najdete je v nabídce výběru polí):

    • Výchozí kategorie
    • Nákupní cena
    • Nákupní cena v procentech DPH
    • Nákupní cena včetně DPH
    • Měna

    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.

  2. 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).

  3. 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.
  • „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:

Bylo to užitečné?

Související články