Setting up scales

Setting up scales

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.

 

Prerequisites

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:

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.

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

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

Installation Procedures

On-Premise

1.      On each machine connected to a scale, run the setup.exe as administrator.



      

Click Next.

      
      

Accept the defaults and click Next to finish the installation.

Verify that the service installed correctly, and that IIS is functioning properly by navigating to this address: http://<computer_name>/SureShipScaleWS/.   
A page displaying the available web service function calls should display.



      2.      To test the scale settings, and choose the appropriate driver, run the provided SureShipScaleTestUtility.exe as administrator. 
      3.      Enter the settings for your scale, enter the Web Service URL http://<computer_name>/SureShipScaleWS/, and select a driver from the Driver selection box. 
      4.      Click “Read Weight” to verify the scale is communicating properly.




5.      In Syteline, navigate to the SureShip Scale Config form and add the record for your new scale as follows:











For USB Scales:
      a)      Enter the Connection Type of USB and set HID to true.  
      b)      Enter a description, select a driver, enter the Vendor and Product ID in hex format (0x0000), and enter the scale webservice address in the Scale Portal URL field.  All other fields can be left blank.

For COM Scales:
      a)      Enter the Connection Type of COM and set HID to false. 
      b)      Enter a description, select a driver, enter the full set of communication settings, and enter the scale webservice address in the Scale Portal URL field.  All other fields can be left blank.

6.       In Syteline, open the SureShip Kiosks form and select the scale to be used for the appropriate kiosk.
7.      In the SureShip Console, select the kiosk, and click Get Weight to call the scale and retrieve the weight.

SaaS/Hosted

1.      Follow the on-premise installation procedure steps 1 and 2 above for each machine connected to scale.  

2.      When that is complete, on the public facing web server, run the portal setup.exe as administrator.


            












Click Next.















Accept the defaults and click Next to finish the installation.

Verify that the service installed correctly, and that IIS is functioning properly by navigating to this address: https://<external_web_address>/SureShipScalePortalWS/.   
A page displaying the available web service function calls should display.














3.      In Syteline, navigate to the SureShip Scale Config form and add the record for your new scale as follows:












For USB Scales:

      a)      Enter the Connection Type of USB, and set HID to true.  
      b)      Enter a description, select a driver, and enter the Vendor and Product ID in hex format (0x0000). 
      c)      Enter the public facing web address for the scale portal in the Scale Portal URL field.
      d)      Enter the machine name where the local scale webservice is installed in the Local Scale Machine Name.   
      e)      Enter the Scale Portal User ID that was provided to you by AIT and save the record.   
      f)      Click the Generate Web Service Key button to generate the unique encrypted credentials required to access the public facing portal web service and save.

For COM Scales:

      a)      Enter the Connection Type of COM, and set HID to false. 
      b)      Enter a description, select a driver, and enter the full set of communication settings.  
      c)      Enter the public facing web address for the scale portal in the Scale Portal URL field. 
      d)      Enter the machine name where the local scale webservice is installed in the Local Scale Machine Name. 
      e)      Enter the Scale Portal User ID that was provided to you by AIT and save the record.   
      f)      Click the Generate Web Service Key button to generate the unique encrypted credentials required to access the public facing portal web service and save. 

4.      In Syteline, open the SureShip Kiosks form and select the scale to be used for the appropriate kiosk.

5.      In the SureShip Console, select the kiosk, and click Get Weight to call the scale and retrieve the weight.











    • Related Articles

    • System and Hardware Requirements

      ERP Software Requirements SureShip™ Enterprise is currently compatible with the following ERP applications: SyteLine® 8.02 SyteLine® 8.03.11 SyteLine® 8.03.20 SyteLine® 9.00.30 SyteLine® 9.01 SyteLine® 10 On Premise SureShip™ QuickShip for Cloud is ...

    • Setting up kiosks (work stations)

      Introduction A kiosk is a computer work station (or a set of identically configured work stations) which will use the SureShip™ module to communicate with shipping carriers via API, receive weight inputs from scales, and/or print shipping labels. ...

    • Setting up label printers

      Introduction Label printers may be used to print API labels or non-API labels. This article describes how to set up and view label printers in the SureShip™ module. SureShip Printer Config The SureShip Printer Config form is used to review and modify ...

    • System and Hardware Requirements

      ERP Software Requirements The SurePrint™ module interfaces with BarTender® Software to design and print various label templates. Use of the module requires the Automation Edition for BarTender® Software Version 10 and above. It is currently ...

    • Setting up label printers

      Introduction This article describes how to set up and view label printers in the SurePrint™ module. SurePrint Printers The SurePrint Printers form is used to setup and review the descriptions and network paths of any label printer on your company ...