Carrier - UPS Troubleshooting

Overview

If you are receiving an error messages related to the UPS shipments, the article provides the troubleshooting tips to help you resolve the issues.

Error messages

data.shipment.ship_to.phone is too short, minimum length is 10

What does it mean

The error message indicates that the phone number you’ve entered for the recipient is shorter than the minimum required length of 10 digits.

How to solve

Double check the recipient's phone number and confirm if it is correct and valid.
If the phone number is correct, but is still short, considering adding the country code.

data.shipment.ship_to.phone is too long maximum length is 15

What does it mean

The error indicates that the phone number you’ve entered for the recipient is longer than the maximum required length of 15 digits.

How to solve

Double check the recipient's phone number and confirm if it is correct and valid.
If the phone number is correct, but is still longer, considering removing the country code.

data.shipment.ship_from.phone is too short, minimum length is 10

What does it mean

The error indicates that the shipper's phone number is shorter than the minimum required length of 10 digits.

How to solve

Double check the shipper's phone number and confirm if it is correct and valid.
If the phone number is correct, but is still short, considering adding the country code.

data.shipment.ship_from.phone is too long maximum length is 15

What does it mean

The error indicates that the phone number you’ve entered for the shipper is longer than the maximum required length of 15 digits.

How to solve

Double check the shipper's phone number and confirm if it is correct and valid.
If the phone number is correct, but is still longer, considering removing the country code.

data.shipper_account is not available for this shipment

What does it mean

The error indicates indicates that the shipper account you’re trying to use for shipping is not eligible or cannot be used for the current shipment.

How to solve

Reach out to your UPS account manager or customer support to check the account status and verify the details of the account. They can help provide specific insights on why the account is not available for the shipment and help activate any necessary services or permissions.

data.shipment.ship_from.country must be the same as shipper_account.country for forward shipment.

What does it mean

The error message means that when using UPS for forward shipments, the origin country of the shipment must match the country associated with your UPS account.

For example, if your UPS account is based in the USA, you can only ship from the USA.

How to solve

If you only have a USA account, but expect to ship from GBR (Great Britain), you will need to contact your UPS account manager to recreate a GBR-enabled UPS account and create a carrier account at AfterShip Shipping.
Once the GBR-enabled account is enabled, use that account to create your shipping labels for any shipments originating from GBR.

data.shipment.ship_to.country must be the same as shipper_account.country for return shipment.

What does it mean

The error message means that when using UPS for return shipments, the destination country of the shipment must match the country associated with your UPS account.

For example, if your UPS account is based in the USA, you can only send return shipments to addresses in the USA.

How to solve

If you have a UPS account that is only based in the USA but need to ship returns to GBR, you will need to contact your UPS account manager to recreate a GBR-enabled UPS account and create a carrier account at AfterShip Shipping.
Once the GBR-enabled account is enabled, use that account to create your return shipping labels for any shipments going to GBR.

Request can not be authorized due to invoice not found in UPS billing system.

What does it mean

The input invoice info cannot be found in UPS billing system to authorize the carrier account creation. The invoice may be too old or the invoice number maybe incorrect.

How to solve

Please double check and make sure you have input the correct invoice number within required date range.
The invoice should be in the past 90 days, or the past 45 days for accounts not based in the US or Canada.

Updated on: 07/10/2024