Technician Troubleshooting Documentation

Edit

Set up the ShipRush program

The first thing that you need to check is, if Shiprush Program is already installed on the local computer. It is assumed you are properly licensed for the program and have a program installation for each carrier you use.

There is a separate Shiprush Installer for every carrier

  • ShipRush for FedEx
  • ShipRush for UPS (Pro and Basic)
  • ShipRush Discount Postage (for USPS shipping or Endicia Shipping)
It is important to ensure each workstation has the shiprush.zip file contents installed locally and the ShipRush program set up and running for each carrier or you incur errors at Point of Sale.
Edit

Stylesheet Setup

In order to install the ShipRush integration with System Five, you must first obtain a copy of the stylesheets.

  • Download Here: Shiprush Stylesheets
  • Store this file on the local drive of the workstation, specifically on the Drive C:\
  • LIKE: C:\Shiprush
The stylesheets were programmed to look to this specific directory. If you MUST put this folder elsewhere, a number of XML & XSL stylesheets will need to be edited to point to where exactly the shiprush files are located.
  • Now that you have the “stylesheets”, it is time to “WRITE” it into “XMLCENTRAL.XML” file.
  • Navigate to “C:\Shiprush\” folder
  • Edit “Install.bat” file
  • Update the line “echo ie: install c:\mydata\xmlcentral.xml” to point to the actual location of the xmlcentral.xml file of the customer.
  • Eg: “echo ie: install W:\System5\Data\xmlcentral.xml”
  • Save the changes and exit

  • Now open up “Command Prompt” and queue to the Shiprush folder
  • Type “CD C:\Shiprush” and press enter key

  • You should get this prompt “C:\Shiprush”
  • Now type the following “Install.bat W:\System5\Data\xmlcentral.xml” and press enter
  • If no errors encountered, then you have successfully written Shiprush into XMLCENTRAL

It is assumed here that the actual path of the customer’s data is “W:\System5\Data”. XmlCentral.xml file is relative to the “Data” folder.
Edit

System Five Setup

  • Login to System Five
  • Navigate to Setup Tools / Utilities / XML Central / Export XML
  • Click the Export drop down box and you should see 5 new exports created with their corresponding setting

Edit

Create Invoice Free-Form Comments

You can either go to the Setup Wizard or edit and existing invoice Again the free-form comments are being handled by the stylesheets, so it is important that you create them on their respective line number namely.

Row 2: Carrier
Row 3: ShippingService
Row 4: TrackingNumber
Row 5: ShipDate
Row 6: ShippingCost
Row 7: Weight
Row 20: Link

Image

Edit

Create a keyboard shortcut for Export

A “Keyboard” shortcut makes the process of exporting the invoice over to Shiprush program much easier and quicklier. Depending on which “Carrier” they are using, the shortcut can be created via Setup Tools / Miscellaneous / XML Shortcut Keys.

Sample

Edit

Configure Shiprush Program to communicate with SystemFive

Shiprush program will have an “ICON” running at the System Tray (bottom right of the computer screen).

  • Right-click this icon
  • Select “Settings” > “Program Setting”
  • The ShipRush Program Settings dialog box appears. Ensure the 'ADO and SQL Databases (Direct Access)' option is selected from the Program drop-down list (the default is 'Stand-alone (no contact manager)').

  • Click on “CM Setting” Button
  • On the General tab, click [Import Settings From File]. A standard windows Open dialog box appears where you navigate to the ShipRush directory and select the 'settings.xml' file (supplied in the ShipRush.zip file). This file configures information in the Getting Contact Info and Writing History Info tabs for communicating with System Five.

Getting Contact Info

Writing History Info

  • Click [OK] to close the Contact Manager Settings & Writing history dialog box.
  • Click [OK] to close the ShipRush Program Settings dialog box and open the Welcome to ShipRush dialog box.
  • Click [Run ShipRush] to leave the program running in the system tray.
Edit

How the Integration Works

  1. You create an invoice in SystemFive
  2. Go to Options / Invoice Options / Export to XML / “select the carrier” or you can use the shortcut you created
  3. This will load up the invoice in Shiprush program
  4. They will complete all the shipping details in there and click “SHIP” to process or complete
  5. This will then send the invoice back to SystemFive with the “Shipping Information” that was entered from shiprush.
You can confirm this by going to the Free-Form comments of the invoice.