Guide Overview

This guide is designed to give Incident IQ administrators an overview of 

  • Managing InTouch API Integration
  • Creating item categories and item types
  • Review data imported by InTouch

Please see the following guide on how to add payments and fees to users, assets, and tickets:

Guide Index

You can use the following links below to quickly navigate to a specific section in this document. To quickly return to this index simply use the "Return to Index" link located at the end of each section.

  1. Getting Started
  2. Settings Tab
  3. Import Log Tab
  4. Errors Tab
  5. Item Categories Tab
  6. Item Types Tab
  7. Sync History Tab
  8. Export Tab
  9. Permissions
  10. FAQ 

 

Getting Started

There are a few step to integrate with InTouch and Incident IQ. Navigate to the Intouch app. Click Incident IQ Apps > Manage on the left side bar. Then select Manage next to the Intouch App.
mceclip1.png
First, you will need to generate an API token by selecting Generate API Token under the Getting Started Tab. Copy the API Token and please provide this to support@intouchreceipting.com so they can finish setting up the integration.

Below are the following required fields that need to match between iiQ and InTouch: 

    • School Id within iiQ must match InTouch field Student Id 
    • Sku within iiQ must match the InTouch field Item Collection
    • Location Abbreviation (set up on the Locations page) within iiQ must match the InTouch field Fine Location Code

Next, you will need to go to Item Categories tab. Here, you set up the Item Categories of fees you use (ie. Library Fees, Technology Fees, etc). Then, you will need to go to the Item Types tab. Here, you will need to create the Items Types that can be charged (ie. Laptop Insurance Fee, Lost Book Fee, etc.)

Finally, you'll want to set permissions to control what users or roles should be able to create, edit and delete charges and fees.

Please see the additional article sections for more details on setting up Item Categories, Item Types, and Permissions. 

mceclip0.png

[Return to Index]

Settings Tab

On the Setting tab enter in the number of days before a fee is overdue. 

mceclip8.png

[Return to Index]

 

Import Log

On the Import Log tab you can view the raw data received from InTouch. You can search by the different data fields below: 

  • Message
  • Import Status (Unprocessed, Imported, Error, Ignored)
  • Raw Values
  • Data Imported From and To

mceclip9.png

[Return to Index]

 

Errors Tab

Here you can view failed line item transfers between In Touch Payments Api and Incident IQ.

mceclip10.png

[Return to Index]

 

Item Categories

Item Categories are the fines for fees categories (i.e. course fees, library fines, device insurance, athletics). Click on the Item Categories tab. Then click Add New Item Category. Enter the Title of the category, along with the Description. Click Save

mceclip11.png

When adding or editing and item category, you will need to Re-Build Payment Data after making all of your changes. Re-Build Payment Data is updating existing data for your grid column payment data to be displayed correctly. Click on Re-Build Payment Data

mceclip9.png

You can Edit or Delete the category to the right. 

mceclip10.png

[Return to Index]

 

Item Types

Item Types are the fees, payments or adjustments that associated to the Item Category. For example, under the Item Category library fines you can have item types: overdue, damaged, lost. Click on the Item Types tab. Then click Add New Item Type

mceclip11.png

Next you will need to fill out the following fields: 

  • Sku:  required to enter the item has a Sku.
    Please note: Sku within iiQ must match the InTouch field Item Collection
  • Title: required to enter the items title. 
  • Description: enter in a description of the item. 
  • Category: required select which category the item is associated with. 
  • Type: required to select the type: fee, payment, adjustment.
  • Default Amount: enter the default amount. This can be changed when issuing the payment or fee. 

mceclip13.png

Click Save. You can Edit or Delete the item type to the right.

mceclip14.png

[Return to Index]

 

Sync History

This tab allows you to view your sync history between IIQ and InTouch. Every sync, whether it completed successfully or not, is logged for reference purposes and available for review.

Clicking on View Details will open that sync's details. From here, you can review the full list of payments that were added or number of errors.  

mceclip6.png

[Return to Index]

 

Export 

On the Export tab you can Export All Transactions. This will generate an excel file that contains all of transactions and information need (SKU, category, name, description, amount, due date and more.)
mceclip7.png

[Return to Index]

 

Permissions

Under the Permission tab you have access to limit which users can: 

  • Delete existing payment or fee transactions 
  • Modify existing payment or fee transactions
  • Create a new payment or fee transactions

    mceclip18.png

[Return to Index]

 

FAQ

  1. Do payments recorded in iiQ write back to InTouch? (ex: student pays cash or writes a check, agent adds payment in iiQ)
    Yes, if a fines is recorded as paid in iiQ it will be removed from InTouch. 

  2. Does the sync from InTouch update fees on users account and the assets? (ex: if a fee is associated with a user and an asset it is paid in InTouch, does it update both the user and the asset with the next sync?)
    Yes. When a payment comes in from InTouch, it will reference the fine that it is associated with user or asset. If this fine was associated with both a user and an asset, that fine will now be marked as paid, reducing the outstanding balance for both the user and the asset.

  3. Are there any error logs or alerts/notifications for when an error has occurred during a sync? 
    No. But you can view any errors from the nightly sync on Errors Tab or the Import Log tab. 

 

[Return to Index]

Was this article helpful?
1 out of 1 found this helpful