Print

ACHWorks-IP

ACHWorks-IP or eChexIP is a fast, very robust, small footprint and yet powerful TCP/IP client program that exchanges ACH transaction files with our ACH Gateway Servers. All communications are securely encrypted and compressed. Just double-click on the program icon and you are ready to go. It can be used interactively as a stand-alone program, or can be used in a command line.  It can be tightly integrated into your in-house software packages and other third-party software that are capable of calling out external programs through command line scripts.

You can totally control the eChexIP program through these command line scripts, or using the Windows Shell API commands. The shell script commands can be called from any programming language using CreateProcess Windows API or other equivalent Shell API functions within your programming environment  (C#, VC++, VB, MS Access, Paradox, Delphi, etc.).

It also includes file validation tests to point out the errors in your submitted file before they are received by our servers. This would give you enough time to correct your file before it is too late in the process, providing you control on timely submissions of validated files.

Using the eChexIP program interactively.

eChexIP is a simple but user-friendly program. The first time you eChexIP, you should setup the correct eChexIP server address, port number, location ID, server password and download directory. We will provide you the Server IP Addresses, Port Number, Location ID and password after you completed signing up with us. To setup ACHWorks-IP (eChexIP) connections properly, just click on the File menu and select connection setup. Enter the values required in the appropriate boxes and then click the save button. To test if you can connect with our ACH Gateway servers, you just click the Receive button and you should get a message like the one below:

Searching for eChexIP ACH Gateway Server...
Server found.
Logging in...
Connected.
Access Granted.
Checking server directory...
Downloading Files...
Downloaded Files:

No files to download.

The Access Granted message should indicate that you have set your eChexIP server address, port number, location ID and server password correctly. And if there are connection problems, such as not setting your firewall, not having internet connections, you may get:

Searching for eChexIP ACH Gateway Server...
Server Error Code:10061
Server is not accessible.
Cannot establish connection with the server.

Download unsuccessful.

Image

After a successful setup, you can start sending and receiving files. You can validate your batchfile without sending it to us. You can do this by clicking the Validate button. After clicking the validate button, navigate through the file dialog box until you find the file and double-click the file that you want to validate. Results of the validation are shown in the message window, and also will be automatically stored in a .SUM file. The Validation response file will have the same name as the original file but with an extension named to .SUM and can be found in the same directory where you originated your file. Validation will let you know if the file is ok for submission or failed the validation test. Any error will always result in failing the validation test. Details about the errors are found in the .SUM file. This command should help you troubleshoot the required format for the eChex Batch files. You don’t need to validate the file every time.


To send a batch file to our ACH Gateway servers, just click the send button. Then navigate through the file dialog box and double-click the file that you want to send. Your file will be validated, and if it passes, your file will be uploaded. The message window should tell you if your file has been accepted or not and any communication errors encountered. Everytime you send a file, you will either get a .ACK file after a successful upload or a .ERR file for a failed upload. After a successful upload, the .ACK file will contain:

  • The first line of the ACK file is the server time stamp (dd/mm/yyyy hh:mm:ss AM/PM PST) the file was received by our server.
  • The second line is the acknowledgement that we have accepted your file and it shows the file name.
  • The third line is the summary of your Debits and credits associated with the accepted file.
  • The fourth line are your total number of records (including header and trailer), the number of debit transactions, the number of credit transactions, and the number of addendas.
  • The last line should hopefully be always zero, the number of errors in your submitted file.


In case of errors, there is no specific format for the error logs, as different kinds of error could happen. The errors are shown in the message window as well as in the .ERR file.


To receive response files just click the receive button. The message window should display the list of files downloaded as well as any errors encountered. Also, the Download.LOG file is created in the destination directory after each receive attempt.

Other eChexIP tips:

You can send a file immediately by dragging a batchfile from any folder and dropping it directly into the eChexIP program. You can also drag and drop a file directly into the eChexIP program icon and it will start the sending process right away. This is of course if you have done the connection setup correctly.