Holds
Table of Contents
1. Use Cases
Quick Links: Hit pause before a problem ships | A platform customer cancels mid-process | Let orders move again once resolved
Scenario 1: Spot a problem before shipping and hit the pause button
Situation: An order is about to enter the fulfillment flow, but customer service flags that the shipping address is incomplete, or the convenience-store pickup number can't be found. Shipping it as-is would likely get the parcel returned.
Use this feature: Once an order is held, it won't move forward (no picking, packing, or shipping) until the issue is confirmed resolved. Holds are placed from the order side (see the order list / order detail under Related Features), and every held order is collected in this list — the "Hold Reason" column tells you at a glance which problem each order is stuck on.
Result: Problem orders stop where they are instead of shipping with a wrong address, so you avoid returns and re-shipments later.
Scenario 2: A platform customer changes their mind mid-process
Situation: The order is already being processed in the warehouse, but the customer on the e-commerce platform suddenly wants to cancel. For platform-notified cancellations, the system holds the order automatically with the reason "Platform Cancel".
Use this feature: Whether detected automatically by the system or placed manually by staff, all holds appear in this list. Use the "Hold Reason" filter to tell platform cancellations apart from address or store-number issues, then decide for each one whether to release it back to shipping or move it to cancellation.
Result: An in-progress order is stopped in time, so you don't ship a parcel the customer has already cancelled.
Scenario 3: Let orders return to the shipping flow once resolved
Situation: A batch of held orders has been sorted out — the address is fixed, the store number is confirmed, or the merchant has approved shipping — and now they need to continue through fulfillment.
Use this feature: Select these hold records in the list and use "Release Holds" to release them all at once (see 2.3 Batch Actions). When releasing, you can add a resolution note to record what you did; these records are kept for future reference.
Result: The orders resume their normal flow and continue to ship, and the released records disappear from this list.
2. Features
When something is off with an order — wrong shipping address, invalid store number, a last-minute merchant request to pause, or a platform cancellation notice — you can place the order on "hold", like hitting a pause button. A held order stops where it is and won't be picked, packed, or shipped until the issue is confirmed resolved and the hold is released. This list shows every order currently on hold so you can work through them one by one or release holds in batch.

Quick Jump: Filters | List Columns | Batch Actions
💡 Tip: Click the question-mark icon next to the page title to open the "What are order holds?" concept guide.
2.1 Filters
| Filter | Description |
|---|---|
| Merchant | Show only a specific merchant's held orders |
| Hold Reason | Filter by reason category — e.g. show only "Address Issue" to handle them together, or only "Platform Cancel" to decide what to cancel. Full reason list in 3.1 FAQ |
| Created At | Filter by the date range the hold was placed |
2.2 List Columns
This list only shows orders that are currently on hold; once a hold is released, its record disappears from the list.
| Column | Description |
|---|---|
| Order Number | The held order; click to open order details, with the Status shown beside it |
| Merchant Name | Merchant the order belongs to |
| Hold Reason | The reason category for this hold |
| Note | Details entered when the hold was placed |
| Held By | Who placed the hold; automatic holds show "System (auto)" |
| Created At | When this hold was placed |
2.3 Batch Actions
Select one or more hold records and the "Release Holds" action appears.
- What can be released: Everything shown in this list is currently on hold and can be released. Releasing acts on the "hold" pause flag and does not change the Status.
- Effect of releasing: The order resumes from where it stopped and can be picked and shipped again. You can add a resolution note (optional) when releasing; the note is recorded in the order's operation history.
- Can it be undone: Once released, the record disappears from this list. If the order later needs to be paused again, you can place a new hold from the order side (an order can have at most one active hold at a time).
3. FAQ
3.1 FAQ
▪ Where does a held order get stopped?
A held order won't move forward — no picking, no packing, and it's blocked from completing shipping. Held orders are clearly marked throughout the system: a red "HELD" badge appears in the order list, and when you open the order detail a warning at the top lists every hold reason and who placed it, so they're hard to miss.
▪ Which hold reasons are there?
| Reason | Description |
|---|---|
| Merchant Request | The merchant asks to temporarily pause a specific order |
| Platform Cancel | The order is already being processed but the platform customer cancels (usually held automatically by the system) |
| Shipped on Platform | The order is still waiting in the warehouse, but the platform shows an item as already shipped (usually by another system). Held automatically. On 91APP the note shows which item (TS number), shipping number and platform status triggered it; on other platforms it shows the platform's shipping status. Check whether it has already shipped: cancel if everything has, or remove the shipped items before releasing if only some have |
| Refunded on Platform | The platform shows the order as fully refunded but not canceled, or as partially refunded or with a refund in progress while platform quantities don't subtract the refund (EasyStore, Shopline). Held automatically and never canceled automatically; the note is the platform's payment status (for a partial refund it starts with partial_refund_status=). Check with the merchant or platform: cancel the order if it should not ship, or confirm the quantities and release the hold if it should still ship. Once released, the order follows platform updates again. A released full refund hold isn't held again; after a partial refund hold is released, the order isn't held again while the refund stays partial, but moving to a full refund holds it again, and both holds stay if the first hasn't been released |
| Buyer Requested Cancellation | The buyer asked to cancel on the platform, and the seller can still decline. Held automatically and never canceled automatically; the note is the platform's status value. Handle it on the platform: once the cancellation is approved the system cancels the order on its own; if you decline or the order should still ship, release the hold. Once released, the same order isn't held for this reason again. BVSHOP orders whose order status is abnormal, pending confirmation or completed are also held for this reason; the note is then "order_status=" followed by the platform's order status code (-1 = abnormal, 2 = pending confirmation, 4 = completed), so the buyer may not have asked to cancel. Check the actual status on the platform before handling it. For BVSHOP, after you release a hold the same status isn't held again, but if the platform moves the order to a different status (for example from pending confirmation to abnormal) it is held once more |
| Items Changed on Platform | The order is already being picked or shipped, but its items or quantities were changed on the e-commerce platform (for example, the merchant split the order on the platform and moved some items to a new order). Held automatically (currently BV SHOP only) with the items kept unchanged; the note shows each SKU's "current warehouse quantity → platform quantity". See the next question for how to handle it |
| Fraud Suspect | A suspicious order needs confirmation first |
| Address Issue | The address is incomplete, malformed, or undeliverable |
| Convenience Store Issue | The pickup store number is invalid or the store is closed |
| Inventory Discrepancy | Physical stock doesn't match the system |
| Other Reason | Anything else; add a note to explain |
▪ How do I handle an "Items Changed on Platform" hold?
Picking has already started on this order, so the system does not change its items directly; it holds the order instead, so it isn't shipped with the pre-split contents (which would ship the split-off items twice). The new order created by the split comes in and ships as usual; nothing extra is needed for it. Handle the hold in this order:
- Use the note to confirm what the order now contains on the platform ("1 → 0" in the note means the item is no longer on the platform order).
- On the Picking Wave Detail, use "Return" to return this order's fulfillment and put the picked goods back. The hold stays after the return, and the items aren't updated automatically.
- Release the hold once the order should ship. After the release, the next scheduled order fetch (per the store connection's "Fetch Schedule") updates the items and the COD Amount to the platform's contents. This only works for orders the platform still returns — orders paid (for cash on delivery, created) within the last 7 days. If the order is older or doesn't update, edit the order yourself after the release to remove the split-off items.
- Wait for the items to update before picking again, and check the COD Amount on cash-on-delivery orders. Picking before the update, or releasing the hold without returning the order from picking, ships it with the pre-split items and COD Amount.
This hold coexists with any hold already on the order (for example, a merchant request), and the order detail lists them all; releasing holds from the order detail releases all of them at once, so check every reason before releasing.
Orders are not held when only item names or prices change and the shipped products and quantities stay the same. If the order is split on the platform after it has already shipped, the goods have left the warehouse and the system cannot stop them; the new order from the split still comes in — when you notice, check with the merchant whether to cancel the new order.
▪ Where are holds placed? Can't I hold an order from this list?
Holds are placed from the order side: on the Order List by selecting orders, or on the Order Detail page, both offer "Hold Order", and you choose a hold reason when placing it. This holds list is for reviewing and releasing holds in one place — you don't create holds here.
▪ Where does the order go after a hold is released?
A hold is just a pause flag — releasing it does not change the Status. The order resumes from where it stopped and can be picked and shipped again. See 2.3 Batch Actions for details.
▪ What if stock changed while the order was on hold?
When an order is held, its product contents and existing inventory allocation are kept. If stock changed during the hold, use "Recheck Stock" on the order detail to re-confirm before deciding whether to release it for shipping.
▪ I just want to fix the address, phone, or store number — do I need to hold the order first?
No. On the order detail, use "Correct Info" to fix the recipient, address, phone, scheduled delivery, and so on (product items are not changed). The system automatically holds the order during the correction to protect it from shipping mid-edit; this auto-hold shows "System (auto)" as the holder.
▪ Will held orders be canceled automatically?
A hold doesn't cancel the order by itself: a held order stays on hold until someone releases it or moves it to cancellation. The exception is when the platform confirms the cancellation: an order that hasn't started picking is canceled automatically and holds created by the platform sync are released too, while manual holds stay. Review this list regularly so orders don't pile up.
▪ Can I still find a hold record after it's released?
This list only shows orders that are currently on hold; once released, the record disappears from the list. To trace it, open the order detail and expand "Operation History" — the resolution note you entered when releasing is kept there too.
▪ Are order holds the same as "Inventory Holds"?
No. An order hold blocks at the order level — it pauses a single order so it won't ship. "Inventory Holds" block at the inventory level — they reserve certain stock so it won't be allocated. The two are independent: releasing an order hold doesn't touch any inventory hold, and vice versa.
3.2 Notices
⚠️ Important
- Confirm the issue is genuinely resolved before releasing a hold — once released, the order resumes the shipping flow immediately and may be picked and shipped soon after.
- When the e-commerce platform confirms a cancellation and the order becomes canceled, holds created by the platform sync are released, and the order history records it; manual holds and other system holds (such as store code checks) stay.
- While a hold created by the platform sync is active, the order doesn't follow platform updates; warehouse staff need to confirm it ("Items Changed on Platform" too: after picking is canceled, release the hold first for the order to update).
- After you release "Refunded on Platform", "Buyer Requested Cancellation" or "Shipped on Platform", the order follows platform updates again until picking starts and isn't held for that reason again (91APP exception: after you release "Shipped on Platform", the order isn't updated while any sub-order is shipped or confirmed for shipping, and it's still canceled if every sub-order is canceled; a released partial refund hold is followed by a new hold if the order moves to a full refund). An "Other Reason" hold caused by the payment status stops updates after release while the platform still reports that payment status, so the collection amount isn't changed. After you release "Refunded on Platform", the system no longer changes the collection amount, so check and edit it yourself.
- When holding manually, an order can have at most one active hold at a time; to place a new hold, you must release the existing one first. The "Items Changed on Platform", "Refunded on Platform", "Buyer Requested Cancellation", "Shipped on Platform" (except on 91APP) and payment-status "Other Reason" holds created automatically by the system are the exception and coexist with any existing hold; once an order is in picking and the platform confirms the cancellation, a "Platform Cancel" hold is always added alongside whatever holds it already has, so releasing another hold doesn't let it ship. If that hold is released, it is added back whenever a later sync or QC check finds the order still canceled on the platform.
💡 Tip: Write a clear note both when placing and when releasing a hold, so that later — when tracing it from the "Operation History" — you can tell what happened and how it was handled.
4. Related Features
| Feature | Description | Link |
|---|---|---|
| Order List | View all orders; holds are placed from here | Go |
| Order Detail | View order details, the hold warning, and operation history | Go |
| Fulfillments | View fulfillment statuses (held orders can't complete shipping) | Go |
| Picking Lists | View orders awaiting picking (held orders won't enter picking) | Go |