Flowhub's LucidID integration makes it quick and easy to associate LucidGreen Case IDs with your inventory and scan item-level LucidIDs at the point of sale. In this article, we'll guide you through enabling the integration, linking Case IDs to inventory items by scanning them manually or syncing them from a LucidGreen Virtual Manifest, and scanning LucidIDs into carts so your team can track unit-level product verification throughout the sales process.
💡 Note: Flowhub's LucidGreen integration is fully API-based. If your store previously used LucidGreen with another POS platform, the setup process in Flowhub is different.
Case IDs can be manually scanned onto inventory items in Flowhub, or synced automatically from a LucidGreen Virtual Manifest.
Understand Case IDs and LucidIDs
Before getting started, it helps to understand how LucidGreen organizes its identifiers:
A Case ID is a QR code that represents a physical shipping box (case). A case may contain multiple packages, and a single package may be shipped across multiple cases. Think of a Case ID like a shipping label on a box: it tells you what units are inside that specific box, regardless of how many boxes make up the full shipment.
A LucidID is a unique, item-level QR code on each individual unit within a batch. Each of the 100 units in a batch, for example, has its own unique LucidID.
Because cases describe physical boxes rather than regulatory packages, the relationship between Case IDs and inventory is flexible:
One inventory item, multiple Case IDs: 1,000 units of a single package shipped in two boxes of 500 each. Scan both Case IDs into the same inventory record.
One Case ID, multiple inventory items: One box contains 500 units of Package A and 250 units of Package B. Scan the same Case ID into both inventory records.
💡 Tip: Case IDs and LucidIDs are configured upstream by the manufacturer or distributor. If a Case ID arrives at your store with incorrect information, reach out to your supplier or LucidGreen support at retailsupport@lucidgreen.io to resolve the issue.
Before You Begin
To use the LucidID integration, you must have a LucidRetail account with LucidGreen. If you don't have one yet:
Navigate to retail.lucidgreen.io.
Select Sign Up.
Complete the sign-up process, then select Create API Key.
Send the Client ID and Client Secret to your Flowhub representative or email help@flowhub.com so we can complete the integration for you.
Once your integration is connected, follow the steps below to configure LucidID in Flowhub.
Enable the LucidID Integration
To connect Flowhub with LucidGreen, your store needs an API key from the LucidRetail platform. Once you get the key, contact your Flowhub representative or email help@flowhub.com so we can complete the integration for you.
Navigate to store settings and toggle on Automatically Look up External Inventory IDs When Saving Inventory Items.
Retrieve your LucidGreen API key
Log in to the LucidRetail web platform.
Select API Keys from the left navigation at the bottom.
Learn more about LucidRetail API keys here.
Copy the Client ID and Client Secret.
Add a Case ID to Inventory
Once the integration is enabled, you can associate Case IDs with inventory items during the intake process. There are two ways to do this:
Scan Case IDs manually onto each inventory item (see steps below).
Sync Case IDs from a LucidGreen Virtual Manifest with no physical scanning required. See Sync Case IDs from a Virtual Manifest below.
To scan Case IDs manually:
Navigate to the inventory item you want to associate with a Case ID.
At the bottom of the inventory record near the SKU field, select Add Case ID.
Scan or enter the Case ID into the CaseID or URL field.
Flowhub will recognize a Case ID scan regardless of whether your cursor is inside the field.
Only Case IDs may be scanned here. If you scan a LucidID, an error message will display indicating that only Case IDs are accepted.
Flowhub will validate the Case ID and confirm that it matches the Regulatory ID on the inventory item.
Repeat steps 2-4 to associate additional Case IDs if the inventory was shipped across multiple cases.
Select Save on the inventory item.
Budtenders can now scan any individual item-level LucidIDs on the Products for this Regulatory Id into a cart.
💡 Tip: To remove a Case ID, select the trash can icon next to the Case ID you want to de-associate.
✏️ Note: The Add Case ID button is inactive when there is no Regulatory ID on the inventory item. A Regulatory ID is required before a Case ID can be associated.
Sync Case IDs from a Virtual Manifest
Flowhub integrates with LucidGreen's Virtual Manifest feature, allowing you to sync Case IDs associated in a Virtual Manifest directly into your Flowhub inventory without manually scanning each Case ID. If a package's Case IDs are already associated in a Virtual Manifest, Flowhub can sync them at the individual item level or across your entire inventory.
✏️ Note: This workflow requires an enabled LucidGreen integration and the use of Virtual Manifests with LucidGreen. It is entirely optional. Manually scanning Case IDs onto inventory is still available.
For instructions on setting up and using Virtual Manifests, see LucidGreen's documentation on creating a Virtual Manifest through their LucidRetail app.
Sync Case IDs to an individual inventory item
In LucidGreen, create a Virtual Manifest where all Case IDs are associated to their respective Regulatory IDs.
In Flowhub, edit the inventory item. You'll see a Sync CaseIDs button alongside the existing manual scan option.
Select Sync CaseIDs. Flowhub pulls in the Case IDs already associated with that package in your Virtual Manifest, with no physical scanning required.
If you're not using Virtual Manifests, continue to scan Case IDs onto inventory manually.
Select Save on the inventory item. A LucidID icon will appear on the item, indicating linked Case IDs.
Sync Case IDs globally across inventory
Navigate to Inventory.
Select Sync Virtual Manifest, located above the Upload CSV and New Inventory functions.
Flowhub runs a sync across your entire inventory to pick up any eligible Case IDs from your Virtual Manifest in one pass.
The global sync can take several minutes to complete, especially with multiple pages of inventory.
If a sync is already in progress, attempting to start another will notify you that one is already running.
When the sync completes, the Notifications Bell will show a notification reporting how many items were successfully synced and any errors encountered.
To see errors, click the notification to download the error report.
Rejected package handling
Within a Virtual Manifest, Case IDs/Packages can be Rejected:
When a Case ID is Rejected on a Virtual Manifest, Flowhub will not sync that Case ID to inventory. It will appear as an error on a full Virtual Manifest inventory sync, indicating it could not be synced because it has been Rejected.
Rejected Case IDs can be unrejected at any time on the Virtual Manifest in the LucidGreen portal, making them available for sync onto Flowhub inventory again.
⚠️ Compliance note: Rejecting a Case ID/Package in a LucidGreen Virtual Manifest has no relationship to your seed-to-sale regulator (e.g., Metrc or BioTrack). If a package must be rejected within the seed-to-sale regulator, take that action separately within the regulator. It will not happen automatically if the rejection is only done on the LucidGreen Virtual Manifest.
Scan a LucidID into a Cart
With Case IDs associated to inventory, your cashiers can scan individual LucidIDs at the point of sale.
In Cashier, open a cart.
Scan the item-level LucidID QR code on the product.
Flowhub will find the associated inventory item and add it to the cart with a LucidID tag.
If a Case ID is scanned instead of a LucidID, an error message will display indicating that only LucidIDs may be scanned into a cart.
To add another unit of the same batch, scan that unit's unique LucidID QR code to increment the quantity.
You cannot manually increment the quantity in the cart when a LucidID has been scanned. Each unit must be individually scanned so Flowhub can track which specific units were sold.
💡 Tip: If the same LucidID is scanned twice, Flowhub will prompt you to confirm whether you want to remove that item from the cart. Select Cancel to keep the item, or select Remove from Cart to decrease the quantity by one.
Manage Sales, Voids, and Returns with LucidID
Sales
When a sale is completed, Flowhub pushes the transaction to the state regulator and to the LucidGreen API. This reports which LucidIDs were sold and flips the QR code experience from retailer-facing to consumer-facing information.
Voided sales
When a sale is voided in Flowhub, the associated LucidIDs are also voided with the LucidGreen API. Those items become available for sale again.
Returns
A returned item that was originally sold by LucidID must be scanned into the Returns cart so Flowhub can notify LucidGreen that the item was returned.
Mark a previously sold LucidID as unsold
If a LucidID was scanned at sale but the wrong physical unit was handed to the customer, the scanned LucidID is still marked as sold even though the actual product remains in the store.
Scan the LucidID that needs to be corrected.
A message will display: "This LucidID has already been marked as sold."
Enter your PIN to authorize marking the item as unsold.
The LucidID is now available for sale to the next customer.
Search Inventory by Case ID or LucidID
You can search inventory by Case ID to find all associated inventory items, or scan a LucidID to pull up the corresponding item.
Search by Case ID
Navigate to Inventory.
Enter a Case ID in the search field.
Flowhub will display all inventory items associated with that Case ID.
Scan a LucidID into Inventory search
Navigate to Inventory.
Place your cursor in the search field, then scan the LucidID QR code.
Flowhub will display the corresponding inventory item.
✏️ Note: Unlike Case ID scans, your cursor must be placed in the search field before scanning a LucidID.
Inventory items with associated LucidIDs display a LucidID icon for quick identification.
Frequently Asked Questions
Can I use LucidIDs on bulk flower?
No. Case IDs and LucidIDs are never applied to bulk flower. Prepackaged flower can have Case IDs and LucidIDs.
Can I split a package that has associated Case IDs or LucidIDs?
No. LucidGreen's API does not support splitting packages with associated LucidIDs or Case IDs at the retailer level. The Split Package button is not available in Flowhub on inventory with associated Case IDs or LucidIDs. If a package needs to be split, reach out to your supplier or LucidGreen support.
Who do I contact if a Case ID is configured incorrectly?
Reach out to your supplier or contact LucidGreen support at retailsupport@lucidgreen.io. Retailers have limited ability to correct Case ID configurations using the LucidRetail app or web portal. Most corrections need to happen upstream with the supplier.
Can a cashier manually adjust the quantity in the cart after scanning a LucidID?
No. When items are added to the cart via LucidID scan, the quantity cannot be manually incremented. Each unit must be scanned individually so Flowhub can track exactly which units were sold.
You did it! 🙌 Your store is now set up to use LucidID integration.