--- site_name: Toret dokumentace site_url: https://documentation.toret.cz contact_email: info@toret.cz title: Dokumentace pluginu Toret TOPTRANS url: https://documentation.toret.cz/toptrans/ date: 2024-06-21 modified: 2026-07-03 author: tcirkl type: page --- # Dokumentace pluginu Toret TOPTRANS Nacházíte se na stránkách dokumentace pluginu TOPTRANS pro WooCommerce, který implementuje tohoto dopravce do e-shopu. Plugin TOPTRANS zakoupíte zde: [Toret TOPTRANS pro WooCommerce](https://toret.cz/produkt/toptrans/) Obsah 1. Instalace pluginu 2. Aktivace pluginu 3. Napojení na TOPTRANS 4. Hlavní nastavení - Nastavení API pro Mapy.com 5. Nastavení dopravců v pluginu TOPTRANS - Služba Top Comfort 6. Nastavení dopravních zón 7. Podání zásilky z webu do TOPTRANS - 1. Manuálně přes tlačítko v přehledu objednávek nebo v detailu objednávky - - 2. Automatické odeslání balíku při změně stavu objednávky 8. Doprava zdarma - Doprava zdarma pouze pro vybrané produkty 9. Tisk štítků 10. Dobírka 11. Zobrazení stavu zásilek - Manuální aktualizace stavu zásilky - - Automatická aktualizace stavu zásilky 12. Filtry - Filtry pro rozměry balíku 13. 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 TOPTRANS, do příslušného pole vložíte licenční klíč a tlačítkem aktivujte. ![Plugin Toret TOPTRANS - aktivace](https://documentation.toret.cz/wp-content/uploads/2024/08/toptrans-licence.png "Plugin Toret TOPTRANS - aktivace") ## Napojení na TOPTRANS Pro použití pluginu TOPTRANS, musíte mít vytvořený účet u [zp.toptrans.cz](https://zp.toptrans.cz/). Po nainstalování a aktivaci pluginu pokračujte na jeho nastavení. To se nachází v sekci *Toret plugins → TOPTRANS*. Pro propojení pluginu s účtem TOPTRANS je potřeba v pluginu vyplnit přihlašovací údaje do TOPTRANS účtu: - Uživatelské jméno - Heslo ![Plugin Toret TOPTRANS - napojení na API](https://documentation.toret.cz/wp-content/uploads/2024/08/toptrans-api.png "Plugin Toret TOPTRANS - napojení na API") ## Hlavní nastavení Kromě nastavení přístupu do API najdete na hlavní stránce pluginu *(Toret Plugins > TOPTRANS > Hlavní nastavení)* globální nastavení: - Nastavení plateb – pro přijímání plateb na dobírku - Automatické odeslání balíku při změně stavu objednávky - Nastavení ikon v pokladně – ikony lze nahrát vlastní, zobrazovat výchozí nebo nezobrazovat - Hlavní nastavení - služby Top Comfort - výchozích hodnot pro popis, hmotnost a rozměry balíku - dialogu v administraci a avizací - Nastavení cen – DPH, zahrnutí poplatků do ceny přepravy, daňová třída poplatku za dobírku - Nastavení zdroje směnných kurzů - Nastavení API pro Mapy.com (pro načítání ceny přepravy dle vzdálenosti) ### Nastavení API pro Mapy.com Aby bylo možné **vypočítávat cenu dopravy podle vzdálenosti**, je třeba plugin propojit s API Mapy.com. To provedete v Hlavním nastavení pluginu *(Toret Plugins > TOPTRANS > Hlavní nastavení > Mapy.com API).* ![Plugin Toret TOPTRANS - Nastavení API pro Mapy.cz](https://documentation.toret.cz/wp-content/uploads/2025/01/vlastni-poborky-mapy-api-1024x172.png "Plugin Toret TOPTRANS - Nastavení API pro Mapy.cz") Pro použití REST API budete potřebovat účet v portále Mapy.com. Přihlášení/registraci provedete [zde](https://developer.mapy.cz/account/). Po [přihlášení v portále](https://developer.mapy.cz/account/) si vytvoříte projekt… ![Nastavení REST API pro Mapy.cz](https://documentation.toret.cz/wp-content/uploads/2025/01/mapy-projekt-1-1024x542.png "Nastavení REST API pro Mapy.cz") …a získáte API klíč. V přehledu projektu uvidíte také dostupné kredity a jejich čerpání, příp. cenu za nákup dalších. V Základním tarifu je k dispozici zdarma 250 000 kreditů na měsíc. ![Nastavení REST API pro Mapy.cz](https://documentation.toret.cz/wp-content/uploads/2025/01/mapy-api-1-1024x542.png "Nastavení REST API pro Mapy.cz") Zkopírovaný API klíč vložte do pole REST API key v pluginu a klikněte na Uložit. [Více informací o REST API (Mapy.com)](https://developer.mapy.cz/rest-api/) ## Nastavení dopravců v pluginu TOPTRANS Jednotlivé dopravní metody najdete v pluginu na kartách v horní části obrazovky *(Toret Plugins > TOPTRANS)*. K dispozici jsou tyto metody dopravy: - Standard (běžná doba doručení do 24 h od převzetí) - TOPTIME (dopolední doručení do 12:00) - TOP-PRIVAT (večerní doručení 16:00-20:00) - TOP-WEEKEND (sobotní doručení – do 13:00) - ROZVOZ PO AVIZACI (dovoz po předchozí telefonické domluvě dopravce se zákazníkem) Všechny typy doprav je možné nastavit pro Českou republiku a Slovensko. Pokud je ve Woo Commerci nastaveno DPH, tak cenu v pluginu nastavujte bez DPH. ![Plugin Toret TOPTRANS - nastavení dopravců](https://documentation.toret.cz/wp-content/uploads/2024/08/toptrans-nastaveni-1024x562.png "Plugin Toret TOPTRANS - nastavení dopravců") **Pod jednotlivými kartami doprav TOPTRANS je možné nastavit:** - maximální hmotnost a maximální rozměr objednávky - kontrolu rozměrů a hmotnosti - dopravu zdarma nad částku a pro konkrétní produkty - nastavení ceny dopravy - jednotně - podle celkové hmotnosti objednávky - podle rozměrů objednávky - na základě vzdálenosti a hmotnosti - načítáním z API - cenu dobírku jednotně nebo podle ceny objednávky - dobírku zdarma nad částku - přejmenování jednotlivých dopravců je možné v dopravní zóně WooCommerce přímo v editaci dopravce > **Tip:** pokud chcete v pokladně spustit dopravu nebo dobírku zdarma např. od 500, v pluginu nastavte 499. ### **Služba Top Comfort** V pluginu *(Toret Plugins > TOPTRANS > Hlavní nastavení)* je možné ke všem dopravním metodám nastavit službu Top Comfort. Jedná se o výnos zásilky do patra za aktivní asistence příjemce, max. 80 kg/1 ks. Nad 80 kg se účtuje za každých započatých 80 kg příplatek. U této služby je možné nastavit: - Text služby - Příplatek za službu - Štítek příplatku ![Plugin Toret TOPTRANS - nastavení služby TOP COMFORT](https://documentation.toret.cz/wp-content/uploads/2024/08/toptrans-top-comfort.png "Plugin Toret TOPTRANS - nastavení služby TOP COMFORT")![Plugin Toret TOPTRANS - zobrazení služby a příplatku TOP COMFORT v pokladně](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-top-comfort-v-pokladne.png "Plugin Toret TOPTRANS - zobrazení služby a příplatku TOP COMFORT v pokladně") ## Nastavení dopravních zón Po nastavení dopravců v pluginu TOPTRANS 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 TOPTRANS v pokladně nezobrazí. Je nutné mít vytvořenou dopravní zónu, do které se přidá dopravní metoda z pluginu TOPTRANS. Dopravní metodu nastavte ve *WooCommerce > Nastavení > Doprava > požadovaná zóna dopravy* *> Přidat způsob dopravy.* ![Plugin Toret TOPTRANS - nastavení dopravních zón](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-dopravni-zony-980x575-1.png "Plugin Toret TOPTRANS - nastavení dopravních zón") Vyberte z nabízených způsobů dopravy a klikněte na Pokračovat. ![Plugin Toret TOPTRANS - nastavení dopravních zón](https://documentation.toret.cz/wp-content/uploads/2024/08/toptrans-zony-dopravy.png "Plugin Toret TOPTRANS - 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 TOPTRANS - nastavení dopravních zón](https://documentation.toret.cz/wp-content/uploads/2025/04/TOPTRANS-nastaveni-dopravni-metody-1024x553.png "Plugin Toret TOPTRANS - nastavení dopravních zón") ## Podání zásilky z webu do TOPTRANS V pluginu máte dvě možnosti podání zásilky do sytému TOPTRANS. > Pozor! Neposílejte objednávku do systému TOPTRANS, pokud nejste připraveni balíček odeslat. Podáním balíku dáváte společnosti TOPTRANS najevo, že máte balík připraven k vyzvednutí kurýrem. ### **1.** Manuálně přes tlačítko v přehledu objednávek nebo v detailu objednávky ![Plugin Toret TOPTRANS - podání zásilky z přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-TOPTRANS-podani-zasilky-z-prehledu-objednavek.png "Plugin Toret TOPTRANS - podání zásilky z přehledu objednávek")![Plugin Toret TOPTRANS - podání zásilky z detailu objednávky](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-TOPTRANS-podani-zasilky-z-detailu-objednavky.png "Plugin Toret TOPTRANS - podání zásilky z detailu objednávky") K podání je možné využít tlačítka Odeslat balíček (a) nebo Uložit balíček (b). **Odeslat balíček**: Slouží k úplnému odeslání zásilky – tzn. pošle data do systému, vytvoří se štítek, sledovací číslo a požadavek na dopravce. **Uložit balíček:** Pouze přenese data do systému Toptrans. Objednávku uvidíte ve svém Toptrans účtu (v sekci Nepotvrzené) a můžete tam objednávku dopravy ještě editovat. Dokončit objednání dopravy lze přímo z Toptrans účtu i z administrace e-shopu (Po uložení bude v administraci e-shopu dále viditelné tlačítko Odeslat balíček, takže lze i poté dopravu potvrdit a dogenerovat štítky) ### **2.** Automatické odeslání balíku při změně stavu objednávky Automatické podání lze nastavit v pluginu *(Toret plugins > TOPTRANS > Hlavní nastavení).* V případě automatického podání dochází k úplnému odeslání (vč. vytvoření štítků, přidělení čísla zásilky a objednání dopravy).[](http://documentation2.toret.cz/toptrans/wp-content/uploads/sites/56/2021/12/toret-toptrans-automaticke-podani-baliku.png) ![Plugin Toret TOPTRANS - nastavení automatického podání zásilky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-automaticke-podani-baliku.png "Plugin Toret TOPTRANS - nastavení automatického podání zásilky") ## Doprava zdarma Dopravu zdarma nastavíte přímo v pluginu TOPTRANS u každého dopravce. Nastavení pluginu dopravy zdarma je „nad“ částku, tedy doprava zdarma se na webu aktivuje po překonání nastavení částky v košíku. **PŘÍKLAD:** 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č. ### **Doprava zdarma pouze pro vybrané produkty** V pluginu je možné nastavit dopravu zdarma pouze pro vybrané produkty. Nastavení najdete u každého produktu na kartě TOPTRANS. ![Plugin Toret TOPTRANS - nastavení dopravy zdarma pro produkt](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-doprava-zdarma-pro-jednotlive-produkty-1.png "Plugin Toret TOPTRANS - nastavení dopravy zdarma pro produkt") Dále je nutné v nastavení pluginu u stejnojmeného dopravce tuto funkci povolit. ![Plugin Toret TOPTRANS - nastavení dopravy zdarma pro produkt](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-doprava-zdarma-pro-jednotlive-produkty-nastaveni-v-pluginu.png "Plugin Toret TOPTRANS - nastavení dopravy zdarma pro produkt") ## Tisk štítků Štítky podaných balíků je možné si stáhnout rovnou v administraci webu. V přehledu objednávek u již podané objednávky do systému TOPTRANS klikněte na ikonu dokumentu PDF (viz. obrázek) u vybrané objednávky. Štítek se uloží ve formátu PDF a poté jej můžete vytisknout. ![Plugin Toret TOPTRANS - tisk štítků z přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-tisk-stitku-v-prehledu-objednavek-1024x121-1-1.png "Plugin Toret TOPTRANS - 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 TOPTRANS - tisk štítků z detailu objednávky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-tisk-stitku-v-detailu-objednavky-1-1024x626.png "Plugin Toret TOPTRANS - tisk štítků z detailu objednávky") ## Dobírka U jednotlivých dopravců je možné pro každou zemi nastavit příplatek za dobírku. Aby se příplatek zobrazil v pokladně a předala se informace o tom, že je podaný balíček na dobírku, je nutné v nastavení WooCommerce zapnout platební metodu dobírky z WooCommerce (=cod). V pluginu lze nastavit jednotný příplatek za dobírku a podmínku pro spuštění dobírky zdarma. Také můžete příplatek dobírky škálovat podle celkové ceny objednávky, včetně podmínky pro dobírku zdarma (viz screen). ![Plugin Toret TOPTRANS - nastavení dobírky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-nastaveni-priplatku-dobirky.png "Plugin Toret TOPTRANS - nastavení dobírky") V hlavním nastavení pluginu *(Toret plugins >TOPTRANS > Hlavní nastavení)* je také nutné nastavit bankovní účet pro výplatu dobírky. ![Plugin Toret TOPTRANS - nastavení dobírky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-nastaveni-uctu-pro-dobirku.png "Plugin Toret TOPTRANS - nastavení dobírky") Dále lze v *Hlavním nastavení > Ceny* zadat **daňovou třídu dobírky**. Ta může být fixní nebo se určovat podle produktů v košíku. Také lze **poplatek za dobírku zahrnout do ceny přepravy** a neuvádět jej zvlášť. ![Plugin Toret TOPTRANS - nastavení daňové třídy dobírky](https://documentation.toret.cz/wp-content/uploads/2025/02/toptrans-dobirka-1024x280.png "Plugin Toret TOPTRANS - nastavení daňové třídy dobírky") ## Zobrazení stavu zásilek Plugin obsahuje funkci, která umožňuje v přehledu objednávek ve sloupci „Toptrans stav“ sledovat aktuální stav zásilky. ![Plugin Toret TOPTRANS - zobrazení stavu zásilek v přepravě](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-stav-zasilky-1024x121-1.png "Plugin Toret TOPTRANS - zobrazení stavu zásilek v přepravě") ### **Manuální aktualizace stavu zásilky** Stav zásilky můžete aktualizovat manuálně přes ikonu „refresh“. Manuální aktualizaci můžete spustit v přehledu objednávek jednotlivě u každé objednávky nebo v detailu objednávky. ![Plugin Toret TOPTRANS - manuální aktualizace stavu zásilky v přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-stav-zasilky-manualni-aktualizace-1024x121-1.png "Plugin Toret TOPTRANS - manuální aktualizace stavu zásilky v přehledu objednávek")![Plugin Toret TOPTRANS - manuální aktualizace stavu zásilky v detailu objednávky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-manualni-aktualizace-v-detailu-objednavky-1024x626-1-1.png "Plugin Toret TOPTRANS - manuální aktualizace stavu zásilky v detailu objednávky") ### **Automatická aktualizace stavu zásilky** Pokud chcete aktualizaci stavů zásilek automatizovat, je nutné nastavit na hostingu CRON. Vlastní URL CRONu najdete v hlavním nastavení pluginu. ![Plugin Toret TOPTRANS - automatické načítání stavu zásilky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-url-cronu-1024x385-1.png "Plugin Toret TOPTRANS - automatické načítání stavu zásilky") ## Filtry ### Filtry pro rozměry balíku - ttt_pack_width - ttt_pack_height - ttt_pack_length Parametry: $rozmer, $order, $balik a $pocet_baliku ## 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í.