This article collects the most common problems you may hit while working with batch-tracked and serial-tracked stock, with a plain explanation of the cause and how to fix each one. A serial number in Qoblex is simply a batch with a quantity of one, so the same rules apply whether you track by batch or by serial.
Match your symptom to a row below, then follow the fix. Where Qoblex shows an exact message, it is quoted so you can find your row quickly.
Common problems and fixes
The batch or serial option is not available
Batch and serial tracking is part of a paid capability on your plan, shown in billing as “Lot, Serial & Expiry Dates”. If your subscription does not include it, you cannot set a variant to batch or serial tracking, and downloading the batch import template fails with “Your subscription does not support lot/serial expiry dates.” Ask an administrator to review your plan, then try again. See Before you use batch and serial tracking.
“Cannot change tracking option as there is quantity balance”
You tried to switch a variant to Batch Tracked or Serial Tracked while it still holds stock, and the save was rejected with “Cannot change tracking option as there is quantity balance. Remove the quantity and try again”. A variant can only change tracking option while both its on-hand quantity and any allocated (reserved) stock are zero. Write the on-hand quantity off to zero with a stock adjustment, clear any stock still allocated to open orders, then bring the stock back in as batches (a CSV batch stocktake or a purchase-order receipt), which sets the variant to Batch Tracked. See Set a variant to batch or serial tracked.
“Cannot change tracking option as there are batches associated with this variant”
The variant already has batch or serial records, so its tracking option is locked with the message “Cannot change tracking option as there are batches associated with this variant. Remove the batches and try again”. Remove the existing batches for the variant first, then change the tracking option. See Edit or delete batches and Set a variant to batch or serial tracked.
“Batch / Serial number tracking not supported for bundled products”
You tried to set a bundle variant to Batch or Serial tracking. A bundle must stay on Standard tracking, so Qoblex refuses with “Batch / Serial number tracking not supported for bundled products”. Keep the bundle on Standard and track its component variants instead if you need lot or serial control. See Set a variant to batch or serial tracked.
“This field is required” on a batch number when receiving
While assigning batches during goods receipt, a batch row was left without a value in the Batch N° field. Every manual batch row needs a batch or serial number before you can save. Type a number into each row, or remove empty rows. See Receive batches from purchase orders.
“Quantity must not be zero” on a batch row
A batch row has an empty or zero quantity. Each batch you enter must carry a quantity greater than zero. Enter the number of units for that batch, or delete the row if it is not needed. On a legacy receiving or shipping screen you may instead see “batch quantity must be greater than zero”, which means the same thing.
“This batch is selected more than once. Combine the quantities into a single row instead.”
The same batch was chosen on two different rows for one line while allocating batches on an inventory adjustment. Qoblex expects each batch to appear once per line. Delete the duplicate row and add its units to the single remaining row for that batch. See Adjust batch-tracked stock.
The batch quantities I allocated do not add up to the line
When allocating batches on an adjustment, the total of all batch quantities on a line must exactly equal that line’s counted quantity before you can authorize. If the totals differ, adjust the quantities until they match. On a legacy sales or receiving screen the equivalent message is “the sum of batches to receive does not match the total quantity to receive”. See Adjust batch-tracked stock and Ship batches and serials on sales orders.
I cannot select a batch, or the one I need is missing
The batch picker lists the batches that exist for that product variant at the order or adjustment’s location. If a batch does not appear in the list, it belongs to a different location. Confirm you are working at the location where the batch was received, or receive the batch in at the correct location first. You can also type part of the batch number into the picker to search for it. Use the trace view to check where a batch’s stock currently sits. See Trace a batch or serial.
“Batches aren’t supported for the “Set” operation yet”
On an inventory adjustment, batch-tracked lines cannot use the “Set” operation. The full message names the affected lines and asks you to switch them before allocating batches. Change those lines away from “Set” to a counting operation, then allocate the batches. See Adjust batch-tracked stock.
A serial number ended up with a quantity above one
A serial number identifies a single unit, so its quantity should always be one. If a serial row shows more than one unit, you most likely entered a batch-style quantity on a serial-tracked variant. Split it into separate rows, one per serial number, each with a quantity of one. When entering many serials at once, use the “Bulk Insert” box and follow the prompt to “Paste serial numbers separated by semicolons (;)” so each serial becomes its own single-unit entry. See Receive batches from purchase orders.
My stock quantity and the number of serials disagree
For a serial-tracked variant, the on-hand quantity should equal the count of distinct serial numbers on hand, because each serial is one unit. A mismatch usually means units moved without their serials being assigned, or serials were entered on the wrong line. Open the variant’s trace to see received, sold, transferred, and adjusted movements and find where the counts diverged. See Trace a batch or serial.
An expiry date looks wrong after a transfer
A batch keeps its own batch number and expiry date as it moves between locations, so a transfer does not change the expiry. If the date still looks off, the batch was most likely received with the wrong expiry to begin with, or two different batches were confused. Trace the batch to confirm its receipt and re-check the expiry recorded when it first arrived. See Transfer batch-tracked stock and Trace a batch or serial.
The batch list will not load
If the Batches & Serial Tracking page shows “Something went wrong while fetching list of batches. Try to clear your filters if any.”, an applied filter is likely returning nothing or the list failed to load. Clear any active filters and reload the page. See Trace a batch or serial.
The batch trace will not load
If opening a trace shows “Something went wrong while fetching the batch trace.”, the trace could not be retrieved. Close the panel and reopen it, then reload the page if it persists. See Trace a batch or serial.
The CSV batch import is rejected
The batch stocktake import checks a few things before it runs. The first data row must name a product variant in the “Id” column, or you see “Invalid CSV format: first row is missing Product Variant Id”. Every batch row needs a value in “Batch/Lot Number”, or the import stops with “Batch number cannot be empty”. And the same variant cannot list the same batch number twice, or you get “Duplicate batch numbers have been detected”. Fix the flagged rows and re-upload. See Import or update batches by CSV (stocktake).
A serial number is a batch with a quantity of one. Anywhere this article says “batch”, the same rule applies to serials, one unit per serial number.