Margly.io doplněk z Upgates marketplace#
Pro Upgates jsme připravili oficiální doplněk Margly.io v Upgates marketplace. Nainstalujete ho na dva kliky, Upgates Margly automaticky předá API credentials přes signované volání a Margly za vás vytvoří účet i tenant. Žádné kopírování tokenů, žádná samostatná registrace na webu.
Postup#
Otevřete doplněk v Upgates marketplace
Přejděte na doplnky.upgates.cz/detail/margly-io.
Klikněte na Nainstalovat
Upgates vás přesměruje na přihlášení do administrace vašeho e-shopu (pokud nejste přihlášeni). Po přihlášení uvidíte detail doplňku se souhrnem oprávnění.
Schvalte oprávnění
Upgates se zeptá, jestli chcete Margly udělit přístup ke čtení produktů, objednávek a zákazníků. Souhlaste — Margly je read-only, nezapisuje vám do e-shopu.
Po schválení Upgates pošle Margly podepsaný install payload s API credentials (token + apiUser + apiKey + apiUrl). Signaturu Margly ověří a credentials uloží v zašifrované podobě.
Margly automaticky dokončí napojení
Margly:
- Vytvoří pro vás účet a 14denní trial
- Detekuje měnu vašeho e-shopu (CZK / EUR podle Upgates locale)
- Spustí první načtení dat na pozadí
Během 5–30 minut uvidíte první data v Margly (podle velikosti katalogu).
Co Margly z Upgates čte#
- Produkty — názvy, SKU, prodejní ceny, nákupní ceny (pokud je v Upgates vyplňujete), DPH sazby, zásoby, kategorie
- Objednávky — položky, sleva, doprava, stav (zaplaceno, stornováno), datum, zákazník
- Zákazníci — e-mail, jméno, město, kontakt na firmu
Margly Upgates webhooky automaticky zaregistruje během instalace doplňku — změny v e-shopu (nová objednávka, storno, změna ceny) dostávám okamžitě.
Časté problémy#
- Doplněk se nepřesměroval zpět do Margly — zkontrolujte e-mail (Margly vám pošle uvítací zprávu s odkazem na přihlášení) nebo otevřete přímo app.margly.io. Napojení proběhlo, jen browser ztratil kontext.
- Doplněk při instalaci selhal — zkuste obnovit stránku a instalaci spustit znovu. Pokud chyba přetrvá, napište na support@margly.io s názvem e-shopu a screenshotem chyby.
- Načítání dat trvá neobvykle dlouho — Upgates má pro velké katalogy přísnější rate limity. První načtení dat e-shopu s 10 000+ produkty může trvat 20–30 minut. Stav vidíte v Margly v Napojení → Aktualizace dat.
- Chybějící nákupní ceny v produktech — Upgates je má jako volitelné pole. Pokud je nemáte, Margly nedopočítá marže — viz tip výše.
Reinstall#
Pokud doplněk odinstalujete a později ho do 30 dnů znovu nainstalujete, Margly rozpozná stejný shop podle Upgates tokenu a propojí ho s vaším původním účtem — data se neztratí, načítání se obnoví a Margly přestane posílat upomínkové e-maily.
Odinstalace doplňku#
V Upgates administraci jděte na Doplňky → Margly.io → Odinstalovat. Margly hned:
- Zastaví načítání nových dat z vašeho e-shopu
- Přejde do read-only režimu (historická data v aplikaci stále vidíte)
- Spustí 30denní lhůtu pro zachování dat
- Pošle vám během této doby několik upomínek (3., 7., 14., 21. a 27. den)
31. den se účet i veškerá historická data nenávratně smažou (GDPR retention). Pokud doplněk do té doby znovu nainstalujete (viz Reinstall), Margly vás napojí na původní účet a načítání obnoví.
Pokud chcete účet smazat dřív, napište nám na support@margly.io.
Co dál#
- Napojení Google Ads pro ROAS a profitabilitu reklamy
- PDF import faktur — pro provozní náklady (logistika, marketing, opex)
- Troubleshooting — pokud něco selže