> ## Documentation Index > Fetch the complete documentation index at: https://docs.batchlane.io/llms.txt > Use this file to discover all available pages before exploring further. # Common errors > Common Batchlane validation messages, why they happen, and how to fix them. Use this page when an action fails, a workflow is blocked, or a job reports validation errors. Most fixes are source-record fixes: correct the item, lot, recipe, order, document, role, or mapping that caused the failure. ## Import errors | Message or symptom | Why it happens | Fix | | ----------------------------------------------------- | -------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | No files selected | The import form has no supported files. | Add at least one supported CSV. See [CSV imports](/imports). | | Unsupported file name | Batchlane imports by exact filename. | Rename the file to a supported name such as `items.csv` or `customers.csv`. | | Row-level validation errors | Required column, duplicate value, bad date, bad status, or missing referenced record. | Fix the CSV row shown in the dry-run report, then validate again. | | Referenced SKU does not exist | A lot, recipe, component, or order references an item missing from the workspace and bundle. | Add the item first or include `items.csv` in the same bundle. | | Only workspace owners and admins can import core data | Current user lacks import permission. | Ask an owner/admin to run the import or update roles in [Settings and roles](/settings-and-roles). | | Import job failed | Worker hit validation or processing after queueing. | Open job history, review the error and validation rows, fix source data, then retry if appropriate. | ## Document and QA errors | Message or symptom | Why it happens | Fix | | --------------------------------------------------- | --------------------------------------------------------------- | --------------------------------------------------------------------------- | | Upload a file before accepting this document | The document has no current file version. | Upload the COA, supplier doc, batch attachment, or export before accepting. | | Review the current document version | Someone uploaded a newer version while an old version was open. | Reopen the document and review the latest version. | | Only uploaded or rejected documents can be accepted | The document is missing, reviewed, or retired. | Upload a file, restore if retired, or leave reviewed documents unchanged. | | Retired documents cannot be reviewed or rejected | Retired files are not active review work. | Restore the document first if active review is needed. | | A rejection reason is required | QA rejected without explaining the correction. | Add a clear reason that tells the uploader what to fix. | ## Inventory and scan errors | Message or symptom | Why it happens | Fix | | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | No lot matched scan input | The scanned code is not an internal lot, supplier lot, traceability lot, or Batchlane lot link in this workspace. | Search manually in [Inventory](/inventory), then verify the label source. | | Lot unavailable for production | Quantity, status, expiry, unit, or component relationship blocks selection. | Check available quantity, status, unit, and recipe component setup. | | Valuation looks wrong | Cost was missing or incorrect during receiving or production. | Review lot cost and movement history in [Inventory](/inventory) and [Reports](/reports). | | FEFO selected a different lot than expected | Earlier-expiring available stock exists. | Check expiry dates, hold/quarantine state, and documented QA exceptions. | ## Production errors | Message or symptom | Why it happens | Fix | | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | | Create an active recipe before scheduling production | No active recipe version exists. | Activate a valid recipe version in [Recipes](/recipes). | | Run is blocked by shortages | Required input lots are missing, unavailable, held, quarantined, expired, or in the wrong unit. | Fix [Inventory](/inventory), receiving, or recipe component quantities. | | QA cannot sign off | User lacks role access or required review work is incomplete. | Check [Settings and roles](/settings-and-roles) and [Documents and QA](/documents-qa). | | Signed run needs correction | Signed records preserve history. | Use auditable correction workflows instead of silent edits. | ## Order and shipment errors | Message or symptom | Why it happens | Fix | | ------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------ | | No reserved inventory is ready to ship | The order has no active open reservations. | Reserve finished lots before posting shipment. | | Shipment quantity exceeds reserved quantity | Ship quantity is greater than the reservation's open quantity. | Reduce the shipment quantity or reserve additional finished stock. | | Reservation has no open quantity to release | Reservation is already shipped, released, or fully consumed. | Review order status and reservation history. | | Canceled or shipped orders cannot be edited | Finalized order states are protected. | Create a new order or use an allowed correction path. | ## QuickBooks errors | Message or symptom | Why it happens | Fix | | ---------------------------------------- | ------------------------------------------------- | ------------------------------------------------------------------- | | Connect QuickBooks before syncing | Workspace has no active QuickBooks connection. | Connect from [QuickBooks setup](/quickbooks-setup). | | Reconnect QuickBooks to continue syncing | OAuth needs reauthorization. | Reconnect QuickBooks, then retry sync. | | QuickBooks is not configured | Required integration settings are missing. | Confirm QuickBooks app credentials and redirect URL are configured. | | Item sync requires default account IDs | QuickBooks item sync needs accounting defaults. | Configure default income and expense accounts before item sync. | | Sync finished with issues | Some records failed while others may have synced. | Review sync issues before month-end close. | ## Permission and plan errors | Message or symptom | Why it happens | Fix | | --------------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------- | | Upgrade in Settings to use this workspace feature | Plan does not include the feature. | Review billing in Settings or ask an owner/admin. | | Only workspace owners and admins can manage billing | Current user cannot change billing. | Ask an owner/admin. | | Choose an active workspace role | Task or signoff selected an inactive or missing role. | Update role selection in [Settings and roles](/settings-and-roles). | | Platform admin access is required | Founder/admin action is restricted. | Use a normal workspace workflow unless you are a platform admin. | Related pages: [FAQ](/faq), [Reports](/reports), [Settings and roles](/settings-and-roles).