Nacházíte se na stránkách dokumentace pluginu FOFR pro WooCommerce, který implementuje tuto službu dopravy do e-shopu.
- Instalace pluginu
- Aktivace pluginu
- Napojení na FOFR
- Nastavení dopravy v pluginu FOFR
- Nastavení dopravních zón
- Podání zásilky z webu do FOFR
- Doprava zdarma
- Tisk štítků
- Dobírka
- Zobrazení stavu zásilek
- Sledování zásilek
- Automatická změna stavu objednávky na základě stavu zásilky
- Ostatní nepovinné nastavení
- Časté dotazy
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.
Aktivace pluginu
Po instalaci pluginu si otevřete plugin FOFR, do příslušného pole vložte licenční klíč a tlačítkem Ověřit aktivujte.
![](https://documentation.toret.cz/wp-content/uploads/2024/08/fofr.png)
Napojení na FOFR
Pro použití pluginu FOFR, je nutné mít vytvořený účet u objednavky.fofrcz.cz/registrace.
Po nainstalování a aktivaci pluginu pokračujte na jeho nastavení. To se nachází v sekci Toret plugins → FOFR
Pro napojení pluginu s účtem FOFR je potřeba v pluginu vyplnit vlastní přihlašovací údaje do FOFR účtu:
- Uživatelské jméno
- Kód pobočky (bez #)
- ID společnosti
![](https://documentation.toret.cz/wp-content/uploads/2024/08/fofr-api.png)
Implementační údaje najdete v účtu FOFR objednavky.fofrcz.cz vpravo nahoře.
![Toret Fofr – implementační údaj Uživatel](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-implementacni-udaj-uzivatel.png)
Kód pobočky do pluginu vkládejte bez křížku – #. Vkládejte pouze číselný kód.
![Toret Fofr – implementační údaje ID společnosti a Kód pobočky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-implementacni-udaje-id-spolecnosti-a-kod-pobocky.png)
Aby bylo možné zásilky podávat, je nutné v nastavení pluginu na kartě „Hlavní nastavení“ uložit alespoň jednu adresu odesílatele.
![Toret FOFR – adresa odesílatele](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-adresa-odesilatele-1024x374-1.png)
Nastavení plátce balíku
Na kartě „Hlavní nastavení“ v části „Výchozí nastavení balíčku“ je nastavení „Plátce balíčku„. Zde vyberte typ plátce. Pokud nevíte, zda jste odesílatel nebo zadavatel, ověřte si svou roli u podpory FOFR.
![Toret FOFR – nastavená plátce balíku](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-nastavena-platce-baliku-1024x616-1.png)
Nastavení dopravy v pluginu FOFR
V pluginu FOFR můžete nastavit pro doručení v rámci České republiky dopravu:
- MODUL F
- MODUL B
- MODUL C
- MODUL N
- MODUL S
Pro doručení do zahraničí je v pluginu doprava:
- MODUL Z
Doprava MODUL Z podporuje nastavení doručení do 18 zemí.
Pod jednotlivými kartami doprav FOFR je možné nastavit:
- cena dopravy
- jednotná cena
- škálovat ceny dopravy podle celkové hmotnosti objednávky, nebo na základě rozměrů
- kalkulace ceny dopravy podle API
- dopravu zdarma nad částku
- dobírka
- jednotný příplatek
- škálovat příplatek dobírky podle celkové ceny objednávky
- dobírka zdarma nad částku
- dostupnost dopravní metody (podmínky pro její zobrazení v pokladně)
- dle minimální a maximální hodnoty objednávky
- dle minimálního a maximálního množství produktů v košíku
- dle minimální a maximální ceny produktu
- dle minimální a maximální hmotnosti košíku
![Toret FOFR – příklad nastavení ceny dopravy a dobírky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-priklad-nastaveni-ceny-dopravy-a-dobirky-1024x758-1.png)
Tip: pokud chcete v pokladně spustit dopravu nebo dobírku zdarma např. od 500, v pluginu nastavte hodnotu 500.
V nastavení dopravy MODUL Z je tabulka „Hlavní nastavení“. Zde je možné nastavit globální hodnoty pro všechny aktivní země v dané dopravě. Ty se použijí jako výchozí, pokud nejsou nastaveny hodnoty u konkrétní země. Cena dopravy se vždy nastavuje v tabulce u aktivované země (níže).
![Toret FOFR – globální nastavení dopravy](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-globalni-nastaveni-dopravy-1024x689-1.png)
Přejmenování dopravy
Přejmenování jednotlivých dopravců je možné v dopravní zóně WooCommerce přímo v editaci dopravce (viz níže).
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-editace-nazvu-dopravy-zobrazujiciho-se-v-pokadne-1024x492-1.png)
Nastavení dopravních zón
Po nastavení dopravy v pluginu FOFR je potřeba nastavit stejnojmenné dopravce v dopravních zónách WooCommerce. Bez jejich nastavení v zónách dopravy se dopravci z pluginu FOFR v pokladně nezobrazí.
![Toret FOFR – Přidání dopravy FOFR do dopravní zóny](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-pridani-dopravy-fofr-do-dopravni-zony-1024x478-1.png)
![Toret FOFR – Nastavení dopravy v dopravní zóně](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-nastaveni-dopravy-v-dopravni-zone.png)
Podání zásilky z webu do FOFR
V pluginu jsou tři možnosti podání zásilky do sytému FOFR.
Pozor! Neposílejte objednávku do systému FOFR, pokud nejste připraveni balíček odeslat. Podáním balíku dáváte společnosti FOFR najevo, že máte balík připraven k vyzvednutí kurýrem.
Manuální podání
1) Manuálně přes tlačítko v přehledu objednávek nebo v detailu objednávky
![Toret FOFR – Podání zásilky z přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-podani-zasilky-z-prehledu-objednavek-1024x99-1.png)
![Toret FOFR – Podání zásilky z detailu objednávky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-podani-zasilky-z-detailu-objednavky-1024x310-1.png)
Po kliknutí na tlačítko se zobrazí dialogové okno, které umožňuje doplnit či změnit atributy zásilky.
![](https://documentation.toret.cz/wp-content/uploads/2024/08/fofr-pop-up.png)
Zobrazování tohoto dialogového okna lze zakázat v Hlavním nastavení pluginu, v sekci Vyskakovací okna. V takovém případě ale musíte mít atributy přednastavené (Hlavní nastavení > Výchozí nastavení balíčku).
2) Manuálně přes hromadné akce v přehledu objednávek.
U hromadného podání je nutné vybrat objednávky a použít hromadnou akci „Vytvoření balíčku FOFR“.
Při podání přes hromadné akce se neotevře okno s atributy zásilky. Je tedy nutné mít přednastavené atributy v Hlavním nastavení pluginu v sekci Výchozí nastavení balíčku.
![Toret FOFR – Hromadné podání zásilek z přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2024/06/screenshot-fofr.toret_.dev-2024.05.28-11_29_04-1024x335-1.png)
Automatické podání při změně stavu objednávky
Třetím způsobem podání je podání automatické na základě změny stavu objednávky. Automatické odeslání lze nastavit v pluginu FOFR → Změna stavu objednávky.
![Toret FOFR – Automatické podání zásilky při změně stavu objednávky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-automaticke-podani-zasilky-pri-zmene-stavu-objednavky-1024x322-1.png)
Doprava zdarma
Dopravu zdarma nastavíte přímo v pluginu FOFR u každého dopravce.
PŘÍKLAD: Pokud chcete dopravu zdarma od 500,- tak do pluginu nastavte částku 500.
Pokud jste plátci DPH, na kartě „Hlavní nastavení“ je možné si aktivovat funkci „Nastavovat ceny včetně DPH“. Poté můžete v pluginu nastavit hodnotu dopravy zdarma vč. 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 splnit podmínku nastavené hodnot pro dopravu zdarma, 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ě FOFR.
![Toret FOFR – Nastavení dopravy zdarma na úrovni produktu](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-nastaveni-dopravy-zdarma-na-urovni-produktu.png)
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 FOFR 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.
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-tisk-stitku-v-prehledu-objednavek-1024x121-1.png)
U podané zásilky je možné štítek také stáhnout v detailu objednávky.
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-tisk-stitku-v-detailu-objednavky-1024x626.png)
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, tak 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. Nebo můžete příplatek dobírky škálovat podle celkové ceny objednávky včetně pravidla s nulovým příplatek dobírky viz screen.
![Toret FOFR – Nastavení dobírky](https://documentation.toret.cz/wp-content/uploads/2024/06/screenshot-fofr.toret_.dev-2024.05.28-13_19_20-1024x539-1.png)
V Hlavním nastavení pluginu je také nutné nastavit bankovní účet pro výplatu dobírky.
![Toret FOFR – Nastavení bankovního účtu pro dobírku](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-nastaveni-bankovniho-uctu-pro-dobirku-1024x274-1.png)
Zobrazení stavu zásilek
Plugin má funkci, která umožňuje zobrazovat aktuální stav zásilky v přehledu objednávek ve sloupci „Stav FOFR“.
![Toret FOFR – stav zásilky v přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2024/06/screenshot-fofr.toret_.dev-2024.05.28-13_32_00-1024x113-1.png)
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.
![Toret FOFR – Manuální aktualizace stavu zásilky v přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-manualni-aktualizace-stavu-zasilky-v-prehledu-objednavek-1024x103-1.png)
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-toptrans-manualni-aktualizace-v-detailu-objednavky-1024x626-1.png)
Automatická aktualizace stavu zásilky
Automatickou aktualizaci nastavíte na kartě Změna stavu objednávky > Automatické načítání stavu zásilky.
Zde je možné nastavit podmínky pro automatickou aktualizaci stavu zásilek. Dále je nutné nastavit na hostingu URL CRONu a pravidelně jej spouštět podle nastavení funkce např. tak, aby se objednávky kontrolovali 1x za hodinu.
![Toret FOFR – Automatické načítání stavu zásilky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-automaticke-nacitani-stavu-zasilky-1024x307-1.png)
Sledování zásilek
Jakmile je zásilka vytvořena, je k ní vytvořen sledovací odkaz, pod kterým jsou uvedeny infomrace o podané zásilce.
Odkaz „Sledovat stav zásilky“ je automaticky přidán do e-mailu zákazníka, který obdrží při změně stavu objednávky. Podmínkou je, že zásilka musí být při změně stavu objednávky již vytvořena.
Odkaz na sledování zásilky je také uveden v přehledu objednávek ve slouci FOFR pod ikonou lupy. Stejné tlačítko je také v detailu objednávky.
![Toret FOFR – tlačítko pro sledování zásilky v přehledu objednávek](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-tlacitko-pro-sledovani-zasilky-v-prehledu-objednavek.png)
![Toret FOFR – tlačítko pro sledování zásilky v detailu objednávky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-tlacitko-pro-sledovani-zasilky-v-detailu-objednavky.png)
Automatická změna stavu objednávky na základě stavu zásilky
Aby bylo možné automaticky měnit stav objednávky podle stavu zásilky v přepravě, je nutné nejprve nastavit funkci Automatické načítání stavu zásilky (viz výše) na kartě Změna stavu objednávky.
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-automaticke-nacitani-stavu-zasilky-1024x307-2.png)
Na stejné kartě (Změna stavu objednávky) je dále nutné aktivovat funkci Povolit změnu stavu objednávky na základě stavu zásilky.
V posledním kroku je potřeba nastavit stav objednávky, na kterou se má objednávka přepnout při aktualizaci stavu zásilky.
![Toret FOFR – Automatická změna stavu objednávky na základě stavu zásilky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-automaticka-zmena-stavu-objednavky-na-zaklade-stavu-zasilky-1024x583-1.png)
Ostatní nepovinné nastavení
Zde najdete ostatní funkce, které plugin obsahuje a jejich nastavení není povinné pro fungování pluginu.
Nastavení pluginu → Hlavní nastavení
Na kartě „Hlavní nastavení“ v nastavení pluginu najdete většinu ostatních funkcí.
Vyskakovací okna
U této funkce je možné vypnout dialogové okno při manuálním odesílání balíčku. Funkce se používá v kombinaci s nastavenou funkcí „Výchozí nastavení balíčku“, ve které si fixně nastavíte hodnoty, které se jinak vyplňují v dialogovém okně.
Dále je možné vypnout dialogové okno při stažení vytvořeného štítku, ve kterém se nastavuje pozice štítku na PDF dokumentu. Tím se rovnou stáhne štítek s pozicí na prvním místě. Případně je možné nastavit výchozí pozici štítku v nastavení pluginu u stejnojmenné funkce – „Výchozí pozice štítku balíčku“.
![Toret FOFR – vyskakovací okna](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-vyskakovaci-okna-1024x214-1.png)
Výchozí nastavení balíčku
Zde je možné nastavit výchozí hodnoty zásilky, které se použijí při podání, pokud objednávka dané hodnoty neobsahuje. Například pokud produkt nemá nastavenou hmotnost a objednávka je bez hmotnosti, doplní se pro zásilku přednastavená hmotnost.
Také je možné přednastavit atributy zásilky jako typ zásilky, označení nebo služby.
![Toret FOFR – výchozí nastavení zásilky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-vychozi-nastaveni-zasilky-1024x529-1.png)
Poznámky a odkazy
Při vytvoření zásilky je možné nastavit poznámku pro odesílatele, příjemce nebo k nákladnímu listu.
Poznámku lze také nastavit pomocí proměnných: {order_id}, {order_number} nebo {customer_note}
![Toret FOFR – Poznámka a odkazy](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-poznamka-a-odkazy-1024x266-1.png)
Štítky
Zde lze nastavit výchozí pozici štítku zásilky pro tisk. Tuto pozici lze také nastavit v dialogovém okně při jednotlivém tisku štítku k zásilce.
![Toret FOFR – nastavení výchozí pozice štítku](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-nastaveni-vychozi-pozice-stitku-2-1024x183-1.png)
![Toret FOFR – výchozí pozice štítku v dialogovém okně](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-vychozi-pozice-stitku.png)
Nastavení ikony pokladny
Plugin obsahuje výchozí ikonu, která se zobrazuje v pokladně před názvem dopravy. Zde je možné zobrazení ikon vypnout nebo si nastavit vlastní ikonu pro jednotlivé dopravní metody. V nastavení pluginu je možné pomocí CSS stylů loga stylovat.
![Toret FOFR – nastavení ikon pokladny](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-nastaveni-ikon-pokladny-1024x464-1.png)
Nastavení směnných kurzů
Pokud by bylo nutné přepočítat hodnotu zásilky do jiné měny, je možné vybrat zdroj směnného kurzu nebo nastavit vlastní sazbu.
![Toret FOFR – Nastavení směnných kurzů](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-nastaveni-smennych-kurzu-1024x173-1.png)
DPH a příplatky
V případě, že je jste plátci DPH a máte ve WooCommerce nastavené DPH, doporučujeme aktivovat funkci „Nastavovat ceny včetně DPH“. Poté je možné v pluginu nastavovat všechny hodnoty vč. DPH.
Další funkcí je možnost vytvořit vlastní příplatky k dopravě.
Nastavení příplatků je velice variabilní. Nastavuje se:
- popis
- cena
- viditelnost v pokladně
Zde je možné vypnout nebo zapnout viditelnost příplatku v pokladně. Pokud je viditelnost poplatku vypnutá, tak se poplatek připočte do ceny dopravy.
- násobit počtem
Je možné nastavit, aby se příplatek započítal za každý kus produktu v košíku. V případě, že je funkce násobku počtem produktů vypnutá, započítá se příplatek pouze jednou pro celou objednávku.
- rozsah
Rozsah příplatků je možné nastavit globálně pro všechny produkty, pro vybrané dopravní metody z pluginu, pro produkty ve vybrané kategorii nebo pro vybrané produkty či varianty.
![](https://documentation.toret.cz/wp-content/uploads/2024/08/fofr-dph.png)
Jakmile je příplatek vytvořený s nastaveným rozsahem pro produkt, zobrazí se v detailu produktu na kartě „Toret FOFR“. Zde jej můžete pro produkt povolit či ne.
![Toret FOFR – Příplatek na úrovni produktu](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-priplatek-na-urovni-produktu.png)
Stejné nastavení je na úrovni každé varianty, pokud je příplatek nastaven s rozsahem pro variantu.
![Toret FOFR – Příplatek na úrovni varianty](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-priplatek-na-urovni-varianty.png)
V případě, že má příplatek nastavený rozsah pro Kategorie, je možné jej povolit v nastavení kategorie nebo při jejím vytvoření.
Nastavení dopravy na úrovni produktu, varianty nebo kategorie
Nastavení dopravy v pluginu je globální pro všechny produkty ve WooCommerce.
Plugin obsahuje možnost nastavit vybrané funkce pro samostatné produkty/varianty.
V nastavení produktu na kartě „Toret FOFR“ jsou jednotlivé roletky s funkcemi. Je možné pro konkrétní produkt:
- nastavit dopravu zdarma
- zakázat vybranou dopravu
- nastavit dobírku zdarma
- fixně nastavit atributy např. „Křehké“
- aktivovat vytvořené poplatky
![](https://documentation.toret.cz/wp-content/uploads/2024/08/fofr-produkt.png)
Stejné nastavení dopravy je na konci každé varianty nebo kategorie.
Časté dotazy
Nevytvořila se zásilka
V případě, že jste plugin nastavili podle dokumentace a vytvoření zásilky se nezdařilo, přejděte do detailu objednávky, vpravo je box FOFR a v něm je odkaz „Zobrazit log pro tuto objednávku“. V logu najdete informace o podané objednávce a chybovou hlášku.
![Toret FOFR – log v detailu objednávky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-log-v-detailu-objednavky-1024x279-1.png)
![Toret FOFR – data v logu objednávky](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-fofr-data-v-logu-objednavky-1024x161-1.png)
Pokud si s chybou v logu nebudete vědět rady, napište nám na podporu.