📝 Overview
This article covers how to set up and use the Heska Cloud integration, including uninstalling any previously installed Heska widget, enabling the integration, and mapping inventory items to Heska's test catalog.
⚠️ Before You Get Started
If you are currently using the older integration that required a locally-installed widget, that widget must be uninstalled before activating the Heska Cloud integration. Failing to do so will disrupt the integration's ability to receive results.
To uninstall the old Heska widget:
Download the uninstaller
Double-click the downloaded file and confirm your intent to uninstall
⛔️ The locally-installed Heska widget must be uninstalled before proceeding.
🔑 Enabling the Integration
To enable the Heska Cloud integration:
Click Settings > Integrations from the left hand navigation or the Integrations if you are in the Settings module
Search for the the Heska Cloud Integration in the search bar on the upper right
Complete the form that appears
⚠️ Please Note: If you do not have your client ID and secret, contact your Heska representative.
🗂️ Mapping Inventory Items
To complete the integration, you may need to map your existing inventory items to Heska's test catalog.
To map an inventory item:
Navigate to the Inventory module and select New Item or click search and click Edit Item on an exisiting Heska item.
In the Name field, type the Heska test name and select the appropriate test from the list that appears
Click Save + Done
💡 Heska tests will appear in the list starting with Heska:
⚠️ Important: Items must be selected from the dropdown list for the integration to function. Custom inventory items will not be recognized by the integration.
💡 Tip: The names of integrated lab items cannot be edited. Use the Display Name option to set a custom name for the item.
❓ Frequently Asked Questions (FAQs)
Find answers to common questions or additional details that may not be covered in the main instructions.
What happens if I don't uninstall the old Heska widget before enabling the new integration?
Click the arrow to see the answer
Click the arrow to see the answer
Failing to uninstall the locally-installed Heska widget before activating the Heska Cloud integration will disrupt the integration's ability to receive results. The old widget must be fully uninstalled before proceeding.
What if I don't have my Heska client ID and secret?
Click the arrow to see the answer
Click the arrow to see the answer
Contact your Heska representative to obtain your client ID and secret before completing the integration setup form.
Can I use a custom inventory item name with the Heska integration?
Click the arrow to see the answer
Click the arrow to see the answer
No. Items must be selected directly from Heska's test catalog list within the Name field — custom inventory items will not be recognized by the integration. If you need a custom display name, use the Display Name option instead, as integrated lab item names cannot be edited directly.
I'm using the older locally-installed Heska widget. What do I need to do before setting up the Heska Cloud integration?
Click the arrow to see the answer
Click the arrow to see the answer
The locally-installed widget must be uninstalled before activating the Heska Cloud integration. Failing to do so will disrupt the integration's ability to receive results.
To uninstall the old Heska widget:
Download the uninstaller
Double-click the downloaded file and confirm your intent to uninstall
The locally-installed Heska widget must be uninstalled before proceeding.