| No rate options appear in Step 3 | No rate card covers the origin-destination pair, or rate cards are inactive | Go to Settings → Rates and verify that an active rate card exists for the selected route |
| Country/State/City dropdowns are empty | Geographic data has not been seeded or imported | Run the geographic data seeder or import countries/states/cities from Settings → Locations |
| Google Places autocomplete not working | Google Maps API key is missing or invalid | Configure a valid Google Maps API key in Settings → Integrations → Maps |
| Cannot delete a shipment | The shipment is linked to an active invoice or manifest | Cancel or void the linked invoice/manifest first, then retry deletion |
| Label barcode does not scan | Print quality is too low or label is smudged | Reprint the label at a higher DPI setting. For thermal printers, ensure the print head is clean. |
| Status change button shows no options | The shipment is in a terminal state (delivered, cancelled, returned) | Terminal states do not allow further transitions. For delivered shipments, use the Return Request flow instead. |
