Multi-Lot Package Runs allow you to combine material from multiple source lots into a single packaging operation. This is useful when you need to draw from several lots of the same variety to fulfill a packaging requirement.
In this article:
- What Are Multi-Lot Package Runs?
- Prerequisites
- How to Create a Multi-Lot Package Run
- Understanding the Lots Table
- Divisibility Requirement
- After Creation
- Tips and Best Practices
🎯 What Are Multi-Lot Package Runs?
A Multi-Lot Package Run works the same as a standard Package Run, but draws material from two or more source lots instead of just one. This gives you more flexibility when packaging, especially when no single lot has enough inventory to complete a full run.
For example, if you need to package 500 units but Lot A only has 300g and Lot B has 250g, you can create a Multi-Lot Package Run that pulls from both.
✅ Prerequisites
Before creating a Multi-Lot Package Run, ensure:
- You have two or more lots with available inventory
- All selected lots must have the same variety (e.g., all "Blue Dream")
- All selected lots must have the same unit type (e.g., all "dried", all "oil")
- None of the selected lots have a Recall flag
- If lot approval is enabled, all lots must be in Released status
- At least one SKU exists that matches the lots' variety and end type
📝 How to Create a Multi-Lot Package Run
Step 1: Navigate to the Lots Grid
Go to Warehouse > Lots from the sidebar menu to view your lots in the grid.
Step 2: Select Multiple Lots
Using the checkboxes on the left side of the grid, select two or more lots that you want to package from.
Step 3: Click Create Multi Lot Package Run
Once multiple lots are selected, the Create Multi Lot Package Run button becomes active in the toolbar above the grid. Click it to open the dialog.
Matching Requirements
If the selected lots have different varieties or unit types, the dialog will display a validation error explaining what needs to match.
Step 4: Select a SKU
From the SKU dropdown, select the SKU you want to package. Only SKUs matching the lots' variety and end type are shown.
Step 5: Name the Package Run
Enter a Package Run Name to identify this run. This field is required for Multi-Lot Package Runs.
Required Field
Unlike single-lot Package Runs, the name field is required for Multi-Lot Package Runs.
Step 6: Enter THC/CBD Values
Enter the potency values for this Package Run:
| Field | Description |
|---|---|
| THC (mg) | THC content in milligrams (must be 0 or greater) |
| CBD (mg) | CBD content in milligrams (must be 0 or greater) |
| THC Percentage (%) | THC as a percentage (0-100) |
| CBD Percentage (%) | CBD as a percentage (0-100) |
Step 7: Allocate Quantity per Lot
The dialog shows a table listing all selected lots. For each lot, enter the quantity to use:
| Column | Description |
|---|---|
| Lot ID | The identifier for the lot |
| Lot Name | The name of the lot |
| Available Qty | How much material is available in that lot |
| Quantity to Use | The amount you want to draw from this lot |
The quantity for each lot cannot exceed its available quantity. The unit is shown as grams (g) for weight-based products or as the unit type for discrete items (plants, seeds).
A summary below the table shows:
- Total weight to be packaged (or total units for discrete items)
- Package Run Items to be created - the number of finished packages
Step 8: Select Location and Approval
Select the Location where the packaged items will be stored and the Approved By user.
Step 9: Set Date and Time
Choose the Date & Time of Package Run. The date must be between the earliest lot creation date and today.
Step 10: Upload Documents (Optional)
You can optionally upload a COA (Certificate of Analysis) or other documents related to the new inventory.
Step 11: Submit
Click Create Package Run to complete the process.
📊 Understanding the Lots Table
The lots table in the dialog is your primary tool for allocating material:
- Each row represents one of the lots you selected
- The Available Qty column shows the maximum you can draw from each lot
- You must enter a quantity for each lot (minimum 0.001)
- The system validates that your entry does not exceed available inventory
⚠️ Divisibility Requirement
The total quantity across all lots must be evenly divisible by the SKU's target weight (or target quantity for discrete units). If it's not, you'll see an error:
"The total selected quantity must be perfectly divisible by the SKU's target weight."
For example, if your SKU has a cannabis weight of 3.5g per unit, and you select 10g from Lot A and 4g from Lot B (total 14g), this creates exactly 4 packages (14 / 3.5 = 4). But if you selected 10g and 3g (total 13g), you'd get an error because 13 / 3.5 = 3.71 — not a whole number.
Avoiding Divisibility Errors
Calculate your total quantity before entering values to avoid the divisibility error.
📋 After Creation
Once created, the Multi-Lot Package Run appears under Warehouse > Package Runs like any other Package Run. The detail page will show:
- Source Lot - Links to all source lots (displayed as a list)
- Multi Lot Original Info - Shows each source lot ID and the quantity drawn from it
Important differences from single-lot Package Runs:
- Edit Package Run is not available for multi-lot runs
- Recycle uses a dedicated Recycle Multi Lot Package Run option that handles returning material to the correct source lots
Multi-Lot Limitation
Edit Package Run is not available for Multi-Lot Package Runs. Use Revert or Recycle instead.
💡 Tips and Best Practices
- Plan your quantities - Before opening the dialog, know how much you need from each lot to avoid the divisibility error
- Check lot statuses - All lots must be released (if lot approval is enabled) and free of recall flags
- Use descriptive names - Since multi-lot runs draw from multiple sources, a clear name helps with traceability
- Review the summary - Always check the "Package Run Items to be created" count before submitting
- Upload COAs - Take advantage of the optional document upload to attach relevant quality documentation
🔗 Related Articles
- Package Runs - Creating and Managing - Basics of single-lot Package Runs
- Revert, Edit, and Recycle Package Runs - Managing and modifying Package Runs
- Working With Lots - Understanding lot inventory management
- SKUs - Setting up and managing SKUs