This guide helps you resolve the messages Qoblex shows when a manufacturing order will not save, start, complete, cancel, or import. Each row below pairs the exact message you may see on screen with the reason it appears and the steps to clear it.
After reading this, you will be able to recognize each blocked state, understand what Qoblex was trying to do when it stopped, and take the right corrective action so the order moves forward.
Below, the manufacturing order statuses are Draft, In Production, Completed, and Canceled. Most blocks happen at the transition between two statuses (for example, moving a Draft order into In Production). Expand a row to see its cause and fix.
Saving validates every component line and every labor/overhead line. Fix the line named in the message (“Line 1”, “Line 2”, and so on), then Save again. You may see:
- “Line {n} : unknown product name. Please remove this line or enter the product to your inventory first” — the line points to a product Qoblex no longer recognizes. Remove the line, or add the product to your inventory first.
- “Line {n} : quantity undefined or equals 0. Please remove this line or enter a valid quantity greater than 0” — enter a quantity greater than zero.
- “Line {n} : negative quantity not supported. Please remove this line or enter a valid quantity greater than 0” — enter a positive quantity.
- “Line {n} : cost undefined. Please remove this line or define the product cost first” — set the component cost.
- “Line {n} : negative cost not supported. Please remove this line or enter a positive product cost first” — enter a cost of zero or more.
- “Line {n} : Quantity must be greater than equal to the sum of wasted and unconsumed units” — the line quantity is lower than its Wastage plus Unconsumed amounts. Raise the quantity or lower wastage/unconsumed.
- “Landed cost item at line {n} : undefined description! …”, “… undefined price! …”, or “… undefined tax! …” — a Labor / Overhead line is missing its description, price, or tax. Complete the line or remove it.
When you start an order, Qoblex allocates stock at the production location: for an assembly it reserves each component (quantity plus wastage); for a disassembly it reserves the finished product. If any item is short, the start is rejected and the order stays in Draft. The message names the order number and the item, for example: “Order MO-1001: …”.
[!important] Fix the shortage by receiving or transferring stock into the production location, then start the order again. Qoblex reserves stock only at the order’s own location.
Complete is only available from In Production. If completion is rejected, check the reason below, fix it, then Complete again.
- A finished-batch total message — “The total quantity of finished batches must be equal to the yield quantity of the assembly order”: in Lots & Serial, the finished batch quantities you recorded do not add up to the Yield Quantity. Adjust the batches to match.
- A consumed-batch message — “{product} The total quantity of batch operations does not match the quantity consumed” or “{product} Order quantity does not match batch quantities”: the input batches recorded for that component do not reconcile to the amount actually consumed. Correct the per-line batch quantities.
- A produced-batch message — “{product} The total quantity of batch operations does not match the quantity produced”: for a batch-tracked finished product, the finished batch quantities you recorded do not add up to the Yield Quantity at completion. Adjust the finished batches so their total equals the yield.
- “Oops! Something went wrong while trying to complete the production order. Please refresh the page and try again” — the completion request failed. Refresh the page and retry.
[!important] Batch and serial totals must reconcile exactly to the produced and consumed quantities, or Qoblex aborts the completion and leaves the order In Production.
An In Production order cannot be canceled directly, because stock is already allocated. Open it for edits first:
- Select Amend. Qoblex releases the allocations and returns the order to Draft.
- Select Cancel on the Draft order.
- Confirm the prompt: “Are you sure you want to cancel this order? This operation cannot be undone”.
[!important] Canceling cannot be undone, and a Completed order can never be canceled.
The importer validates each row on its own and skips the rows that fail; valid rows still import. Common causes:
- The Manufacturer Name does not match an existing manufacturer.
- The Location does not match an existing location.
- The finished product (by Finished Product Id, Finished Product Sku, or Finished Product Barcode) matches zero bills of material, or more than one. It must resolve to exactly one.
- The resolved item is not a recipe: “the item to manufacture is not a bill of material”. Point the row at a product that is a bill of material.
- Number is duplicated within the file. Order numbers must be unique inside a single upload.
[!info] The upload button rejects files larger than 10 MB even though the on-screen note says 2 MB. Keep the file under 10 MB. See the CSV import article for the full field list.
