Common Troubleshooting Tips
data.shipment.ship_to.city is a required property
data.shipment.ship_to.city is invalid
data.shipment.ship_to.postal_code is invalid
data.shipment.ship_to.street1 is invalid
data.shipment.ship_to.phone is invalid
data.shipment.ship_to.email is invalid
data.shipment.ship_to address is invalid
data.shipment.ship_from.postal_code is invalid
data.shipment.ship_from.phone is invalid
data.shipment.ship_from address is invalid
You don't have permission to access AfterShip Shipping API. Please upgrade to a Pro plan
the carrier service is unavailable, please try again later
data.service_type is not available for this shipment,please select an appropriate and acceptable service type
Shipper account not found
SSL certificate problem: certificate has expired
If you need further assistance or have any questions, please don't hesitate to reach out to our support team.
The city field is missing in the receiver's address of your shipment.
Ensure that you include the 'city' field in the receiver's address when making the request.
If you're uncertain about the validity of the address, you can use a service like https://dct.dhl.com/ to verify its correctness.
The city is invalid in the receiver's address of your shipment.
In general, our response will include the suggestion address, such as data.shipment.ship_to.city is invalid, the correct city might be CARSON. Please update your city and try again, you can use the suggestion city to retry.
Refer to the suggested changes to the value of the shipment.ship_to.city.
If you're uncertain about the validity of the address, you can use a map service like https://www.google.com/maps to verify its correctness.
The postal_code is invalid in the receiver's address of your shipment.
In general, our response will include the suggestion address, such as data.shipment.ship_to.postal_code is invalid, the correct postal_code might be xxx . Please update your postal_code and try again, you can use the suggestion postal_code to retry.
Refer to the suggested changes to the value of the shipment.ship_to.postal_code.
If you're uncertain about the validity of the address, you can use a map service like https://www.google.com/maps to verify its correctness.
The street1 is invalid in the receiver's address of your shipment.
In general, our response will include the suggestion address, such as data.shipment.ship_to.street1 is invalid, the correct address might be U 44 134 ... ... Please update your street1 and try again, you can use the suggestion street1 to retry.
Refer to the suggested changes to the value of the shipment.ship_to.street1.
If you're uncertain about the validity of the address, you can use a map service like https://www.google.com/maps to verify its correctness.
The phone is invalid in the receiver's address of your shipment.
Check the format of the phone number in the recipient's address and modify it.
The email is invalid in the receiver's address of your shipment.
A valid email address consists of an email prefix and an email domain, both in acceptable formats. The prefix appears to the left of the @ symbol. The domain appears to the right of the @symbol. For example, in the address example@mail.com, "example" is the email prefix, and "mail.com" is the email domain.
Check the format of the email in the recipient's address and modify it.
The address is invalid in the receiver's address of your shipment.
In general, our response will include the suggestion address, such as data.shipment.ship_to address is invalid, the correct address might be U 44 134 ... ... Please update your ship_to address and try again, you can use the suggestion address to retry.
If you're uncertain about the validity of the address, you can use a map service like https://www.google.com/maps to verify its correctness.
The postal_code is invalid in the shipper's address of your shipment.
In general, our response will include the suggestion address, such as data.shipment.ship_from.postal_code is invalid, the correct postal_code might be xxx . Please update your postal_code and try again, you can use the suggestion postal_code to retry.
Refer to the suggested changes to the value of the shipment.ship_from.postal_code.
If you're uncertain about the validity of the address, you can use a map service like https://www.google.com/maps to verify its correctness.
The phone is invalid in the shipper's address of your shipment.
Check the format of the phone number in the shipper's address and modify it.
The address is invalid in the shipper's address of your shipment.
In general, our response will include the suggestion address, such as data.shipment.ship_from address is invalid, the correct address might be U 44 134 ... ... Please update your ship_from address and try again, you can use the suggestion address to retry.
If you're uncertain about the validity of the address, you can use a map service like https://www.google.com/maps to verify its correctness.
You're required to subscribe AfterShip Shipping Pro plan or Enterprise plan to use the API capabilites.
If you're interested at our Enterprise plan, please refer to here for details.
If you're not interested at our Enterprise plan, you can subscribe our online plans at AfterShip Shipping portal.
The carrier service is temporarily unavailable or there may be some internal error on the carrier side.
You can wait for a moment and retry the same shipment again. It should work properly. If you still face the same error, please confirm with the carrier side or check their announcements regarding their service status.
It typically indicates that the service you are trying to select or access is currently unavailable or restricted. For example, you selected a service type that can't be used for your destination, or your account settings have some limitations for this.
You can use other service types that might be more suitable for your needs. For instance, with Australia Post, you cannot use australia-post_parcel_post_sign for a return shipment. Instead, please use australia-post_eparcel_post_returns or australia-post_eparcel_post_returns.
Alternatively, you can contact your carrier account manager for advice.
An API request was initiated using a non-existent shipper account id.
Log in to the https://admin.postmen.com/carriers to view the list of carriers and find the carrier account you need to use.
Copy the correct account id with the button.
Refer to the documentation for changes to use the correct shipper_account.id property
The cause of the problem is that the root SSL certificate of the server is expired. This certificate is used to communicate between two websites, and this communication can only happen via https. The communication between two servers uses a different certificate than the communication between the browser and the website.
Normally, you don't need to save our SSL certificate then use it for the API requests, and you should not meet this error.
Please check with your IT team and make sure you don't save our SSL certificate at your local server.
If you save, please remove it from your local server and try again to call our API should resolve this error.
data.shipment.ship_to.city is invalid
data.shipment.ship_to.postal_code is invalid
data.shipment.ship_to.street1 is invalid
data.shipment.ship_to.phone is invalid
data.shipment.ship_to.email is invalid
data.shipment.ship_to address is invalid
data.shipment.ship_from.postal_code is invalid
data.shipment.ship_from.phone is invalid
data.shipment.ship_from address is invalid
You don't have permission to access AfterShip Shipping API. Please upgrade to a Pro plan
the carrier service is unavailable, please try again later
data.service_type is not available for this shipment,please select an appropriate and acceptable service type
Shipper account not found
SSL certificate problem: certificate has expired
If you need further assistance or have any questions, please don't hesitate to reach out to our support team.
data.shipment.ship_to.city is a required property
What it means
The city field is missing in the receiver's address of your shipment.
How to solve
Ensure that you include the 'city' field in the receiver's address when making the request.
If you're uncertain about the validity of the address, you can use a service like https://dct.dhl.com/ to verify its correctness.
data.shipment.ship_to.city is invalid
What it means
The city is invalid in the receiver's address of your shipment.
How to solve
In general, our response will include the suggestion address, such as data.shipment.ship_to.city is invalid, the correct city might be CARSON. Please update your city and try again, you can use the suggestion city to retry.
Refer to the suggested changes to the value of the shipment.ship_to.city.
If you're uncertain about the validity of the address, you can use a map service like https://www.google.com/maps to verify its correctness.
data.shipment.ship_to.postal_code is invalid
What it means
The postal_code is invalid in the receiver's address of your shipment.
How to solve
In general, our response will include the suggestion address, such as data.shipment.ship_to.postal_code is invalid, the correct postal_code might be xxx . Please update your postal_code and try again, you can use the suggestion postal_code to retry.
Refer to the suggested changes to the value of the shipment.ship_to.postal_code.
If you're uncertain about the validity of the address, you can use a map service like https://www.google.com/maps to verify its correctness.
data.shipment.ship_to.street1 is invalid
What it means
The street1 is invalid in the receiver's address of your shipment.
How to solve
In general, our response will include the suggestion address, such as data.shipment.ship_to.street1 is invalid, the correct address might be U 44 134 ... ... Please update your street1 and try again, you can use the suggestion street1 to retry.
Refer to the suggested changes to the value of the shipment.ship_to.street1.
If you're uncertain about the validity of the address, you can use a map service like https://www.google.com/maps to verify its correctness.
data.shipment.ship_to.phone is invalid
What it means
The phone is invalid in the receiver's address of your shipment.
How to solve
Check the format of the phone number in the recipient's address and modify it.
data.shipment.ship_to.email is invalid
What it means
The email is invalid in the receiver's address of your shipment.
A valid email address consists of an email prefix and an email domain, both in acceptable formats. The prefix appears to the left of the @ symbol. The domain appears to the right of the @symbol. For example, in the address example@mail.com, "example" is the email prefix, and "mail.com" is the email domain.
How to solve
Check the format of the email in the recipient's address and modify it.
data.shipment.ship_to address is invalid
What it means
The address is invalid in the receiver's address of your shipment.
How to solve
In general, our response will include the suggestion address, such as data.shipment.ship_to address is invalid, the correct address might be U 44 134 ... ... Please update your ship_to address and try again, you can use the suggestion address to retry.
If you're uncertain about the validity of the address, you can use a map service like https://www.google.com/maps to verify its correctness.
data.shipment.ship_from.postal_code is invalid
What it means
The postal_code is invalid in the shipper's address of your shipment.
How to solve
In general, our response will include the suggestion address, such as data.shipment.ship_from.postal_code is invalid, the correct postal_code might be xxx . Please update your postal_code and try again, you can use the suggestion postal_code to retry.
Refer to the suggested changes to the value of the shipment.ship_from.postal_code.
If you're uncertain about the validity of the address, you can use a map service like https://www.google.com/maps to verify its correctness.
data.shipment.ship_from.phone is invalid
What it means
The phone is invalid in the shipper's address of your shipment.
How to solve
Check the format of the phone number in the shipper's address and modify it.
data.shipment.ship_from address is invalid
What it means
The address is invalid in the shipper's address of your shipment.
How to solve
In general, our response will include the suggestion address, such as data.shipment.ship_from address is invalid, the correct address might be U 44 134 ... ... Please update your ship_from address and try again, you can use the suggestion address to retry.
If you're uncertain about the validity of the address, you can use a map service like https://www.google.com/maps to verify its correctness.
You don't have permission to access AfterShip Shipping API. Please upgrade to a Pro plan at https://admin.postmen.com/settings/billing to get access to premium features
What it means
You're required to subscribe AfterShip Shipping Pro plan or Enterprise plan to use the API capabilites.
How to solve
If you're interested at our Enterprise plan, please refer to here for details.
If you're not interested at our Enterprise plan, you can subscribe our online plans at AfterShip Shipping portal.
the carrier service is unavailable, please try again later
What it means
The carrier service is temporarily unavailable or there may be some internal error on the carrier side.
How to solve
You can wait for a moment and retry the same shipment again. It should work properly. If you still face the same error, please confirm with the carrier side or check their announcements regarding their service status.
data.service_type is not available for this shipment, please select an appropriate and acceptable service type
What it means
It typically indicates that the service you are trying to select or access is currently unavailable or restricted. For example, you selected a service type that can't be used for your destination, or your account settings have some limitations for this.
How to solve
You can use other service types that might be more suitable for your needs. For instance, with Australia Post, you cannot use australia-post_parcel_post_sign for a return shipment. Instead, please use australia-post_eparcel_post_returns or australia-post_eparcel_post_returns.
Alternatively, you can contact your carrier account manager for advice.
Shipper account not found
What it means
An API request was initiated using a non-existent shipper account id.
How to solve
Log in to the https://admin.postmen.com/carriers to view the list of carriers and find the carrier account you need to use.
Copy the correct account id with the button.
Refer to the documentation for changes to use the correct shipper_account.id property
SSL certificate problem: certificate has expired
What it means
The cause of the problem is that the root SSL certificate of the server is expired. This certificate is used to communicate between two websites, and this communication can only happen via https. The communication between two servers uses a different certificate than the communication between the browser and the website.
Normally, you don't need to save our SSL certificate then use it for the API requests, and you should not meet this error.
How to solve
Please check with your IT team and make sure you don't save our SSL certificate at your local server.
If you save, please remove it from your local server and try again to call our API should resolve this error.
Updated on: 25/01/2024
Thank you!