Configure a scale

mdi scale icon fafafa png

The intent of this article is to guide the configuration of a scale used to rate a package.

1. Install Scale Agent

Go to page→
  • Log in to EPISHIP as an Admin.
  • Navigate to Scale Integration on the left sidebar.
  • Tap Download Scale Agent in the actions menu.
  • Select the target operating system for your computer
  • Run and install the Scale Agent
  • Configure the Scale Agent to run at startup or as a login item.
  • Proceed to Create Access Token.

Supported types

  • Windows
  • Apple
  • Linux

2. Create Access Token

Go to page →
  • Navigate to Developer Keys on the left sidebar.
  • Tap Create New Token.
  • Name the token and specify scope (i.e. Printer Agent Access and Scale Agent Access is common).
  • Tap Create Token.
  • Copy the token.
  • Proceed to Configure Scale Agent.

3. Configure Scale Agent

  • Open Scale Agent and Tap on the Connection tab.
  • Specify the API URL as: https://app.epiship.com
  • Paste the Access Token from Step 2 (above) into the token field.
  • Tap Save button and Test Connection Button.

4. Connect Scale

  • Connect your scale to your computer, and power it on.
  • Note: USB scales that follow the HID Point-of-Sale standard appear automatically; a serial scale needs specification of protocol to be set, which can be done through the Probe button.

5. Add a scale

Add a scale →
  • Log in to EPISHIP as an Admin.
  • Navigate to Scale Integration on the left sidebar.
  •  Tap + Add Scale button within the actions menu.
  • Specify Name, specify the Records weights in scale type (i.e. Pounds (lb), specify description, specify connection type (i.e. USB scale HID), Tap the dropdown for Detected scale, and select the scale targeted. 
  • Choose from options within Add Scale modal popup:
    • Make this the default scale for the company. 
    • Let colleagues in my company use this scale. 
    • Share with child companies
    • Only accept a settled reading. Note: enabling this checkbox is suggested, recommended. 
  • Tap Save

How to use the scale

Within the Create A Shipment view inside your dashboard, look for the scale icon within the What’s being shipped step for each package. Tap the scale icon to read out the scale reading and populate into the weight field on the page.

  • Tip: look for icon within Create a Shipment

Troubleshooting

Note: on Linux, USB scales need a udev rule to be read. See PEERMISSIONS.md in the Scale Agent documentation for more information. 

 

Tip: Use the Dignostics tab within the Sale Agent to inspect HID Devices, show input devices and see law raw reponse for a scale reading. 

Copy
Search

Related

Related Categories
service icons rotating
EPISHIP is the most powerful transportation cost management platform ever built.
Get started
China
Featured Lane

China Import Priority

Full specs →

Pay as you go →

Only pay as you ship.
Profile 1 pricing requires a minimal credit balance.
First shipment

Explore the docs →

Built-in features used by some of the largest shippers to save time and money.
Explore
Search
Create Shipment
Shipments
Address Book
Invoices
Invoice Payments
Payment Method
Credits
Company Setting
User
Developers