Napojenie cez plugin Margly#
Pre WooCommerce máme oficiálny plugin Margly v katalógu WordPress.org. Nainštalujete ho vo svojej administrácii, kliknete na Prepojiť s Margly a plugin za vás urobí zvyšok: vytvorí prístupové údaje len na čítanie, zaregistruje podpísané webhooky a odovzdá nám ich priamo zo servera na server. Nič nikam nekopírujete a žiadne kľúče vám neprejdú prehliadačom.
Čo potrebujete#
- WordPress 6.6 alebo novší a PHP 7.4 alebo novšie
- WooCommerce 9.0 alebo novší
- E-shop na HTTPS — cez nešifrované spojenie by sme prístupové údaje neprenášali
- Účet v Margly (stačí bezplatný trial — založíte ho počas prepájania)
Postup#
Nainštalujte plugin Margly
Vo WordPress administrácii choďte na Pluginy → Pridať plugin, vyhľadajte Margly a kliknite na Inštalovať. Potom plugin aktivujte.
Otvorte WooCommerce → Margly
V ľavom menu sa po aktivácii objaví položka Margly pod WooCommerce. Otvorte ju a kliknite na Prepojiť s Margly.
V tej chvíli plugin vo vašom e-shope vytvorí API kľúč s právom len na čítanie a zaregistruje webhooky. Nič v e-shope nemení — kľúč Margly neoprávňuje na zápis.
Prihláste sa do Margly
Plugin vás presmeruje do Margly. Ak účet ešte nemáte, rovno tu sa zaregistrujete a spustí sa 14-dňový trial.
Potvrďte prepojenie
Margly vám ukáže, o ktorý obchod ide, a vy prepojenie potvrdíte tlačidlom Prepojiť obchod. Margly potvrdenie pošle späť do vášho WordPressu a spustí prvý import.
Prvé dáta uvidíte v Margly počas niekoľkých minút. Pri veľkom katalógu a dlhej histórii objednávok trvá prvý import dlhšie — priebeh sledujete priamo v aplikácii.
Čo Margly z WooCommerce číta#
- Objednávky — položky, množstvá, ceny, zľavy, doprava, DPH, vratky, stav platby a doručenia, dátum
- Produkty — názvy, SKU, predajné ceny, DPH, sklad, kategórie, viditeľnosť. Varianty berieme ako samostatné položky, takže marže vidíte po variantoch, nielen po produkte.
- Zákazníci — údaje potrebné pre návratnosť zákazníkov a ich celoživotnú hodnotu
Margly je výhradne na čítanie — nikdy nemení objednávky, produkty, ceny ani nastavenia vášho e-shopu.
Nákupné ceny#
Bez nákupných cien sa nedajú spočítať marže a WooCommerce ich nemá ako štandardné pole. Margly ich preto hľadá na troch miestach, v tomto poradí:
- Nákupné ceny priamo vo WooCommerce (funkcia „Cost of Goods", WooCommerce 10.3 a novší)
- Plugin „Cost of Goods" od SkyVerge, ak ho používate
- Cena uložená pri produkte v katalógu, keď ju objednávka sama nenesie
DPH#
Ceny v položkách objednávky posiela WooCommerce vždy bez dane a daň zvlášť, takže sadzbu pri každej položke spočítame z vašich vlastných čísel — nedosadzujeme sadzbu podľa krajiny. Keď je objednávka alebo položka bez dane, uložíme skutočnú nulu; vymýšľať pri obchode oslobodenom od DPH dvadsaťjeden percent by rozbilo celý výpočet tržieb.
Stavy objednávok#
Štandardné stavy WooCommerce (čaká na platbu, spracováva sa, čaká na vybavenie, dokončené, zrušené, vrátené, zlyhalo) Margly prevádza na svoje stavy, aby sa dali e-shopy z rôznych platforiem porovnávať. Rozpracované a zmazané objednávky (koncepty, kôš) neukladáme vôbec.
Keď si stav pridáte vlastným pluginom, Margly ho nezahodí — zaradí ho podľa toho, či je objednávka zaplatená. Nikdy sa teda nestane, že by objednávka z čísel ticho zmizla.
Zmeny sa premietajú okamžite#
Plugin registruje deväť podpísaných webhookov — vznik, zmenu a zmazanie pri objednávkach, produktoch aj zákazníkoch. Nová objednávka je preto v Margly do pár minút, nie až pri ďalšej plánovanej synchronizácii.
Každá požiadavka je podpísaná zdieľaným tajomstvom a nepodpísané odmietame. Webhook navyše nikdy nezapisuje dáta z toho, čo príde — len povie, že sa niečo zmenilo, a Margly si dané objednávky alebo produkty znova prečíta z vášho e-shopu. Opakovane doručený alebo prehodený webhook preto nemôže vaše dáta poškodiť.
Čo Margly stráži sama#
WooCommerce sám vypne webhook po piatich neúspešných doručeniach a už ho nikdy nezapne. Margly preto raz denne kontroluje váš obchod a:
- znova zapne webhooky, ktoré WooCommerce vypol,
- porovná počet objednávok u vás a u nás — a keď sa rozídu, dotiahne chýbajúce,
- overí, že sa objednávky neprečíslovali (niektoré pluginy menia čísla objednávok); ak áno, Margly si ich spáruje podľa vnútorného identifikátora, ktorý sa nemení.
Že niečo z toho prebehlo, spoznáte len podľa toho, že vám čísla sedia — zasahovať nemusíte.
Bezpečnosť#
- Prístupové údaje vytvára plugin s právom len na čítanie a odovzdáva ich zo servera na server — prehliadačom nikdy neprejdú.
- U nás sú uložené zašifrované.
- Webhooky sú podpísané; nepodpísané požiadavky odmietame.
- Plugin nepridáva do vášho e-shopu žiadny kód na frontende a nespomaľuje ho.
Časté problémy#
- „E-shop musí bežať na HTTPS" — cez nešifrované spojenie prístupové údaje neprenášame. Nasaďte certifikát a spustite prepojenie znova.
- „Vaša verzia WooCommerce je príliš stará" — aktualizujte WooCommerce a skúste to znova.
- „Platnosť párovacieho odkazu vypršala" / „už bol použitý" — odkaz platí 30 minút a len raz. V administrácii kliknite na Prepojiť s Margly znova.
- „Tento obchod je už pripojený k inému účtu" — jeden e-shop sa nedá napojiť na dva účty Margly. Napíšte nám na support@margly.io a vyriešime to.
- „Účet má pripojenú inú platformu" — ste prihlásení účtom, ktorý už má napojený iný e-shop. Prepojte obchod s iným účtom (tlačidlo je priamo na stránke).
- „Potvrdenie do WordPressu sa nepodarilo" — obvykle za to môže bezpečnostná vrstva pred vaším webom (ochrana hostingu, Wordfence a podobné pluginy), ktorá našu požiadavku nepustila ďalej. Skontrolujte, či je plugin aktívny, a skúste to znova.
- „Spojenie s WooCommerce je prerušené" — prišlo vám upozornenie, že váš e-shop prestal prijímať naše požiadavky. Takmer vždy je to bezpečnostný plugin blokujúci REST API. Margly v takom prípade účet nezneaktívni a dáta vám zostanú — len sa dočasne neaktualizujú. Povoľte prístup k REST API a synchronizácia sa rozbehne sama.
- Chýbajú nákupné ceny — viď sekciu vyššie; bez nich marže nedopočítame.
Odpojenie a odinštalácia#
Odpojiť môžete dvoma spôsobmi a oba urobia to isté: v administrácii WordPressu tlačidlom Odpojiť na stránke Margly, alebo úplnou odinštaláciou pluginu. Plugin v oboch prípadoch zmaže vytvorený API kľúč aj všetky webhooky a dá Margly vedieť, že spojenie skončilo.
Potom sa stane toto:
- Margly prestane sťahovať nové dáta
- Historické dáta v aplikácii ďalej vidíte, len sa neaktualizujú
- Platené predplatné sa nastaví na ukončenie ku koncu zaplateného obdobia — ďalej vám nič nestrhneme
- Rozbehne sa 30-dňová lehota na zachovanie dát a Margly vám počas nej pošle pripomienky (3., 7., 14., 21. a 27. deň)
Ak plugin do 30 dní znova aktivujete a prepojíte, Margly nadviaže na pôvodný účet a dáta sa nestratia. V Nastaveniach vám medzitým ukazujeme tlačidlo, ktoré vás do administrácie pluginov rovno pošle.
Čo ďalej#
- Prvé načítanie dát — čo sa deje hneď po napojení
- Napojenie Google Ads — návratnosť reklamy a jej ziskovosť
- PDF import faktúr — prevádzkové náklady, logistika a marketing
- Riešenie problémov pri napojení