---
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-05-18
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. Video Tutorial
4. Connecting to PPL
5. Shipment Number Range (my API only)
6. Main Settings
7. 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)
8. 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
9. Shipping Zone Settings
10. Product and Category Level Settings
11. Shipment Submission from Web to PPL
 - 1. Manual via button in order overview or order detail
 -
 - 2. Automatic shipment sending on order status change
12. Ordering Package Pickup
 - Manual
 -
 - Automatic
13. Age Verification
14. Printing Labels
 - Label Printing Settings with my API
 - Setting Data on Label
 - Setting Label Format, Note, and Reference Number
 -
 - Downloading and Printing Labels
15. Automatic Shipment Status Loading
 - Order Status Change Based on Shipment Status in Transit
16. Customs documents
17. FAQ
 - Custom VAT Rate for COD Surcharge
18. 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.

![Toret PPL Plugin - activation](https://documentation.toret.cz/wp-content/uploads/2025/03/ppl-licencni-klic-1024x401.png "Toret PPL Plugin - activation")

## Video Tutorial

[Propojení pluginu Toret PPL a dopravce PPL](https://www.youtube.com/embed/XZ_4SmilVXs?feature=oembed)

## 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

![Toret PPL Plugin - connecting to PPL API](https://documentation.toret.cz/wp-content/uploads/2025/03/PPL-api-1024x558.png "Toret PPL Plugin - connecting to PPL API")

## 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.**

![Toret PPL Plugin - shipment number range settings](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-ppl-rozsah-cisel-zasilky-1024x539.png "Toret PPL Plugin - shipment number range settings")

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 – opening, button placement, hiding boxes and COD
- Pickup addresses for shipment collection by courier
- 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.
- 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 2.0 1024x594](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-PPL-nastaveni-widgetu-2.0-1024x594.png "Plugin PPL nastaveni widgetu 2.0 1024x594")

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.

![Toret PPL Plugin - carrier settings](https://documentation.toret.cz/wp-content/uploads/2025/03/ppl-zpusoby-dopravy-1024x413.png "Toret PPL Plugin - carrier settings")

After activating the given shipping method by checking the checkbox and clicking Save, the settings for that method will appear.

![Toret PPL Plugin - shipping method settings detail](https://documentation.toret.cz/wp-content/uploads/2025/03/ppl-zpusoby-dopravy-2-1024x412.png "Toret PPL Plugin - shipping method settings detail")

In the Toret PPL plugin, you can set up shipping:

- PPL Private (delivery to address)
- PPL Parcelshop (pickup points for the Czech Republic, Slovakia, Poland, Germany)
- PPL Smart Europe (Pickup locations in 14 European countries at a great price)
- PPL Business (delivery to company address)
- PPL Dopolední balík (Morning package)
- 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

For each shipping method and delivery country, the following options can be set:

- shipping price – flat or based on weight
- 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)
- return shipment (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,

![Toret PPL Plugin - price settings](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-PPL-nastaveni-ceny-1.png "Toret PPL Plugin - price settings")

or set custom price rules based on shipment weight.

![Toret PPL Plugin - price settings by weight](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-PPL-nastaveni-ceny-2-1024x557.png "Toret PPL Plugin - price settings by weight")

**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.

![Toret PPL Plugin - free shipping settings](https://documentation.toret.cz/wp-content/uploads/2025/03/ppl-doprava-zdarma.png "Toret PPL Plugin - free shipping settings")

The free shipping setting is “above” an amount, meaning free shipping is activated on the website after exceeding the set amount in the cart.

**EXAMPLE:** If you want free shipping from 500, set the amount 499 in the plugin.

> **Tip:** If you have VAT configured in WooCommerce, the value for triggering free shipping is entered without VAT.

The free shipping amount setting applies only to products; the shipping price is not included.

**EXAMPLE:** If you have free shipping set from 500, and the cart contains a product for 450 + shipping price 65 = 515 CZK, free shipping will not be activated. It is necessary to exceed the set price with the product, i.e., to activate free shipping set this way, you need to put product(s) worth at least 500 CZK into the cart.

**Free shipping for a specific product**can be set in its detail on the PPL tab.

![Toret PPL Plugin - free shipping per product](https://documentation.toret.cz/wp-content/uploads/2024/07/ppl-doprava-zdarma2-1024x658.png "Toret PPL Plugin - free shipping per product")

Free shipping for goods from a specific product category can be enabled in the category settings.

![Toret PPL Plugin - free shipping per category](https://documentation.toret.cz/wp-content/uploads/2024/07/ppl-doprava-zdarma3-1024x469.png "Toret PPL Plugin - free shipping per category")

### 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í)*.

![Toret PPL Plugin - free shipping coupon settings](https://documentation.toret.cz/wp-content/uploads/2025/03/PPL-%E2%80%B9-Toret-dev-start-%E2%80%94-WordPress-03-10-2025_01_14_PM.png "Toret PPL Plugin - free shipping coupon settings")

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.

![Toret PPL Plugin - enable coupon for specific method](https://documentation.toret.cz/wp-content/uploads/2025/03/ppl-kupon-pro-dopravu-zdarma.png "Toret PPL Plugin - enable coupon for specific method")

### Cash on Delivery (COD)

To set up COD for shipping, it is necessary to check the *Povolit dobírku (Enable COD)* checkbox.

![Toret PPL Plugin - COD settings](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-PPL-nastaveni-dobirky.png "Toret PPL Plugin - COD settings")

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)*,

![Toret PPL Plugin - COD fee calculation](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-PPL-nastaveni-dobirky-2.png "Toret PPL Plugin - COD fee calculation")

or scale the surcharge according to the order value – *Celková cena (Total price)* and set custom price rules.

![Toret PPL Plugin - COD price scaling](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-PPL-nastaveni-dobirky-3-1024x407.png "Toret PPL Plugin - COD price scaling")

### 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.

![Toret PPL Plugin - weight and dimension limits](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-PPL-hmotnostni-a-rozmerove-limity.png "Toret PPL Plugin - weight and dimension limits")

### 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.

![Toret PPL Plugin - availability settings](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-PPL-dostupnost.png "Toret PPL Plugin - availability settings")

### 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.

![Toret PPL Plugin - evening delivery](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-PPL-vecerni-doruceni.png "Toret PPL Plugin - evening delivery")

It will appear in checkout as an additional checkbox for the shipping method.

![Toret PPL Plugin - evening delivery checkout](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-PPL-vecerni-doruceni-2.png "Toret PPL Plugin - evening delivery checkout")

### Parcel Return Service

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.)*

![Toret PPL Plugin - return service settings](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-PPL-vraceni-baliku-1024x742.png "Toret PPL Plugin - return service settings")

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")

## 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)
- 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)

![Toret PPL Plugin - product level settings](https://documentation.toret.cz/wp-content/uploads/2024/07/ppl-produkt-1024x392.png "Toret PPL Plugin - product level settings")

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)

![Toret PPL Plugin - category level settings](https://documentation.toret.cz/wp-content/uploads/2024/07/ppl-kategorie-1024x469.png "Toret PPL Plugin - category level settings")

## 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

![Toret PPL Plugin - manual submission from overview](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-ppl-manualni-podani-zasilky-v-prehledu-objednavek-1024x38.png "Toret PPL Plugin - manual submission from overview")![Toret PPL Plugin - manual submission from detail](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-ppl-manualni-podani-zasilky-v-detailu-objednavky-1-1024x487.png "Toret PPL Plugin - manual submission from detail")

### **2.** **Automatic shipment sending on order status change**

Automatic submission can be set in the PPL plugin on the tab*Automatické odesílání (Automatic Sending).*

In the section *Odeslat data do systému PPL při změně stavu objednávky (Send data to PPL system on order status change)*, choose the order status for individual payment methods at which data will be automatically sent to the PPL system.

In the *Hlavní nastavení (Main Settings)* section, you can set whether a label will also be automatically created and pickup ordered when creating a shipment.

Do not forget to save the changes made.

![Toret PPL Plugin - automatic submission settings](https://documentation.toret.cz/wp-content/uploads/2025/03/PPL-automaticke-odesilani-1024x469.png "Toret PPL Plugin - automatic submission settings")

## 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.

![Toret PPL Plugin - manual pickup ordering](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-ppl-manualni-objednavni-svozu-baliku-1024x215.png "Toret PPL Plugin - manual pickup ordering")

### 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.

![Toret PPL Plugin - automatic pickup ordering](https://documentation.toret.cz/wp-content/uploads/2025/03/PPL-automaticke-objednani-svozu-1024x493.png "Toret PPL Plugin - automatic pickup ordering")

## 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.

![Toret PPL Plugin - age verification settings](https://documentation.toret.cz/wp-content/uploads/2024/07/ppl-overeni-veku-1024x392.png "Toret PPL Plugin - age verification settings")

## 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.

![Toret PPL Plugin - shipment number range settings](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-ppl-rozsah-cisel-zasilky-1-1024x539.png "Toret PPL Plugin - shipment number range settings")

The number range on the screen is just an example. Request your own from PPL support.

#### Setting Data on Label

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

You can find shipment label settings on the “Hlavní nastavení” (Main Settings) tab

![Toret PPL Plugin - label data settings](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-ppl-vyplneni-imformaci-propsanych-na-stitek-ppl-1024x289.png "Toret PPL Plugin - label data settings")

### Setting Label Format, Note, and Reference Number

You can configure label format, note, and reference on the label in the PPL plugin, on the *Hlavní nastavení (Main Settings)* tab.

![Toret PPL Plugin - label format settings](https://documentation.toret.cz/wp-content/uploads/2025/03/PPL-nastaveni-stitku-1024x560.png "Toret PPL Plugin - label format settings")

### 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.

![Toret PPL Plugin - printing labels from overview](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-ppl-stazeni-stitku-z-prehledu-objednavek-1024x99.png "Toret PPL Plugin - printing labels from overview")

For a submitted shipment, the label can also be downloaded in the order detail.

![Toret PPL Plugin - printing labels from detail](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-ppl-stazeni-stitku-z-detailu-objednavky-1024x286.png "Toret PPL Plugin - printing labels from detail")

## Automatic Shipment Status Loading

To track the shipment status in transit directly in the order overview, you can use cron. You find it on the *Sledování (Tracking) tab (Toret Plugins > PPL > Sledování)*. Then set up the cron in your hosting including the required execution interval.

![Toret PPL Plugin - automatic status loading](https://documentation.toret.cz/wp-content/uploads/2025/03/ppl-sledovani-zasilky-1024x436.png "Toret PPL Plugin - automatic status loading")

### 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)*.

![Toret PPL Plugin - automatic order status change](https://documentation.toret.cz/wp-content/uploads/2025/03/ppl-zmena-stavu-objednavky-dle-stavu-zasilky-1024x705.png "Toret PPL Plugin - automatic order status change")

## Customs documents

If you are shipping to a country that requires customs clearance, you can upload the customs documents to the PPL system directly from the details of the relevant order.

![Toret PPL - custom documents](https://documentation.toret.cz/wp-content/uploads/2026/04/ppl-celni-prohlaseni-1024x462.png "Toret PPL - custom documents")

## 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,