Equitrac DisburseMate Interface Program
Version 4.4
The EQDCONV interface program is a DOS based program. It is used to convert photocopy, disbursement, facsimile, laser printer, word processing, postage and phone transactions from an Equitrac data capture unit to a file format that can be imported into Tabs3 using the Tabs3 Merge Data Capture Transactions program. EQDCONV is compatible with both Windows and DOS versions of Tabs3 Version 3.4 and above.
This program also creates client validation files that can be used by the Equitrac System. The validation files contain a record for each active client/matter that exists in the Tabs3 Client file.
To transfer the data from your Equitrac data capture device to Tabs3, a file named Transact.eqd is used. The data in this file must be in ASCII format, which is obtained by using a conversion program available from Equitrac, or by using Equitracs SSP communication program to transfer the Equitrac data from the Equitrac device to a host computer. The TRANSACT.EQD file must reside in the Tabs3 program directory before transactions can be imported into Tabs3.
Note: Transaction entry fields 1 and 2 entered on the Equitrac device are assumed to be the User number and Tabs3 Client number respectively. Fields 3 and 4 are used for disbursements and postage transactions and are assumed to be the number of pieces and the rate per piece respectively. If you are using Equitracs variable pricing feature that is available with version 3.22 and later of Equitracs System III Software, then field 5 is used for the cost for each transaction. Field 6 can be used to override the default Tabs3 transaction code. Field 7 is used as the transaction description. Field 8 is used as the phone or facsimile telephone number.
Note: You may want to create a validation file in EQDCONV before configuring the program. The validation file(s) created in EQDCONV are used by Equitrac to accurately attribute and track transactions to clients in Tabs3. By initially creating a validation file in EQDCONV and transferring it to Equitrac before configuring the program, you can begin collecting valid transactions to import into Tabs3. See the section titled "Creating Validation Files for Equitrac" for more information.
EQPCONV Note: If you are upgrading from Equitrac Phone (EQPCONV) to Equitac Disbursements (EQDCONV), changes will need to be made to your Equitrac file layout. Contact your Equitrac representative for scheduling these changes.
Installation
The EQDCONV interface program (EQDCONV.EXE) must be transferred to the directory on your hard disk where the Tabs3 program files reside. This is done by using the INSTALL program.
To install the EQDCONV interface program on your hard disk:
A:
INSTALL
Note: The Install program has a built-in search feature that will find where your Tabs3 program files reside. On larger network hard drives, this search feature can take quite a bit of time. If you know where the Tabs3 program files reside, you can bypass this search feature by entering the path following the install command. For example, if the Tabs3 program files reside on drive F: in a directory named "STI", you would enter: INSTALL F:\STI
Starting the EQDCONV Interface Program
CD\STI
EQDCONV
The EQDCONV screen will be displayed. The available command options are shown in the following table. These options depending on whether EQDCONV has been configured.
| EQDCONV | Command | Option |
Not configured |
CF |
Configure EQDCONV |
CV |
Create Validation Files for Equitrac | |
Q |
Quit | |
Configured |
CD |
Convert Data |
CV |
Create Validation Files for Equitrac | |
Q |
Quit |
Configuring EQDCONV
EQDCONV must be configured in order to import transactions into Tabs3. Configuration is performed the first time the program is run and will not need to be repeated unless you want to change how the data is being imported into Tabs3. Configuration options are stored in a parameter file named EQDCONV.prm. Each time the EQDCONV program is executed, it will read the EQDCONV.prm file and use those options automatically.
The TRANSACT.EQD file must be present in your Tabs3 program directory when you configure the EQDCONV program. This is because different versions of Equitrac software produce different TRANSACT.EQD file formats. The EQDCONV interface program automatically detects the version of the TRANSACT.EQD file and proceeds accordingly.
Note: It is recommended that you review the configuration options in this document before proceeding with the configuration of the EQDCONV program. There are several options that will impact how the data is converted and imported into Tabs3.
3b) If you answered "Y" in Step 3a, you will be asked three questions
pertaining to the conversion of descriptions. The section titled "Configuration
Options for Converting Equitrac Descriptions" found later in this document includes
examples of descriptions generated by EQDCONV:
3b.1. You will be asked if you want to convert descriptions as all upper
case text or as mixed upper and lower case text.
3b.2. You will be asked if you want to convert predefined hard-coded
descriptions for each transaction type or convert the Tabs3 transaction code
description instead.
3b.3. You will be asked if you want to include Equitracs data entry
field 7 as part of the converted description.
Note: The surcharge is a static dollar amount that will be automatically added to a transaction. It does not calculate on a per item basis (i.e., if you enter a surcharge amount of $5.00 for photocopies, $5.00 will be added on top of the total copy cost for each photocopy session). A separate surcharge can be applied to each transaction type.
If you answered "Y" in response to the "Use generated transaction descriptions" question in Step 3a, you will be asked if you want to include transaction detail information in the description. Please refer to the section titled "Configuration Options for Converting Equitrac Descriptions" at the end of this document for examples of descriptions with or without transaction detail information.
Following the questions about photocopies, you will be asked similar questions about
disbursements, local faxes, long distance faxes, laser copies, local telephone
calls, long distance telephone calls, postage and word processing time. Each of these transaction
types is optional and can be ignored by entering a zero for the appropriate transaction
code when prompted by the program.
Configuration Options for Converting Equitrac Descriptions
During configuration of the EQDCONV program, the following options determine how the descriptions for each Equitrac transaction type are converted. There are 12 possible configurations for converting transaction descriptions. All possible transaction descriptions for each transaction type are listed in the section titled "Examples of Converted Equitrac Descriptions".
If you selected "Y" in step 3a, the following five options determine how the descriptions for each Equitrac transaction type are converted. The description conversion used depends on how you responded to the selections presented in steps 3b and 4.
| Use generated transaction descriptions? | If you enter "N" in response to this
question in step 3a of configuration, none of the descriptions generated by this program
will be converted. The Tabs3 transaction code descriptions will be converted instead. If you enter "Y", one of the descriptions listed in the section titled "Examples of Converted Descriptions" will be converted based on how you respond to the other configuration questions. |
| All Upper Case or Mixed Upper/Lower Case? | If you enter "U" in response to this question in step 3b.1 of configuration, all the descriptions listed in the section titled "Examples of Converted Descriptions" will be converted in upper case text. If you enter "M", all the descriptions will be converted with mixed upper and lower case text as listed. |
| Hard-Coded or Tabs3 Transaction Code Descriptions? | If you enter "H" in response to this question in step 3b.2 of configuration, transaction descriptions 1, 2, 3, 4, 5, or 6 are converted. If you enter "T", transaction descriptions 7, 8, 9, 10, 11, or 12 are converted. |
| Include Field 7? | If you enter "N" in response to this question in step 3b.3 of configuration, transaction descriptions 1, 2, 3, 7, 8, or 9 are converted. If you enter "Y", transaction descriptions 4, 5, 6, 10, 11, or 12 are converted. |
| Include Detail Information? | If you enter "N" in response to this question in step 4 of configuration, transaction descriptions 1, 4, 7, or 10 are converted. If you enter "Y", transaction descriptions 2, 3, 5, 6, 8, 9, 11, or 12 are converted. |
The transaction descriptions used for the next two options depend on how Equitrac is configured.
| Flat Amounts & Variable Pricing | If you are using Equitracs variable pricing feature and the copy count (photocopies, facsimiles, & laser print copies), number of pieces (disbursements & postage), or elapsed time (word processing and phone calls) is zero, descriptions 3, 6, 9, or 12 are converted. If the copy count, number of pieces, or elapsed time is greater than zero, descriptions 2, 5, 8, or 11 are converted. |
| Flat Amounts for Disbursements and Postage | If the number of pieces for disbursements or the rate for postage is zero, descriptions 3, 6, 9 or 12 are converted. If the number of pieces for disbursements or the rate for postage is greater than zero, descriptions 2, 5, 8, or 11 are converted. |
The transaction descriptions used for this option are based on the use of a surcharge.
| Surcharge Amounts | If you enter a surcharge amount of zero in step 4 for any of the transaction types, the text "and surcharge $x.xx" will be omitted for that transaction type. |
Cost Totals Only: If you answer "Y" in response to Import Cost Totals Only (when running the Merge Data Capture Transactions program) and you answered "Y" to keep transaction descriptions in Step 3 of "Configuring EQDCONV", then the transaction descriptions generated by EQDCONV will not be converted. The Tabs3 transaction descriptions will be converted instead.
Reconfiguring: You can change any of the assigned transaction codes or charges in the future by deleting the file EQDCONV.PRM which is created in your Tabs3 program directory during configuration. This will enable you to reconfigure EQDCONV as a first time user of the program.
Variable Pricing: The transaction amount is converted in one of two ways. If you are using Equitracs variable pricing feature, then any amount (zero or otherwise) entered in field 5 is converted as the cost for each transaction. If you are not using variable pricing or leave field 5 blank, the transaction amount is calculated by the EQDCONV program.
Creating Validation Files for Equitrac
The EQDCONV program includes an option to create validation files that can be used by Equitrac to attribute transactions to the appropriate client in Tabs3. Validation files should be created and transferred to Equitrac after adding or deleting clients in Tabs3 or after changing a clients status. This will keep valid Tabs3 client numbers in Equitrac for accurate tracking of transactions.
If new validation files are not created in Tabs3 before creating validation files in EQDCONV, current client information will not be included in the new validation files for Equitrac.
|
Method |
File Name |
Format |
|
1 |
CCUVLDTB.EQT |
Client/Matter Number |
|
2 |
CLNTSIMP.EQT |
Client/Matter Number;Client/Matter Name |
|
3 |
CCUVLDTB.EQT |
Client Number & Client/Matter Number |
|
CLNTSIMP.EQT |
Client Number;Client Name |
|
|
MTTRSIMP.EQT |
Client/Matter Number;Work Description |
|
|
4 |
CLNTSIMP.EQT |
Client/Matter Number;Client/Matter Name;Work Description |
|
5 |
CLNTSIMP.EQT |
Client/Matter Number;Client/Matter Name Search |
|
6 |
LOOKUP.EQT |
Sequence Number;Client/Matter Number |
|
7 |
CLNTSIMP.EQT |
Client/Matter Number;Client/Matter Name Search;Client/Matter Name;Work Description |
The following validation methods are available if you answered "N" to using Equitrac DisburseMate 4.0 or higher:
Method |
File Name |
Format |
1 |
CCUVLDTB.EQT | Client/Matter Number |
2 |
CLNTSIMP.EQT | Client/Matter Number=Client/Matter Name |
3 |
CCUVLDTB.EQT | Client Number & Client/Matter Numbers |
| CLNTSIMP.EQT | Client Number=Client Name | |
| MTTRSIMP.EQT | Client/Matter Number=Work Description | |
4 |
CLNTSIMP.EQT | Client/Matter Number=Client/Matter Name=Work Description |
5 |
CLNTSIMP.EQT | Client/Matter Number=Client/Matter Name Search |
6 |
LOOKUP.EQT | Sequence Number=Client/Matter Number |
7 |
CLNTSIMP.EQT | Client/Matter Number=Client/Matter Name Search=Client/Matter Name=Work Description |
Client Validation
As stated in the section titled "Creating Validation Files for Equitrac", there are 7 possible client validation methods to choose from. Please note that any client names and work descriptions for validation methods 2, 3, 4, 5 and 7 are changed as they are exported in the following 2 ways:
Client Validation Examples If You Are Using Equitrac DisburseMate Version 4.0 Or Higher
Method 1: This method creates a file named CCUVLDTB.EQT containing a list of Tabs3 client/matter numbers. The following is an example of a CCUVLDTB.EQT file:
100;00
101;00
200;01
200;02
200;03
300;00
Method 2: This method creates a file named CLNTSIMP.EQT containing a list of client/matter numbers and client names. The following is an example of a CLNTSIMP.EQT file:
100;00;McBride/John
101;00;Martin/Mary L. & Fred J.
200;01;ABC Insurance Company
200;02;ABC Insurance Company
200;03;ABC Insurance Company
300;00;Harrison/Bradley
Method 3: This method creates 3 files named CCUVLDTB.EQT, CLNTSIMP.EQT and MTTRSIMP.EQT. CCUVLDTB.EQT contains a list of client numbers with all their client/matter numbers following them, CLNTSIMP.EQT contains a list of client numbers and client names, and MTTRSIMP.EQT contains a list of client/matter numbers and work descriptions. The following are examples of CCUVLDTB.EQT, CLNTSIMP.EQT, and MTTRSIMP.EQT files (the file names and the blank lines do not appear in any of the files):
|
CCUVLDTB.EQT |
CLNTSIMP.EQT |
MTTRSIMP.EQT |
|
100 |
100;McBride/John |
|
|
100;00 |
100.00;Management of Estate Trust |
|
|
101 |
101;Martin/Mary L. & Fred J |
|
|
101;00 |
101.00;Private Adoption |
|
|
200 |
200;ABC Insurance Company |
|
|
200;01 |
200.01;Automobile Accident |
|
|
200;02 |
200.02;Hail Damage - Palmer Farm |
|
|
200;03 |
200.03;Death Benefits |
|
|
300 |
300;Harrison/Bradley |
|
|
300;00 |
300.00;Purchase of Real Estate |
Method 4: This method creates a file named CLNTSIMP.EQT containing a list of client/matter numbers, client names, and work descriptions. The following is an example of a CLNTSIMP.EQT file:
100.00;McBride/John;Management of Estate Trust
101.00;Martin/Mary L. & Fred J.;Private Adoption
200.01;ABC Insurance Company;Automobile Accident
200.02;ABC Insurance Company;Hail Damage - Palmer Farm
200.03;ABC Insurance Company;Death Benefits
300.00;Harrison/Bradley;Purchase of Real Estate
Method 5: This method creates a file named CLNTSIMP.EQT containing a list of client/matter numbers and client name search values. The following is an example of a CLNTSIMP.EQT file:
100;00;McBride/John
101;00;Martin/Mary L. &
200;01;ABC Insurance Co
200;02;ABC Insurance Co
200;03;ABC Insurance Co
300;00;Harrison/Bradley
Method 6: This method creates a file named Lookup.eqt containing a single list of sequence numbers which are associated with a client/matter number. This validation method is used when tracking phone calls to client/matters. When a call is logged, the sequence number is entered from the phone to attribute the call to the appropriate client/matter.
The first time this validation file is created, the sequence numbers are assigned to client/matter numbers in the Tabs3 client lookup order. As new client/matter numbers are added to Tabs3, and the validation file is updated the new client/matter numbers will be assigned the next available number in the sequence. The lookup.eqt file must remain in the Tabs3 directory if you want clients to retain the same sequence number. In the following example, a new client matter 200.03 is entered for client 200. In the original validation file client/matter number 200.01 is assigned sequence number 3, 200.02 sequence number 4, and 300.00 sequence number 5. When client matter 200.03 is added it is assigned the next available number in the sequence. For our example lets use 25 as the next available number; so, the next time the validation file is updated client/matter 200.03 will be assigned to sequence number 25.
If the validation file is deleted, the sequence numbers will be reassigned in the Tabs3 client lookup order. If new clients have been added to Tabs3, clients will be reassigned a different sequence number. If the validation file is recreated (i.e., Lookup.eqt has been deleted or removed from the Tabs3 directory) client/matter 200.03 will be assigned sequence number 5, 300.00 assigned sequence number 6, and so on. In recreating the validation file the sequence numbers will be changed from the point where a new client/matter is added.
|
Original |
Updated |
Recreated |
|
1;100;00 |
1;100;00 |
1;100;00 |
|
2;101;00 |
2;101;00 |
2;101;00 |
|
3;200;01 |
3;200;01 |
3;200;01 |
|
4;200;02 |
4;200;02 |
4;200;02 |
|
5;300;00 |
25;200;03 |
5;200;03 |
|
6;xxx;xx |
5;300;00 |
6;300;00 |
Method 7: This method creates a file named CLNTSIMP.EQT containing a list of client/matter numbers, client name search values, client names, and work descriptions. The following is an example of a CLNTSIMP.EQT file:
100;00;McBride/John;McBride/John;Management of Estate Trust
101;00;Martin/Mary L. &;Martin/Mary L. & Fred J.;Private Adoption
200;01;ABC Insurance Co;ABC Insurance Company;Automobile Accident
200;02;ABC Insurance Co;ABC Insurance Company;Hail Damage - Palmer Farm
200;03;ABC Insurance Co;ABC Insurance Company;Death Benefits
300;00;Harrison/Bradley;Harrison/Bradley;Purchase of Real Estate
Client Validation Examples If You Are Using An Equitrac DisburseMate Version Older Than 4.0
Method 1: This method creates a file named CCUVLDTB.EQT containing a list of Tabs3 client/matter numbers. The following is an example of a CCUVLDTB.EQT file:
100.00
101.00
200.01
200.02
200.03
300.00
Method 2: This method creates a file named CLNTSIMP.EQT containing a list of client/matter numbers and client names. The following is an example of a CLNTSIMP.EQT file:
100.00=McBride/John
101.00=Martin/Mary L. & Fred J.
200.01=ABC Insurance Company
200.02=ABC Insurance Company
200.03=ABC Insurance Company
300.00=Harrison/Bradley
Method 3: This method creates 3 files named CCUVLDTB.EQT, CLNTSIMP.EQT and MTTRSIMP.EQT. CCUVLDTB.EQT contains a list of client numbers with all their client/matter numbers following them, CLNTSIMP.EQT contains a list of client numbers and client names, and MTTRSIMP.EQT contains a list of client/matter numbers and work descriptions. The following are examples of CCUVLDTB.EQT, CLNTSIMP.EQT, and MTTRSIMP.EQT files (the file names and the blank lines do not appear in any of the files):
| CCUVLDTB.EQT | CLNTSIMP.EQT | MTTRSIMP.EQT |
| 100 | 100=McBride/John | |
| 100.00 | 100.00=Management of Estate Trust | |
| 101 | 101=Martin/Mary L. & Fred J | |
| 101.00 | 101.00=Private Adoption | |
| 200 | 200=ABC Insurance Company | |
| 200.01 | 200.01=Automobile Accident | |
| 200.02 | 200.02=Hail Damage - Palmer Farm | |
| 200.03 | 200.03=Death Benefits | |
| 300 | 300=Harrison/Bradley | |
| 300.00 | 300.00=Purchase of Real Estate |
Method 4: This method creates a file named CLNTSIMP.EQT containing a list of client/matter numbers, client names, and work descriptions. The following is an example of a CLNTSIMP.EQT file:
100.00=McBride/John=Management of Estate Trust
101.00=Martin/Mary L. & Fred J.=Private Adoption
200.01=ABC Insurance Company=Automobile Accident
200.02=ABC Insurance Company=Hail Damage - Palmer Farm
200.03=ABC Insurance Company=Death Benefits
300.00=Harrison/Bradley=Purchase of Real Estate
Method 5: This method creates a file named CLNTSIMP.EQT containing a list of client/matter numbers and client name search values from Tabs3. The following is an example of a CLNTSIMP.EQT file:
100.00=McBride/John
101.00=Martin/Mary L. &
200.01=ABC Insurance Co
200.02=ABC Insurance Co
200.03=ABC Insurance Co
300.00=Harrison/Bradley
Method 6: This method creates a file named Lookup.eqt containing a single list of sequence numbers which are associated with a client/matter number. This validation method is used when tracking phone calls to client/matters. When a call is logged, the sequence number is entered from the phone to attribute the call to the appropriate client/matter.
The first time this validation file is created, the sequence numbers are assigned to client/matter numbers in the Tabs3 client lookup order. As new client/matter numbers are added to Tabs3, and the validation file is updated the new client/matter numbers will be assigned the next available number in the sequence. The lookup.eqt file must remain in the Tabs3 directory if you want clients to retain the same sequence number. In the following example, a new client matter 200.03 is entered for client 200. In the original validation file client/matter number 200.01 is assigned sequence number 3, 200.02 sequence number 4, and 300.00 sequence number 5. When client matter 200.03 is added it is assigned the next available number in the sequence. For our example lets use 25 as the next available number; so, the next time the validation file is updated client/matter 200.03 will be assigned to sequence number 25.
If the validation file is deleted, the sequence numbers will be reassigned in the Tabs3 client lookup order. If new clients have been added to Tabs3, clients will be reassigned a different sequence number. If the validation file is recreated (i.e., Lookup.eqt has been deleted or removed from the Tabs3 directory) client/matter 200.03 will be assigned sequence number 5, 300.00 assigned sequence number 6, and so on. In recreating the validation file the sequence numbers will be changed from the point where a new client/matter is added.
|
Original |
Updated |
Recreated |
|
1=100.00 |
1=100.00 |
1=100.00 |
|
2=101.00 |
2=101.00 |
2=101.00 |
|
3=200.01 |
3=200.01 |
3=200.01 |
|
4=200.02 |
4=200.02 |
4=200.02 |
|
5=300.00 |
25=200.03 |
5=200.03 |
|
6=xxx.xx |
5=300.00 |
6=300.00 |
Method 7: This method creates a file named CLNTSIMP.EQT containing a list of client/matter numbers, client name search values, client names, and work descriptions. The following is an example of a CLNTSIMP.EQT file:
100.00=McBride/John=McBride/John=Management of Estate Trust
101.00=Martin/Mary L. &=Martin/Mary L. & Fred J=;Private Adoption
200.01=ABC Insurance Co=ABC Insurance Company=Automobile Accident
200.02=ABC Insurance Co=ABC Insurance Company=Hail Damage - Palmer Farm
200.03=ABC Insurance Co=ABC Insurance Company=Death Benefits
300.00=Harrison/Bradley=Harrison/Bradley=Purchase of Real Estate
Converting Data
Before the transactions from Equitrac can be imported into Tabs3, the TRANSACT.EQD file must be converted into data files that Tabs3 can read. After configuring EQDCONV and collecting data in Equitrac, you are ready to convert the collected data.
Caution: Be sure to clear the transactions from your Equitrac devices memory after creating and transferring the TRANSACT.EQD file. This will avoid duplication of data merged with your Tabs3 files.
Transact.eqd Deletion: If you are not using a demo version of the program, the TRANSACT.EQD file will automatically be deleted when the conversion is complete to avoid double posting of the data.
Rejected Records: If any records in the TRANSACT.EQD file are rejected as errors, they will be noted in an EQDCONV.ERR file. You can look at this file with a text editor to see which records (if any) were not converted. If no records are rejected, the EQDCONV.ERR file is not created.
Examples of Converted Descriptions
Photocopies
Disbursements
Local Facsimiles without Facsimile Numbers
Local Facsimiles with Facsimile Numbers
Long Distance Facsimiles without Facsimile Numbers
Long Distance Facsimiles with Facsimile Numbers
Laser Print Copies
Word Processing
Postage
Local Phone without Phone Numbers or Extensions
Local Phone with Phone Numbers without Extensions
Local Phone without Phone Numbers with Extensions
Local Phone with Phone Numbers and Extensions
Long Distance Phone without Phone Numbers or Extensions
Long Distance Phone with Phone Numbers without Extensions
Long Distance Phone without Phone Numbers with Extensions
Long Distance Phone with Phone Numbers and Extensions
2004/03/11