Overview

SureShip communicates with scales by means of a webservice running on the machine(s) where the scale(s) are connected.    Currently SureShip supports COM and USB connected scales.

If your Syteline installation is hosted, or SaaS then there is an additional portal webservice that is required to be installed on a public facing webserver in your environment. 

Prereqiusites

On-Premise:

1.  On each machine that is connected to a scale, the following windows features must be installed:

               a) Enable .NET Framework 3.5 (includes .NET 2.0 and 3.0).

               b) Enable all the feature under .Net Framework Advanced Services.

               c) Enable Internet Information Services, with all the default choices, as well as every feature under Web Management Tools.

2.  On each machine that is connected to a scale, make sure TLS1.2 is the default communication protocol.   The scale web services do not support anything below TLS1.2.

3.  For each scale, determine the settings for COM scales (baud, parity, data bits, etc..) or the Vendor Id and Product Id for USB scales.

Hosted/SaaS:

1) On each machine that is connected to a scale, the following windows features must be installed:

d) Enable .NET Framework 3.5 (includes .NET 2.0 and 3.0).

e) Enable all the feature under .Net Framework Advanced Services.

f) Enable Internet Information Services, with all the default choices, as well as every feature under Web Management Tools.

2) On each machine that is connected to a scale, make sure TLS1.2 is the default communication protocol.   The scale web services do not support anything below TLS1.2.

3) For each scale, determine the settings for COM scales (baud, parity, data bits, etc..) or the Vendor Id and Product Id for USB scales.

4) On the public facing web server, repeat steps 1 and 2 above.

The public facing web server must be able to reach the internal address of each scale machine webservice.

4. Enter the appropriate SQL Server Name, SureShip Database Name, SQL Server UserId, and SQL Server Password, then click Next.
   

5. Follow additional prompts until installation is complete. Verify that the SureShip Scale Configuration Utility application appears in the specified install location.
   

Setting up a scale

1. Verify that the scale is plugged in and powered on before continuing.
   
2. Run the SureShip Scale Configuration Utility.
   

3. Use the following instructions for USB scales:
   

1. Verify that the USB checkbox is enabled.
   
2. Click Auto-detect USB Devices. A list of all connected USB devices, including their vendor IDs and product IDs, will appear in the table below. Select a device from the list, then skip to step 5.
   

4. Use the following instructions for COM scales:
   

1. Verify that the USB checkbox is disabled.
   
2. Enter the appropriate Baud Rate, Parity, Data Bits, Handshake, and Stop Bits settings, then proceed to step 5.
   

These settings are not automatically detected. Please refer to the scale’s user manual for this information.

5. Click Read Weight to run a scale test, allowing up to 10 seconds for a response.
   

1. If a numerical weight is returned below then the test is successful. Proceed to step 6.
   

2. If an error message is returned below then the test was not successful.
   

1. For USB scales, select a new device from the list and retry.
   
2. For COM scales, double-check settings for errors. Update and retry as appropriate.
   

A successful scale test is required to complete the next step.

6. Enter a Name for the scale, then click Create to add the scale to the SureShip Scale Config form.
   

Updating SQL connection credentials

1. Open the SureShip Scale Configuration Utility.
   
2. Click Update SQL Connection.
   

3. Enter the appropriate SQL Server Name, SureShip Database Name, SQL Server UserId, and SQL Server Password, then click OK.
   

4. A notification message will appear. Click OK to restart the utility with updated SQL connection credentials.
   

Uninstalling the utility

The utility can be uninstalled as needed using the Add or Remove Programs tool in Windows.

SureShip Scale Config

The SureShip Scale Config form is used to review and modify the description of any scale that SureShip™ has access to. Each scale receives a unique system-assigned Scale ID number, which can be used to attach it to specific kiosks (work stations), though an optional Description may be set for easy identification.

Although it is possible to add new scales from this form, users are recommended to take advantage of the SureShip Scale Configuration Utility and its built-in scale test for this purpose.

References and Related Articles

System and Hardware Requirements

Setting up kiosks (work stations)