Error messages
Messages you may see, what they mean, and what to do.
The app's refusals are written to be read — this page collects the ones worth knowing ahead of time, with the fix.
| Message | What it means | What to do |
|---|---|---|
| "One or more items are out of stock" | A stock check failed at the moment of writing — often a race with another till. | Check the stock page; reduce the line or restock. |
| "an order that is … cannot be edited — use a return or a refund" | The order is past confirmed — the wall. | Process a return or refund instead. |
| "order status changed by another request — please refresh and retry" | A colleague moved the order first. | Refresh; the menus now show where it really is. |
| "cannot complete order before payment is completed" (and kin) | A cross-axis guard: completion needs payment and fulfilment done. | Settle the blocking axis first — the message names it. |
| "store is disabled" / "store is archived" / "store is being deleted" | The store takes no writes in that state; reads still work. | Enable the store, or work in another. |
| "store credit 'REF-…' was just used on order 'ORD-…'" | Two orders raced for one credit slip; this one lost. | Remove the credit from this order — it names the winner. |
| Message | What it means | What to do |
|---|---|---|
| "cannot complete order while … is owed back — void a payment or refund the excess first" | An edit lowered the total below what was paid; the order shows Refund due. | Void a payment or refund the excess. |
| "cannot complete order while … is still owing — record the payment first" | The order's payments don't cover its total. | Record the payment. |
| "paid is recorded when a payment settles the total — record the payment instead" | Paid can't be picked by hand while money is owing. | Pick Paid again — it opens Record payment — or record from the Payments section. |
| "… is recorded against this order — void the payments and the status returns to pending on its own" | Pending can't be picked while money is recorded. | Pick Pending to open Void payments, or void the rows yourself. |
| "payment exceeds the outstanding balance" | The payment is larger than what remains. | Record at most what remains; change given is not a payment. |
| "an overpayment is refunded in cash or as an adjustment — a store credit for money owed back is not supported yet" | Store credit isn't offered for an overpayment refund. | Refund as a cash return or an adjustment. |
| Message | What it means | What to do |
|---|---|---|
| "this product still has stock in one or more stores — adjust it to zero before deleting, or mark it out of stock instead" | Delete is blocked while stock exists anywhere. | Zero the stock honestly, or archive the product. |
| "product name already exists" / "SKU must be exactly 6 digits" | The uniqueness and format rules — business-wide, variants included. | Pick another value, or leave the code blank to have one generated. |
| "This product still has stock in this store. Adjust it to zero, or mark it out of stock instead." | Unlinking would destroy the stock record. | Zero it first, or just switch the product out of stock. |
| "a note is required when the reason is 'other'" / "reason … cannot increase stock" | The adjustment reason rules. | Add the note, or pick the reason that matches the direction. |
| "Batch number must be the letter B followed by 5 digits" / "reserved for the system" | The batch number format; prefixed numbers belong to the system. | Use the B00042 shape. |
| Message | What it means | What to do |
|---|---|---|
| "only completed orders can be returned" | A return needs a finished sale behind it. | Complete or cancel the order first. |
| "…K have already been returned, so R remain" | The quantity ceiling — more can't come back than went out. | Return at most R. |
| "refund amount X exceeds the Y still refundable on this return (A of B already allocated)" | The refund ceiling, counting pending refunds too. | Refund at most Y, or cancel a pending refund first. |
| "a COMPLETED return is final — its items and fees cannot be changed" | Completed returns freeze — reopening once restocked goods twice. | Raise a fresh return or refund for the difference. |
| "a store credit settles when the customer spends it at checkout, not by hand — cancel it instead…" | Credit settlement is the system's. | Cancel the credit if it shouldn't be redeemable. |
| Message | What it means | What to do |
|---|---|---|
| "you have used all of your staff seats; buy another seat or free one up, then try again" | A seat-pool refusal — not an upgrade prompt. | Buy a seat, or free one (disable/delete a unit). |
| "this workspace cannot add you right now — please contact your administrator and try this link again" | An invitee hit an empty seat pool; the link stays valid. | The Administrator frees or buys a seat; the same link then works. |
| "monthly order limit reached for the free plan" | The Free plan's order allowance is spent for the month. | Upgrade, or wait for the window to reset. |
| "… is not available on your current plan" | A plan capability gate — the message names the feature. | See which plan includes it; the in-app upgrade page names the cheapest. |
| "this date range is outside the analytics history included in your current plan" | The history window. | Narrow the range, or move to a plan with a longer window. |
| "customer has orders and cannot be deleted — deactivate the customer instead" | History protection. | Deactivate — it's fully reversible. |
| "Payment failed. Update your payment method" | A genuine card decline on the subscription. | Fix the card in the Stripe portal. |
| "Action restricted. Please contact your administrator." | Staff-facing face of a billing restriction — no billing details are exposed to staff. | Tell the Administrator; only they can settle the bill. |
| "invoice not found" on a shared link | The access token is missing or wrong — often a trimmed URL. | Re-send the link from the invoice and share it whole. |