--- site_name: Toret dokumentace site_url: https://documentation.toret.cz contact_email: info@toret.cz title: Dokumentace pluginu Toret One by Allegro url: https://documentation.toret.cz/one-by-allegro/ date: 2024-08-20 modified: 2025-09-23 author: mantinova type: page --- # Dokumentace pluginu Toret One by Allegro Nacházíte se na stránkách dokumentace pluginu One by Allegro pro WooCommerce, který implementuje tuto službu dopravy do e-shopu. Plugin One by Allegro zakoupíte zde: [Toret One by Allegro pro WooCommerce](https://toret.cz/produkt/one-by-allegro/) Obsah 1. Instalace pluginu 2. Aktivace pluginu 3. Napojení na One by Allegro - Ověřovací proces v testovacím režimu a získání ostrých implementačních údajů 4. Import poboček a nastavení CRONu 5. Hlavní nastavení 6. Nastavení dopravců v pluginu One by Allegro - One Courier - - One Point - - One Box 7. Nastavení dopravních zón 8. Podání zásilky z webu do One by Allegro - Manuálně - - Automaticky při změně stavu objednávky 9. Objednání vyzvednutí balíku - Manuálně - - Automatické objednání svozu 10. Doprava zdarma 11. Tisk štítků 12. Automatické načítání stavu zásilek 13. Změna stavu objednávky na základě stavu zásilky 14. Filtry 15. Časté dotazy - Chyba: Unexpected status: 22:Přihlášený uživatel nemá oprávnění používat XML server. 16. Testování pluginu ## Instalace pluginu Po zakoupení pluginu obdržíte e-mailem licenční klíč a odkaz na stažení zip souboru s pluginem. Detailní návod, jak do WordPress nainstalovat plugin z počítače, najdete [zde](https://documentation.toret.cz/instalace-pluginu/). ## Aktivace pluginu Po instalaci pluginu si otevřete plugin One by Allegro, do příslušného pole vložíte licenční klíč a tlačítkem aktivujte. ![Plugin Toret One by Allegro - aktivace](https://documentation.toret.cz/wp-content/uploads/2024/08/one-licence.png "Plugin Toret One by Allegro - aktivace") ## Napojení na One by Allegro Pro použití pluginu One by Allegro musíte mít vytvořený účet v One by Allegro nebo u [wedo.cz](https://www.wedo.cz/) a používat typ API V2. Po nainstalovaní a aktivaci pluginu pokračujte na jeho nastavení. To se nachází v sekci *Toret plugins → One by Allegro*. Pro napojení pluginu s účtem je potřeba vyplnit: - uživatelské jméno - heslo - ID zákazníka - ![Plugin Toret One by Allegro - napojení na API](https://documentation.toret.cz/wp-content/uploads/2024/08/one-api.png "Plugin Toret One by Allegro - napojení na API") ### Ověřovací proces v testovacím režimu a získání ostrých implementačních údajů Abyste mohli používat One by Allegro (dále jen One) v ostrém provozu, je třeba projít ověřovacím procesem pro podání zásilek. 1. U podpory One si vyžádejtetestovací ID zákazníkapro váš účet. 2. Do pluginu vložte kromě uživatelského jména a hesla také toto ID a zapněte testovací mód. 3. One vyžaduje v testovacím prostředí provést8 zkušebních objednávek: 1. Dvě české (jednu s dobírkou, jednu bez dobírky) 2. Dvě slovenské (jednu s dobírkou, jednu bez dobírky) 3. Dvě zásilky na výdejní místa (1 s dobírkou, 1 bez dobírky) 4. Dvě EURODIS zásilky (jednu s dobírkou, jednu bez dobírky). EURODIS zásilky jsou zásilky zahraniční (vyjma Slovenska), např. Německo nebo Francie. 4. Po vytvoření osmi testovacích objednávek pro kontroluzašlete na zákaznickou podporu čísla všech osmi zásilek(postačí zaslat štítky podaných balíků). 5. Jakmile One štítky ověří, zašle ostré implementační údaje pro napojení (ID zákazníka). Posledním krokem je vložení těchto ostrých implementačních údajů do pluginu a poté je nutné vypnout testovací mód. ![Plugin Toret One by Allegro - napojení na API](https://documentation.toret.cz/wp-content/uploads/2024/08/one-api-2.png "Plugin Toret One by Allegro - napojení na API") ## Import poboček a nastavení CRONu Pro zobrazení One výdejních míst a boxů v pokladně na mapce je potřeba**nejprve pobočky načíst**. První načtení můžete provést pomocí tlačítka „Importovat výdejní místa“. Poté **doporučujeme nastavit CRON pro pravidelnou aktualizaci poboček**. URL CRONu pro váš web je uvedena v nastavení pluginu One na kartě „Hlavní nastavení“. ![Plugin Toret One by Allegro - import poboček](https://documentation.toret.cz/wp-content/uploads/2024/08/one-import.png "Plugin Toret One by Allegro - import poboček") ## Hlavní nastavení Na kartě Hlavní nastavení *(Toret Plugins > One by Allegro > Hlavní nastavení)* dále nastavíte: - automatické objednání a adresu vyzvednutí - formát a reference štítku - ikony pro zobrazení v pokladně (nahrát vlastní, zobrazovat defaultní či nezobrazovat) - výchozí počet a hmotnost balíků - DPH, daňová třída dobírky a vlastní příplatky - nastavení směnných kurzů ## Nastavení dopravců v pluginu One by Allegro V pluginu One můžete nastavit dopravu: - One Courier (doručení na adresu) - One Point (doručení na výdejní místo) - One Box (doručení do boxu) Pokud je ve Woo Commerci nastaveno DPH, cenu doprav v pluginu nastavujte bez DPH. ### One Courier Pod kartou One Courier je možné nastavit dopravu na adresu pro Českou republiku a 34 dalších zemí. ![Plugin Toret One by Allegro - nastavení dopravy One Courier](https://documentation.toret.cz/wp-content/uploads/2024/08/one-courier-1024x231.png "Plugin Toret One by Allegro - nastavení dopravy One Courier") Pro jednotlivé země je možné nastavit: cenu dopravy – jednotně, na základě hmotnosti či rozměrů, nebo ji načítat přes API dopravce --- dopravu zdarma nad částku --- dostupnost dle hodnoty objednávky, hmotnosti, množství produktů v košíku či ceny produktu --- příplatky za dobírku, dobírku zdarma nad částku a maximální povolenou dobírku --- > **Tip:** pokud chcete v pokladně spustit dopravu nebo dobírku zdarma např. od 500,-, v pluginu nastavte 499. Pokud u jednotlivých zemí nevyplníte jednotlivé hodnoty, použijí se jako výchozí ty v hlavním nastavení One Courier*(Toret Plugins > One by Allegro > One Courier > Hlavní nastavení)* ### One Point Na kartě One Point lze nastavit podmínky pro doručování na výdejní místa v **České republice**. Lze nastavit: cenu dopravy – jednotně, na základě hmotnosti či rozměrů, nebo ji načítat přes API dopravce --- dopravu zdarma nad částku --- dostupnost dle hodnoty objednávky, hmotnosti, množství produktů v košíku či ceny produktu --- příplatky za dobírku, dobírku zdarma nad částku a maximální povolenou dobírku --- ### One Box Dopravní službu One Box pro doručování do výdejních boxů je možné nastavit pro **Českou republiku**. Možnosti nastavení jsou stejné jako u předchozích druhů doprav. ## Nastavení dopravních zón Po nastavení dopravců v pluginu One je potřeba nastavit také stejnojmenné dopravce v dopravních zónách WooCommerce. Bez jejich nastavení v zónách dopravy se dopravci z pluginu One v pokladně nezobrazí. Je nutné mít vytvořenou dopravní zónu, do které se přidá dopravní metoda z pluginu One. Dopravní metodu nastavte ve *WooCommerce > Nastavení > Doprava > požadovaná zóna dopravy* *> Přidat způsob dopravy.* ![Plugin Toret One by Allegro - Nastavení dopravních zón](https://documentation.toret.cz/wp-content/uploads/2025/04/gls-nastaveni-dopravni-metody-1024x398.png "Plugin Toret One by Allegro - Nastavení dopravních zón") Vyberte z nabízených způsobů dopravy a klikněte na Pokračovat. ![Plugin Toret One by Allegro - Nastavení dopravních zón](https://documentation.toret.cz/wp-content/uploads/2024/08/one-zony-2.png "Plugin Toret One by Allegro - Nastavení dopravních zón") V dalším kroku zvolte Titulek a Popisek dopravní metody a Stav daně (Zdanitelný nebo Žádný). Klikněte na Create and save. Nový způsob dopravy je vytvořen. ![Plugin Toret One by Allegro - Nastavení dopravních zón](https://documentation.toret.cz/wp-content/uploads/2025/04/one-nastaveni-dopravni-metody-2-1024x542.png "Plugin Toret One by Allegro - Nastavení dopravních zón") ## Podání zásilky z webu do One by Allegro V pluginu máte dvě možnosti podání zásilky do sytému One. **Podání balíku vyžaduje váhu.** Doporučujeme nastavit váhu na úrovni produktů, bez nastavené váhy u produktů nebude fungovat automatické podání zásilek při změně stavu objednávky. ### Manuálně Podat zásilku lze manuálně přes tlačítko v přehledu objednávek nebo v detailu objednávky. ![Plugin Toret One by Allegro - podání zásilky z přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-wedo-podani-zasilky-z-prehledu-objednavek.png "Plugin Toret One by Allegro - podání zásilky z přehledu objednávek")![Plugin Toret One by Allegro - Podání zásilky z detailu objednávky](https://documentation.toret.cz/wp-content/uploads/2024/08/one-odeslani-1024x398.png "Plugin Toret One by Allegro - Podání zásilky z detailu objednávky") ### Automaticky při změně stavu objednávky Automatické podání lze nastavit v pluginu*One by Allegro > Změna stavu objednávky > Vytvoření balíčku při změně stavu objednávky.* Zde nastavíte pro jednotlivé metody platby stavy objednávek, ve kterých dojde automaticky k vytvoření balíčku a odeslání dat do systému One. ![Plugin Toret One by Allegro - automatické podání zásilky](https://documentation.toret.cz/wp-content/uploads/2024/08/one-odeslani-automaticke.png "Plugin Toret One by Allegro - automatické podání zásilky") ## Objednání vyzvednutí balíku Přes plugin je možné si objednat vyzvednutí balíku. Objednávku vyzvednutí je možné provést dvěma způsoby. ### Manuálně V přehledu objednávek je u podaných objednávek do systému One ikona auta. Po kliknutí na ikonu se nad přehledem objednávek zobrazí box s možností výběru datumu, na kdy vyzvednutí balíku objednat. ![Plugin Toret One by Allegro - manuální objednání svozu](https://documentation.toret.cz/wp-content/uploads/2024/08/one-svoz-1024x184.png "Plugin Toret One by Allegro - manuální objednání svozu") Na kartě *Hlavní nastavení* lze povolit funkci *Automaticky naplánovat vyzvednutí v nejbližším možném termínu, pokud vybrané datum není dostupné*. ![Plugin Toret One by Allegro - manuální objednání svozu](https://documentation.toret.cz/wp-content/uploads/2024/08/wedo-svoz-1.png "Plugin Toret One by Allegro - manuální objednání svozu") ### Automatické objednání svozu Na kartě*Hlavní nastavení**> Objednávka vyzvednutí a adresa vyzvednutí* v pluginu One je možné nastavit automatické objednání vyzvednutí zásilky na další den při vytvoření zásilky. ![Plugin Toret One by Allegro - automatické objednání svozu](https://documentation.toret.cz/wp-content/uploads/2024/08/one-svoz-2.png "Plugin Toret One by Allegro - automatické objednání svozu") ## Doprava zdarma Dopravu zdarma nastavíte přímo v pluginu One v nastavení dopravce pro danou zemi (např. *Toret Plugins > One > One Courier > Česká republika*). Nastavení pluginu dopravy zdarma je „nad“ částku, tedy doprava zdarma se na webu aktivuje po překonání nastavené částky v košíku. Např. pokud chcete dopravu zdarma od 500,- tak do pluginu nastavte částku 499. > **Tip:** Pokud máte ve Woo Commerci nastavené DPH, tak se hodnota pro spuštění dopravy zdarma zadává bez DPH. Nastavení částky dopravy zdarma se vztahuje pouze pro produkty, nezapočítává se cena dopravy. PŘÍKLAD: Pokud máte nastavenou dopravu zdarma od 500,- a v košíku je produkt za 450,- + cena dopravy 65,- = 515,- Kč, tak se doprava zdarma neaktivuje. Je potřeba překonat nastavenou cenu produktem – tedy aby se takto nastavená doprava zdarma aktivovala, je zapotřebí vložit do košíku produkt(y) hodnoty minimálně 500,- Kč. ## Tisk štítků Štítky podaných balíků je možné si stáhnout rovnou v administraci webu. V přehledu objednávek najdete u již podaných objednávek do systému One ikonu dokumentu PDF (viz. obrázek). U vybrané objednávky na ni klikněte, štítek se uloží ve formátu PDF a poté jej můžete vytisknout. ![Plugin Toret One by Allegro - tisk štítků z přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-wedo-stazeni-a-tisk-stitku-v-prehledu-objednavek-1-980x39-1.png "Plugin Toret One by Allegro - tisk štítků z přehledu objednávek") U podané zásilky je možné štítek také stáhnout v detailu objednávky. ![Plugin Toret One by Allegro - tisk štítků z detailu objednávky](https://documentation.toret.cz/wp-content/uploads/2024/08/one-stitky.png "Plugin Toret One by Allegro - tisk štítků z detailu objednávky") ## Automatické načítání stavu zásilek V přehledu objednávek ve sloupci „One by Allegro stav“ je uvedeno v jakém stavu se zásilka nachází. Funkce automatického načítání stavu zásilky má své vlastní detailní nastavení, které najdete v sekci*Toret Plugins → One by Allegro → Změna stavu objednávky → Automatické načítání stavu zásilky*. Pokud chcete vidět aktuální stav zásilky, je nutné nastavit CRON, který najdete v nastavení pluginu One by Allegro *→ Změna stavu objednávky. * ![Plugin Toret One by Allegro - automatické načítání stavu zásilek](https://documentation.toret.cz/wp-content/uploads/2024/08/one-cron.png "Plugin Toret One by Allegro - automatické načítání stavu zásilek") **Počet zkontrolovaných objednávek na běh CRONu**– zde si můžete nastavit, kolik objednávek se zkontroluje při jednom běhu CRONu. **Počet dní pro zpětnou kontrolu** – počet dní u objednávek, po který bude stav One balíků zpětně kontrolován. **Nekontrolovat stav zásilky v následujících stavech objednávky** – zde si můžete určit, ve kterých stavech objednávky nebude kontrolován stav balíku u One. ## Změna stavu objednávky na základě stavu zásilky Pokud je v pluginu již nastavená funkce pro automatické načítání stavu zásilek, je možné nastavit změnu stavu objednávky na základě změny stavu zásilky. Funkce změny stavu objednávky podle stavu balíku je v sekci *Toret Plugins → One by Allegro → Změna stavu objednávky → Změna stavu objednávky*. Ke stavům zásilky v systému One (levý sloupec) lze nastavit požadovaný stav objednávky, na který se objednávka změní (v pravém sloupci). ![Plugin Toret One by Allegro - změna stavu objednávky na základě stavu zásilky v přepravě](https://documentation.toret.cz/wp-content/uploads/2024/08/one-zmena-stavu-obj.png "Plugin Toret One by Allegro - změna stavu objednávky na základě stavu zásilky v přepravě") ## Filtry pro omezování dostupných typů produktu pro výpočet celkové hmotnosti – tone_disabled_weight_types --- ## Testování pluginu Pro účely testování můžete využít: - subdoménu “dev.doménalicence” (se stejnou licencí jako pro produkční web) - localhost (127.0.0.1) Na těchto umístěních budou zakoupené pluginy fungovat také a můžete zde otestovat implementaci a kompatibilitu před ostrým nasazením na web i v průběhu jeho užívání. ## Časté dotazy ### Chyba: Unexpected status: 22:Přihlášený uživatel nemá oprávnění používat XML server. Dle vypsané chyby jste ještě u One neprošli ověřovacím procesem v testovacím režimu a nezískali jste ostré implementační údaje. Abyste mohli používat One v ostrém provozu je třeba projít ověřovacím proces pro podání zásilek. 1. U podpory One si vyžádejte testovací ID zákazníka nastaveného v účtu One. 2. Do pluginu vložte kromě uživatelského jména a hesla také testovací implementační údaje a zapněte testovací mód. 3. One vyžaduje v testovacím prostředí provést 8 zkušebních objednávek: 1. Dvě české (jednu s dobírkou, jednu bez dobírky) 2. Dvě slovenské (jednu s dobírkou, jednu bez dobírky) 3. Dvě zásilky na výdejní místa( 1 s dobírkou, 1 bez dobírky) 4. Dvě EURODIS zásilky (jednu s dobírkou, jednu bez dobírky). EURODIS zásilky jsou zahraniční (vyjma Slovenska), například Německo nebo Francie. 4. Po vytvoření osmi testovacích objednávek zašlete podpoře One čísla všech osmi zásilek pro kontrolu (postačí zaslat štítky podaných balíků). 5. Jakmile One štítky ověří, zašle ostré implementační údaje pro napojení (ID zákazníka) a posledním krokem je vložení těchto ostrých implementačních údajů do pluginu a poté je nutné vypnout testovací mód.