--- 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: 2026-09-03 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 - API v3 - - API v2 (končící podpora) [Ověřovací proces v testovacím režimu a získání ostrých implementačních údajů – pouze API v2](https://documentation.toret.cz/#ov%C4%9B%C5%99ovac%C3%AD-proces-v-testovac%C3%ADm-re%C5%BEimu-a-z%C3%ADsk%C3%A1n%C3%AD-ostr%C3%BDch-implementa%C4%8Dn%C3%ADch-%C3%BAdaj%C5%AF-pouze-api-v2) --- 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 lze využít: - API V2 (přístupové údaje do portal.wedo.cz) – podpora bude ukončena v r. 2026 - API V3 (přístupové údaje do One Send – onedelivery.cz) – novější, doporučujeme Po nainstalovaní a aktivaci pluginu pokračujte na jeho nastavení. To se nachází v sekci *Toret plugins → One by Allegro*. Vyberte API, kterou chcete využívat. ![Plugin Toret One by Allegro - napojení](https://documentation.toret.cz/wp-content/uploads/2026/08/Plugin-Toret-One-by-Allegro-napojeni-1024x473.png "Plugin Toret One by Allegro - napojení") ### API v3 Pro napojení na API v3 je nutné mít účet (vč. smlouvy) One Send na onedelivery.cz (registrace na [www.onedelivery.cz/registrace](http://www.onedelivery.cz/registrace)). Po úspěšné registraci u One by Allegro si ve svém účtu vygenerujete potřebné údaje: - ID tokenu - API heslo V účtu One Send na onedelivery.cz přejděte na Můj účet > Správa API klíčů a vytvořte nový API přístup. 1. Zadejte jméno (dle potřeby, např, E-shop 1) 2. Klikněte na Vytvořit přístupové údaje ![Plugin Toret One by Allegro - generování tokenu](https://documentation.toret.cz/wp-content/uploads/2026/08/Plugin-Toret-One-by-Allegro-generovani-tokenu-1024x537.png "Plugin Toret One by Allegro - generování tokenu") 3. V následujícím pop-up okně si zkopírujte**ID tokenu a API heslo** (pozor, po zavření okna nelze znovu zobrazit). ![Plugin Toret One by Allegro - generování tokenu](https://documentation.toret.cz/wp-content/uploads/2026/08/Plugin-Toret-One-by-Allegro-generovani-tokenu-2-1024x537.png "Plugin Toret One by Allegro - generování tokenu") 4. Tyto údaje vložte do příslušných polí v pluginu a uložte. Nyní je váš e-shop napojen a je možné pokračovat [Importem odběrných míst.](https://documentation.toret.cz/#import) ![Plugin Toret One by Allegro - vložení tokenu](https://documentation.toret.cz/wp-content/uploads/2026/08/Plugin-Toret-One-by-Allegro-vlozeni-tokenu-1024x473.png "Plugin Toret One by Allegro - vložení tokenu") ### API v2 (končící podpora) Pro napojení pluginu s účtem je potřeba vyplnit přístupové údaje k portal.wedo.cz: - 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ů – pouze API v2 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í aadresu vyzvednutí(povinné) - 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) ### 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ů - 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ů - 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") Podání je možné také přes hromadnou akci v přehledu objednávek. ![Plugin Toret One by Allegro - hromadné podání](https://documentation.toret.cz/wp-content/uploads/2026/08/Plugin-Toret-One-by-Allegro-hromadne-podani-1024x307.png "Plugin Toret One by Allegro - hromadné podání") ### 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") Pro objednání/zrušení vyzvednutí je možné využít také **hromadné akce v přehledu objednávek.** ### 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í čá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") Je možné také stahovat štítky hromadně prostřednictvím hromadné akce. ![Plugin Toret One by Allegro - hromadné stažení štítků](https://documentation.toret.cz/wp-content/uploads/2026/08/Plugin-Toret-One-by-Allegro-hromadne-stazeni-stitku-1024x313.png "Plugin Toret One by Allegro - hromadné stažení štítků") 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 (platí pouze pro API v2). 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.