Plans: All Plans | Platforms: All platforms
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.
Common errors
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.
Error: Failed to Generate Labels
This error typically occurs when there is a mismatch between the selected package type and the carrier service type. To resolve this:
Verify that the package dimensions and box type you selected are supported by the carrier service level you are using.
Adjust the package type or service level as needed and reattempt label generation. Another cause of this error can be invalid shipment data, such as overly long address fields. For example, the "Town" field exceeding the allowed character length can trigger this issue. To fix:
Review the shipment and address details, especially the Town/City field, and shorten or correct any overly long values.
Reattempt label generation after correcting the data.### Error:
data.shipment.ship_to.country must be the same as shipper_account.country for return shipmentThis error occurs when the return destination country (ship_to.country) does not match the country associated with the shipper’s carrier account. To resolve this:Verify the country on your return address in the system.
Confirm that the carrier account you selected for the return label is registered for the same country as the return address. Important Note for UPS Users: UPS return shipments require the ship_to country to match the UPS account’s country. For example, a UPS account based in the USA can only generate return labels for addresses in the USA. Ensure alignment between the return address country and the UPS account country, or use a carrier account based in the destination country.
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
For any further questions or help, please contact our chat support team or reach out to us at [email protected].
Best Practices for Return Label Setup
Setting Default Carrier and Package Details
To streamline the return label generation process, you can set up routing rules to define default carrier/service and package details. Here’s how:
Create routing rules with conditions that apply to all returns (e.g., by location or store-wide conditions).
Configure the action to use your desired carrier/service (e.g., UPS) and package type (e.g., Customer Supplied Package).
Ensure that the shipping information in the rule matches your carrier’s allowed services and package types.
Avoid using conditions that rely on Customer Tags if you are not on Shopify, as this may cause issues.