Installing Rapidship Client with Barcode Order Entry

This document will provide a step-by-step guide to installing Rapidship Client with support for barcode scan based order entry.

Requirements

  • The Rapidship Client installer, available here.

  • A barcodes_master.xml and an XSLT configuration file, provided by CXT Software.

  • A sample barcode for testing purposes, provided by CXT Software.

Install Rapidship Client

If you do not have the installer please contact CXT Software Technical Support.

  1. Double click the installer.

  2. Click the Install button.

  3. Click Close when installation is completed.

Create the barcodesXSLT Directory

  1. Navigate to the path where Rapidship Client was installed. By default, this will be C:\Program Files (x86)\Connexion\RapidShip.

  2. Add a folder in the directory called “barcodesXSLT”.

  3. Open the barcodesXSLT directory, copy the barcodes_master.xml file and XSLT file that you have received from CXT Software.

Launch Rapidship and Test a Barcode.

  1. Open Rapidship Client and log in with the Server URL for the Operations App instance, in the format 0000.cxtsoftware.net (replacing 0000 with your 4-digit customer ID) and the appropriate internet user’s Username and Password.

  2. Choose the correct customer Account from the dropdown, and then paste your sample barcode directly into the Address Book field.

  3. The barcode will be automatically decoded and the appropriate fields filled.

    Example of when a barcode is entered successfully.
  4. Choose a Service Type, an available Order Type (you may need to click the “Refresh” button in that field before the list appears), then click Place Order when ready to place the order.

  5. The words “Processing Order” will appear on the bottom bar of the application, and when the order is successfully imported, the new order number in the bottom right-hand corner.

  6. Repeat steps 2 through 5 for any other barcodes you need to scan.

Entering Orders with a Scanner

  1. Open Rapidship Client and log in with the Server URL for the Operations App instance, in the format 0000.cxtsoftware.net (replacing 0000 with your 4-digit customer ID) and the appropriate internet user’s Username and Password.

  2. Choose the correct customer Account from the dropdown, and then click on the Address Book field.

  3. Scan the barcode with the scanner device that is connected to the PC. The scanner will translate the barcode into text and paste its contents into the field, where its contents will automatically be distributed into the correct order fields.

  4. Choose a Service Type, an available Order Type (you may need to click the “Refresh” button in that field before the list appears), then click Place Order when ready to place the order.

  5. The words “Processing Order” will appear on the bottom bar of the application, and when the order is successfully imported, the new order number in the bottom right-hand corner.

  6. Repeat steps 2 through 5 for any other barcodes you need to scan.

Configuring a Service Type and Order Template for One-Click Scanning

The need to select a service type and order type after scanning and before placing an order can be removed by setting up a service type with only one order type in it, and creating an order template that assigns that service type.

  1. In the Operations App, create a ‘Rapidship Client’ service type. See Service Type or Service Types (Classic Operations App).

  2. Go to the order type that you want scanned orders to use and check the ‘Rapidship Client’ service type in the Service Types Filter tab. See Order Types or Order Types (Classic Operations App).

  3. In Rapidship Client, go to Order Templates, click the Create button, and give the new template a name.

  4. Select the Account and the Service Type that this template will use, then click Save the Template.

  5. To scan with this template, go to the Place Orders form and choose the new template from the dropdown. The Account and Service Type will be automatically set.

  6. Now, position your cursor in the Address Book field and scan or paste a barcode. Since the Service Type is already set, only one Order Type is available, so you can place the order with a single click of the Place Order button after scanning.

Adding Parcels to Scanned Orders

If there are parcels that need to be added to the order, you can quickly add those with the scanner as well.

  1. When placing an order, click on the dropdown in the Parcels section in the top right of the Place Orders page and choose a parcel type for the parcel you want to add under Type.

  2. Place your cursor in the Barcode field.

  3. Scan the barcode of the parcel you are adding. The barcode reference value will be entered into the Barcode field as a text string as shown here.

  4. You may also add a Weight value for the parcel, and repeat these steps for any other parcels that need to be entered.

  5. Now, when you click the Place Order button, the parcels you added will be included in the created order.