Handling Order Errors
Read and act on errors surfaced on an order.
Some orders carry errors recorded by upstream systems — for example a failed payment, a fulfilment integration failure, or a stock reservation problem. The app surfaces these at the top of the order detail page so staff can see what has gone wrong before taking any further action. This page explains where errors appear, what to look for, and how to deal with common situations.
Order-level errors
When an order has one or more recorded errors, a red alert banner appears at the very top of the order detail page, above the status progress bar. The banner shows an error icon on the left and lists each error message below it.
If there are no errors on the order, the banner is not shown.
Errors shown in this banner are recorded by the backend or integration systems. You cannot add or remove errors from within the app — they clear when the underlying problem is resolved in the originating system.
Each error entry shows a message from the system that raised it. In rare cases where no message is available, the entry reads Unknown error.
When the order detail fails to load
If the app cannot retrieve the order — for example due to a network interruption or a server error — the order detail page shows a full-screen error state instead of the order content. The screen shows:
- A large red error icon
- The heading Error loading order
- A description of the specific error below the heading
- A Retry button
Tap Retry to try loading the order again. If the problem persists, check your network connection or contact your system administrator.
When the order is not found
If the order ID no longer exists in the system — for example because it was deleted or the link is incorrect — the page shows:
Order not found
No Retry button is shown in this case. Navigate back to the Orders list and verify the correct order.
When the orders list fails to load
If the Orders list itself cannot load, the same full-screen error pattern is used — a red icon, the heading Error loading orders, an error description, and a Retry button. Tap Retry to reload the list.
Workflow step errors
When you update an order status and a workflow step fails to complete, the workflow results dialog highlights the failed step with a red error icon and a short description of what went wrong.
If a workflow step fails, the status change may still have been applied to the order. Review the order status after closing the dialog and take any necessary manual corrective action.
See Updating Order Status for full details on the workflow results dialog.
Print errors
If printing a label or document fails, a red notification appears at the bottom of the screen showing Print error: [detail] or Print failed: [detail]. These are transient notifications — they dismiss automatically. Attempt the print action again, and contact your system administrator if the problem continues.