MassCIP configuration guide - Dutchie POS
This article applies to Dutchie POS.
Learn how to configure Dutchie POS with MassCIP.
The state of Massachusetts uses the Massachusetts Cannabis Industry Portal (MassCIP) in addition to Metrc to regulate cannabis. Dutchie communicates with MassCIP via Metrc for patient allotment, posting products dispensed to patients, and sales reporting.
Things to know
- Dutchie POS does not directly integrate with MassCIP and does not retrieve any patient information from MassCIP, such as demographics, photos, etc. Instead, Dutchie POS and MassCIP both integrate with Metrc.
- MassCIP uses the Grams/concentration value of each package in Dutchie POS to calculate allotments. Dutchie POS' Flower equivalent value is only used to limit sales in the Dutchie Register and is not transmitted to MassCIP.
- Each item's Metrc External category maps to the MassCIP category. For non-flower external categories (such as concentrates, infused products, or suppositories), MassCIP multiplies the Dutchie POS Grams/concentration value by 5.3.
- Manufacturers and Cultivation facilities in Massachusetts: The MA M-Number is issued by the state. Item records must be added to Metrc first, once the M-Number is registered. Product names in the Catalog must match Metrc item names EXACTLY.
- Once added, Dutchie can update Item information by saving the Catalog products with Sync to Metrc Item set to Yes. However, if the name in Dutchie POS ever changes, the connection will be broken.
Integration requirements
- Certain settings need to be enabled by Dutchie in order to use the MassCIP integration. Reach out to your Dutchie Administrator for assistance with settings.
Integration workflow
Configure MassCIP settings
There are a number of options for configuring settings for MassCIP. These settings are editable in the Backoffice to configure settings:
- Go to Settings > Integrations.
- Click the MassCIP card.
- Click the Actions dropdown.
- Select Settings and fill out the fields as below:
Field | Description |
Enable Dispensing | Setting to Yes enables posting transactions. Setting this to "No" puts the integration into "Allotment only" mode. |
Require Individual User Credentials |
If set to Yes, users cannot use the master username and password and must provide their own credentials to log in.
If set to No, the integration will use the individual users' credentials if they exist but automatically fall back to the master username and password if they do not.
In NEITHER case will it use the master username/password if the user's credentials fail, only if they are not set. |
Use Flower Equivalent for Transmission | Select No |
Use External Component | Select No |
MassCIP MTC Name | The official name of your LSP. |
MassCIP Master Username and MassCIP Master Password | The user name and password for the master account. |
Status and modes
The MassCIP integration displays a Status and Mode for the integration. A status of Disabled indicates Dutchie is not communicating with the VG at all, and it has been disabled in the database.
There are three possible modes: Real Time, Batch, and Allotment Only.
- Real Time: Transactions are posted to the VG before they're checked out in Dutchie. Any failure in posting will return an error to the POS and prevent the checkout.
- Batch: Transactions are queued for transmission periodically (typically every 15 minutes) and checkout will never be blocked by the VG. If a failure occurs, it is logged for review and will be tried again with every subsequent push until the error is resolved.
- Allotment Only: No transactions are ever posted to the VG and the integration is used to pull allotments only.