Please Note: This article relates to the METRC Delivery Feature in the following markets:
California
For more information about METRC Delivery outside of California, see our METRC Delivery (Excluding CA) article here.
The new CA Delivery feature accommodates the California Cannabis Delivery Ledger regulations. Treez has integrated METRC reporting directly into the Fulfillment Workflow, allowing the system to maintain its Product Taxonomy while adding compliance reporting elements specific to California's unique regulatory environment.
Customers can request this feature by contacting Treez Support and we will set this up for you.
Skip To:
Set Up
Enable Sales Delivery Permission in METRC
In order to report Delivery Sales to METRC, the METRC API Key used for your Treez instance will need to have the Sales Delivery permission enabled. You can enable this directly in the METRC UI by navigating to Admin > Employees
Please Note: If you have multiple stores using the same METRC API key and the API key is regenerated, you will need to update that API Key in each store to avoid interruption in your METRC reporting and related functionality.
Add your METRC License to each store in Organization Management
Add the "Handle Deliveries" permission to roles associated with your delivery drivers and adding the following require fields to each user who will be performing deliveries:
Name
Employee Number
Driver's License number
DL expiration date
Phone number
Need help updating your roles and user in preparation for METRC Delivery? See our How To Enable Delivery Driver Permissions for METRC Delivery article!
Configure Vehicles
The next step will require that you add vehicles and vehicle information in the config page under the “Delivery” module. Navigate to Configuration > Config Page > Delivery and click the Orange Plus Button to add your vehicle(s).
Configure Users
You will now need to provider your users the "Handle Delivery" permission for them to show up as available drivers when grouping a delivery. You can set up your drivers as follows:
Add the Sell Treez > Misc > Handle Deliveries permission to the role(s) your drivers are assigned in Role Management
Create or Update your drivers in User Management and ensure they have the following information in their profile:
Name
Employee Number
Driver's License number
DL expiration date
Phone number
Need help updating your roles and user in preparation for METRC Delivery? See our How To Enable Delivery Driver Permissions for METRC Delivery article!
Create Grouped Orders
The METRC Delivery feature allows users to create delivery groups in the Fulfillment Dashboard which will represent a "Ledger" in METRC. A delivery group and METRC Ledger consists of 1 or more deliveries.
In order to create group orders and report delivery sales to METRC follow the steps outlined below:
Navigate to Retail > Fulfillment Dashboard
Select the “Group for Delivery” button in the top right corner which will launch a New Group Delivery
Within the new modal:
Select the desired delivery orders for grouping using the checkbox
(Note: only Packed & Ready delivery orders are selectable)
Select the driver and vehicle from the dropdown (these will auto populate)
Select “Group” to create new delivery group - this will surface as a stacked card on the Fulfillment Dashboard
Edit or Delete Group Orders
Edit
A group can be edited any time before sending to METRC. To do this, simply click on the stacked group order from the Fulfillment Dashboard. From here the same group modal will launch where Packed & Ready orders can be added and notes, driver info, and vehicle info can be updated.
Delete
In event an order needs to be removed or the user wishes to delete the entire group, they can delete the order via the delivery group modal. They can perform this at any time prior to creating the order in METRC by selecting the group card from Fulfillment and hitting “Delete.”
Send Orders to METRC
Send to METRC
Once the order is ready to depart the facility, the user will select the group card (same as above), verify the grouped order appear correct, and hit “Create in METRC.” This will both move the group to Out for Delivery and create the delivery group in the METRC manifest under status = “departed.” This can be searched in the client’s METRC portal under “Deliveries” > “Active”
Please Note: Once an order is created in METRC, edits to and order in Treez will not be edited in METRC. The ONLY edits that can be made to a METRC delivery manifest once its been created by the METRC Delivery integration are Rejecting packages originally on the manifest, adding packages to an active delivery order cannot be done. If you remove an Item from the Treez order at this point, you must manually complete the delivery in METRC and mark the removed package as Rejected.
Editing Orders After Moving to Out For Delivery
Adding Items/Packages
Once an order has been moved to Out For Delivery using the METRC Delivery Integration, items/packages cannot be added to the METRC Delivery manifest. If you add an item/package to the order in Treez, it will not be added to the METRC Delivery manifest and will cause a discrepancy if you complete the order with the newly added item/package.
If you would like to add an item/package, you will need to cancel the current order and create a new order in Treez with the proper line items/packages.
Removing Items/Packages
Once an order has been moved to Out For Delivery using the METRC Delivery Integration, items/packages cannot be removed from the METRC Delivery manifest. If you remove an item/package from the order in Treez, it will not be removed from the METRC Delivery manifest and will create a discrepancy if you complete the order in Treez unless you manually update the manifest in METRC>
The only way to remove an item/package from the METRC Delivery manifest is to manually Complete the delivery manifest in METRC and mark the package as Rejected.
To manually Complete a manifest in METRC and reject a package that was not delivered to the customer, follow these steps:
Login to METRC.
Navigate to Sales > Deliveries.
Locate the delivery you need to edit.
Click the "Complete" button to the right of the delivery
Locate the package(s) you need to remove from the delivery and click the "Reject Package" checkbox next to those packages.
Once you have clicked the Reject Package button, additional required fields will appear. Update the fields with the appropriate information including the Return Reason and Optional Note.
Once all of the information has been updated, click the "Complete Sales Delivery button.
Once the Sales Delivery is Completed in METRC, you may now Complete related Treez ticket in the Treez Fulfillment Dashboard, ensuring that the Treez ticket now matches the Complete Sales Delivery in METRC.
Complete Orders
To complete orders within a group, the user must select the group fulfillment card (in Out for Delivery) and launch the group modal. From here, a user can select the desired order and hit “Complete Order,” launching SellTreez POS. Once “paid” and “Complete” the individual order will be removed from the group and populate under “Complete” in fulfillment. After all individual orders have been completed, the group card will no longer be present. Completed METRC delivery sales can be viewed in the client’s METRC portal under “Deliveries” > “Inactive.”
Cancel Orders
If after an order moves to Out for Delivery, the order cannot be completed for any reason, that order can be canceled in Treez as long as the delivery group is still in Out for Delivery status. From inside the group modal, a user can click the desired order and hit the "Cancel Order" button, which will remove the order from the group and cancel it. This action will be reported to METRC automatically, removing the canceled order from its associated ledger in METRC. Removing an order from the METRC ledger in this manner will return all inventory from that order back to the retailer's facility.
Closing Delivery Groups
Once a delivery group is moved to Out for Delivery, the group can no longer be edited, the individual orders within the group can only be completed or canceled. As the individual orders are completed or canceled, those orders will be removed from the group and the group will be updated in the Out for Delivery column of the Fulfillment Dashboard to show the number of orders remaining in the group. Upon completing or canceling the last remaining order in any group, that group will automatically be closed and it will be removed from the fulfillment screen. This final action will also be reported to METRC, which will complete the delivery ledger.
Errors from METRC
If delivery group is rejected by METRC with an error, after Treez attempts to create a ledger, the group will automatically be pushed back to Packed & Ready. The failed group will have a red sidebar and clicking into the group will display the error message from METRC at the top. This group will now be in a draft state and can be edited to make any necessary adjustments.
Please note: This group has NOT been created in METRC at this point. It can be edited or deleted and recreated, and the orders / items on them can be edited as well.
Once the error(s) has been addressed, this group can be tried again by using the ‘Send to METRC’ function as described above.
Known Limitations:
METRC Delivery is not intended to support the Dynamic Delivery (also known as Ice Cream Truck) delivery model.
METRC Delivery feature is not available in all markets.
METRC Delivery is not available to partners via external API.
Delivery Groups created in Treez will not create groups in Onfleet.
METRC Delivery does not currently allow for adjustments to orders after being sent to METRC (After the "Send to METRC button is clicked and the orders have moved to "Out for Delivery" status). Editing an order in SellTreez after the order has been marked out for delivery will create inventory discrepancies.
Orders moved to Out For Delivery via POS instead of fulfillment will not create a METRC manifest and will not be reported to METRC. Ensure you only move orders to Out For Delivery using the Fulfillment Dashboard.