Why does sending an order to the carrier fail over the address?
Last verified: 2026-09-18
The unmapped-address message is not a system fault but deliberate protection: the system refuses to hand a carrier an order outside its coverage instead of accepting a shipment that would stall later. The fix always lives in the area mapping, not in blind retries: one correct row with the store country and city plus the carrier city id opens the door for every order in that area. See sending an order to the carrier, connecting a shipping carrier, and shipping carrier support.
Fix steps
- Copy the shipping address country and city from the failed order exactly as the customer wrote them.
- Open the shipping carrier integrations on the shipping page and pick the intended carrier.
- Add a new area-mapping row with the store country and city plus the matching carrier city id.
- Save the mapping and wait until the area-mapping-saved success message appears.
- Return to the order, send it again, and watch for the send-success message.
Recommended practices
- Cover every city you sell in with mapping rows in advance instead of fixing at each failure.
- Double-check city names and ids, since a spelling slip is a common cause of mismatch.
- When a whole area keeps failing, review the actual carrier coverage for that area.
- Document added mapping rows to ease review when switching carriers.
Frequently Asked Questions
What causes the unmapped-address message?
No area-mapping row matches the shipping address country and city for the chosen carrier, so the system refuses sending to protect you from a shipment that would stall. The fix is adding the matching row, then sending again.
Which data does an area-mapping row require?
The row requires the store country and city with the matching carrier city id. After saving and seeing the save-success message, sending becomes available for every order in that area.
I added the row but sending still fails. What now?
Verify the city spelling and id match the carrier data exactly, confirm the mapping was saved with its success message, and review the actual carrier coverage for that area before retrying.