Napojení přes plugin Margly#
Pro WooCommerce máme oficiální plugin Margly v katalogu WordPress.org. Nainstalujete ho ve své administraci, kliknete na Propojit s Margly a plugin za vás udělá zbytek: vytvoří přístupové údaje jen pro čtení, zaregistruje podepsané webhooky a předá nám je přímo ze serveru na server. Nic nikam nekopírujete a žádné klíče vám neprojdou prohlížečem.
Co potřebujete#
- WordPress 6.6 nebo novější a PHP 7.4 nebo novější
- WooCommerce 9.0 nebo novější
- E-shop na HTTPS — přes nešifrované spojení bychom přístupové údaje nepřenášeli
- Účet v Margly (stačí bezplatný trial — založíte ho během propojování)
Postup#
Nainstalujte plugin Margly
Ve WordPress administraci jděte na Pluginy → Přidat plugin, vyhledejte Margly a klikněte na Instalovat. Pak plugin aktivujte.
Otevřete WooCommerce → Margly
V levém menu se po aktivaci objeví položka Margly pod WooCommerce. Otevřete ji a klikněte na Propojit s Margly.
V tu chvíli plugin ve vašem e-shopu vytvoří API klíč s právem jen ke čtení a zaregistruje webhooky. Nic v e-shopu nemění — klíč Margly neopravňuje k zápisu.
Přihlaste se do Margly
Plugin vás přesměruje do Margly. Pokud účet ještě nemáte, rovnou tady se zaregistrujete a spustí se 14denní trial.
Potvrďte propojení
Margly vám ukáže, o který obchod jde, a vy propojení potvrdíte tlačítkem Propojit obchod. Margly potvrzení pošle zpátky do vašeho WordPressu a spustí první import.
První data uvidíte v Margly během několika minut. U velkého katalogu a dlouhé historie objednávek trvá první import déle — průběh sledujete přímo v aplikaci.
Co Margly z WooCommerce čte#
- Objednávky — položky, množství, ceny, slevy, doprava, DPH, vratky, stav platby a doručení, datum
- Produkty — názvy, SKU, prodejní ceny, DPH, sklad, kategorie, viditelnost. Varianty bereme jako samostatné položky, takže marže vidíte po variantách, ne jen po produktu.
- Zákazníci — údaje potřebné pro návratnost zákazníků a jejich celoživotní hodnotu
Margly je výhradně pro čtení — nikdy nemění objednávky, produkty, ceny ani nastavení vašeho e-shopu.
Nákupní ceny#
Bez nákupních cen nejde spočítat marže, a WooCommerce je nemá jako standardní pole. Margly je proto hledá ve třech místech, v tomhle pořadí:
- Nákupní ceny přímo ve WooCommerce (funkce „Cost of Goods", WooCommerce 10.3 a novější)
- Plugin „Cost of Goods" od SkyVerge, pokud ho používáte
- Cena uložená u produktu v katalogu, když ji objednávka sama nenese
DPH#
Ceny v položkách objednávky posílá WooCommerce vždy bez daně a daň zvlášť, takže sazbu u každé položky spočítáme z vašich vlastních čísel — nedosazujeme sazbu podle země. Když je objednávka nebo položka bez daně, uložíme skutečnou nulu; vymýšlet u obchodu osvobozeného od DPH jednadvacet procent by rozbilo celý výpočet tržeb.
Stavy objednávek#
Standardní stavy WooCommerce (čeká na platbu, zpracovává se, čeká na vyřízení, dokončeno, zrušeno, vráceno, selhalo) Margly převádí na svoje stavy, aby šly e-shopy z různých platforem porovnávat. Rozpracované a smazané objednávky (koncepty, koš) neukládáme vůbec.
Když si stav přidáte vlastním pluginem, Margly ho nezahodí — zařadí ho podle toho, jestli je objednávka zaplacená. Nikdy se tedy nestane, že by objednávka z čísel tiše zmizela.
Změny se propisují okamžitě#
Plugin registruje devět podepsaných webhooků — vznik, změnu a smazání u objednávek, produktů i zákazníků. Nová objednávka je proto v Margly do pár minut, ne až při další plánované synchronizaci.
Každý požadavek je podepsaný sdíleným tajemstvím a nepodepsané odmítáme. Webhook navíc nikdy nezapisuje data z toho, co přijde — jen si řekne, že se něco změnilo, a Margly si dané objednávky nebo produkty znovu přečte z vašeho e-shopu. Opakovaně doručený nebo prohozený webhook proto nemůže vaše data poškodit.
Co Margly hlídá sama#
WooCommerce sám vypne webhook po pěti neúspěšných doručeních a už ho nikdy nezapne. Margly proto jednou denně kontroluje váš obchod a:
- znovu zapne webhooky, které WooCommerce vypnul,
- porovná počet objednávek u vás a u nás — a když se rozejdou, dotáhne chybějící,
- ověří, že se objednávky nepřečíslovaly (některé pluginy mění čísla objednávek); pokud ano, Margly si je spáruje podle vnitřního identifikátoru, který se nemění.
Že něco z toho proběhlo, poznáte jen podle toho, že vám čísla sedí — zasahovat nemusíte.
Bezpečnost#
- Přístupové údaje vytváří plugin s právem jen ke čtení a předává je ze serveru na server — prohlížečem nikdy neprojdou.
- U nás jsou uložené zašifrované.
- Webhooky jsou podepsané; nepodepsané požadavky odmítáme.
- Plugin nepřidává do vašeho e-shopu žádný kód na frontendu a nezpomaluje ho.
Časté problémy#
- „E-shop musí běžet na HTTPS" — přes nešifrované spojení přístupové údaje nepřenášíme. Nasaďte certifikát a spusťte propojení znovu.
- „Vaše verze WooCommerce je příliš stará" — aktualizujte WooCommerce a zkuste to znovu.
- „Platnost párovacího odkazu vypršela" / „už byl použit" — odkaz platí 30 minut a jen jednou. V administraci klikněte na Propojit s Margly znovu.
- „Tento obchod je už připojený k jinému účtu" — jeden e-shop nejde napojit na dva účty Margly. Napište nám na support@margly.io a vyřešíme to.
- „Účet má připojenou jinou platformu" — jste přihlášeni účtem, který už má napojený jiný e-shop. Propojte obchod s jiným účtem (tlačítko je přímo na stránce).
- „Potvrzení do WordPressu se nezdařilo" — obvykle za to může bezpečnostní vrstva před vaším webem (ochrana hostingu, Wordfence a podobné pluginy), která naši žádost nepustila dál. Zkontrolujte, že je plugin aktivní, a zkuste to znovu.
- „Spojení s WooCommerce je přerušené" — přišlo vám upozornění, že váš e-shop přestal přijímat naše požadavky. Skoro vždy to je bezpečnostní plugin blokující REST API. Margly v takovém případě účet nezneaktivní a data vám zůstanou — jen se dočasně neaktualizují. Povolte přístup k REST API a synchronizace se rozjede sama.
- Chybí nákupní ceny — viz sekce výše; bez nich marže nedopočítáme.
Odpojení a odinstalace#
Odpojit můžete dvěma způsoby a oba udělají totéž: v administraci WordPressu tlačítkem Odpojit na stránce Margly, nebo úplnou odinstalací pluginu. Plugin v obou případech smaže vytvořený API klíč i všechny webhooky a dá Margly vědět, že spojení skončilo.
Pak se stane tohle:
- Margly přestane stahovat nová data
- Historická data v aplikaci dál vidíte, jen se neaktualizují
- Placené předplatné se nastaví na ukončení ke konci zaplaceného období — dál vám nic nestrhneme
- Rozběhne se 30denní lhůta pro zachování dat a Margly vám během ní pošle připomínky (3., 7., 14., 21. a 27. den)
Pokud plugin do 30 dnů znovu aktivujete a propojíte, Margly naváže na původní účet a data se neztratí. V Nastavení vám mezitím ukazujeme tlačítko, které vás do administrace pluginů rovnou pošle.
Co dál#
- První načtení dat — co se děje hned po napojení
- Napojení Google Ads — návratnost reklamy a její ziskovost
- PDF import faktur — provozní náklady, logistika a marketing
- Řešení problémů při napojení