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, 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. Virtual Manifests are not available through the LucidGreen API, so Case IDs must be manually scanned onto inventory items in Flowhub.
Check out the video below to learn more about our integration with Lucid ID.
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:
Go to help.lucidgreen.io
Select "Submit a ticket" in the upper right corner.
In your ticket, mention that you are looking to use the LucidID integration with Flowhub.
The LucidGreen team will create an account for you and provide the API key required to complete the integration setup.
Once you have your API key, follow the steps below to connect LucidID to 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.
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 API key.
Add a Case ID to Inventory
Once the integration is enabled, you can associate Case IDs with inventory items during the intake process.
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.
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
You can search for inventory by Case ID to find all associated inventory items.
Navigate to Inventory.
Enter a Case ID in the search field.
Flowhub will display all inventory items associated with that Case ID.
Note: You can search by Case ID, but you cannot search by individual 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.