Margly
Napojenie

Napojenie Upgates e-shopu

Nainštalujte si doplnok Margly.io z Upgates marketplace — prepojenie počas minúty.

3 min čítania

Margly.io doplnok z Upgates marketplace#

Pre Upgates sme pripravili oficiálny doplnok Margly.io v Upgates marketplace. Nainštalujete ho na dva kliky, Upgates Margly automaticky odovzdá API credentials cez signované volanie a Margly za vás vytvorí účet aj tenant. Žiadne kopírovanie tokenov, žiadna samostatná registrácia na webe.

Postup#

  1. Otvorte doplnok v Upgates marketplace

    Prejdite na doplnky.upgates.cz/detail/margly-io.

  2. Kliknite na Nainštalovať

    Upgates vás presmeruje na prihlásenie do administrácie vášho e-shopu (pokiaľ nie ste prihlásení). Po prihlásení uvidíte detail doplnku so súhrnom oprávnení.

  3. Schváľte oprávnenia

    Upgates sa opýta, či chcete Margly udeliť prístup ku čítaniu produktov, objednávok a zákazníkov. Súhlaste — Margly je read-only, nezapisuje vám do e-shopu.

    Po schválení Upgates pošle Margly podpísaný install payload s API credentials (token + apiUser + apiKey + apiUrl). Signatúru Margly overí a credentials uloží v zašifrovanej podobe.

  4. Margly automaticky dokončí napojenie

    Margly:

    • Vytvorí pre vás účet a 14-dňový trial
    • Deteguje menu vášho e-shopu (CZK / EUR podľa Upgates locale)
    • Spustí prvé načítanie dát na pozadí

    Počas 5–30 minút uvidíte prvé dáta v Margly (podľa veľkosti katalógu).

Čo Margly z Upgates číta#

  • Produkty — názvy, SKU, predajné ceny, nákupné ceny (pokiaľ ich v Upgates vypĺňate), DPH sadzby, zásoby, kategórie
  • Objednávky — položky, zľava, doprava, stav (zaplatené, stornované), dátum, zákazník
  • Zákazníci — e-mail, meno, mesto, kontakt na firmu

Margly Upgates webhooky automaticky zaregistruje počas inštalácie doplnku — zmeny v e-shope (nová objednávka, storno, zmena ceny) dostávame okamžite.

Časté problémy#

  • Doplnok sa nepresmeroval späť do Margly — skontrolujte e-mail (Margly vám pošle uvítaciu správu s odkazom na prihlásenie) alebo otvorte priamo app.margly.io. Napojenie prebehlo, len browser stratil kontext.
  • Doplnok pri inštalácii zlyhal — skúste obnoviť stránku a inštaláciu spustiť znova. Pokiaľ chyba pretrvá, napíšte na support@margly.io s názvom e-shopu a screenshotom chyby.
  • Načítanie dát trvá neobvykle dlho — Upgates má pre veľké katalógy prísnejšie rate limity. Prvé načítanie dát e-shopu s 10 000+ produktmi môže trvať 20–30 minút. Stav vidíte v Margly v Napojenia → Aktualizácia dát.
  • Chýbajúce nákupné ceny v produktoch — Upgates ich má ako voliteľné pole. Pokiaľ ich nemáte, Margly nedopočíta marže — pozri tip vyššie.

Reinstall#

Pokiaľ doplnok odinštalujete a neskôr ho do 30 dní znova nainštalujete, Margly rozpozná rovnaký shop podľa Upgates tokenu a prepojí ho s vaším pôvodným účtom — dáta sa nestratia, načítanie sa obnoví a Margly prestane posielať upomienkové e-maily.

Odinštalácia doplnku#

V Upgates administrácii choďte na Doplnky → Margly.io → Odinštalovať. Margly hneď:

  • Zastaví načítanie nových dát z vášho e-shopu
  • Prejde do read-only režimu (historické dáta v aplikácii stále vidíte)
  • Spustí 30-dňovú lehotu pre zachovanie dát
  • Pošle vám počas tejto doby niekoľko upomienok (3., 7., 14., 21. a 27. deň)

31. deň sa účet aj všetky historické dáta nenávratne zmažú (GDPR retention). Pokiaľ doplnok do tej doby znova nainštalujete (pozri Reinstall), Margly vás napojí na pôvodný účet a načítanie obnoví.

Pokiaľ chcete účet zmazať skôr, napíšte nám na support@margly.io.

Čo ďalej#

Bolo to užitočné?

Súvisiace články