Why Can’t Return Labels Be Generated in Swap, and How Can I Resolve the Issue?

Return label and QR code generation issues in Swap can arise due to various reasons, including carrier-specific configurations, regional restrictions, system errors, or address-related problems. This article outlines common causes and provides actionable steps to resolve these issues.

Common Causes and Resolutions

1. Carrier Configuration Errors

Missing Destination Settings

If the selected carrier (e.g., DHL) does not have a destination configured, return labels cannot be generated.

Resolution: Update the destination settings for the carrier in your shipping configuration. After updating, delete the affected return/exchange and resubmit it to generate the label.

Incorrect Sender Address Formatting

DHL labels may fail due to formatting errors in the sender address, such as missing street numbers or unsupported special characters.

Resolution: Replace special characters (e.g., change “ß” to “ss”) and ensure the address includes a street number. Save the updated address and regenerate the label.

Incorrect Product Weight

If a product weight is not set in Shopify, a default weight of 0.1 kg is applied, which may cause issues.

Resolution: Set the correct product weight in Shopify, delete the existing return, and reprocess it to generate a new label with the correct weight.

Unsupported Regions

Some carriers, like DHL Return Connect, do not support returns from specific regions (e.g., Malta).

Resolution: Use an alternative carrier, such as UPS, to generate the return label.

2. Regional Restrictions

Country Not Enabled for Returns

Return labels may fail if the customer’s origin country is not configured in your returns settings.

Resolution: Add the country to your enabled return regions and configure the carrier and return shipping fee. Once added, customers can generate labels.

Carrier-Specific Regional Limitations

For example, a Spain-based UPS account cannot generate return labels for shipments to the UK.

Resolution: Use a UK-based UPS account for GB returns or configure the carrier appropriately.

3. System Downtime or Errors

Temporary Carrier Downtime

For example, EVRi downtime may prevent label generation.

Resolution: Labels affected during downtime are automatically regenerated and sent to customers. No further action is required.

Missing Customs Information

Labels may fail if product variants lack customs information, such as HS codes.

Resolution: Add valid HS codes to all product variants, delete the existing RMA, and resubmit the return to generate a new label.

4. Alternative Solutions for Label Generation Failures

No Suitable Drop-Off Location

If a DHL label fails due to the recipient’s address being too far from a DHL depot:

Resolution: Generate a return label with an alternative carrier, such as UPS.

No Alternative Carrier Enabled

If no alternative carrier is enabled, customers may need to arrange their own return shipment.

Resolution: Enable an alternative carrier in your dashboard to provide customers with additional options.

5. Mintsoft Integration Issues

If an order is closed in Mintsoft before dispatch, shipment data is not sent to Swap, preventing label creation.

Resolution: Reopen the order in Mintsoft, reprocess the shipment, and set the shipping method to SWAP. Mark the order for dispatch again to trigger label creation.

6. Drop-Off Point Issues

If a DHL return label is not accepted at a drop-off point:

Resolution: Regenerate the label from the RMA in your dashboard. Ensure the label has two barcodes and advise the customer to try another DHL access poi

7. QR Code Generation Issues

Address-Related Issues

QR codes will not generate if the return address contains errors or is incomplete. Common address-related problems include:

Invalid or incorrectly formatted postcodes (e.g., "S73 0NR" instead of "S73 onr").
Missing country information in the address. Solution:
Verify and correct the address details, ensuring all fields are complete and formatted correctly.
After updating the address, delete the existing return and resubmit it to generate the QR code.

Carrier-Specific Limitations

Some carriers have restrictions on QR code generation:

DHL: QR codes are not supported for DHL return labels. Only printable labels are available.
Own Label Shipping: QR codes may not generate if there is no active carrier available for the destination (e.g., returns from Ireland). Solution:
For DHL, download the printable return label and provide it to the customer.
For Own Label Shipping, reprocess the return using a carrier label (e.g., UPS) to generate a standard printable label.

Network Issues

QR code generation may fail due to intermittent network performance issues with external service providers. These outages can temporarily disrupt QR code creation. Solution:

No action is required on your part. Once the service provider resolves the issue, QR code generation should resume automatically.

Missing Customer Information

QR codes may not generate if essential customer information is missing from the order. For example, Royal Mail QR codes require a first and last name to be included in the order details. Solution:

Ensure the order includes the customer’s first and last name in your e-commerce platform.
After adding the missing information, delete the existing return and resubmit it to generate the QR code.nt.

General Troubleshooting Steps

Verify carrier settings and ensure all required configurations are complete.
Check for regional restrictions or unsupported destinations.
Update product information, such as weights and customs details.
Enable alternative carriers to provide customers with more options.
Regenerate labels after resolving configuration issues.
Verify customer information (e.g., first and last name) is complete in your e-commerce platform.
For QR code failures with DHL, use the printable label as an alternative.

By following these steps, you can resolve most return label and QR code generation issues in Swap.

Why can’t return labels be generated in Swap, and how can I resolve the issue?