Commercial and in Confidence
The information contained in this document is confidential.  No part of this document may be reproduced, disclosed to any third party, or issued in any form or by any means without the express written permission of Intersoft Systems & Programming Ltd.

Contents
Document Controls
Table of Figures
1. Introduction
2. Installing Print Harvester
3. Configuring Print Harvester
3.1. Scan Settings
3.2. Response Settings
3.3. Printing Settings
3.4. API Information
4. Run Print Harvester
4.1. Application Log
5. Switching from Test to Live Environment
5.1. Uninstalling the Silent Print and Print Harvester Applications
Appendix 1 – Print Harvester Example Responses
Appendix 2 – Quick Reference Guide Print Harvester

Table of Figures

Figure 1 - Open Print Harvester Settings
Figure 2 - Print Harvester Settings Screen
Figure 3 - Print Harvester Scan Settings
Figure 4 - Print Harvester Response Settings
Figure 5 - Print Harvester Printing Settings
Figure 6 - Silent Print Profile ID
Figure 7 - Enter Profile ID in Print Harvester
Figure 8 - Copy Import Profile ID
Figure 9 - Enter Import Profile ID in Print Harvester
Figure 10 - Run and Pause Print Harvester
Figure 11 - Print Harvester Application Log
Figure 12 - Silent Print application in Uninstall or Change a Program list

Introduction

The Print Harvester functionality allows you to relay shipment details by transferring data files from a computer or network location to Intelligent Shipper for automatic processing and creation of shipments.

Installing Print Harvester

1. To install the Print Harvester application, you will first need to download the executable file.

• To download Print Harvester for use in the Sandbox environment, select the following link: {+}https://test.intelligentshipper.net/downloads/releases/printharvester/setup.exe+
• To download Print Harvester for use in the Live environment, select the following link: https://rmls.intelligentshipper.net/downloads/releases/printharvester/setup.exe

1. When prompted, select to run the executable file.
2. The executable will run and the Print Harvester application will be installed on your PC.
3. Once Print Harvester is installed the settings screen will open automatically, allowing you to configure the application.
4. The settings screen can also be opened at any time by right-clicking on a small icon that will appear in the system tray, as shown in the picture below.

Figure 1 - Open Print Harvester Settings

1. Once Print Harvester is installed, or when the Settings option is selected, the Settings screen will open.

Figure 2 - Print Harvester Settings Screen

Configuring Print Harvester

Once the Print Harvester application has been installed you then need to configure your settings.

Scan Settings

1. When the application is installed, it creates default scan & response folders on the local system, e.g. "C:\PrintHarvester\Scan". You can use this default location or change the scan folder to a location of your choice by selecting "Browse".
2. The application accepts files in all the formats applicable in bulk mailing, i.e. csv, pipe & ascii. The extension csv is automatically populated by default. Do not change the setting from the default, as this is the extension of the Bulk Mailing Template created earlier.
3. If the files you will be importing contain a header row, then select the "Header" tick box.

Figure 3 - Print Harvester Scan Settings

Response Settings

1. Base64 encoded PDF images of the labels generated from the scanned file will be written to the Response Folder. You can either use the default location or choose a folder or your choice by selecting "Browse".
2. The label can be returned as either an xml or json response. Select your preferred response file type from the Response File Type drop-down list, then update the Response File Extension to match the selected file type.

Figure 4 - Print Harvester Response Settings

Printing Settings

There are 2 print options available to select form:

1. Print Direct: This option requires you to click a button for labels to be printed. Your current printer settings will be populated in this field by default.
2. Silent Print: This option will automatically print labels once they are generated, reducing mouse clicks. When this option is selected, the system will silent print the labels as per the preference selected in the silent print profile.

Figure 5 - Print Harvester Printing Settings

1. Tick the Silent Print box.
2. To find your Silent Print profile ID, in Intelligent Shipper navigate to Maintenance > Silent Print > Edit Print Profile. Your Silent Print profile ID will then be displayed on screen, as shown in the image below.

Figure 6 - Silent Print Profile ID

1. Copy the Silent Print profile ID, then paste it into the Profile ID field in the Print Harvester Settings screen.

Figure 7 - Enter Profile ID in Print Harvester

API Information

This section will store all the data needed to connect to Intelligent Shipper.

1. The URL field will be populated by default and cannot be changed.
2. API UserID, Password and Account Code will be provided by Intersoft. If you do not already have API credentials or need additional information, please contact techsupport@intersoft.co.uk .
3. Import Profile ID can be found in the Intelligent Shipper Bulk Mailing Templates screen. Navigate to Maintenance -> Bulk Mailing Templates and click the icon next to Import Profile ID to copy the profile ID.

Figure 8 - Copy Import Profile ID

1. Paste the import profile ID into the import Profile field of the Print Harvester settings screen.

Figure 9 - Enter Import Profile ID in Print Harvester

1. Select your preferred import action from the 2 available options:
2. Print: This option will print labels generated from the scanned data file.
3. Create: This option will create shipments in Intelligent Shipper's unprocessed state. The shipments will then need to be scanned for the labels to be generated.
4. Once the configuration has been completed click "Save".

Run Print Harvester

1. To start transferring files, right-click on the Print Harvester Application icon and then click "Run".
2. To Pause file transferring click "Pause". To resume file transfer after pausing click "Run" again.

Figure 10 - Run and Pause Print Harvester

Application Log

This window will keep a log of the days when the Print Harvester application has run.

1. To open the application log right-click on the Print Harvester Application icon, and then click on "Application Log".
2. The Application Log window is then displayed.

Figure 11 - Print Harvester Application Log

Switching from Test to Live Environment

When switching over from Intersoft's Test environment to the Live environment, you will need to uninstall any test versions of the Print Harvester application that were installed during testing before downloading and installing the Live version.

Uninstalling the Silent Print and Print Harvester Applications

To uninstall the Print Harvester application from your PC, complete the following steps:

1. Access Control Panel on your PC.
2. Select Programs and Features > Uninstall or Change a Program.
3. Locate the 'Intersoft Print Harvester' application from the list and uninstall the applications.

Figure 12 - Silent Print application in Uninstall or Change a Program list

1. You will now need to remove the temporary files pertaining to Print Harvester from your PC.
2. Access the App Data > Local folder on your PC via the following file path:

C:\UsersUser Name\AppData\Local
NOTE: You can also find the App Data folder by searching for %appdata% in file explorer, which will take you to the AppData > Roaming folder, you can then backtrack to the AppData folder and will see Local:



Within the Local folder, delete the following folder:

• Intersoft_Systems_&_Progr > PrintHarvester.exe_URL…

1. You have now removed the Print Harvester application from your PC. Print Harvester can be downloaded and installed again for use with the Live environment.
   
   

Appendix 1 – Print Harvester Example Responses

Appendix 2 – Quick Reference Guide Print Harvester