TechMate Integration Setup

The section outlines the steps needed to support the TechMate Integration on your system.

PREREQUISTES:

These instructions assume that your company currently has an account established with TechMate. Additionally, you will need the following items:

•    The TechMate executable (TechMateIntegration.exe).

•    List of carton and distribution codes from TechMate to identify supported items in MoversSuite, such as the code of “Dishpack,” which is mapped to a MoversSuite Item Code via XML Item Code Setup.

•    Login credentials for each MoversSuite user you wish to grant the ability to import/export.

STEPS:

1.    Establish a TechMate vendor within XML Interface Setup.

2.    Add system record for TechMate within XML System Setup.

3.    Add supported items within XML Item Code Setup.

4.    Add supported types within Note Type Setup.

5.    Add TechMate credentials to supported employees through their Personnel Setup record.

6.    Update sales Personnel Setup records to have them included in imports/exports

7.    Update the ThirdParty folder with configuration files and executables and test.

STEP 1: Add a TechMate Vendor to XML Interface

Setup Area: MoversSuite Administration > Administration > XML Interface

Create a single TechMate record within XML Interface Setup. Set the Vendor Name to “TechMate.”

Figure 1: XML Interface Setup record

The Van Line Item setting is ignored for TechMate Integration.

By default, you can import items for all branches. Optionally, if you wish to restrict this to certain branches, then add branches to the list of Branch Item records. Once you add branches, you can only import from TechMate items associated to branches in the list. NOTE: Manage branches through Branch Setup.

STEP 2: Add an XML System Setup record for the TechMate Vendor

Setup Area: MoversSuite Administration > Administration > XML System

Create a single record within XML System Setup using the value shown in the table below the image.

Figure 2: XML System Setup record

Establish the following values for the system record:

Additionally, create a single XML System Data Type Map record through the XML System Data Type Map section.

Figure 3: Add XML System Data Type Map dialog

Specify the following attributes to the data type mapping for TechMate:

STEP 3: Define supported Item Codes for Revenue Import

Setup Area: MoversSuite Administration > Administration > XML Item Code

For each supported TechMate carton code, define an XML Item Code Setup record. Set the XML Item Code to one of the supported codes listed within the TechMate Supported Carton and Distribution Codes topic and link it to a MoversSuite a Material Type or Item Code. In the example below, the TechMate Carton Code of “Carton, 1.5” is set within the XML Item Code field and it links to the Material Type of “1.5 Cubic Feet”, which is defined in MoversSuite through the Material Type Setup.

Figure 4: XML Item Code Setup sample for a carton code

Each supported code must be mapped to a Material Type or to an Item Code to avoid missing data when bringing in revenue through a Revenue Import.

If you wish the carton codes to link to Containers, Packing and Unpacking (CPU) items, then set link the XML Item Code record to a Material Type. The example above, the Material Type of “1.5 Cubic Feet” maps to a Material Type Setup record that contains the necessary Item Code mappings for each container type.

Figure 5: Material Type Setup record

Optionally, you can also link directly to an Item Code as in the example below.

Figure 6: XML Item Code record for a distribution code

NOTE: Typically, carton codes link to Material Type values and distribution codes link to Item Code values directly. You can refer to each supported type through the TechMate Supported Carton and Distribution Codes topic.

IMPORTANT: Avoid setting both the Item Code and Material Type when defining these records.

Reference the Material Type Setup and the TechMate Supported Carton and Distribution Codes topics when defining the XML Item Code Setup records.

STEP 4: Add Supported Note Types

Setup Area: MoversSuite Administration > Customer Service > Note Type

There are three different types of notes that are documented for the TechMate Integration. You will need to define each type as a separate Note Type Setup record within MoversSuite.

Figure 7: Note Type Setup

Create three Note Type Setup records for each Van Line Code listed below.

STEP 5: Update Personnel Setup records for Estimators

Setup Area: MoversSuite Administration > Personnel > Personnel

Each estimator that needs to log into TechMate from within the MoversSuite application must have their credentials defined within Personnel Setup. Set these credentials for the TechMate interface through the Interface Mappings tab.

Add TechMate as the Interface for each person.

Figure 8: Personnel Setup > Interface Mapping

Then you can click on the Credentials button to supply their specific TechMate login credentials. Note that the User Name is associated to the estimator’s login identifier within TechMate.

Figure 9: Credentials dialog for TechMate

These credentials are passed to the TechMate application when the evoked through the Accounting Tools Menu.

STEP 6: Update Personnel Setup records for Salespeople

Setup Area: MoversSuite Administration > Personnel > Personnel

If you wish to import and export identifiers for salespeople, then for each you must set their User ID within the Interface Mappings on their Personnel Setup record.

Figure 10: Personnel Setup > Interface Mapping

The User ID within the Add Employee Interface Mapping must match the Salesperson ID in TechMate.

Figure 11: Add Employee Interface Mapping dialog

Set the values on the Employee Interface Mapping for salespeople as indicated in the following table.

STEP 7: Configure TechMate Application and Third Party Menu

There should be a ThirdParty folder within the MoversSuite application directory. Add this folder, if it is missing, and place the configuration file and executable program for the TechMate application within this folder.

Figure 12: Sample Windows Explorer view

The ThirdParty folder typically resides in the following location on your application server:

C:\Program Files (x86)\Movers Suite\ThirdParty

Refer to the TechMate Integration Configuration File topic for specifics on the configuration file and executable loaded into the ThirdParty folder. Additionally, import folders for TechMate files must also be defined. Details are also described within the TechMate Integration Configuration File topic.

Update the config.xml file found within the ThirdParty folder to run the TechMate application in the following two modes.

Config.xml:

The above assumes that the TechMateIntegration.exe file exists in the ThridParty folder along with corresponding XML configuration files.

Below is a sample file running the TechMate application.

These two entries will show up as menu options within the Third Party Applications Menu.

Figure 13: Third Party Applications menu