Installing and configuring the HubCapp Peripheral Agent for SendPro Enterprise

HubCapp Peripheral Agent is a program that connects your printers, scales, and other peripherals to SendPro Enterprise.
Products affected: SendPro® Enterprise

HubCapp Peripheral Agent is a program that connects your printers, scales, and other peripherals to SendPro Enterprise.

Before you begin

  • Ensure that all peripherals and printers along with their associated drivers have been installed using the instructions included with the hardware.
  • Ensure that the correct folder rights are set:
    1. Right-click on the C:\Program Files (x86)\HubCapp Peripheral Agent\ folder and select Properties.
    2. Select the Security tab.
    3. Select Edit.
    4. In the Groups or user names section, ensure that both Users and Everyone are present. If not, select Add and add them.
    5. Click once on Users. In the lower section under Permissions for Users, check the box in the Allow column next to Full Control.
    6. Click once on Everyone. In the lower section under Permissions for Everyone, check the box in the Allow column next to Full Control.
    7. Select Apply and then OK to close the window.
    8. Repeat steps 1-7 for each of the following folders:
      • C:\ProgramData\HubCapp Peripheral Agent\
      • C:\ProgramData\IsolatedStorage\ (only available if using a meter)
      • C:\ProgramData\Pitney Bowes\ (only available if using a meter)

Install HubCapp Peripheral Agent and create shortcuts

  1. Download and install HubCapp Peripheral Agent.
  2. (Optional) To have HubCapp Peripheral Agent open when the computer starts, add a shortcut to the Startup folder:
    1. Open File Explorer and go to the HubCapp Peripheral Agent installation folder. The default path is C:\Program Files (x86)\HubCapp Peripheral Agent.
    2. Right-click on HubCapp Peripheral Agent.exe and select Send To > Desktop (create shortcut).
    3. Move or copy the HubCapp Peripheral Agent shortcut you created in the previous step to one of the following Startup folders:
      • For all users: C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup\
      • For the current user only: C:\Users\[Username]\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\

Launch and configure HubCapp Peripheral Agent

  1. Double-click on the HubCapp Peripheral Agent desktop icon, or go to Windows > HubCapp Peripheral Agent > HubCapp Peripheral Agent.exe. The HubCapp Peripheral Agent will launch and an “H” icon will be displayed in the system tray (small icons near the clock).
  2. Right-click on the H icon in the system tray and select Configure, or open a web browser and go to http://localhost:50000/Config.html. We recommend bookmarking this page for easier access later.
  3. When the Configuration page opens, click the Settings icon (gears in the upper right).
  4. Fill in the following settings:
    ItemDescriptionNotes/Example
    Server
    Name
    Provided by Pitney Bowes
    Tenant specific
    Example: https://{servername}HC.sendproenterprise.com
    License
    Key
    Provided by Pitney Bowes
    Tenant specific
    Example: ABCD-EFGH-IJLK-MNOP (Must be in ALL CAPS) (No spaces before or after)
    Machine
    Name
    Specific name to allow connection to SendPro EnterpriseWhile the Server Name and License Key will be the same across all your users, the machine name is what specifies which HubCapp Peripheral Agent connects with which SendPro Enterprise login. This needs to be unique and not copied across all HubCapp Peripheral Agents installed.
    Configure
    Per User
    Used if multiple users will be signed in to the computer at the same timeIf multiple users are signed in to the computer at the same time, check this box and each user will be allowed to set up their own settings for HubCapp Peripheral Agent connections.
  5. Save the settings.
  6. Add the same settings to SendPro Enterprise:
    1. Open the SendPro Enterprise App that you will use with the HubCapp Peripheral Agent.
    2. Select Settings in the upper right.
    3. Add the same settings you added above in step 4.
    4. Save the settings.

Configure printers

  1. Select the Printers tab.
  2. Complete the form as follows:
    Printer TypeItemValue
    Thermal Label FormatPrinterSelect the target label printer attached to the computer.
    FormatZebra-ZPL
    Laser Document PrinterPrinterSelect the target laser printer.
    Form PrinterPrinterSelect the target form printer.
  3. Select Save.
  4. Use the Test Print buttons to verify functionality.

Configure a scale or QubeVu Dimensioner

  1. Select the Scale tab.
  2. Complete the form as follows:
    DeviceItemValue
    USB ScaleInterface TypeUSB
    Scale TypeSelect the attached scale.
    Pitney Bowes Dimensioner (QubeVu)Interface TypeQubeVu
    Hostname or IP{devicename} or IP (for example, 192.168.1.11)
    Serial ScaleInterface TypeSerial
    Scale TypeSelect the scale type.
    Serial PortSelect the serial port to which the scale is connected.
    Bits per Second (BPS)Set the BPS (9600 is default)
    Data BitsSet the Data Bits (7 is default)
    ParitySet the Parity (Even is default)
    Stop BitsSet the Stop Bits (1 is default)
  3. Select Save.
  4. Use the Zero and Weigh buttons to verify connectivity.

Configure documents (optional)

The Documents tab allows for sending specific document types to certain printers in the specified quantities. For example, each time a Commercial Invoice is generated, HubCapp may be set up to print a certain number of copies to a different printer than the Laser Document Printer configured in the Printers tab. This is an optional configuration.

  1. Select the Documents tab.
  2. Unless instructed otherwise, leave the Image Resize and Margin Settings values at their defaults.
  3. For each document type to be handled by a specific printer, enter the desired quantity, then select the Specific Printer.
  4. Select Save.

Configure labels (optional)

The Labels table allows for sending specific label types to certain printers in the specified quantities. For example, each time a Return Label is generated, HubCapp may be set up to print a certain number of copies to a different label printer than the Label Printer Format Printer configured in the Printers tab. This is an optional configuration.

  1. Select the Labels tab.
  2. For each label type to be handled by a specific printer, enter the desired quantity, select the Specific Printer from the list box, then select Zebra-ZPL from the Printer Format list box.
  3. Select Save.

Configure postage meter

  1. Select the Postal Meter tab.
  2. Select the Meter Type.
  3. Under Import, select Choose File to Import.
  4. Select the meter .XML file to import.
  5. Meter ID should list the meter.
  6. Select Save in the upper right.

UPDATED: September 21, 2023