--- site_name: Toret dokumentace site_url: https://documentation.toret.cz contact_email: info@toret.cz title: Dokumentace pluginu Toret ybox24 url: https://documentation.toret.cz/dokumentace-pluginu-toret-ybox24/ date: 2025-09-17 modified: 2025-09-30 author: mantinova type: page --- # Dokumentace pluginu Toret ybox24 Nacházíte se na stránkách dokumentace pluginu, který do e-shopu integruje službu ybox24. Pro používání této služby je nutné uzavřít smlouvu se společností [ybox24](https://ybox24.com/). Plugin ybox24 zakoupíte zde: [Toret ybox24 pro WooCommerce](https://toret.cz/produkt/ybox24/) Obsah 1. Instalace pluginu 2. Aktivace pluginu 3. Napojení na službu ybox24 4. Hlavní nastavení pluginu - Sazby a daně - - Vlastní příplatky - - Nastavení widgetu s mapou - - Nastavení ikon v pokladně - - Ostatní nastavení 5. Nastavení dopravy ybox24 - Nastavení dopravních zón - - Nastavení způsobu dopravy - - Typy objednávek způsobu dopravy – doprava zdarma a paušální cena 6. Podání zásilky - Manuální podání přes tlačítko v přehledu objednávek nebo v detailu objednávky - - Hromadné podání - - Automatické odeslání při změně stavu objednávky 7. Objednání svozu - Manuální objednání svozu v přehledu a detailu objednávky - - Objednání svozu hromadnou akcí - - Automatické objednání svozu 8. Sledování zásilek - Automatické načítání stavu zásilky 9. Změna stavu objednávky na základě změny stavu zásilky 10. Vypnutí dopravce pro produkt, variantu, kategorii 11. Testování pluginu ## Instalace pluginu Po zakoupení pluginu obdržíte emailem 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 Toret ybox24, do příslušného pole vložíte licenční klíč a uložte. ![Plugin Toret ybox24 - aktivace pluginu](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-overeni-licence-1024x583.png "Plugin Toret ybox24 - aktivace pluginu") ## Napojení na službu ybox24 Pro použití pluginu Toret ybox24 je nutné mít vytvořený účet u společnosti ybox24 (https://ybox24.com/). Pro napojení pluginu k API budou potřeba implementační údaje: 1. ID uživatele 2. API klíč Tyto údaje obdržíte přímo od společnosti ybox24. Implementační údaje zadáte v nastavení pluginu *Toret plugins → ybox24 →* karta *Hlavní nastavení*. ![Plugin Toret ybox24 - napojení na API](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-implementace.png "Plugin Toret ybox24 - napojení na API") ## Hlavní nastavení pluginu Následující funkce najdete na kartě *Hlavní nastavení (Toret Plugins > ybox24 > Hlavní nastavení)*. ### Sazby a daně V této sekci nastavíte, zda ceny za dopravu budete nastavovat s či bez DPH. ![Plugin Toret ybox24 - nastavení DPH u ceny dopravy](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-dane.png "Plugin Toret ybox24 - nastavení DPH u ceny dopravy") ### Vlastní příplatky Příplatky lze nastavit: - globálně - pro produkt/variantu - pro kategorii - pro doručení do ybox24 Příplatky mohou být lze násobit počtem či započítat jednorázově a také nastavit jejich viditelnost v pokladně. ![Plugin Toret ybox24 - nastavení vlastních příplatků](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-vlastni-priplatky-1024x256.png "Plugin Toret ybox24 - nastavení vlastních příplatků") Příplatky pro produkt/variantu nebo kategorii je nutné ještě povolit v detailu produktu/varianty nebo kategorie. ![Plugin Toret ybox24 - Nastavení příplatku v detailu produktu](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-priplatek-detail-produktu.png "Plugin Toret ybox24 - Nastavení příplatku v detailu produktu") ### Nastavení widgetu s mapou Pro widget s mapou je možné v Hlavním nastavení nastavit: automatické otevření widgetu při výběru dopravy (zákazník nemusí klikat pro otevření mapky) --- použití adresy výdejního místa jako dodací (zákazník nemusí vyplňovat svoji adresu, automaticky se vyplní adresa boxu) --- umístění tlačítka pro otevření widgetu (pod seznamem dopravních metod nebo přímo u dané metody) --- ![Plugin Toret ybox24 - nastavení widgetu s mapou](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-nastaveni-widgetu-1024x375.png "Plugin Toret ybox24 - nastavení widgetu s mapou") ### Nastavení ikon v pokladně V této sekci lze nastavit, zda se u dopravní metody ybox24 a u tlačítka pro otevření widgetu bude zobrazovat ikona a nastylovat je pomocí CSS. Vlastní ikonu můžete nahrát v nastavení dopravce (viz dále). Plugin také obsahuje výchozí ikony, které se zobrazí, pokud vlastní nezadáte. ![Plugin Toret ybox24 - nastavení ikon v pokladně](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-nastaveni-ikon-v-pokladne-1024x537.png "Plugin Toret ybox24 - nastavení ikon v pokladně") ### Ostatní nastavení V sekci *Hlavní nastavení > Ostatní nastavení* můžete aktivovat/deaktivovat log pluginu a podrobný API log. ![Plugin Toret ybox24 - aktivace logu](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-ostatni-nastaveni.png "Plugin Toret ybox24 - aktivace logu") ## Nastavení dopravy ybox24 Nastavení dopravy ybox24 provedete na kartě *Dopravci*. Nejprve je nutné nastavit způsob dopravy v dopravních zónách, následně je možné přikročit k samotnému nastavení dopravy. ### Nastavení dopravních zón Do nastavení dopravních zón se můžete prokliknout přímo z karty Dopravci > Nastavení dopravních zón. Bez nastavení způsobu dopravy v zónách dopravy se v pokladně nezobrazí. ![Plugin Toret ybox24 - nastavení dopravních zón](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-nastaveni-dopravnich-zon.png "Plugin Toret ybox24 - nastavení dopravních zón") Je nutné mít ve WooCommerce vytvořenou dopravní zónu, do které se přidá dopravní metoda ybox24. Vyberte zónu a klikněte na *Přidat způsob dopravy > ybox24 > Pokračovat.* Služba ybox je v současnosti dostupná pouze pro Česko. ![Plugin Toret ybox24 - nastavení dopravních zón](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-dopravni-zony.png "Plugin Toret ybox24 - nastavení dopravních zón")![Plugin Toret ybox24 - nastavení dopravních zón](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-dopravni-zony-2.png "Plugin Toret ybox24 - nastavení dopravních zón") Nový způsob dopravy je vytvořen. Nyní můžete nastavit dopravu v pluginu. ### Nastavení způsobu dopravy Níže na kartě Dopravci můžete nastavit parametry dopravy. Klikněte na *Nastavení* u dané země. ![Plugin Toret ybox24 - nastavení způsobu dopravy](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-nastaveni-dopravy-1024x381.png "Plugin Toret ybox24 - nastavení způsobu dopravy") Nyní můžete nastavit: - typy objednávek způsobu dopravy - vlastní titulek (text, který se zobrazí zákazníkům v pokladně) - vlastní ikony - v pokladně (ikona se zobrazí u způsobu dopravy) - místa vyzvednutí v pokladně (ikona se zobrazí u tlačítka pro otevření widgetu s mapou) - dostupnost dopravy **Dostupnost dopravy** lze omezit hmotností, rozměrem, objemem, hodnotou nebo množstvím košíku a cenou produktu. Pokud objednávka některému omezení nevyhoví, způsob dopravy se zákazníkovi v pokladně nenabídne. ![Plugin Toret ybox24 - nastavení způsobu dopravy](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-nastaveni-dopravy-2-1024x694.png "Plugin Toret ybox24 - nastavení způsobu dopravy") ### Typy objednávek způsobu dopravy – doprava zdarma a paušální cena **Ve výchozím stavu**je doprava v ybox24 hrazena zákazníkem při převzetí zásilky přímo dopravci. K objednání i úhradě potřebuje zákazník aplikaci ybox24 a cena se stanovuje dle doby uložení zásilky v boxu. V sekci Typy objednávek způsobu dopravy můžete nastavit **dopravu zdarma a paušální cenu.** V případě těchto doprav **zákazník platí cenu dopravy přímo e-shopu** (a e-shop následně dopravci) a**nepotřebuje aplikaci ybox24**. **Pro povolení dopravy zdarma** zaškrtněte checkbox „Povolení dopravy zdarma (ybox24 – Metoda Zdarma)“ a zadejte hodnotu objednávky, od které bude doprava zdarma. **Pro povolení paušální ceny** zaškrtněte checkbox „Povolení paušální ceny dopravy (ybox24 – Metoda E-shop)“ a zadejte cenu dopravy. ![Toret plugin ybox24 - Typy objednávek způsobu dopravy](https://documentation.toret.cz/wp-content/uploads/2025/09/Toret-plugin-ybox24-Typy-objednavek-zpusobu-dopravy-1024x416.png "Toret plugin ybox24 - Typy objednávek způsobu dopravy") ## Podání zásilky V pluginu máte tři možnosti podání zásilky do systému ybox24. ### Manuální podání přes tlačítko v přehledu objednávek nebo v detailu objednávky ![Plugin Toret ybox24 - podání zásilky z přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox-podani-zasilky.png "Plugin Toret ybox24 - podání zásilky z přehledu objednávek")![Plugin Toret ybox24 - podání zásilky z detailu objednávky](https://documentation.toret.cz/wp-content/uploads/2025/09/Upravit-objednavku-Order-%E2%80%93-10-zari-2025-04-07-PM-%E2%80%B9-Toret-dev-start-%E2%80%94-WordPress-09-16-2025_03_17_PM.png "Plugin Toret ybox24 - podání zásilky z detailu objednávky") ### Hromadné podání Přes hromadné akce v přehledu objednávek lze podat do ybox24 více objednávek najednou. Postačí označit objednávky k podání a použít hromadnou akci „Vytvořit balíček (ybox24)“. ![Plugin Toret ybox24 - hromadné podání zásilek](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-hromadne-akce.png "Plugin Toret ybox24 - hromadné podání zásilek") ### Automatické odeslání při změně stavu objednávky Automatické podání lze nastavit v pluginu ybox24 → karta *Automatické odesílání*. Zde je ke každé platební metodě možné nastavit stav objednávky, ve kterém se zásilka automaticky podá. ![Plugin Toret ybox24 - nastavení automatického podání zásilek](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-automaticke-odesilani-1024x453.png "Plugin Toret ybox24 - nastavení automatického podání zásilek") ## Objednání svozu Objednat vyzvednutí zásilky je možné manuálně nebo automaticky. ### Manuální objednání svozu v přehledu a detailu objednávky Manuální objednání provedete kliknutím na tlačítko *Připravena k výdeji* v přehledu nebo detailu objednávky. ![Plugin Toret ybox24 - manuální objednání svozu v přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-manualni-objednani-svozu.png "Plugin Toret ybox24 - manuální objednání svozu v přehledu objednávek")![Plugin Toret ybox24 - manuální objednání svozu v detailu objednávky](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-manualni-objednani-svozu-2.png "Plugin Toret ybox24 - manuální objednání svozu v detailu objednávky") ### Objednání svozu hromadnou akcí Objednání svozu je možné provést také hromadnou akcí v přehledu objednávek – akce *Označit balíček jako připravený (ybox24).* ![Plugin Toret ybox24 - hromadné objednání svozu z přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-objednani-svozu-hromadne-1024x476.png "Plugin Toret ybox24 - hromadné objednání svozu z přehledu objednávek") ### Automatické objednání svozu Pokud chcete objednávat svoz automaticky již při vytvoření zásilky v systému, lze to nastavit v Hlavním nastavení pluginu. ![Plugin Toret ybox24 - nastavení automatického objednání svozu](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-automaticke-objednavani-svozu.png "Plugin Toret ybox24 - nastavení automatického objednání svozu") ## Sledování zásilek Po vytvoření objednávky s vyzvednutím v ybox24 se zobrazí**informace o vybrané pobočce** v: - e-mailech - na děkovné stránce - v administraci objednávek **Stav balíčku** v přepravě můžete sledovat v přehledu i detailu objednávek. Tento stav lze načítat manuálně kliknutím na tlačítko nebo automaticky (viz dále) ![Plugin Toret ybox24 - sledování zásilky z přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-sledovani-zasilky-1024x115.png "Plugin Toret ybox24 - sledování zásilky z přehledu objednávek")Tlačítko pro načtení stavu a zobrazení stavu v přehledu objednávek![Plugin Toret ybox24 - sledování zásilky z detailu objednávky](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-sledovani-zasilky-2-1024x206.png "Plugin Toret ybox24 - sledování zásilky z detailu objednávky")Tlačítko pro načtení stavu a zobrazení stavu v detailu objednávky ### Automatické načítání stavu zásilky Abyste u každé objednávky viděli její aktuální stav, můžete jej načítat automaticky pomocí CRONu. Url pro CRON najdete přímo v pluginu na kartě *Sledování* a nastavíte jej na svém hostingu. V pluginu dále nastavte počet dní pro zpětnou kontrolu a vylučte stavy objednávek a stavy zásilek, které se kontrolovat nebudou. ![Plugin Toret ybox24 - nastavení automatického načítání stavu zásilek](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-automaticke-nacitani-stavu-zasilek-1024x446.png "Plugin Toret ybox24 - nastavení automatického načítání stavu zásilek") Aktuální stav zásilky se pak bude zobrazovat v detailu i přehledu objednávek. ## Změna stavu objednávky na základě změny stavu zásilky Plugin umožňuje také automatickou změnu stavu objednávky na základě změny stavu zásilky. Pro tuto funkci doporučujeme mít aktivní [automatické načítání stavu zásilky.](https://documentation.toret.cz/#automaticke-nacitani-stavu) Tuto funkci nastavíte níže na kartě*Sledování.* Zapněte funkci (checkbox Povolit změnu stavu objednávky na základě stavu zásilky) a k jednotlivým stavům zásilky (levý sloupec) přiřaďte stavy objednávky v roletkách. Uložte. ![ybox24 automatická změna stavu objednávky](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-automaticka-zmena-stavu-objednavky.png "ybox24 automatická změna stavu objednávky") ## Vypnutí dopravce pro produkt, variantu, kategorii Pomocí pluginu si můžete vypnout doručování dopravcem pro vybraný produkt, variantu či kategorii. Pokud zákazník bude mít takovou položku v košíku, dopravce ybox24 se v pokladně nenabídne. Nastavení najdete při úpravě konkrétního produktu v boxu Data produktu a záložce ybox24. ![Plugin Toret ybox24 - nastavení vypnutí dopravce pro produkt](https://documentation.toret.cz/wp-content/uploads/2025/09/ybox24-zakazani-dopravce-pro-produkt.png "Plugin Toret ybox24 - nastavení vypnutí dopravce pro produkt") Podobně lze nastavit vypnutí dopravy v detailu varianty či kategorie. ## 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í.