| Cannot delete a customer | The customer has linked shipments, invoices, or other records. | Use the deactivate toggle instead. Only customers with no linked records can be hard-deleted. |
| Customer cannot log in to the portal | No password was set and the invitation email was not received or has expired. | Open the customer detail page and click Resend Invitation to send a new portal access link. If SMTP is not configured, copy the invitation URL from the amber banner and share it manually. |
| Import skips many rows | Required fields are missing, email format is invalid, or duplicate emails already exist in the database. | Review the import summary report for specific error reasons per row. Fix the source file and re-upload. |
| Customer not found during shipment creation | The customer may be deactivated or the search term does not match any field. | Check that the customer is active. Try searching by email or phone instead of name. |
| Self-registration link shows 404 | The organization slug in the URL is incorrect or the organization is inactive. | Verify the correct org-slug in Settings → Organization. Ensure the organization is active. |
| Locker not created after self-registration | The locker auto-creation feature may be disabled in organization settings. | Check Settings → Organization → Locker Settings and ensure auto-creation is enabled for new customer registrations. |
