TruckMate 2024.2 New Features: Back Office

Required upgrade (TM-173710)

TruckMate 2024.1 and later requires DB2 version 11.5.9.

You must upgrade your instance of DB2 to this version before upgrading TruckMate.

AR Adjustments

Added ability to correct mixed currency issues in AR Inquiry and AR Aging (TM-170155)

Previously, if you posted a cash receipt in a different currency control account than the one the bill is in, there was an AR control account mismatch. Only Trimble Transportation Support could fix this issue.

Now there is a new security config under Security > Business Events - Allow Changes > AR - Allow Edit of A/R Adjustment Currency.

The Allow Edit of A/R Adjustment Currency security config.

If this config is set to True, you can change the currency yourself.

The app config AARAE.EXE - Allow Bal Forward must still be set to True to have access to the Currency field:

The Allow Bal Forward app config.

The currency you choose still needs to be the same as the AR Control Acct that is selected.

Check Printing, Direct Deposit

Control ability to delete checks (TM-169578)

New Security Configuration settings in Business Events > Miscellaneous > Checks let you determine whether users can delete checks in Check Printing and Direct Deposit and if so, which checks they can delete.

The Allow Deleting Direct Deposit and Allow Deleting Printing Checks business events.

  • Allow Deleting Direct Deposit
    Affects the ability to delete checks in Direct Deposit. Valid options include:

    • Disallow
      Users cannot delete any checks.

    • My Direct Deposit
      Users can only delete checks that they created.

    • Allow
      Users can delete any check.

  • Allow Deleting Printing Checks
    Affects the ability to delete checks in Check Printing. Valid options include:

    • Disallow
      Users cannot delete any checks.

    • Allow
      Users can delete any check.

If Allow is selected, TruckMate looks at the value of the AP - Allow Clearing of Other Users Checks option to determine which checks users can delete. This option is on the Security tab under Business Events > Allow Changes.

The Allow Clearing of Other Users Checks business event.

Codes Maintenance

Enhance rating for brokerage use case (TM-159575)

The Zone Codes tab in Codes Maintenance was changed to show more information if the zone is a Rate Base Zone in Rates Maintenance.

tm 159575 242a

If the zone you are viewing is included within the range of a rate base zone, the Zone Code of the rate base is displayed in this field:

tm 159575 242b

If included in multiple rate base zones, Multiple is displayed instead.

You can also now increase your client charges based on a percentage of your carrier charges, without accessorials. This is enabled by two new tabs.

The first new tab is under Rates Maintenance > Vendor Information > Client Markups. This tab has a grid where you can configure client markup changes. These will apply where the vendor rate sheet is applied to a freight bill when determining the carrier payment.

tm 159575 242c

The second new tab is under Rates Maintenance > Client Information > Carrier Markups. This tab has a simple grid where you can configure a global client markup charge. This will apply where the client profile is the bill-to party on a freight bill.

tm 159575 242d

A new section in Customer Service > IP > Charges shows the original and adjusted markups.

tm 159575 242e

Vendor rating audits and logging were changed to capture this information in two locations.

The first location is Customer Service > IP > Rating:

tm 159575 242f

The second location is Customer Service > IP > View Rate Log:

tm 159575 242g

When the carrier is assigned in Dispatch or Multi Mode Dispatch, the client markup is calculated when the prorated charges are assigned to each freight bill in the manifest. At that point, each freight bill is checked for:

  • If the bill-to party of the freight bill is configured for a profile-level global markup.

  • If the vendor rate sheet used for the carrier assignment has a client-specific markup.

    If multiple rate sheets apply, this type of markup is not used.

Select Rate Log to see the log for each freight bill.

tm 159575 242h

The Billing tab in Customer Service was changed to show when client charges are being increased due to markups on vendor or carrier payments.

tm 159575 242i

By default, markups are considered taxable. The app config Client Markup Taxable can be used to make them non-taxable.

Because the client’s total charges are being increased, GL Distribution was changed to set the GL account to be associated with IP markups. The GL account must be associated with a new GL Type of PR004, IP Markup Revenue.

tm 159575 242j

The IP Audit program was updated to change the client markup amounts if the IP pay is changed. However, this cannot be done if a freight bill has already been interfaced for billing. Two new warnings were added for this scenario.

One warning tells you that the markups will be recalculated:

tm 159575 242k

Another warning tells you that, if the freight bill has markups and is approved for billing, the markups cannot be increased:

tm 159575 242m

The IP Inquiry Import tool under Tools > IP Import Processing was also affected. If the freight bill linked to the carrier payment is already approved for billing or interfaced to the GL, client markups cannot be adjusted. In this case, the Import tool will populate a new error code:

tm 159575 242n

This situation will require you to use the "Manual Update" feature to force the carrier payment through. However, client markups will not be adjusted.

The TruckMate orders REST API’s GET method was updated to return the client markup charges as part of its body payload.

tm 159575 242o

Filter option for fuel prices (TM-168714)

On the Prices tab in the Fuel Prices window, a new Filter field lets you refine your search by:

  • Specific text in the Average Code field

  • A range of start dates

  • A range of current prices

In addition, if you select Multiple Filters, you can specify two or more filters.

tm 168714 242a

Added the Applies to option to the Accessorial Charges settings (TM-170172)

In the Accessorial Charges section, Applies to sets what type of movement that the Accessorial Charge applies to.

tm 170172 242a

Applies to can have these values: Pickup, Delivery, Both, CrossDock, and None. The details area shows the ACHARGE_DETAIL records for this accessorial charge code. The IP Movement Type column shows the type of movement that this ACHARGE_DETAIL applies to.

IP Movement Type can have these values: Advance, Any, Beyond, Crossdock, Linehaul, and Other. When Applies to and IP Movement Type have conflicting values, the accessorial charge will never be applied.

  • If Applies to is None, then the accessorial charge is changed for all IP Movement Type values.

  • If IP Movement Type is Any, then the accessorial charge is changed for all Applies to values.

For example, if Applies to is Delivery, then the IP Movement Type values that do not conflict are Beyond and Any. Other values conflict. Therefore, the accessorial charge will not be applied.

If any ACHARGE_DETAIL records exist, then MOVEMENT_TYPE is verified. If it conflicts with the Applies to value, then you are alerted. If you change Applies to to the Any value, you have two choices:

  • Select Yes to change all MOVEMENT_TYPE values that conflict to Any.

  • Select No to make no changes.

Made labels editable for two tables on the Users Fields section (TM-171148)

In the Custom Defined Fields > User Fields tab, we changed the Table Name menu. We added ORDER_INTERLINER and VENDOR_LOAD_SUMMARY to Table Name.

We added a new setting, Label. The default is the Field Name value. However, if Table Name is ORDER_INTERLINER or VENDOR_LOAD_SUMMARY, you can edit the Label. The ability to edit this is currently limited to those two Table Name values, ORDER_INTERLINER and VENDOR_LOAD_SUMMARY.

We added the columns Label and Sync to the grid.

  • Label shows the value for the Label field.

  • Sync shows True or False to indicate if the UDFs match in the ORDER_INTERLINER and VENDOR_LOAD_SUMMARY tables.

Because the VLS (trip-level carrier assignment) and OI (freight bill-level carrier assignment) tables are closely associated, we added a feature to synchronize (sync) the user-defined fields in these tables.

When you save an edit to any user field for the VLS or OI table, TruckMate checks if you want to update the matching field in the other table.

  • If you select No, then the user-defined field value for Sync saves False in the current table and the matching field in the other table. No other changes are made.

  • If you select Yes, then the user-defined field value in the other table changes to match the new value you entered in this table. Sync saves Trude in both tables.

One exception is if the Read Only value is set in one table.

  • If the other table is VENDOR_LOAD_SUMMARY, Sync is False.

  • If the other table is ORDER_INTERLINER, then Sync is True. In this case, to UDF fields for both tables are changed to match.

On the I/P tab, we added the a User Fields tab. This displays all ORDER_INTERLINER user-defined fields. In the grid, these ORDER_INTERLINER fields are visible but read-only. You can only edit them in this new User Fields tab.

Added more site codes (TM-174247)

You can now add up to 50 site codes in Site Setup.

The Series dropdown list with 50 as the highest value.

Customer Service

Changed a Customer Service Business Event description (TM-138310)

The business event DRIVERPAY - Allow Edit of Driver Pay in CServ(Approval N/A has been renamed to DRIVERPAY - Allow Edit of Driver Payments/Deductions.

Appointment auditing added for freight bill changes from EDI or the TruckMate API (TM-170902)

Previously, TruckMate created status history records in the ODRSTAT table if all the following were true:

  • Any of these dates changed for a freight bill while in Customer Service:

    • Pickup start/end

    • Delivery start/end

    • Pickup appointment required/made

    • Delivery appointment required/made

  • In Security Configuration, under Business Events > Miscellaneous > Customer Service, the Pickup/Delivery Dates and/or Pickup/Delivery Appt field value is Audit.

Now, if the Security Configuration field value for one or both fields is set to Audit Edits No Prompt, ODRSTAT records are created when freight bill dates are changed via EDI or the TruckMate API.

Adding trace numbers to multiple freight bills (TM-171163)

A new Add Trace Number(s) shortcut menu option is available when in filter mode. On the Add Trace Number - Freight Bills (Multiple) window, you can add or update one or more trace numbers for multiple freight bills.

tm 171163 242a

Quick Trace Number Entry window added (TM-171834)

Pressing CTRL+A displays a new Quick Trace Number Entry window in which you can enter trace number data quickly.

tm 171834 242a

Data Purge

Added tables to clear out all expected data (TM-174416)

Nine tables were added to Data Purge: five main tables and four child tables.

The main tables are:

  • BTLORDER

  • DETERMINE_IP_LOG

  • EDI_990_WORK

  • *MOBCOMM_DRIVER_CHAT_BATCH *

  • WCD_GENERIC_RESOURCE_TRIP

The child tables are:

  • PTLORDER_ILT_HIST

  • TLORDER_EXCLUSIVE

  • TLORDER_TERMINAL_LOC_PLAN

  • TLORDER_ZONE_STOP_OVERRIDE

Driver Pay Audit, Driver Pay Contracts

Added semi-monthly pay deduction frequency (TM-170840)

A new Semi-Monthly option has been added to:

  • The Deduction Frequency radio button group in Driver Pay Contracts

    The Deduction Frequency radio button group.

  • The Deduction Frequency field in the Memorized Driver Deduction window in Driver Pay Audit. You access this window by right-clicking in the Deductions tab and selecting Memorize this Deduction.

    Memorized Driver Deduction window with the Deduction Frequency emphasized.

EDI Communication Manager

Specify one transaction set per envelope (TM-163813)

For the KNect outbound map, you can now select the One Tx Set Per Envelope checkbox if you want EDI to generate a single file when multiple invoices go out at the same time.

By default, this checkbox is deselected. EDI generates a file for each invoice.

tm 163813 242a

Export Wizard

Added new fields to the PROBILL output file (TM-174739)

When exporting data to the TCG LTL/Traffic Costing Info format:

The TCG LTL/Traffic Costing Info export type.

There are now three additional fields in the Monthly Shipment File:

The Monthly Shipment File.

These fields are:

  • RATE_ROW_ID 41

  • Pickup Equipment 53V

  • Delivery Equipment 53V

The three new fields in the grid.

Fuel Card Data Import

Added Flying J file format (TM-174468)

A Flying J - CSV file format (format #83, License 33083) has been added to the Fuel Card Import.

A grid with data from a Pilot Flying J CSV.

The fuel purchases can be imported into:

  • Accounts Payable

  • Driver Deductions

  • Fuel Tax modules

The rate precision in this format is six digits. Trimble Transportation recommends you update the TruckMate app config for Accounts Payable to match this format. The app config is APNE.EXE - Exp Rate Field Prec. Change this value from 4 to 6.

Added the ability to import fuel and product purchases from Flying J Excel file (TM-173147)

Flying J Excel files can now be imported. This is available in CardImport.exe as format #82, "Pilot Flying J - Excel", License 33082.

Fuel Card Management

More record logging for TCH LoadCash call (TM-174019)

Extra logging has been added for the TCH LoadCash call. TruckMate records successes, failures, and exceptions in the TCH_FuelVendorCard.log file.

GL Journal Entries

Added Resource Type and Resource ID TM-172537

Two columns have been added to Journal Entry Import:

  • Column I: Resource Type
    Valid values:

    • empty string

    • C – Container

    • D – Driver

    • E – Misc. Equip.

    • F – Freight Bill

    • I – Interliner

    • P – Power Unit

    • R – Trailer

    • T – Trip Number

    • V – Vendor

  • Column J: Resource ID
    Valid values:

    • TruckMate resource ID based on the resource type.

Here is how they look during an import:

The Journal Entry Import window showing imported data.

Here is the result of the import:

Imported data in the Journal Entry window.

Warn when a Foreign Exchange Currency Adjustment Batch already exists for the same year or time period (TM-174927)

If you try to add a GL transaction that has the same fiscal year, period, and currency already in the database as another entry, a warning now appears.

The warning says, "The journal entries in the same year and period already exist. Continue?"

The journal entries warning window.

Select Yes to ignore the warning and add the transaction. Select No to return to the Period End Currency Adjustments window.

Imaging API

Fixed invoice date not being updated in IP Audit Module (TM-174481)

Added remit date to Imaging API so that Synergize can update the invoice date correctly.

Several of the Card Import file formats do not have a unique row identifier (ROWNO). For these cases, TruckMate creates its own unique ROWNO. However, the dropdown list to select a field in the Key Column Definitions did not have this value. This could create a validation error if you attempted to change the definition. Adding ROWNO to the dropdown list resolved this issue.

New configuration added to improve performance (TM-173950)

The IMAGING > Maximum Months To Search for API Application Configurator option lets you determine the maximum number of months within which orders can be selected.

The default value is 3 months. If you increase this value, it may affect performance, specifically for the tlorders and query/imagingtlorders endpoints.

Orders API

Updated handling for when original accessorial is disallowed (TM-172935)

The conditions for allowed client accessorial charge codes have been updated. This applies when the accessorial is:

  • Set as notActive.

  • Set as a vendorCode.

  • Set as customCodeOnly.

  • Set on the client’s substitution list as Disallowed.

For example, the FLATMANUAL accessorial code will not be accepted because the Substitution Code is marked as Disallowed.

An accessorial charge with its Substitution Code set to Disallowed.

New billing resource added to the TruckMate REST API (TM-172301)

A new "billing" resource has been added to the TruckMate Rest API under the orders endpoint. This resource is currently read-only (accessible through the GET method). It provides billing-related information, such as markup charges.

Schema definition:

The schema definition.

Retrieve billing information for orders:

The GET method for order billing information.

New expand option:

The expand option.

Payroll Configuration

Fixed issue with incorrect values for vacation pay codes (TM-173450)

Fixed an issue where the vacation pay was sometimes calculated incorrectly. This could happen if:

  • The Vacation Pay Default app config was set to False.

    The Vacation Pay Default app config.

  • A non-system Vacation Payout code had its Do Not Assess Vacation Pay checkbox either checked or cleared.

    An example of a Vacation Payout code.

If the non-system Vacation Payout code has its Do Not Assess Vacation Pay is set to False, any dollars allocated to that code should be added to the total. The VACATION and VAC-EXP system codes are calculated using that total, including the amount on the non-system vacation code, regardless of the Vacation Pay Default config’s setting.

If the non-system Vacation Payout code has its Do Not Assess Vacation Pay checkbox set to True, any dollars allocated to that code should not be added to the total. The VACATION and VAC-EXP system codes are calculated using that total, not including the amount on the non-system vacation code, regardless of the Vacation Pay Default config’s setting.

This applies to both US and CAN vacation codes.

Project 44 (P44)

New bill of lading type (TM-172726)

All load offers in Project 44 now include a BILL_OF_LADING shipment identifier. It has the same value os the customer reference number (freight bill number).

Rate Maintenance

RateWare density rating (TM-168268)

TruckMate now supports density rating from within RateWare XL.

Two new options, Dim Factor and Dim Factor Units, have been added to the Tariff & CL tab. If a value is in the Dim Factor Units field, it is validated against the rate sheet’s rate unit. If they do not match, an error message appears.

RateWare XL density rating is not supported for vendors.

TMT Integration

Updated TMT integration to remove special event when RO is cancelled (TM-170401)

For the repair status download, the TMT service now checks for any special events linked to repair orders that have been closed or cancelled. If such special events are found, they will be moved to history status before a special event for the new repair status is added.

TruckMate Windows Service Host

TMT message-level authentication support added (TM-174320)

With this version, TruckMate now supports SOAP message-level authentication in the TMT service. This change applies to previous TMT integrations.