Recovering a Deleted Cart
How to recreate a cart that was deleted from another channel while the In-Store App had it active.
When the active cart is deleted from an external channel — such as the back office or another device — the In-Store App detects the deletion in the background and surfaces a Cart Deleted dialog. If the cart had items, you are given the option to recreate it immediately with the same line items.
This page covers the automatic recovery dialog and explains which deletion scenarios cannot be recovered.
When recovery is offered
The app polls the active cart in the background. If it detects that the cart no longer exists on the server and the cart contained at least one item, it shows the Cart Deleted dialog automatically — no action is required to trigger it.
If the deleted cart was empty, no dialog is shown. The cart panel clears silently and you can start a new cart.
The Cart Deleted dialog
When the dialog appears:
| Element | Description |
|---|---|
| Warning icon + Cart Deleted title | Signals that the cart was removed externally |
| This cart has been deleted from another channel. | Confirms the source of the deletion |
| Would you like to recreate it with the same items? | The recovery prompt, shown in bold |
| Item count | The number of line items in the deleted cart, shown in muted text |
The dialog has two actions:
| Button | What it does |
|---|---|
| CANCEL | Dismisses the dialog and clears the active cart — no recreation |
| RECREATE CART | Creates a new cart and adds back all the original line items |
Recreating the cart
Tap RECREATE CART. The app creates a new cart on the server and adds all the original line items back, preserving quantities.
On success, a Cart recreated successfully notification is shown and the new cart becomes the active cart.
The recreated cart is a new cart with a new cart ID. Any customer attachments, shipment settings, or manual discounts from the original cart are not carried over — only the line items and their quantities are restored.
If recreation fails, a Failed to recreate cart: [reason] error notification is shown. In that case, add the items manually to a new cart.
Cancelling without recovering
If you tap CANCEL, or dismiss the dialog by tapping outside it or pressing back, the cart panel clears and the deleted cart is not recreated. Start a new cart to continue serving the customer.
When recovery is not available
Recovery is only offered when the deletion is detected while the cart is active in the app. In the following situations, a recovery dialog is not shown and the deletion cannot be undone:
| Situation | What happens |
|---|---|
| Staff taps Delete cart in the cart panel overflow menu (⋮) | Cart is deleted immediately; a Cart deleted successfully notification is shown |
| Staff taps Delete cart in the Carts list context menu | Cart is deleted immediately; a Cart [ID] deleted notification is shown |
| The deleted cart had no items | Cart panel clears silently; no dialog is shown |
Manual deletions from the cart panel or the Carts list are permanent and cannot be recovered. Take care when using the Delete cart action.
