Overview

The Heska Imaging (SPI) integration is a new integration that will replace the existing Cuattro integration in ezyVet.


Part 1: Configuring the API Partner (Heska Imaging) Integration

Part 2: Send the API Partner (Heska Imaging) Client Credentials to Heska

Part 3: Configuring the Heska Imaging (SPI) Integration

Part 4: Setting up Diagnostics

Part 5: Creating a Diagnostic Request

Part 6: Receiving Diagnostic Results


Contacting Heska Imaging:

Email: imagingsupport@heska.com

Call support line: (800) 464-3752





Part I: Configuring the API Partner (Heska Imaging) Integration


1. Navigate to ADMIN

2. Using the drop-down menu on the left, select Integration.

3. On the main page, use the Integration drop-down/search to find API Partner.

When you select API Partner, an extra section will appear called API Partner Settings.

4. Under the Partner drop-down, select Heska Imaging



5. Click SAVE to save the integration.

6. Upon saving, credentials will be generated and the list of scopes will be displayed. Under the Scopes section, click the green 'Select All' button to enable all scopes.



7. Click SAVE again. 




Part 2: Send the API Partner (Heska Imaging) Client Credentials to Heska


1. Go to the API Partner (Heska Imaging) setting that was created from Part 1.




2. Click the 'Download Credentials' button to download the client credentials for this API Partner integration.


3. You will download a .txt file which will contain the below information:


4. Please email this .txt as an attachment to imagingsupport@heska.com and mention that this is for the Heska Imaging integration with ezyVet.


5. Heska will reply with a confirmation that the API Partner Client Credentials have been set up on their end. This set up must be done in order for Heska to send results back successfully through the new Heska Imaging integration.




Part 3: Configuring the Heska Imaging (SPI) Integration


Warning: This part will be done with the assistance of both ezyVet and the Heska Imaging team. Please be advised that you may expect to see up to an hour downtime of the Cuattro integration and is advised to do this step during a quieter hour at the clinic.


1. Go to Admin -> Integration -> Integrations.


2. From the drop down (of the new integration settings tab) choose 'Heska Imaging (SPI)'



3. Select the Division (if applicable)


4. Select a supplier record.



5. Under the 'API Partner' section, search for 'API Partner (Heska Imaging)'. This is the integration created in part 1.


6. Under the 'HeskaImaging Integration Settings', set the Client ID and Client Secret provided by Heska. If you do not know this Client ID and Client Secret, please reach out to imagingsupport@heska.com.

Set the Grant Type to be 'client_credentials'

 

7. Click SAVE


8. Set the 'Modality' under 'HeskaImaging Integration Settings'. If this is the first time configuring a SPI, click the modality list once - this will start generating the list of modalities. You can then click the drop-down again with the list of modalities to choose from. Please note, you will need a separate integration AND a separate Supplier for each modality



Selecting an example modality: [DX] Digital Radiography



9Click SAVE


10Click 'Validate Credentials' and ensure the credentials validate. If it doesn't, it is likely that one of the Client ID, Client Secret or Grant Type are incorrect.


11. You have now completed the integration configuration in ezyVet.




Part 4: Setting up Diagnostics

1. Navigate to the ‘Admin’ tab and select ‘Clinical’ from the drop-down menu.


2. Select 'Diagnostics’ from the top left list.


3. Choose the diagnostic from the below-left list or create a new one.


4. In the open tab, enter a diagnostic code.


5. Include a name for the diagnostic.


6. Select the supplier to link the diagnostic to.


7. Select a diagnostic form (if applicable).


8. Set the billing trigger (product) or create a new one by double clicking in this field.

Note: Adding a billing trigger will ensure automatic billing capture and an invoice will generate each time the diagnostic is requested.


9. Click ‘Save’.





Part 5: Creating a Diagnostic Request

Sending Diagnostic Requests

In the clinical record of a patient, select the (+) plus icon before ‘Diagnostic Request’ to open to Diagnostic Request window. Each test must have its own request and lab reference number.



In this window, select your Heska Imaging Integration as the Supplier and choose the diagnostic(s). Include additional notes/information in the ‘Specifics’ section. 


Lastly, click the blue ‘Add’ button to send.



The request will be listed under diagnostic requests on the patient’s medical record and the request will have sent to the Cuattro machine. 


Creating initial and secondary requests for the same study

Many clinics will have an initial diagnostic and a secondary diagnostic for billing purposes, however do all imaging on the initial request.

When creating an initial diagnostic, you will need to select your initial diagnostic and make sure the supplier is linked. This will ensure a request is sent to the machine.

To create secondary diagnostics for billing purposes, you will want to add the diagnostic however make sure the supplier is not linked - this will create a billing line without sending another request to the machine.

All imaging can be completed on the initial request.




Part 6: Receiving Diagnostic Results

Once imaging is completed, a diagnostic result will be created. All of the images will be added to the diagnostic result as well as reports and any additional files. You will automatically be notified when results come back by an automated memo (If you have memos toggled on). These results should return to ezyVet within 5 minutes.

The diagnostic results can be found in a patient’s clinical record under ‘Diagnostic Results’ as well as in the ‘Diagnostics’ tab on the Dashboard. Currently, there are no thumbnails for the images in the diagnostic result however you can click the icon in the screenshot below to open the online viewer.




When the study is complete, mark the results as complete by changing the ‘tick icon’ to complete. This is indicated when the icon is green.