Guide Overview

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

  • Managing InTouch 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. Sync Profiles
  4. Import Log
  5. Item Categories
  6. Item Types
  7. Sync History
  8. Export 
  9. Permissions

 

Getting Started

There are a few step to integrate with InTouch and Incident IQ. First, you will need to contact InTouch at support@intouchreceipting.com. Stating you want to integration with Incident IQ and then InTouch will:
    • Provision a SFTP account for you and provide the credentials. These credentials will need to  be entered in the Sync Profiles tab within iiQ.
    • The verify that any fee types you would like to have in iiQ are configured in InTouch.
    • Set the schedule you would like for the syncs to run. We typically suggest twice per day.

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

Once you have configured with InTouch, 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.) Next, 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 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. 

mceclip1.png

[Return to Index]

 

Sync Profiles

You will need to contact InTouch at support@intouchreceipting.com. Stating you want to integration with Incident IQ. InTouch will then p rovision a SFTP account for you and provide the credentials. Enter in the SFTP credentials in both sections for iiQ to download and upload transactions from InTouch. Entering both credentials is required. 

 

You will need to verify that any fee types you would like to have in iiQ are configured in InTouch. 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 set the schedule you would like for the syncs to run. We typically suggest twice per day.

mceclip4.png

Toward the bottom of the page you can view the last sync status. Also, you can manually run a new sync by clicking Start New Sync

mceclip5.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

mceclip15.png

[Return to Index]

 

Item Category

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

mceclip8.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.  

mceclip16.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.)
mceclip17.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]

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