Troubleshooting
Learn how to fix issues with return labels and more.
By Jemma1 author20 articles
Return label errors
Got a label error? Here's how to fix it.
- Troubleshooting return label generation issuesOverview of the most common reasons return labels fail to generate in Swap, and how to resolve them — including carrier settings, address issues, missing customs data, and more.
- Label error — No nearby DHL drop-off locationDHL label error caused by no supported drop-off location near the customer's postcode. Learn how to switch carrier or use a DHL collection service.
- Label error — Phone number missing or invalidReturn label error caused by a missing or invalid phone number — either in the customer's shipping address or the merchant's company settings. Covers FedEx, Evri, and more.
- Label error — UPS — Address Validation Error on ShipFrom addressUPS label error caused by an invalid ship-from address. The issue can be with the customer's address in the RMA or the merchant's return address in company settings.
- Label error — UPS — Missing or invalid ship-from state or province codeUPS label error caused by a missing or invalid state or province code on the merchant return address. Learn how to fix it in Swap company settings.
- Label error — DHL — Origin location is invalidDHL label error caused by an invalid origin or return address. The issue can be with the customer's address in the RMA or the merchant's return address in company settings.
- Label error — DHL — Invalid postcode formatDHL label error caused by an incorrectly formatted postcode. Learn how to fix the postcode format for the destination country.
- Label error — UPS — Invalid or missing product origin country codeUPS label error caused by a missing or invalid country of origin on a product. Learn how to add a valid country of origin in the merchant catalog.
- Label error — UPS — Harmonized system code is not definedUPS label error caused by a missing HS code on one or more products. Learn how to add the required customs classification in the product catalog.
- Label error — Royal Mail — Shipment weight exceeds max weight allowedRoyal Mail label error caused by the parcel weight exceeding the 20 kg maximum. Learn how to resolve overweight shipments.
- Label error — FedEx — Carrier timeout or temporary outageFedEx label error caused by a temporary carrier timeout or outage. Learn what to do when FedEx fails to respond during label generation.
- Label error — FedEx — Service type not supportedFedEx label error caused by the selected service not being available for the shipment route or destination. Learn how to switch to a supported service.
- Label error — Royal Mail — Item value out of rangeRoyal Mail label error caused by a declared item value of zero or outside the accepted range. Learn how to correct the item value.
- Label error — DPD UK — Synkka Print Label API 422DPD UK label error via Synkka caused by an unsupported return route, most commonly a customer address in Northern Ireland. Learn how to resolve it.
- Label error — UPS — BillShipper account number mismatchUPS label error caused by a mismatch between the billing account number and the shipper account number. Requires Swap support to fix the carrier configuration.
- Label error — DHL Express — Multiple problems found due to missing COO or HS codeDHL Express label error caused by missing country of origin (COO) or HS code on one or more products. Learn how to add the missing customs data.
- Label error — SEKO EasyPost — Malformed syntaxSEKO EasyPost label error caused by missing or invalid customer contact details, usually a missing or incorrectly formatted phone number.
- Label error — Evri — Request failed with status code 400Evri label error caused by a 400 status code, usually due to a temporary carrier issue. Learn how to resolve it.
- Label error — SEKO — Invalid suburb, city, and postcode combinationSEKO label error caused by an invalid suburb, city, and postcode combination. Most commonly seen for Australian and New Zealand addresses.
- Label error — DHL or UPS — Transportation payer and duty/tax payer combination invalidDHL or UPS label error caused by an invalid combination of transportation payer, duty payer, and VAT settings. Most commonly seen on UPS Standard EU shipments.