Module
Configuration
Product Batches Management
Configuration · BatchesPlatforms
Android + Windows
Workspace
Center + panel
Access
No direct key
Product Batches Management overview
Product Batches Management documents VauPrime's Batch Center and per-product Batch Configuration panel. Use it to track batch numbers against products, manufacturing and expiry dates, batch company/description, purchase/sale/MRP pricing and Active/Inactive status, then search, edit or delete saved batches.
What this manages
Product Batches Management documents VauPrime's Batch Center and per-product Batch Configuration panel. Use it to track batch numbers against products, manufacturing and expiry dates, batch company/description, purchase/sale/MRP pricing and Active/Inactive status, then search, edit or delete saved batches.
Product Center relationship
Product Management, Product Batches and Category Management work together as configuration masters used by inventory and transaction screens.
Screen workspace
Main areas exposed by the current Product Batches Management implementation.
01
Batch Center
The standalone Batch screen presents all batches across products in one searchable list. Android uses a centralized mobile list; Windows uses a desktop table with an Add Batch action.
02
Configure New Batch / Edit Batch
After selecting a product, Batch Configuration opens a panel. Its first tab creates a new batch or edits the selected batch.
03
Existing Batches
The second Batch Configuration tab shows batches for the selected product and provides edit/delete actions.
Batches fields
Visible fields and their current source-backed requirement/behavior.
| Field / message | Requirement / cause | Behavior / action |
|---|---|---|
| Product | Required context | A product must be selected before opening a new batch form. Batch records are saved against that product ID. |
| Batch Number | Required | Primary batch identifier. The current form validator blocks an empty Batch Number. |
| Company | Optional | Company/manufacturer name associated with the batch product. |
| Batch Description | Optional | Free-text description used by Batch Center search as well as the per-product record. |
| Mfg. Date | Optional date | Manufacturing date. The current date picker allows dates from year 2000 through today. |
| Expiry Date | Optional date | Expiry date. The current picker starts from today and allows dates through year 2100. |
| Purchase Price | Optional numeric | Batch-level purchase price. |
| Sale Price | Optional numeric | Batch-level sale price. Batch Center displays this value in the list/table. |
| MRP | Optional numeric | Batch-level maximum retail price. |
| Batch Active Status | Toggle | Controls whether the batch is stored as Active or Inactive. New batch forms default to Active. |
Product
Required contextA product must be selected before opening a new batch form. Batch records are saved against that product ID.
Batch Number
RequiredPrimary batch identifier. The current form validator blocks an empty Batch Number.
Company
OptionalCompany/manufacturer name associated with the batch product.
Batch Description
OptionalFree-text description used by Batch Center search as well as the per-product record.
Mfg. Date
Optional dateManufacturing date. The current date picker allows dates from year 2000 through today.
Expiry Date
Optional dateExpiry date. The current picker starts from today and allows dates through year 2100.
Purchase Price
Optional numericBatch-level purchase price.
Sale Price
Optional numericBatch-level sale price. Batch Center displays this value in the list/table.
MRP
Optional numericBatch-level maximum retail price.
Batch Active Status
ToggleControls whether the batch is stored as Active or Inactive. New batch forms default to Active.
Behavior and configurable controls
Additional behavior that matters when using Product Batches Management.
All-batch view
Batch Center loads batches for the active organization together with product names, then formats Mfg. Date, Expiry Date, Sale Price and Active/Inactive status for display.
Search
Standalone Batch Center search matches Batch Number, Product Name and Batch Description.
Per-product configuration
Product List's Batch action opens the Batch Configuration panel with the selected product already in context. Existing Batches then loads only batches linked to that product ID.
Regular products
The Product Management row action exposes Batch Configuration for products whose type is Regular.
Organization scope
Batch reads and writes use the active organization identifier so Batch Center and per-product views stay scoped to the current organization.
Save and validation flow
What VauPrime checks and updates when a record is created or edited.
01
Select Product
From Batch Center, Add Batch first opens product selection. From Product List, the selected Regular product is already known.
Expected result
Batch Configuration opens with a concrete product context.
02
Validate Batch Number
The Configure New Batch form requires Batch Number.
Expected result
An empty Batch Number is rejected by the form validator.
03
Resolve Product ID
Save resolves id/databaseId/product_id from the selected product and converts it to the integer product identifier used by the batch model.
Expected result
Missing or malformed Product ID stops the save.
04
Build batch record
VauPrime combines Batch Number, description, dates, company, prices, status, product and organization context into the Product Batch model.
Expected result
A complete new/edit batch object is ready for persistence.
05
Create or update
New mode creates a batch; edit mode updates the existing batch ID for the signed-in user and organization.
Expected result
VauPrime reports Batch created successfully or Batch updated successfully when the service succeeds.
06
Reset and reload
After successful save, the form is cleared, batches are reloaded and the panel switches to Existing Batches.
Expected result
The saved batch is immediately visible in the product's batch list.
Existing records and maintenance
Search, list presentation and row actions available after records are created.
Standalone columns
Windows Batch Management shows Batch No, Product, Mfg. Date, Expiry Date, Sale Price and Status.
Android list
Android Batch Center uses Batch Number as title, Product Name as subtitle and Sale Price as trailing value, with Edit and Delete expanded actions.
Search
Search Batch Number, Product Name or Batch Description from Batch Center.
Refresh
Reloads both all batches and product names for the active organization.
Edit
Standalone edit resolves the linked product, then opens Batch Configuration. The per-product panel loads the batch values into edit mode and switches to its first tab.
Delete
Delete asks for confirmation with the Batch Number, deletes by batch ID within user/organization scope, then reloads the list.
Validation and troubleshooting
Messages or conditions confirmed from the current screen/service behavior.
| Field / message | Requirement / cause | Behavior / action |
|---|---|---|
| Required | Batch Number is empty. | Enter a Batch Number before saving. |
| Product not found for this batch | Standalone edit could not resolve the batch's linked product. | Confirm the product still exists before editing the batch. |
| Product ID not found | Batch Configuration has no valid product identifier. | Close the panel, select the product again and reopen Batch Configuration. |
| Invalid Product ID format | The selected product identifier cannot be converted to the required product ID format. | Reload Product/Batch Center and retry with a valid product. |
| Error creating batch | The batch create service failed or the user context was unavailable. | Confirm sign-in/organization context and retry. |
| Error updating batch | Batch update failed, including missing Batch ID or user context cases. | Reload the batch and retry the edit. |
Required
Batch Number is empty.Enter a Batch Number before saving.
Product not found for this batch
Standalone edit could not resolve the batch's linked product.Confirm the product still exists before editing the batch.
Product ID not found
Batch Configuration has no valid product identifier.Close the panel, select the product again and reopen Batch Configuration.
Invalid Product ID format
The selected product identifier cannot be converted to the required product ID format.Reload Product/Batch Center and retry with a valid product.
Error creating batch
The batch create service failed or the user context was unavailable.Confirm sign-in/organization context and retry.
Error updating batch
Batch update failed, including missing Batch ID or user context cases.Reload the batch and retry the edit.
Implementation-backed notes
Important distinctions preserved from the current Dart implementation.
The standalone screen's Global Header currently uses the screen name Advanced Batch Management.
The sidebar label is Batch Wise Track, while access-permission aliasing maps it to Product Batch Management.
The Product Batch service requires an authenticated user for create, update and delete operations.
Current UI validation explicitly requires Batch Number; other batch fields shown in the form are optional.
There is no separate configuration Batch Center target in the current app-wide Global Search target list.
Related documentation