Troubleshoot address validation

Updated 2026-09-07

When validation fails or carriers return packages, fix the ship-to data before buying another label.

Symptom

• Address rejected at rate shop or purchase
• Suggested correction looks wrong
• Package returns to sender / undeliverable as addressed

Cause

• Missing apartment, suite, or unit
• City / state / ZIP mismatch
• PO Box used with a carrier that does not deliver to PO Boxes
• Military or territory format incorrect
• Buyer typo on the store checkout

Fix

1. Open the order or Get Label draft.
2. Compare the address to the buyer’s order confirmation.
3. Add unit numbers; fix ZIP; use autocomplete when the suggestion matches the real building.
4. For PO Boxes, prefer USPS or obtain a street address for UPS/FedEx.
5. Re-run validation and get rates.
6. Place Order from the corrected order if it is a store fulfill.

Prevent

• Validate before purchase — see Validate shipping addresses
• Keep the address book clean
• Train staff not to strip secondary unit lines from imports