Margly
Napojenie

Napojenie Shoptet e-shopu

Tri spôsoby, ako pripojiť Shoptet — autorizovaný doplnok Margly.io (pripravujeme), API kľúč, alebo 3 CSV feedy.

5 min čítania

Tri možnosti, ako Shoptet napojiť#

Shoptet podporuje tri spôsoby integrácie s Margly:

  1. Autorizovaný doplnok Margly.io v Shoptet Doplnky (pripravujeme — čoskoro dostupný) — inštalácia na preklik, žiadne ručné zadávanie kľúčov. Po vydaní to bude odporúčaná cesta.
  2. API kľúč (Privátne API) — okamžité načítanie, webhooky pre aktualizácie v reálnom čase. Dostupné len v tarife Shoptet Premium.
  3. 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 (pripravujeme)#

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

  1. Vygenerujte Privátny API token v Shoptete

    V administrácii Shoptetu choďte na Nastavenia → Privátne 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).

  2. Vložte token do Margly

    V Margly otvorte Napojenia → Shoptet a vložte Privátny API token. Kliknite na Overiť a uložiť — Margly token okamžite overí proti Shoptet API.

  3. Margly automaticky zaregistruje webhooky

    Po overení tokenu Margly na pozadí zaregistruje sadu webhookov pre:

    • životný cyklus objednávok (vytvorenie, úprava, zaplatenie, storno)
    • dostupnosť produktov a pohyby na sklade
    • životný cyklus zákazníkov (vytvorenie, úprava)

    Registrácia trvá pár sekúnd a uvidíte stav „Webhooky aktívne" v sekcii Napojenia.

  4. Počkajte na prvé načítanie dát

    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.

  1. 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í pridajte tieto stĺpce (nájdete ich v ponuke výberu polí):

    • Východisková kategória
    • Nákupná cena
    • Nákupná cena v percentách DPH
    • Nákupná cena vrátane DPH
    • Mena

    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.

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

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

Bolo to užitočné?

Súvisiace články