Popis
Elementary POS je moderní cloudový pokladní systém pro maloobchodní podniky. Tento plugin umožňuje automatickou, real-time synchronizaci produktů a zásob mezi vaším systémem Elementary POS a obchodem WooCommerce.
Klíčové funkce
- Kompatibilní s HPOS – Plně kompatibilní s WooCommerce High-Performance Order Storage
- Obousměrný import produktů – Importujte produkty z Elementary POS do WooCommerce nebo exportujte z WooCommerce do Elementary POS.
- Systém mapování daní – Inteligentní mapování daní mezi daňovými třídami WooCommerce a typy daní v Elementary POS.
- Import v režimu Koncept – Možnost importovat nové produkty jako koncept místo publikovaných.
- Synchronizace konceptů produktů – Volitelná synchronizace produktů v konceptu spolu s těmi publikovanými.
- Bezpečné odstranění produktů – Produkty jsou místo trvalého smazání přesunuty do koše, což umožňuje jejich obnovu.
- Obousměrná synchronizace skladu – Udržujte skladové zásoby synchronizované v obou směrech.
- Webhooky v reálném čase – Okamžité aktualizace při prodeji v Elementary POS.
- Automatická synchronizace objednávek – WooCommerce objednávky automaticky aktualizují inventář v Elementary POS.
- Systém fronty – Spolehlivé zpracování s automatickým opakováním při selhání; neúspěšné položky jsou automaticky opakovány při nové aktivitě.
- Komplexní logování – Sledování všech synchronizačních aktivit s podrobnými záznamy.
- Manuální ovládání – Plná manuální kontrola nad synchronizací podle potřeby.
Jak to funguje
Co se synchronizuje:
Elementary POS WooCommerce:
* Data produktů (název, SKU, cena, kategorie, daňové třídy)
* Změny skladového množství ze všech zdrojů (prodeje, manuální úpravy, skladové korekce)
WooCommerce Elementary POS:
* Data produktů (název, SKU, cena, daňové třídy)
* Změny skladového množství z dokončených objednávek
* Manuální úpravy zásob v administraci WooCommerce
Kdy dochází k synchronizaci:
Elementary POS WooCommerce:
Když dojde ke změně skladu v Elementary POS (prodej, manuální úprava atd.), webhook je odeslán do WooCommerce.
Plugin zpracuje aktualizaci okamžitě v reálném čase a aktualizuje skladové zásoby ve WooCommerce.
WooCommerce Elementary POS:
Když je objednávka ve WooCommerce dokončena nebo když se zásoby ručně změní v administraci WooCommerce, změny zásob jsou automaticky odeslány do Elementary POS.
Změny jsou odesílány okamžitě. Pokud je API nedostupné, změny jsou zařazeny do fronty a automaticky opakovány s exponenciálním odstupem (15 min, 1 hod, 6 hod). Jakékoli dříve neúspěšné položky jsou automaticky resetovány a opakovány při nové aktivitě, což zajišťuje, že žádné změny nebudou trvale ztraceny.
Požadavky
- WordPress 5.8 nebo vyšší
- WooCommerce 5.0 nebo vyšší
- PHP 7.4 nebo vyšší
- Elementary POS API klíč
- Produkty musí mít SKU kódy pro synchronizaci skladu (import produktů může fungovat i bez SKU)
Kompatibilita
- Kompatibilní s HPOS – Plně kompatibilní s WooCommerce High-Performance Order Storage
- WP Cron – Používá WordPress cron pro zpracování fronty (běží každých 15 minut)
Omezení
- Desetinná množství nejsou podporována – Kvůli omezením WooCommerce jsou podporována pouze celá čísla. Desetinné hodnoty (např. 1,5 kg) jsou automaticky zaokrouhleny, což může ovlivnit obchody prodávající zboží na váhu či objem.
- Spouštěč synchronizace skladu – Synchronizace skladu WooCommerce Elementary POS probíhá ve dvou scénářích: (1) když WooCommerce sníží zásoby z dokončených objednávek a (2) když jsou zásoby ručně změněny v administraci WooCommerce. Pokud má váš obchod zakázanou správu skladu pro určité produkty (např. služby), tyto produkty nebudou synchronizaci do Elementary POS spouštět.
- Viditelnost produktu a stav skladu – Nově importované produkty jsou standardně nastaveny jako „Viditelné“ a „Skladem“. Během aktualizací je viditelnost v katalogu zachována (nemění se), ale stav skladu je vždy nastaven na „Skladem“. Pokud potřebujete produkty skrýt nebo nastavit jako vyprodané, upravte tato nastavení po importu ručně.
- Pouze jednoduché produkty – Plugin importuje všechny produkty jako jednoduché (WC_Product_Simple). Produkty s variantami v Elementary POS jsou importovány jako jednotlivé jednoduché produkty, nikoli jako variabilní produkty. Pokud váš katalog silně spoléhá na varianty (velikost, barva atd.), budete je muset po importu ve WooCommerce ručně nakonfigurovat.
- Plochá struktura kategorií – Všechny kategorie produktů z Elementary POS jsou ve WooCommerce vytvořeny jako kategorie nejvyšší úrovně. Hierarchie kategorií (vztahy rodič/potomek) nejsou během importu zachovány. Kategorie jsou párovány pouze podle názvu.
- Omezení WP-Cron – WP-Cron funguje na základě časových intervalů, ale spouští se pouze při návštěvě stránek. To znamená, že pokud nikdo nenavštíví web, úloha nemusí běžet včas, ale je zařazena do fronty a provedena při první návštěvě.
Podpora
Pro podporu prosím navštivte https://elementarypos.com/en/contact/ nebo kontaktujte support@elementarypos.com
Externí služby
Tento plugin spoléhá na Elementary POS API, externí službu třetí strany, pro synchronizaci dat produktů a inventáře mezi vaším WooCommerce obchodem a Elementary POS systémem.
Co je Elementary POS API a k čemu se používá?
Elementary POS API je cloudová služba poskytovaná Elementary POS, která spravuje vaše data z pokladního systému. Tento plugin se připojuje k API pro:
* Import produktů z Elementary POS do WooCommerce
* Synchronizaci skladových zásob obousměrně
* Odesílání aktualizací WooCommerce objednávek do Elementary POS
* Příjem real-time notifikací o změnách skladu přes webhooky
Jaká data jsou odesílána a kdy?
Plugin odesílá data do Elementary POS API v následujících situacích:
Během importu produktů:
* Žádná data nejsou odesílána – plugin pouze získává informace o produktech (SKU, název, cena, skladové množství)
Během synchronizace skladu (WooCommerce Elementary POS):
* SKU kódy produktů
* Změny skladového množství
* Časové razítko změn
* Nastává při manuální aktivaci WCEP synchronizace nebo při dokončení objednávky ve WooCommerce
Během registrace webhooku:
* URL vaší WordPress stránky
* URL koncového bodu webhooku
* Nastává při zapnutí automatické synchronizace v nastavení pluginu
Co plugin přijímá z Elementary POS:
* Informace o produktech (SKU, název, cena, sklad)
* Notifikace o změnách skladu (SKU, rozdíl v množství)
* Informace o stavu webhooku
Použité API koncové body
- Produkční:
https://api.elementarypos.com
Příslušný koncový bod je automaticky vybrán na základě vašeho Elementary POS API klíče.
Podmínky služby a ochrana soukromí
- Zásady ochrany osobních údajů Elementary POS: https://elementarypos.com/en/privacy-policy/
Důležité: Pro použití tohoto pluginu musíte mít aktivní Elementary POS účet a API klíč. Použitím tohoto pluginu souhlasíte s podmínkami služby Elementary POS a berete na vědomí, že data budou přenášena na jejich API koncové body.
Zásady ochrany osobních údajů
Tento plugin neshromažďuje ani neukládá osobní údaje uživatelů (jména, e-maily, adresy).
Plugin ukládá provozní data ve vaší databázi:
* Protokoly synchronizace (časová razítka, typy operací, SKU produktů)
* Data fronty pro opakované operace (informace o produktech a objednávkách)
Všechna data jsou uložena lokálně ve vaší WordPress databázi. Žádná data nejsou odesílána třetím stranám kromě vašeho Elementary POS API koncového bodu pro účely synchronizace. Protokoly lze manuálně vymazat v nastavení pluginu.
Snímky obrazovky





Instalace
- Nainstalujte plugin z WordPress.org (Pluginy Přidat nový Vyhledat „Elementary POS“)
- Aktivujte plugin
- Přejděte na Elementary POS v administračním menu WordPress
- Přejděte na záložku Nastavení
- Zadejte váš Elementary POS API klíč
- Klikněte na „Uložit nastavení“ pro uložení API klíče
- (Volitelně) Klikněte na „Testovat API připojení“ pro ověření připojení
Počáteční nastavení
Po instalaci a konfiguraci API klíče můžete začít plugin používat:
- (Volitelně) Import produktů: Přejděte na záložku Import Načíst produkty Importovat pro přenesení produktů z Elementary POS do WooCommerce
- (Volitelně) Synchronizace skladu: Proveďte počáteční synchronizaci skladu v libovolném směru (Elementary POS WooCommerce nebo WooCommerce Elementary POS) ze záložky Synchronizace
- (Volitelně) Zapnutí automatické synchronizace: Po provedení počáteční synchronizace skladu můžete zapnout automatickou synchronizaci v záložce Nastavení přepnutím přepínače na ZAP
- Ověření stavu: Zkontrolujte Nástěnku pro potvrzení, že všechna nastavení jsou správně nakonfigurována
Recenze
Pro tento plugin nejsou žádné recenze.
Autoři
Elementary POS for WooCommerce je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.
SpolupracovníciPlugin „Elementary POS for WooCommerce“ byl přeložen do 1 jazyku. Děkujeme všem překladatelům za jejich pomoc.
Přeložte “Elementary POS for WooCommerce” do svého jazyka.
Zajímá vás vývoj?
Prohledejte kód, podívejte se do SVN repozitáře, nebo se přihlaste k odběru protokolu vývoje pomocí RSS.
Přehled změn
0.9.18
- Opraveno: Situace, kdy docházelo ke kolizi při zpracování webhooků, která mohla způsobit zdvojení změn stavu zásob v případě, že dorazilo více webhooků najednou
- Opraveno: Ruční synchronizace skladových zásob (EPWC) již neodesílá zpětné změny do systému Elementary POS
- Opraveno: Opakované provádění neúspěšných změn zásob v režimu „piggyback“ bylo přesunuto ze synchronního odesílání do asynchronního cronu, aby se zabránilo zpomalení odesílání
- Opraveno: Při vrácení změn během ruční synchronizace již nedochází k úniku dat o změnách skladových zásob do systému Elementary POS
- Vylepšení: Deaktivace pluginu nyní správně vymaže všechny naplánované události cronu
0.9.17
- České překlady se nenačítaly – přidáno explicitní volání oad_plugin_textdomain() s přibalenými překlady jako záloha
- Přibalené překlady se nyní načítají nezávisle na jazykových balíčcích z WordPress.org
0.9.16
- Přidáno: Manuální změny skladu v administraci WooCommerce jsou nyní synchronizovány do Elementary POS.
- Přidáno: Prevence smyček, aby se zabránilo duplicitní synchronizaci během importu EPWC.
- Vylepšeno: Synchronizace skladu nyní pokrývá změny z objednávek i manuální úpravy.
- Vylepšeno: Systém fronty nyní automaticky opakuje dříve neúspěšné položky při nové aktivitě.
- Vylepšeno: Potlačení chyb při přepisování serverových limitů pro prevenci chyb na omezených hostinzích.
- Opraveno: Všechny natvrdo zapsané české řetězce nahrazeny anglickými pro správný překlad.
- Opraveno: JavaScript řetězce jsou nyní správně přeložitelné přes wp_localize_script.
- Změněno: Aktualizována dokumentace tak, aby odrážela plnou obousměrnou synchronizaci skladu.
- Změněno: Odstraněny redundantní soubory překladů en_US.
0.9.14
- Přidáno: Obousměrný systém mapování daní pro importy produktů.
- Přidáno: Možnost importovat daňové třídy s mapováním pro oba směry.
- Přidáno: Automatické mapování daní na základě shody procentuální sazby.
- Přidáno: Interaktivní tabulka mapování daní s rozbalovacími nabídkami.
- Přidáno: Vizuální zobrazení daňových sazeb (max. 3 země s indikátorem „…“).
- Přidáno: Možnost „Nepřiřazena žádná daň“ pro daňové třídy WooCommerce.
- Vylepšeno: Mapování daní se během importu ukládá do transients pro zajištění konzistence.
- Vylepšeno: Import WCEP nyní používá správné koncové body API (pro stávající i nové produkty).
- Změněno: Jednoduchý výběr daně v importu WCEP nahrazen komplexním systémem mapování.
- Změněno: Mapování daní je povinné pro import WCEP (vyžadováno API), volitelné pro EPWC.
- Opraveno: Chyba „SKU kód již existuje“ při aktualizaci stávajících produktů při importu WCEP.
0.9.13
- Vylepšeno: Produkty čekající na schválení jsou nyní zpracovávány stejně jako koncepty.
- Vylepšeno: Pokud je zapnuta synchronizace konceptů, jsou zahrnuty i produkty čekající na schválení.
- Vylepšeno: Import, export a synchronizace skladu nyní podporují stav „Čeká na schválení“.
- Vylepšeno: Statistiky na nástěnce zahrnují i čekající produkty, pokud je povolena synchronizace konceptů.
0.9.12
- Vylepšeno: Záložka Import – sjednocené rozhraní s výběrem směru (EPWC nebo WCEP).
- Vylepšeno: Záložka Synchronizace – sjednocené rozhraní s výběrem směru v rozbalovací nabídce.
- Vylepšeno: Jediné tlačítko „Načíst produkty“ místo samostatných tlačítek pro každý směr.
- Vylepšeno: Jediné tlačítko „Aktualizovat sklad“ místo samostatných tlačítek pro každý směr.
- Změněno: Odstraněna sekce „Rychlé akce“ z Nástěnky.
- Změněno: Záložky Import a Synchronizace nyní používají jednotná tlačítka pro lepší UX.
0.9.11
- Hlavní: Přepracování importu na třífázový systém s transparentním hlášením průběhu.
- Přidáno: Fáze 1 – Smazání všech produktů WC v dávkách (volitelné, brání vypršení limitů).
- Přidáno: Fáze 2 – Import produktů z Elementary POS v dávkách (brání vypršení limitů).
- Přidáno: Fáze 3 – Načtení skladu z Elementary POS v dávkách (volitelné, brání vypršení limitů).
- Vylepšeno: Zobrazení průběhu v reálném čase pro každou fázi s počtem produktů.
- Vylepšeno: Zpracování chyb specifických pro danou fázi a podpora zrušení.
- Vylepšeno: Přejmenování funkcí pro budoucí kompatibilitu exportu WC EP.
- Vylepšeno: Možnosti importu jsou během procesu deaktivovány, aby se předešlo nejasnostem.
- Změněno: Operace importu jsou nyní odděleny pro lepší přehlednost a kontrolu.
- Opraveno: Velké importy (přes 10k produktů) již nezpůsobují vypršení časového limitu.
0.9.10
- Opraveno: Produkty v konceptu jsou nyní při importu správně detekovány a aktualizovány.
- Opraveno: Import respektuje stav konceptu – produkty zůstávají koncepty i po aktualizaci.
- Přidáno: Nová pomocná metoda pro načítání produktů s ohledem na stav konceptu.
- Přidáno: Podrobná diagnostika časových limitů v konzoli prohlížeče.
- Vylepšeno: Velikost dávky importu optimalizována pro lepší výkon (50 produktů na dávku).
- Vylepšeno: Ukazatel průběhu nyní zobrazuje skutečná procenta a počty produktů.
- Vylepšeno: Komplexní hlášení chyb se specifickými typy vypršení časového limitu.
- Změněno: Stav produktu (koncept/publikováno) je během aktualizací zachován.
0.9.9
- Přidáno: Volitelná synchronizace produktů v konceptu – nové nastavení v záložce Nastavení.
- Změněno: Produkty jsou místo trvalého smazání přesouvány do koše.
- Vylepšeno: Produkty lze obnovit z koše po použití volby „smazat vše“ při importu.
- Vylepšeno: Mechanismus vrácení změn (rollback) obnoví produkty z koše v případě selhání importu.
0.9.8
- Přidáno: Možnost importovat produkty jako koncept místo stavu publikováno.
- Vylepšeno: Mechanismus prevence smyček nyní používá globální příznaky požadavků místo dočasných dat (transients).
- Vylepšeno: Odinstalace pluginu automaticky vypne webhook v Elementary POS, aby se předešlo osiřelým notifikacím.
- Vylepšeno: Odstraněny podrobné zprávy o inicializaci pro čistší protokoly.
- Změněno: Typ fronty přejmenován na „stock_change“ pro lepší konzistenci.
- Změněno: Handler skladu WooCommerce objednávek refaktorován do samostatné třídy.
0.9.7
- Vylepšeno: Mechanismus prevence smyček nyní používá globální příznaky požadavků místo dočasných dat (transients).
- Vylepšeno: Odinstalace pluginu automaticky vypne webhook v Elementary POS, aby se předešlo osiřelým notifikacím.
- Změněno: Typ fronty přejmenován na „stock_change“ pro lepší konzistenci.
- Změněno: Handler skladu WooCommerce objednávek refaktorován do samostatné třídy.
0.9.6
- Opraveno: Import s načtením skladu správně nastavuje časové razítko pro povolení automatické synchronizace.
- Vylepšeno: Nástěnka přepracována na jednu sjednocenou tabulku stavů (9 řádků).
- Vylepšeno: Na nástěnku přidána statistika „Celkem produktů s SKU“ pro lepší přehled o inventáři.
- Vylepšeno: Stav „Automatická synchronizace“ přesunut na druhou pozici na nástěnce pro lepší viditelnost.
- Vylepšeno: Snížena podrobnost protokolů – odstraněny detailní výpisy API požadavků při zachování chyb a důležitých událostí.
- Změněno: Zjednodušena validace webhooku pro přijetí počáteční synchronizace z obou směrů.
0.9.5
- KRITICKÁ OPRAVA: Webhook nyní správně aplikuje změny skladu jako rozdíly (delta), nikoli absolutní hodnoty.
- KRITICKÁ OPRAVA: Synchronizace používá syncTimestamp z API místo lokálního času serveru.
- KRITICKÁ OPRAVA: Synchronizace WCEP nyní správně nastavuje všechna časová razítka.
- Opraveno: Webhook nyní funguje správně bez ohledu na to, který směr synchronizace proběhl jako první.
- Bezpečnost: Automatická synchronizace je při změně API klíče automaticky vypnuta.
- Bezpečnost: Webhook nelze aktivovat bez provedení počáteční synchronizace (podporovány oba směry).
- Vylepšeno: Manuální synchronizace nyní správně ukládá syncTimestamp z odpovědi API.
- Vylepšeno: Rozšířené logování operací webhooku s detaily o agregaci.
- Změněno: Časová razítka synchronizace se resetují při změně API klíče (bezpečnost při změně účtu).
0.9.4
- Opraveno: Webhook nyní ignoruje změny skladu vyslané vlastním pluginem, aby se předešlo chybám v počtech.
- Opraveno: Odstraněno nadbytečné logování změn pocházejících z vlastního pluginu.
0.9.3
- Vylepšeno: Prodlouženo automatické čištění fronty a protokolů ze 7 na 30 dní.
- Vylepšeno: Protokoly webhooku filtrovány pouze pro události stock_updated.
- Změněno: Odstraněn redundantní „Stav webhooku“ z nástěnky.
- Změněno: Sekce automatického obnovování nahrazena tlačítky pro manuální obnovení u nadpisů.
- Změněno: Formát časového razítka v záznamech změněn na ISO (RRRR-MM-DD HH:MM:SS).
0.9.2
- Vylepšeno: Doba zobrazení upozornění prodloužena z 5 na 8 sekund pro lepší čitelnost.
- Změněno: Test API nyní zobrazuje Base URL místo prostředí a počtu produktů.
- Vylepšeno: Úklid kódu – odstraněny nadbytečné funkce a neaktivní kód.
0.9.1
- Změněno: Standardizace interních identifikátorů s prefixem „elementary-pos-woocommerce“.
- Změněno: Aktualizovány názvy CSS tříd pro lepší konzistenci.
- Změněno: Aktualizovány JavaScript handles pro lepší konzistenci.
- Opraveno: ID pluginu nyní odpovídá slugu pluginu.
0.9.0
- Přidáno: Automatická správa webhooku přes Elementary POS API.
- Přidáno: Přepínač pro zapnutí/vypnutí webhooku v Nastavení.
- Přidáno: Real-time monitorování stavu webhooku (v pořádku, varování, chyba, vypnuto).
- Přidáno: Tlačítko pro test stavu pro manuální ověření webhooku.
- Změněno: URL webhooku se již nekopíruje ručně – proces je plně automatizován.
- Změněno: Zjednodušená konfigurace webhooku v záložce Nastavení.
- Vylepšeno: Lepší UX s vizuálním přepínačem a indikátory stavu.
- Vylepšeno: Automatická registrace webhooku při zapnutí/vypnutí.
- Vylepšeno: Stav načítání brání nechtěným změnám vizuálního stavu přepínače.
0.8.5
- Změněno: Název pluginu zkrácen na „Elementary POS for WooCommerce“.
- Změněno: Text domain aktualizován na „elementary-pos-for-woocommerce“.
- Změněno: Všechny překlady aktualizovány na novou textovou doménu.
- Opraveno: Odstraněna duplicitní Author URI pro soulad s pravidly WordPress.org.
0.8.4
- Opraveno: Soulad názvu pluginu s pravidly WordPress.org pro ochranné známky.
- Opraveno: Příprava SQL dotazů dle standardů WordPress.
- Opraveno: Pojmenování globálních proměnných se správnými prefixy.
- Vylepšeno: Dokumentace kódu a bezpečnostní komentáře pro recenzenty.
- Aktualizováno: Testováno až do WordPress 6.8.
0.8.3
- Počáteční release kandidát.
- Automatický import produktů – Import produktů z Elementary POS do WooCommerce jedním kliknutím.
- Obousměrná synchronizace skladu – Udržujte skladové zásoby synchronizované v obou směrech.
- Webhooky v reálném čase – Okamžité aktualizace při prodeji v Elementary POS.
- Automatická synchronizace objednávek – WooCommerce objednávky automaticky aktualizují inventář Elementary POS.
- Systém fronty – Spolehlivé zpracování s automatickým opakováním při selhání.
- Komplexní logování – Sledování všech synchronizačních aktivit s podrobnými záznamy.
- Manuální ovládání – Plná manuální kontrola nad synchronizací podle potřeby.
- Nástěnka s real-time statistikami a rychlými akcemi.
- Kompatibilní s HPOS – Plně kompatibilní s WooCommerce High-Performance Order Storage.
