--- site_name: Toret dokumentace site_url: https://documentation.toret.cz contact_email: info@toret.cz title: Toret PPL plugin documentation url: https://documentation.toret.cz/en/toret-ppl-plugin-documentation/ date: 2026-02-05 modified: 2026-08-20 author: tcirkl type: page --- # Toret PPL plugin documentation You are on the documentation page for the Toret PPL plugin for WooCommerce, which implements this shipping service into your e-shop. **To use the PPL plugin, you must have an account created with PPL.** **Furthermore, you need to request access to the CPL API from PPL. In the request, state that you will use the integrator solution:** **Toret plugins s.r.o.** **Integr ID: 4257736.** You can purchase the PPL plugin here: [Toret PPL for WooCommerce](https://toret.cz/produkt/ppl/) Table Of Contents 1. Plugin Installation 2. Plugin Activation 3. Connecting to PPL 4. Shipment Number Range (my API only) 5. Main Settings 6. Branch Selection Widget Settings (Nastavení widgetu pro výběr poboček) - Generating an API Key for PPL Widget 2.0 (Generování API klíče pro PPL widget 2.0) 7. Setting up Carriers in the PPL Plugin - Price Settings - - Free Shipping - - Free Shipping Coupons - - Cash on Delivery (COD) - - Weight and Dimension Limits - - Availability - - Evening Delivery - - Parcel Return Service (Pick-up at a Parcelshop) 8. Shipping Zone Settings 9. Product and Category Level Settings 10. Shipment Submission from Web to PPL - 1. Manual via button in order overview or order detail - - 2. Submission as a collective action - - 3. Automatic package dispatch upon order status change 11. Ordering Package Pickup - Manual - - Automatic 12. Age Verification 13. Printing Labels - Label Printing Settings with my API - Label Data Settings (Pickup Location Addresses) - Setting Label Format, Note, and Reference Number - - Downloading and Printing Labels - - Bulk printing of labels 14. Automatic Shipment Status Loading - Order Status Change Based on Shipment Status in Transit 15. Customs Declaration 16. FAQ - Custom VAT Rate for COD Surcharge 17. Plugin testing ## Plugin Installation After [purchasing the PPL plugin](https://toret.cz/produkt/ppl/), you will receive a license key and a download link for the plugin zip file via email. You can find detailed instructions on how to install the plugin from your computer into WordPress [here](https://documentation.toret.cz/instalace-pluginu/). ## Plugin Activation After installing the plugin, open the Toret PPL plugin, insert the license key into the appropriate field, and click the button to activate. ![Plugin Toret PPL aktivace 1024x486](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-aktivace-1024x486.png "Plugin Toret PPL aktivace 1024x486") ## Connecting to PPL After installing and activating the plugin, continue to its settings. This is found in the section *Toret plugins → PPL* To connect the plugin with a PPL account, you need to **select the API type for which you have access credentials.** Insert the access credentials into the corresponding fields and save. To connect to the CPL API (Create package label), you need: - Client ID - Client secret ![Plugin Toret PPL napojeni na API PPL 1024x467](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-napojeni-na-API-PPL-1024x467.png "Plugin Toret PPL napojeni na API PPL 1024x467") ## Shipment Number Range (my API only) **Warning:** my API support in the plugin ends on March 31, 2026. After this date, the plugin can only be used with CPL API. Furthermore, it is necessary to request a shipment number range from PPL, which you insert into the plugin settings on the “Hlavní nastavení” (Main Settings) tab. If the shipment number range runs out over time, have it increased by PPL support and update this value in the plugin settings. **This setting is only necessary if you are using the connection via the older API version – my API.** ![Plugin Toret PPL nastaveni cisel zasilek 1024x462](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-cisel-zasilek-1024x462.png "Plugin Toret PPL nastaveni cisel zasilek 1024x462") The number range on the screen is just an example. Request your own from PPL support. ## Main Settings On the Main Settings tab *(Toret plugins > PPL > Hlavní nastavení)*, you can further configure: - Rates and taxes (VAT, COD tax class, free shipping coupon behavior) - Custom surcharges – can be set per product, variant, category, country, shipping, or globally - Labels – format, note, and references - Widget settings – version, opening, button placement, hiding boxes and COD - Pickup addresses for shipment collection by courier (mandatory for pickups) - Displaying icons for individual shipping methods in checkout - Main settings (functions for checkout and email) - Multiple shipments (automatic splitting of order into multiple packages based on weight) ## Branch Selection Widget Settings (Nastavení widgetu pro výběr poboček) With the PPL plugin, it is possible to use two versions of the map widget for branch selection. Widget 1.0 – an older version of the widget with fewer features. It does not require an API key. **(PPL support for widget 1.0 ends on 31 August 2026)** --- Widget 2.0 – a newer version of the widget with more features. It requires a custom API key, which you generate in the PPL administration. --- ![PPL widget 1.0](https://documentation.toret.cz/wp-content/uploads/2026/05/PPL-widget-1.0-1024x486.png "PPL widget 1.0")PPL widget 1.0![PPL widget 2.0](https://documentation.toret.cz/wp-content/uploads/2026/05/PPL-widget-2.0-1024x486.png "PPL widget 2.0")PPL widget 2.0 ### Generating an API Key for PPL Widget 2.0 (Generování API klíče pro PPL widget 2.0) You can generate the key on the PPL website at [https://klient.ppl.cz/widgetadmin](https://klient.ppl.cz/widgetadmin). Detailed step-by-step documentation directly from PPL can be found [here](https://ppl-widgetapikey.apidog.io/ppl-widget-z%C3%ADsk%C3%A1n%C3%AD-api-kl%C3%AD%C4%8De-a-konfigurace-2106743m0). ![Plugin PPL - API for widget 2](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-PPL-API-pro-widget-2-1024x147.png "Plugin PPL - API for widget 2") In the form, fill in your Company ID (IČO), PPL ID, and the email registered with PPL. Click on Generate API key (Vygenerovat API klíč). ![Plugin PPL generovani API klice widgetu 2.0 1024x427](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-PPL-generovani-API-klice-widgetu-2.0-1024x427.png "Plugin PPL generovani API klice widgetu 2.0 1024x427") Subsequently, you will receive an **API key** and an **activation link for the API key** via email. Click on the activation link and complete the configuration. This must be done within 60 minutes of clicking the link. ![Plugin PPL editace noveho widgetu 1024x576](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-PPL-editace-noveho-widgetu-1024x576.png "Plugin PPL editace noveho widgetu 1024x576") In the edit section, fill in: - the e-shop domain where you want to use the widget (e.g., myeshop.com) - product type -> Custom settings (typ produktu -> Vlastní nastavení) - pickup point types – select those you want to display in the widget (typy výdejních míst) - available countries – select those you want to display in the widget (dostupné země) - default language – of your choice – the widget will open in this language (výchozí jazyk) - display type -> Pop-up window (typ zobrazení -> Vyskakovací okno (Modal)) –> Then click on **Activate (Aktivovat).** Your API key is now active. All that remains is to paste it into the field in the plugin (you have the API key in the first email from PPL). ![Plugin PPL Nastaveni widgetu pro vyber pobocek 1024x454](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-PPL-Nastaveni-widgetu-pro-vyber-pobocek-1024x454.png "Plugin PPL Nastaveni widgetu pro vyber pobocek 1024x454") In the widget settings, select the widget version Widget 2.0. A field for inserting the API key will appear. Paste it and save the settings. ## Setting up Carriers in the PPL Plugin Individual delivery types can be found in the PPL plugin on the *Způsoby dopravy (Shipping Methods)* tab *(Toret Plugins > PPL > Způsoby dopravy)*. After clicking the *Nastavení (Settings)* button for a specific country, you will see an overview of available shipping methods for that country. ![Plugin Toret PPL nastaveni dopravcu 1024x475](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-dopravcu-1024x475.png "Plugin Toret PPL nastaveni dopravcu 1024x475") In the sidebar, select the shipping method you want to configure. In the Toret PPL plugin, you can set up shipping: - PPL Private (delivery to address) - PPL Parcelshop (pickup points – branches and boxes – for the Czech Republic, Slovakia, Poland, Germany, Netherlands, Austria, Hungary, Romania, Bulgaria) - PPL Pick-up Point – physical stores only - PPL Box – pick-up boxes only - PPL Smart Europe (Pickup locations in 14 European countries at a great price) - PPL Business (delivery to company address) - PPL Morning delivery to address (Dopolední balík) - PPL Parcel Return Connect Import (Return shipment from abroad to the Czech Republic. Service available only from supported countries. These countries must be set as the pickup address (sender).) - PPL Parcel CZ Smart to box Check the box to activate the shipping method and proceed with the settings below. ![Plugin Toret PPL nastaveni dopravcu 2 1024x488](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-dopravcu-2-1024x488.png "Plugin Toret PPL nastaveni dopravcu 2 1024x488") For each shipping method and delivery country, the following options can be set: - shipping price – flat or based on weight - custom icon for checkout - free shipping over amount - use of free shipping coupon - flat price in other currencies - maximum weight and maximum dimension (if exceeded, the shipping method will not be displayed in checkout) - availability by cart value, number of items in cart, or product price (if exceeded, the shipping method will not be displayed in checkout) - cash on delivery (if PPL supports it for the given shipping method and country) - COD surcharge – flat or based on order price - free COD over amount - evening delivery (if PPL supports it for the given shipping method and country) - package return service with drop-off at a Parcel Shop (if PPL supports it for the given shipping method and country) > **Tip:** if you want to trigger free shipping or free COD at checkout e.g. from 500, set the value 499 in the plugin. ### Price Settings First, select the *Typ výpočtu dopravy (Shipping calculation type)*. The shipping price can be set uniformly – with a fixed amount entered in the *Jednotná cena (Uniform price)* field, ![Plugin Toret PPL nastaveni ceny](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-ceny.png "Plugin Toret PPL nastaveni ceny") or set custom price rules based on shipment weight. ![Plugin Toret PPL nastaveni ceny2 1024x571](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-ceny2-1024x571.png "Plugin Toret PPL nastaveni ceny2 1024x571") **Flat rate in other currencies**: Here you can set fixed shipping prices to be used if the order is in a currency other than the default e-shop currency. ### Free Shipping You set free shipping directly in the PPL plugin *(Toret Plugins > PPL > Způsoby dopravy)* for each type of shipping, for each country separately. ![Plugin Toret PPL nastaveni dopravy zdarma](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-dopravy-zdarma.png "Plugin Toret PPL nastaveni dopravy zdarma") Free shipping is activated on the website upon reaching the set amount in the cart. **EXAMPLE:** You set free shipping over 500. Free shipping is activated when the cart value reaches 500 (this applies to products only; the shipping cost is not included). You can set**free shipping for a specific product** in its details on the PPL tab. ![Plugin Toret PPL nastaveni dopravy zdarma pro produkt 1024x655](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-dopravy-zdarma-pro-produkt-1024x655.png "Plugin Toret PPL nastaveni dopravy zdarma pro produkt 1024x655") Free shipping for goods from a specific product category can be enabled in the category settings. ![Plugin Toret PPL nastaveni dopravy zdarma pro kategorii 1024x456](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-dopravy-zdarma-pro-kategorii-1024x456.png "Plugin Toret PPL nastaveni dopravy zdarma pro kategorii 1024x456") ### Free Shipping Coupons The plugin supports coupons for free shipping. These can be set globally, for all PPL shipments, or for a specific type of delivery. You configure coupon behavior in the main plugin settings *(Toret plugins > PPL > Hlavní nastavení)*. ![Plugin Toret PPL nastaveni kuponu pro dopravu zdarma](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-kuponu-pro-dopravu-zdarma.png "Plugin Toret PPL nastaveni kuponu pro dopravu zdarma") If you choose the option *Vybraný způsob dopravy zdarma (Selected free shipping method),* enable coupons in the settings of the specific method for which you want to have the coupon active. ![Plugin Toret PPL nastaveni kuponu pro dopravu zdarma 1](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-kuponu-pro-dopravu-zdarma-1.png "Plugin Toret PPL nastaveni kuponu pro dopravu zdarma 1") ### Cash on Delivery (COD) To set up COD for shipping, it is necessary to check the *Povolit dobírku (Enable COD)* checkbox. ![Plugin Toret PPL nastaveni dobirky](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-dobirky.png "Plugin Toret PPL nastaveni dobirky") Subsequently, it is possible to set: **Zdarma od (Free from):** From the entered order value, COD will be without surcharge. **Maximální povolená hodnota (Maximum allowed value):** Upon exceeding this order value, COD will not be available in checkout. **Typ výpočtu poplatku (Fee calculation type):** You can choose a fixed surcharge – *Jednotná cena (Uniform price)*, ![Plugin Toret PPL nastaveni dobirky 1](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-dobirky-1.png "Plugin Toret PPL nastaveni dobirky 1") or scale the surcharge according to the order value – *Celková cena (Total price)* and set custom price rules. ![Plugin Toret PPL nastaveni dobirky2 1024x569](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-dobirky2-1024x569.png "Plugin Toret PPL nastaveni dobirky2 1024x569") ### Weight and Dimension Limits If you activate weight/dimension checks and enter values for maximum dimension/weight, shipping will be hidden in checkout if limits are exceeded. The plugin loads weight/dimensions from values set for products. ![Plugin Toret PPL hmotnostni a rozmerove limity](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-hmotnostni-a-rozmerove-limity.png "Plugin Toret PPL hmotnostni a rozmerove limity") ### Availability In the Availability section, you can set the minimum and maximum cart value, number of items in the cart, or product price. If orders exceed any of the limits, shipping will not be available in checkout. ![Plugin Toret PPL dostupnost](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-dostupnost.png "Plugin Toret PPL dostupnost") ### Evening Delivery Activate evening delivery by checking the *Povolit PPL večerní doručení (17:00 – 21:00) (Enable PPL evening delivery)* checkbox. Evening delivery is available only for some shipping methods. ![Plugin Toret PPL vecerni doruceni](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-vecerni-doruceni.png "Plugin Toret PPL vecerni doruceni") It will appear in checkout as an additional checkbox for the shipping method. ![Plugin Toret PPL vecerni doruceni 2](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-PPL-vecerni-doruceni-2.png "Plugin Toret PPL vecerni doruceni 2") ### Parcel Return Service (Pick-up at a Parcelshop) For supported shipping methods, parcel return is also available – with drop-off at a Parcel Shop. The service must be activated – checkbox *Povolit PPL Return balík v pokladně (PPL Private, PPL Private s dobírkou). Příjemce odnese balík do PPL Parcelshopu. (Enable PPL Return package in checkout. Recipient takes package to PPL Parcelshop.)* ![Plugin Toret PPL sluzba vraceni baliku 1024x616](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-sluzba-vraceni-baliku-1024x616.png "Plugin Toret PPL sluzba vraceni baliku 1024x616") Subsequently, it is possible to set text, surcharge, and field pre-checking. It will appear in checkout as an additional checkbox for the shipping method. ![Toret PPL Plugin - return service checkout](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-PPL-vraceni-baliku-2.png "Toret PPL Plugin - return service checkout") > Note! This service is only available for the classic (shortcode) checkout. ## Shipping Zone Settings After setting up carriers in the Toret PPL plugin, it is necessary to set up identically named carriers in your WooCommerce shipping zones. **Without setting them in shipping zones, carriers from the PPL plugin will not appear in checkout.** In *WooCommerce > Settings > Shipping *select the zone in which you want to enable shipping via PPL. Click “Edit”. ![Toret PPL Plugin - shipping zone settings](https://documentation.toret.cz/wp-content/uploads/2024/07/ppl-zony-dopravy-1024x311.png "Toret PPL Plugin - shipping zone settings") In the zone settings, click “Add shipping method”. ![Toret PPL Plugin - adding shipping method](https://documentation.toret.cz/wp-content/uploads/2024/07/ppl-zony-dopravy2.png "Toret PPL Plugin - adding shipping method") Select your required method from the list and click Continue. ![Toret PPL Plugin - selecting shipping method](https://documentation.toret.cz/wp-content/uploads/2024/07/ppl-zony-dopravy3-1024x492.png "Toret PPL Plugin - selecting shipping method") Leave the Enable box checked, you can adjust the Title and Description as needed. Tax status can be chosen as Taxable or None. After clicking Create and save, the shipping method will be available for the given zone. ![Toret PPL Plugin - saving shipping method](https://documentation.toret.cz/wp-content/uploads/2025/04/ppl-nastaveni-dopravni-metody-1024x538.png "Toret PPL Plugin - saving shipping method") ## Product and Category Level Settings The PPL plugin also adds additional setting options to product and category details. In product detail, you can set: - Age verification (seebelow) - Customs data (for shipments sent to Ireland) - Free shipping for product - Disable shipping method - Free COD for product - Deactivate delivery boxes for product - Surcharge for product (Must first be created in the main plugin settings) ![Plugin Toret PPL nastaveni dopravy na urovni produktu 1024x517](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-dopravy-na-urovni-produktu-1024x517.png "Plugin Toret PPL nastaveni dopravy na urovni produktu 1024x517") In category detail, you can set: - Disable shipping method - Free shipping - Free COD - Disable delivery boxes - Surcharge by category (Must first be created in the main plugin settings) ![Plugin Toret PPL nastaveni dopravy na urovni kategorie 1024x457](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-dopravy-na-urovni-kategorie-1024x457.png "Plugin Toret PPL nastaveni dopravy na urovni kategorie 1024x457") ## Shipment Submission from Web to PPL You have two options for submitting a shipment to the PPL system in the plugin. **Submitting a package requires weight.** We recommend setting the weight at the product level; without set weight for products, automatic shipment submission upon order status change will not work. Shipments sent via the plugin can also be found in the [PPL Customer Zone](https://www1.ppl.cz/main2.aspx?cls=loginZak). ### **1.** Manual via button in order overview or order detail ![Plugin Toret PPL podani zasilky z prehledu objednavek 1024x60](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-podani-zasilky-z-prehledu-objednavek-1024x60.png "Plugin Toret PPL podani zasilky z prehledu objednavek 1024x60")![Plugin Toret PPL podani zasilky z detailu objednavky 1024x327](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-podani-zasilky-z-detailu-objednavky-1024x327.png "Plugin Toret PPL podani zasilky z detailu objednavky 1024x327") ### **2.** **Submission as a collective action** TIP: Mass printing of labels is only possible with batch submission, see below. ![Plugin Toret PPL hromadne podani](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-hromadne-podani.png "Plugin Toret PPL hromadne podani") ### **3.** **Automatic package dispatch upon order status change** Automatic submission can be set in the PPL plugin on the *Automatic Dispatch* tab. a. In the *Send data to PPL system upon order status change* section, select the order status for each payment method that will automatically trigger sending data to the PPL system. b. In the *Main Settings* section, you can configure whether a label and pickup request should also be automatically created when a shipment is created. Don’t forget to save your changes. ![Plugin Toret PPL automaticke podani zasilky](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-automaticke-podani-zasilky.png "Plugin Toret PPL automaticke podani zasilky") ## Ordering Package Pickup Via the plugin, it is possible to order package pickup. Ordering pickup can be done in two ways. ### Manual In the order overview, there is a car icon for orders submitted to the PPL system. Clicking the icon displays a box above the order overview with the option to select the date for ordering package pickup. ![Plugin Toret PPL manualni objednani svozu 1024x356](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-manualni-objednani-svozu-1024x356.png "Plugin Toret PPL manualni objednani svozu 1024x356") Pickup can also be ordered from the order detail or via a bulk action in the order overview. ### Automatic On the tab *Automatické odesílání (Automatic Sending)*, in the section *Hlavní nastavení (Main Settings)* in the PPL plugin, it is possible to set automatic ordering of shipment pickup for the next day upon shipment creation. ![Plugin Toret PPL automaticke objednani svozu 1024x577](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-automaticke-objednani-svozu-1024x577.png "Plugin Toret PPL automaticke objednani svozu 1024x577") ## Age Verification The PPL plugin supports age verification. This can be set for any product directly in the product detail on the PPL tab, where checking the Age Verification requirement is sufficient for activation. Everything works automatically. If the order contains at least one product that requires age verification upon delivery, the entire order will require age verification. You can choose between 15+ and 18+ limits. ![Plugin Toret PPL nastaveni Overeni veku 1024x514](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-Overeni-veku-1024x514.png "Plugin Toret PPL nastaveni Overeni veku 1024x514") ## Printing Labels ### Label Printing Settings with my API **! We recommend using the Create package label (CPL) API, which does not need shipment number range settings. For new registrations, PPL will issue CPL API directly.** If you have an older registration and want to stay with my API, it is necessary to request a shipment number range from PPL, which you insert into the plugin settings on the “Hlavní nastavení” (Main Settings) tab. If the shipment number range runs out over time, have it increased by PPL support and update this value in the plugin settings. ![Plugin Toret PPL nastaveni cisel zasilek 1024x462](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-cisel-zasilek-1024x462.png "Plugin Toret PPL nastaveni cisel zasilek 1024x462") The number range on the screen is just an example. Request your own from PPL support. #### Label Data Settings (Pickup Location Addresses) The label is created by our plugin. For the label to contain all necessary data required by PPL, in addition to the shipment number range, it is also necessary to fill in: - Sender company name visible on label - Sender contact person visible on label - Sender email visible on label - Sender phone number visible on label Fill in these details on the “Main Settings > Pickup location addresses” tab. ![Plugin Toret PPL adresy svozovych mist 1024x463](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-adresy-svozovych-mist-1024x463.png "Plugin Toret PPL adresy svozovych mist 1024x463") ### Setting Label Format, Note, and Reference Number You can configure label format, note, and reference on the label in the PPL plugin, on the *Main Settings**(H*lavní nastavení*)* tab. ![Plugin Toret PPL nastaveni pro stitek zasilky 1024x581](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-nastaveni-pro-stitek-zasilky-1024x581.png "Plugin Toret PPL nastaveni pro stitek zasilky 1024x581") ### Downloading and Printing Labels Labels of submitted packages can be downloaded directly in the website administration. In the order overview for an order already submitted to the PPL system, click on the PDF document icon (see image) for the selected order. The label will be saved in PDF format, and then you can print it. ![Plugin Toret PPL tisk stitku z prehledu objednavek 1024x59](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-tisk-stitku-z-prehledu-objednavek-1024x59.png "Plugin Toret PPL tisk stitku z prehledu objednavek 1024x59") For a submitted shipment, the label can also be downloaded in the order detail. ![Plugin Toret PPL tisk stitku z detailu objednavky 1024x319](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-tisk-stitku-z-detailu-objednavky-1024x319.png "Plugin Toret PPL tisk stitku z detailu objednavky 1024x319") ### Bulk printing of labels Labels can also be generated and printed in bulk (from a single PDF). To perform a bulk print, you must follow this procedure: 1. Shipments must be submitted all at once using a bulk action. 2. Once all shipments are loaded into PPL, labels can be downloaded in bulk—either via the bulk label download action or by clicking the icon with two small rectangles next to any order from the batch (both in the overview and in the detail). ![Plugin Toret PPL hromadny tisk 1024x52](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-hromadny-tisk-1024x52.png "Plugin Toret PPL hromadny tisk 1024x52")![Plugin Toret PPL hromadny tisk2 1024x337](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-hromadny-tisk2-1024x337.png "Plugin Toret PPL hromadny tisk2 1024x337") > Note: If you try to download the labels before the API processes all shipments, only a single label will be downloaded. Especially for larger quantities of shipments, processing may take longer. ## Automatic Shipment Status Loading To track the shipment status directly in the order overview, you can set up automatic status updates on the *Tracking*tab *(Sledování) (Toret Plugins > PPL > Tracking (Sledování))*. Tracking can be set up via a**cron job configured on your hosting** (a), or using the**WP Cron scheduler**(b). ![Plugin Toret PPL automaticke nacitani stavu zasilek 1 1024x572](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-automaticke-nacitani-stavu-zasilek-1-1024x572.png "Plugin Toret PPL automaticke nacitani stavu zasilek 1 1024x572") Next, set up: - number of days for retroactive checking - shipment statuses (from PPL) for which tracking will not be checked - order statuses (from the e-shop) for which shipments will not be checked These settings will reduce the volume of checked orders, thereby lowering system performance demands. ### Order Status Change Based on Shipment Status in Transit On the Tracking tab, you can further set the order status change according to the shipment status at the carrier. Simply assign WooCommerce order statuses for given PPL statuses and save the changes made. E.g. Upon successful PPL shipment delivery, the order status changes to *Completed (Dokončeno)*. ![Plugin Toret PPL zmena stavu objednavky na zaklade stavu zasilky 1024x527](https://documentation.toret.cz/wp-content/uploads/2026/07/Plugin-Toret-PPL-zmena-stavu-objednavky-na-zaklade-stavu-zasilky-1024x527.png "Plugin Toret PPL zmena stavu objednavky na zaklade stavu zasilky 1024x527") ## Customs Declaration If you are shipping to Ireland, custom declaration requirements must be met. Customs classification of goods needs to be set up in the product details. ![PPL celni dokumenty2 1024x523](https://documentation.toret.cz/wp-content/uploads/2026/07/PPL-celni-dokumenty2-1024x523.png "PPL celni dokumenty2 1024x523") You then upload the customs document in the order detail. ![PPL celni dokumenty 1024x503](https://documentation.toret.cz/wp-content/uploads/2026/07/PPL-celni-dokumenty-1024x503.png "PPL celni dokumenty 1024x503") ## Plugin testing For testing purposes, you can use: - the subdomain “dev.domainlicense” (with the same license as for the production website) - localhost (127.0.0.1) Purchased plugins will also work in these locations, and you can test their implementation and compatibility here before deploying them to the website and during its use. ## FAQ ### Custom VAT Rate for COD Surcharge You set the VAT rate for COD in the Main Settings of the plugin, Rates and Taxes section. The tax rate can be determined by items in the cart or set fixed,