---
title: "PPL: common errors and how to fix them"
description: "What the PPL errors in ShipDock mean and how to fix them, from an unmapped shipping rate or a missing pickup point to a shipment PPL refused."
url: https://help.shipdockapp.eu/en/articles/11764791-ppl-common-errors-and-how-to-fix-them
collection: "PPL"
updated: 2026-11-19
language: en
---

# PPL: common errors and how to fix them

What the PPL errors in ShipDock mean and how to fix them, from an unmapped shipping rate or a missing pickup point to a shipment PPL refused.

When a PPL label cannot be created, ShipDock shows its own message or the one PPL returned. Find your error below, fix the cause and create the label again.

## Where you see the error

-   **ShipDock Orders:** the **Review these orders** banner and a red icon in the **Parcels** column. Click **Show** to read the message.
    
-   **Shopify order list, Create & Print dialog:** under **Failed to create labels:**.
    
-   **Printing:** in the banner **Problem with generating shipping labels**.
    

## Provider connection is disabled. Please activate API connection with credentials in the provider detail.

**Cause:** the API connection of PPL is turned off.

**Fix:** in **Providers → PPL → General**, turn on **Connect provider throught API**, check **Client Id** and **Client secret**, and save.

## Shopify Shipping Rate (…) in order not assigned in Shipping settings. Please check if you have this shipping rate set up in our app.

**Cause:** the order's shipping rate is not mapped to PPL.

**Fix:** map the rate on the PPL **Pickup points** or **Home delivery** tab, or change the courier with the exchange icon in the **Shipping** column. See [How to map Shopify shipping rates to a courier](https://help.shipdockapp.eu/en/articles/11516538.md).

## PPL Service has not been found

**Cause:** no PPL service (for example **PPL Private (B2C)**) is set for this home delivery order.

**Fix:** on the PPL **Home delivery** tab, choose the service for the shipping rate and save. For this order, use **Change delivery method** in **Orders**.

## Pickup Point is missing. The user probably did not select it.

**Cause:** the customer did not choose a pickup point.

**Fix:** click **Send reminder** to email the customer, or choose the pickup point yourself in the **Shipping** column.

## PPL internal server error. Try it again later.

**Cause:** PPL's system answered with a server error. Nothing is wrong with the order.

**Fix:** wait a few minutes and try again. If it lasts longer, ask PPL whether its system has an outage.

## PPL refused the shipment (PPL's own message)

Any other message is PPL's own text, followed by the rejected fields (_field - reason_) or by _Error code:_ and a number.

**Cause:** PPL did not accept the shipment data. The field named in the message tells you what to fix:

-   **Recipient address:** **Edit order** → **Override shipping address**.
    
-   **Phone or email:** **Edit order → Override contact**.
    
-   **Sender:** complete **Sender details** on **Providers → PPL → General**.
    
-   **Service and country:** use **Change delivery method** to pick a service that covers the country. ShipDock does not check this before sending.
    
-   **COD amount or currency:** COD goes in the order currency, without conversion. Use **Edit order → Override currency** and **Override COD value**.
    
-   **COD with PPL Parcel Connect Plus:** it has no COD variant in ShipDock. Choose another service for COD orders.
    

Countries of each service: [How to ship PPL parcels abroad from Shopify](https://help.shipdockapp.eu/en/articles/11764789.md).

## Shipment to a DHL Packstation refused

**Cause:** the pickup point is a DHL Packstation in Germany and the order has no DHL customer number (Postnummer).

**Fix:** add the number to the order attribute `PickupPointCustomerId` (6 to 10 digits) or change the pickup point. See [How to deliver PPL parcels to DHL Packstations in Germany from Shopify](https://help.shipdockapp.eu/en/articles/11764786.md).

## Login to PPL fails

**Cause:** **Client Id** or **Client secret** is wrong, or **Connection mode** does not match them. Every PPL order then fails with PPL's answer or a general error.

**Fix:** in **Providers → PPL → General**, enter the details again without extra spaces. Use **Production** with production details and **Sandbox / Development** only with test details.

## The tracking number or label is missing right after creating

This is not an error. PPL finishes the shipment within about a minute and ShipDock fetches the tracking number automatically. A parcel without a finished label is left out of the printed PDF, so wait for the tracking number, then print again.

## Related articles

-   [How to connect PPL](https://help.shipdockapp.eu/en/articles/11554201.md)
    
-   [How to ship PPL parcels abroad from Shopify](https://help.shipdockapp.eu/en/articles/11764789.md)
    
-   [How to create and print shipping labels](https://help.shipdockapp.eu/en/articles/11530903.md)
    
-   [How to set up cash on delivery (COD)](https://help.shipdockapp.eu/en/articles/9579888.md)

## Related

- [How to ship PPL parcels abroad from Shopify](https://help.shipdockapp.eu/en/articles/11764789-how-to-ship-ppl-parcels-abroad-from-shopify.md)
- [How to deliver PPL parcels to DHL Packstations in Germany from Shopify](https://help.shipdockapp.eu/en/articles/11764786-how-to-deliver-ppl-parcels-to-dhl-packstations-in-germany-from-shopify.md)
- [How to connect a courier](https://help.shipdockapp.eu/en/articles/11764762-how-to-connect-a-courier.md)
- [Supported couriers and what each one can do](https://help.shipdockapp.eu/en/articles/11764763-supported-couriers-and-what-each-one-can-do.md)
- [How to connect Balíkovna and Česká pošta](https://help.shipdockapp.eu/en/articles/11764744-how-to-connect-balikovna-and-ceska-posta.md)
