Troubleshoot Label Generation Errors

Overview

AfterShip Returns is an automated, self-service portal designed to deliver a streamlined returns experience to shoppers. You can connect a AfterShip Shipping account to the AfterShip Returns and print labels with just a few clicks.

❗Error: data.shipment.ship_from.country is a required property

To generate labels successfully, the ship_from country must be specified for each return request.

✅ Steps to fix the error

Open order details in your store > Edit shipping address > Specify country in the shipping address
Print label again

❗Error: data.shipment.ship_from.phone is required for this request

This error occurs when a customer’s phone number is not mentioned in contact details. For some carriers, this is a necessary field.

✅ Steps to fix the error

Open order details in your store > Edit customer’s contact information > Add a phone number
Print label again

❗Error: data.shipment.ship_to.state should NOT be shorter than 1 character

✅ Steps to fix the error

Go to Return routing rules > Edit return shipping methods for the desired zone> Ship with a returns label > Auto-generate return labels > Set up shipping > Edit details > Specify state
Print label again

❗Error: 121100 The requested service is invalid for the shipment origin

This error occurs when a particular service is not supported for a shipping address.

✅ Steps to fix the error

Go to Return routing rules > Edit return shipping methods for the desired zone> Ship with a returns label > Auto-generate return labels > Set up shipping > Edit details > Select another shipping service
Print label again

Alternatively, you can visit the carrier's official website and check if the service is supported.

Errors specific to USPS

❗Error: 120213: ShipTo PhoneNumber must be at least 10 alphanumeric characters

✅ Steps to fix the error

Go to Return routing rules > Edit return shipping methods for the desired zone> Ship with a returns label > Auto-generate return labels > Set up shipping > Edit details > Enter phone number
Print label again

❗Error: 120309: Missing or invalid ship from phone number

This error occurs when a customer’s phone number is not mentioned in the contact details or is incorrect.

✅ Steps to fix the error

Open order details in your store > Edit customer’s contact information > Add a phone number
Print label again

❗ Error: 121210: The selected service is not available from the origin to destination**

This error occurs when a service is not available for a particular return request.

✅ Steps to fix the error

Go to Return routing rules > Edit return shipping methods for the desired zone> Ship with a returns label > Auto-generate return labels > Set up shipping > Edit details > Select another service
Print label again

Alternatively, you can visit the Carrier's official website and check if the service is supported.

❗Error: 120121: The Shipper’s shipper number cannot be used for the shipment**

This error occurs due to incorrect details entered while setting up a AfterShip Shipping account.

✅ Steps to fix the error

Ensure the following requirements are fulfilled:

You have a AfterShip Shipping USPS Shipper Account

The ship-to address for the order is US

❗ Error: 121501: The selected packaging is not valid with the requested accessory option**

✅ Steps to fix the error

Go to Return routing rules > Edit return shipping methods for the desired zone> Ship with a returns label > Auto-generate return labels > Set up shipping > Edit details > Select another Package
Print label again

Updated on: 04/08/2023