# Set up CouriersPlease
URL: https://support.starshipit.com/articles/204055239-set-up-couriersplease
Canonical: https://support.starshipit.com/articles/204055239-set-up-couriersplease
Markdown: https://support.starshipit.com/articles/204055239-set-up-couriersplease.md
Updated: 2026-11-17

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Connect CouriersPlease, add product codes and returns, and find help with rates, tracking numbers and printed barcodes.

Connect your CouriersPlease account to Starshipit, add your product codes and configure returns. If you have already connected the account, use the troubleshooting answers below for rates, duplicate tracking numbers and printed barcode problems.

## Before you begin

To integrate CouriersPlease with your Starshipit account, you need to have an EDI (Electronic Data Interchange) account. If you don't have one, simply contact your CouriersPlease account manager.

To complete the setup steps, you will need:

* CouriersPlease account number (9 digits)
* Dispatch ID
* Product codes associated with your CouriersPlease account.
* API Key (optional - used for booking pickups and creating returns. Without one, a pickup is booked on manifest)

If you are missing any of these values, please contact your CouriersPlease account manager or contact [Starshipit support.](https://help.starshipit.com)

## Manifests and NDF

CouriersPlease will apply No Data Fee charges (NDF) per consignment when a parcel is picked up prior to being manifested. Because pickup times can change day to day, a fixed auto manifest time (for example, 6:00 pm) may run too late for same-day collections.

To prevent NDF charges being incurred by CouriersPlease, they require releasing the manifest 30 minutes prior to pickup or from the time of pickup.  Here's what we recommend:

* **Disabling auto manifest for CouriersPlease.**  
  *Under Settings > Couriers > Auto manifest > Ensure that CouriersPlease is unticked from the list of couriers.*
* **Manually releasing the manifest when the freight is ready for collection.**

## Setting up your CouriersPlease account in Starshipit

### 1. Enter your CouriersPlease information

1. Navigate to **Settings** > **Couriers** > **Add New Courier** > **CouriersPlease**.
2. Tick **Enable CouriersPlease**.
3. Complete the **Account No** and **Dispatch ID** fields.
4. Enter the **API Key** if you want to book pickups or create returns.
5. Set the increment value to 1. If you have used CouriersPlease with Starshipit in the past, set it to 1,000,000 or above to avoid overlapping with past orders.
6. Click **Save**.

### 2. Enter your product codes

CouriersPlease will provide different product codes based on your requirements and account eligibility. Product codes for shipments need to be populated similar to the following, and these products will then be available throughout Starshipit.

For shipments with multiple parcels, use **AC2** or **C44** if CouriersPlease has enabled the service on your account. Confirm the parcel limits with CouriersPlease.

1. Navigate to **Settings** > **Couriers** > **CouriersPlease**.
2. Click on **Add Product Codes**.
3. Enter the Code and Name.
4. Click **Save**.

### 3. Enabling Returns (optional)

1. Ensure you have added an API key to your settings.
2. Enter in the Return Product Codes in **Settings** > **Couriers** > **CouriersPlease** > **Add return product codes**.

## Troubleshooting

<!-- faq:start -->

<!-- faq:question -->Why are the rates displayed in Starshipit incorrect?<!-- /faq:question -->

Rates are retrieved, based on the product codes. Check with CouriersPlease that the product codes you are using are correct.

<!-- faq:question -->How can I add Fuel Surcharges to my CouriersPlease rates?<!-- /faq:question -->

CouriersPlease only applies a Standard fuel levy to Road Express if they
are **not** “Local”
(i.e. passed onto an agent to deliver instead of CouriersPlease delivering)
– currently set at 28.6%.

Starshipit does not require an API key to see this included in the freight
breakdown.

Standard fuel levy is not applied to Satchels (Items).

Extra Ordinary Fuel Surcharge (10%) is **not** included
on the CouriersPlease API.

<!-- faq:question -->Why are duplicate tracking numbers being generated for different orders?<!-- /faq:question -->

This is likely due to an overlap in your current consignment increment value.

Navigate to **Settings** > **Couriers** > **CouriersPlease Settings** > Set the **Current Consignment Increment** to a value much higher than the one set currently e.g. 1,000,000.

<!-- faq:question -->How should I set up CouriersPlease on child accounts?<!-- /faq:question -->

If you use the same CouriersPlease account across child accounts, increase the **Current Consignment Increment** by at least 500,000 for each child account. This helps prevent duplicate consignment numbers being generated across accounts.

Add the required product codes and mark one as **Default** when Authority to Leave needs a default service.

<!-- faq:question -->What should I check if a CouriersPlease barcode is not centred or is not scanning?<!-- /faq:question -->

Compare the existing label PDF with the printed label before changing the courier setup. An offset, clipped or blurry printed barcode does not by itself show that the CouriersPlease connection is wrong.

1. Open the existing label PDF and check whether the barcode is complete there.
2. If the printed label is offset or cut off, follow [Labels print at the wrong size or orientation](/articles/213724603-troubleshoot-printing#labels-print-at-the-wrong-size-or-orientation). Match the label format, printer paper size and loaded stock, and calibrate the printer if output crosses label boundaries.
3. If the barcode is blurry or difficult to scan, follow [Printing setup FAQs](/articles/8412386619151-printing-setup-faqs) for scaling, media, resolution and print-quality checks.
4. If a shipment and tracking number already exist, use **Reprint** after correcting the print settings. Confirm that the whole barcode fits on the label and can be scanned; do not create a second shipment just to retry physical printing.

If the barcode is incomplete in the PDF too, or the problem continues after these checks, [contact Starshipit support](/articles/13017036853647-contact-starshipit-support) with the affected order, label PDF and a photo of the printed label.

<!-- faq:end -->
