Purpose: When generating a label in Sendcloud, you may see an error that prevents the label from being created. This article explains the most common causes of label generation issues and provides step-by-step instructions to resolve them.
Where to find the error
Label generation errors appear in a red box within the label creation panel when an issue occurs during the process. These messages help identify the problem, and in this guide, you will find the necessary actions to fix it.
General Errors
What does this error mean?
This error appears when the carrier cannot be reached during the label creation process. It usually happens during a temporary outage or when the carrier sends back a response that isn't recognized by the system.
How to fix it:
- Check status.sendcloud.com to see if there are any ongoing issues with Sendcloud or the carrier.
- If no outage is reported, wait a few minutes and try again, temporary issues often resolve quickly.
- If the error continues, please contact our Support team with the carrier name and shipment details so we can investigate further.
(also applies to “Missing required data: mail”)
What does this error mean?
Mandatory fields (phone or email) were not filled in during order creation.
How to fix it:
Make sure both phone number and email address are entered before saving or processing the order.
What does this error mean?
The selected courier does not support deliveries for the origin/destination combination.
How to fix it:
Change to a courier or shipping method that supports this route.
What does this error mean?
The courier does not allow multiple parcels in one shipment.
How to fix it:
Adjust the shipment to be a single parcel or select a service that supports multicollo.
What does this error mean?
This is a general, non-specific error indicating a temporary glitch with the courier integration.
How to fix it:
Wait a few minutes and retry the operation. The issue is often resolved automatically.
What does this error mean?
Essential data is missing from the order (e.g., address, email, phone number, house number).
How to fix it:
Review the order fields and make sure all required data is entered before continuing.
What does this error mean?
The dimensions of the package (length, width, height) were not filled in.
How to fix it:
Add the missing measurements in the appropriate fields to proceed with shipment creation.
Carrier Errors
DPD
What does this error mean?
This message appears when the carrier is unable to determine the correct route for the shipment, often due to a problem with the address details.
How to fix it:
- Double-check the recipient's postal code, street name, house number, and country.
- Make sure all fields are filled in correctly and do not contain typos or unsupported characters.
- If you're using a connected store, verify that the address was imported correctly from the order details.
Once the address is corrected, try creating the label again.
What does this error mean?
This message indicates that the carrier (DPD) was unable to assign a tracking number during the label creation process. This typically happens when the parcel number range linked to your contract has been fully used or is not correctly configured.
How to fix it:
To resolve this issue, please contact your DPD account manager and inform them of the following error:
"There is no free parcel number within your parcel number ranges."
Your account manager will be able to check your label range and update it if necessary. Once the label range is adjusted, you should be able to generate labels again without issue.
What does this error mean?
This error occurs when the selected service point (PUDO) is no longer recognized or supported by the carrier (DPD).
How to fix it:
- Select a different service point when processing the shipment.
- You can search the original service point on DPD’s website to verify if it is currently active.
- If it is inactive, feel free to escalate the case to our support team so the outdated location can be removed from the service point list and avoid future confusion.
BPOST
What does this error mean?
This error occurs when a shipping method is selected that hasn’t been activated for the destination country in your Bpost contract. It most commonly affects accounts with a direct Bpost integration.
How to fix it:
To ship internationally using this method, you need to enable the relevant destination countries in your Bpost account settings. You can follow the steps in this guide, under the section “Enable your shipping countries for international shipping”:
👉 Enable international shipping – Bpost guide
Once the countries are enabled in your Bpost account, you should be able to create the label successfully.
What does this error mean?
This error appears when the selected service point is no longer active or recognized by Bpost. It prevents the label from being created until a valid pickup point is selected.
How to fix it:
- Check if the selected service point is still available using the Bpost service point selector in the checkout or on the Bpost website.
- If the service point is no longer active, go back to the shipment details and choose a different service point.
- After selecting a valid point, try generating the label again.
If the issue keeps occurring at the same point, feel free to report it to our Support team so we can look into updating the available service points.
What does this error mean?
This error typically appears when the HS (Harmonized System) code provided for a product exceeds the expected length or format accepted by the carrier's system.
How to fix it:
Check the HS code used for the product. It should:
- Be no longer than 8 digits
- Contain only even numbers of digits (e.g., 6 or 8 digits)
- Not be an odd number of digits (e.g., 7)
Once corrected, try generating the label again.
DHL
What does this error mean?
This error appears when the shipping address entered manually includes the address of a Packstation, which is not accepted in this format. Packstations must be selected via the service point map instead of being typed directly into the address fields.
How to fix it:
- Make sure the shipping address entered is the recipient’s personal address, not the address of a Packstation.
- If you want the parcel to be delivered to a Packstation, select it using the service point selection map during checkout or order creation.
- Avoid manually copying Packstation addresses into the standard address fields, as this will trigger an error.
Once the correct address or service point is selected, you can try generating The label again.
What does this error mean?
This error indicates a failure in processing the shipment request with DHL Express. It typically relates to an internal issue that needs to be reviewed by DHL.
How to fix it:
This issue cannot be resolved directly within Sendcloud. Please contact your DHL Express account representative and provide the Process ID shown in the error, so they can investigate further on their side.
PostNL
What does this error mean?
This error occurs when at least one of the items in the shipment does not have a valid declared value. The carrier requires each item to have a value between 1 and 8 characters, and a value of 0.00 is not accepted.
How to fix it:
- Review the items included in the shipment.
- Make sure each product has a value assigned; values such as 0.00 are not allowed.
- Enter a valid amount (e.g., the product price or estimated value) for each item.
Once all items have a valid value, try creating the label again.
What does this error mean?
This error is triggered when the postal code in the shipping address is not in a valid format for the destination country. In some cases, it may also be related to special characters used in the address fields.
How to fix it:
-
Check the postal code in the shipping address.
- If the postal code includes a state abbreviation (e.g., “FL12345”), remove the letters and use only the numeric part (e.g., “12345”).
- The state will already appear elsewhere on the label, so the prefix isn’t needed and can cause errors.
-
Check the name and address fields for any special characters (e.g., accented letters, symbols).
- If present, try replacing them with plain characters (e.g., “é” → “e”).
- Save the corrected address and attempt to generate the label again.
Mondial Relay
What does this error mean?
This error typically occurs when the selected Mondial Relay service point is temporarily unavailable or has reached its capacity. As a result, the shipment cannot be processed for that location.
How to fix it:
Select a different Mondial Relay service point and try generating the label again.
This issue is related to the capacity or availability of specific service points, and no further action is needed beyond selecting an alternative location.
Seur
What does this error mean?
This error occurs when SEUR has already received and recorded a shipment using the same order reference number on the same day.
It often happens after a failed label creation attempt, although the label wasn't generated, the order reference may still have been saved in SEUR’s system, causing a conflict when trying again.
How to fix it:
To resolve the error, change the order reference number to something new and unique. Then, attempt to create the label again.
UPS
What does this error mean?
This error usually occurs when the connection between your UPS contract and Sendcloud fails due to invalid or outdated authentication details. It can also happen if there is a communication issue with the carrier.
How to fix it:
- Go to your Shipping > Carriers > My contract > and check the UPS contract configuration.
- Make sure that all credentials (such as user ID, password, access key, or account number) are correct and up to date.
- If needed, reconnect the contract by removing it and adding it again using new credentials generated via UPS.
- Save your changes and try creating the label again.
If the issue persists, please contact our Support team for assistance.
BRT
What does this error mean?
This error indicates either a misconfiguration in the user’s BRT contract or that the pricing condition code (“codice tariffa”) is missing or incorrect.
How to fix it:
Reach out to BRT to confirm that web services are fully enabled for the contract. Additionally, verify that the “codice tariffa” is correctly entered in the contract settings.
What does this error mean?
This error appears when the BRT customer code linked to the user’s contract is not yet active or not properly associated within the BRT system.
How to fix it:
- If using a direct contract: contact your BRT account manager to verify that the customer code is active and correctly linked.
- If using Sendcloud rates: contact our Support team, who will liaise with BRT to resolve the issue.
What does this error mean?
This error indicates that the destination depot is not currently operational. This may be due to logistical disruptions, such as depot-specific issues or national strikes affecting the BRT network.
How to fix it:
There is no immediate user-side fix. You may choose to wait until operations resume, or reroute the shipment through a different depot or carrier if urgent.
Poste Italiane
What does this error mean?
This error is caused by a configuration issue in the Poste contract: the required organizational unit (“orgunits”) is not associated with the contract.
How to fix it:
You need to contact your Poste reference person (for direct contracts), as this setup is managed externally.
As a workaround, verify that the Cost Center entered in the courier connection modal follows this format: CDC-000NNNNN
What does this error mean?
This occurs when Poste Delivery credentials are incorrect or outdated, preventing label announcement or pickup booking via Sendcloud.
How to fix it:
- For direct contracts: verify the credentials associated with the Poste contract.
- For Sendcloud-managed contracts: confirm that no internal password changes have occurred.
If credentials appear valid but the issue continues, contact tech support. Poste may also need to be contacted to restore access.
If the issue becomes widespread, monitor status.sendcloud.com for updates.
What does this error mean?
There is a mismatch between the entered postal code (CAP) and the selected city. Poste is unable to determine the province for the given CAP.
How to fix it:
- Verify that the CAP (postal code) matches the correct city and province by using nonsolocap.it.
- Only main cities and provinces are recognized by the system — avoid entering minor subdivisions.
- If the address includes a “frazione” (local subdivision), place it in the Address 2 field instead of Address 1.