Connect Flourish to BarTender for Cannabis Label Printing

BarTender® software is trusted by organizations worldwide to improve safety, security, efficiency, and compliance by optimizing their labeling, marking, and printing processes.

Flourish Software offers seamless integration with BarTender® to enable efficient and accurate label printing for packages and plants.

Prerequisites

1. Before you begin, ensure you have an active BarTender® account. This account is required to activate and manage the integration.

1. Once you are signed into BarTender, you will need to connect your printer. You will be prompted to Install the BarTender Print Gateway.

Activate the BarTender® Integration

To integrate Flourish Software with BarTender™, you must register the Flourish application in BarTender™ to generate the necessary authentication codes, then input those codes into Flourish Software.

This is a two-step process:

1. Register Flourish in BarTender™
2. Connect to BarTender™ in Flourish Software

Register Flourish in BarTender™

1. Log in to your BarTender™ account.
2. Click on API Keys under Administration in the side navigation.
3. Click Register Application for OAuth Access.

   

4. Fill out the registration form with the required information (copy from here):
   

   Field Name	Field Content (copy from here and paste in BarTender™ )
   Name	Flourish Web App
   Description	BarTender Cloud integration from Flourish Software web application
   Login URL	https://app.flourishsoftware.com/admin/integrations/bartender/settings?auth=success
   Callback List	https://app.flourishsoftware.com/v1/api/companies/integrations/bartender/callback
   Logout URLs	https://app.flourishsoftware.com/admin/integrations/bartender/settings?auth=logout&error=&error_description=
   Allowed Origins (CORS)	leave this field blank
   Allowed Web Origins	leave this field blank

5. Click Register. BarTender™ will show you the Application ID and Secret for the key you just created, and will add a new application entry at the bottom of the API Keys list.
6. If you need to retrieve the Application ID and Secret again, you can click the three dots (⋮) on the far right of the new entry and choose View ID & Secret.

   

7. Copy both the Application ID and Application Secret.

Connect to BarTender™ in Flourish Software

1. Open Flourish Software.
2. Navigate to Settings.
3. Select Integrations from the menu.
4. Locate the BarTender™ card.
5. Click Configure.

1. Paste the copied credentials from BarTender™ into the corresponding fields.
   1. Client ID → Paste the Application ID
   2. Client Secret → Paste the Application Secret
2. Click Connect.
   Flourish Software will then authenticate to your BarTender™ Cloud instance and complete the connection securely.
3. Click Setup Reference Data. This creates a folder named Flourish Template Data Sources with both package_label.json and plant_label.json files to BarTender for field mapping in the designer.

1. Navigate to your BarTender Librarian to confirm the Reference Data has been populated. We will use this later for Database Connection Setup and configuring your label templates.

Using BarTender Template Designer

The template designer is what you will use to create and print labels from Flourish. We will first create the template file, then we will configure the label.

1. Create the template File
2. Connect the template file to the Flourish database File.
3. Design the label

Creating the Template File

1. To start with a new template, navigate to the BarTender Librarian. You can access from either the home screen's "quick access" page or on the left navigation menu (folder icon).

1. Click +New (drop-down menu) and select Document Design.

1. Name your template, click Design.

1. Find your template in the Librarian and click on the 3 dots to the right of the filename. Click Design.

1. A new tab on your browser will open and you will be prompted to set the printer to use and set the dimensions of your label. Follow the prompts in BarTender to define the settings. Please see example screenshots below.

1. Click Finish.

Connect Your Template to the Flourish Database File

Connect the Flourish database fields to the Template file in BarTender so you can configure your label with integrated Flourish data.

1. Click on the Database Connection Setup icon at the top of screen.
   1. Follow the prompts to add the package_label.json file to the template from the file in your librarian.

1. Click OK and the Flourish database fields will populate on the left side panel for template design and mapping.

Designing the Label

1. Click the text box (A icon in the toolbar) to create a text field. This will be used for element headers and field mappings. It is standard to use Normal or Normal Wrapped if word wrapping is needed for Ingredients or Warnings.

1. You can configure the label in two different ways.
   1. Option 1: Find the field name on the left, click and drag into the desired area of the label. You can do this with or without a field name header.
   2. Option 2: Create the text box, right click to select Properties and follow the prompts.

      

Select Database Field and Click Next.

Click the drop-down menu to search and find the field name to add. Once selected, click Finish. The text box is now mapped to a Flourish field.

Here is a quick video to demonstrate both ways to handle this.

1. Continue either process until all required fields are mapped. Click Save. Click Print to preview a test print of your label. To print labels, follow the instructions below for printing labels out of Flourish.

Print Labels Using BarTender®

You can use the BarTender® integration to print package, product, or plant labels directly within Flourish.

To print labels:

1. Initiate a print action (individual or bulk).
2. Toggle ON the Print with BarTender™ option.

   

3. Enter the number of copies (default is 1).
4. Select a printing device from the dropdown.
5. Choose a label template from the dropdown.
6. Click Print.
7. A success message will confirm your labels have been sent to the printer.