Tec-IT Barcode Generation

The Tec-IT integration generates barcodes based on the PRO Number of a load allowing monitoring while in transit. Barcodes render on the Bill of Lading and Shipping Labels documents on the load. Barcodes are generated when the following criteria are met:

1. A load is populated with a PRO Number.

2. A Carrier is assigned to the load.

3. A Barcode Type is selected on the Carrier Transportation Profile—either Code 39 or Code 128.

4. The Carrier Sales Rep field on the laod is NOT null.

PRO Numbers

A PRO Number is a seven to ten digit number with an optional eleventh character as a check digit. Carriers use PRO Numbers to track and organize the pickups, stops, and deliveries of a load. Typically, PRO numbers are sent through an integration such as Project44, Banyan, AccuFrate, SMC3, SMC3 EVA, or Worldwide Express. They may also be entered or changed manually.

Enter Credentials

Enable the Tec-IT integration by:

1. Navigating to TMS Admin,

2. Select Credentials.

3. Select the Global Services tab,

4. Find Falvey in the list and open the record.

5. Check the Enabled box and

6. Enter the Password 1 into the text field.

7. Click the Save button when finished.

Remote Site Settings

If upgrading from a previous release of the TMS, check that the Remote Site Settings for the Tec-IT integration URL are up to date.

1. Click the Setup gear icon in the top Right corner.

2. From the drop-down, click Setup.

3. In the Quick Find Toolbar type Remote Site Settings and click the link.

4. From the list of remote sites find Tec-IT and click the Edit link.

5. Update the Remote Site URL to match the Service URL below:

Service URL: https://services.tec-it.com
Test Service URL: https://services.tec-it.com

Valid credentials are required from a paid subscription to use the Tec-IT barcode generator. Tec-IT provides the necessary access key.

Platform Events must also be enabled in Setup. Select the Setup gear in the upper-right corner and choose Setup. Type Platform Events into the Quick Find search bar. Click the link for Platform Events. Confirm the Queued Transaction Event is listed.

From TMS Admin, Configuration, confirm that the box for Barcodes is checked.

Barcode Field Settings

Barcode settings are set on the Transportation Profile of each Carrier. A Barcode Type field is required, but the remaining barcode fields may be entered or left blank as necessary. Tec-IT returns default values for any field selection not specified except for the PRO Number and barcode type fields. Navigate to the Carrier Transportation Profile and click the Settings tab and find the Barcode section.

Set the Barcode Type field on the Carrier's Transportation Profile record based on the Carrier's barcode requirement.

API Field Mapping Table

• The Barcode Units applies to the Width, Height, and White Space Border values.

• The Image Resolution is measured in DPI. Do not exceed 600 DPI.

• The Show Text field displays the barcode text based on the below text fields.

• The Text Color is expressed in RGB hex codes:

  • black is 000000

  • white is FFFFFF

  • red is FF0000

• The Text Distance is the space between the barcode and the text as measured in the Barcode Units field.

• The Text Font can have any combination of the font, style, and/or size (Times New Roman; Times New Roman, 12pt.; Times New Roman, 12pt., bold).

• The Text Position default is below the barcode, centered.

• The White Space Border is the margin around all four sides of the barcode. The border can render as one value, or as multiple comma delimited values.

  • One value generates a barcode with the same border size on all four sides.

  • Entering two values sets the top/bottom and left/right: (0.2, 0.1) renders the white space border as .2 inches on the top and bottom, and .1 inches on the left and right.

  • Entering four values in this order: top, right, bottom, left renders a white space with the entered border value (.05, .04, .055, .035). In this example, the white space border is .05 inches on the top, .04 inches on the right side, .055 inches on the bottom, and .035 inches on the left side.

• If values are not entered for the Barcode Width or Barcode Height, the barcode returns as the largest possible representation that is machine-readable.

Generate Barcode API Call

Sample Request String

it.com/aspx/TBarCode/barcode.ashx?accesskey=DEMO&code=Code128&data=24983107&showhrt=yes&height=1650&unit=mils&qz=500&qzunit=mils&textdistance=&textalign=center&textposition=below&font=Times+New+Roman&textcolor=FF0000&format=png&onerror=500\

TMS Field Updates

Creating Barcodes

Barcodes may be created automatically or manually. This setting is found on the Carrier Transportation Profile record as a checkbox field Manually Regenerate Barcode. The barcode is returned from Tec-IT and stored on the load Documents tab, Files subtab.

Once the barcode is returned, the Bill of Lading and/or Shipping Labels documents may be generated and display the barcode image on those documents.

The Remove Special Characters field removes any characters from the PRO Number field outside [A to Z and 0 to 9] for Code 39 barcodes and [a to z and 0 to 9] for Code 128 barcodes. If this field is “unchecked,” any characters outside of the standard values cause an error preventing barcode generation.

If manually creating barcodes, navigate to the Documents tab on the load and choose the Generate Document subtab. From the picklist, select Barcode option and then click the Generate button. Once complete, the barcode image displays below the picklist.

All generated barcodes follow the naming convention of {Load Number} - {PRO Number} - Barcode.png.

Error:

In case of an error, the Carrier Sales Rep contact receives an email notification.

Automatic Barcode Generation

When Manually Regenerate Barcode is unchecked, barcodes are automatically generated as a background process. Barcodes are automatically generated when:

1. The PRO Number changes

2. The Load is tendered

3. The Load is assigned to a Carrier

Regenerating Barcodes

There are a few scenarios in which a barcode may need to be recreated:

1. The PRO Number on the Load changes.

2. The barcode image is deleted.

3. An error occurs in generating a barcode.

A barcode does not automatically generate if an existing barcode image with the same name already exists on the Load.

For example, a barcode image is generated for PRO Number “1234567.” If the PRO Number changes to different value, another barcode image is generated for the new value. If the PRO Number changes back to “1234567” and the original barcode file was not deleted, the TMS will not automatically generate a new file.

Manual Barcode Generation

If the Manually Regenerate Barcode field is checked, the barcode will NOT automatically regernerate when the PRO Number changes.

Manually generate a barcode by navigating to the Documents tab on the load and click on the Generate Document subtab. From the picklist, select the Barcode option and click the Generate button.

Barcode Type Specifications

Barcode Type 39: Accepts only uppercase letters, numbers, and some special characters (Period, -, $, /, +, %, and space. The additional * character is used as start and stop delimiters.

Barcode Type 128: All ASCII characters, upper and lower case letters.

For more information on barcodes, see the Tec-IT support page.

Tec-IT API URL: https://services.tec-it.com