7.7 Installation Guide
Initial TMS Installation
- Use these instructions only if you are a first-time installer of Revenova TMS. Go to the Upgrading from a Previous Version section to perform an upgrade of a previous release.
- Obtain the URL and install the package, using the Install for all Users setting.
- Wait a few minutes for the application to complete the installation process. You will receive an email upon completion of the installation.
- From Setup→Installed Packages click on the Manage Licenses link for the TMS package and assign licenses to users.
- Turn on Country/State Picklists. Start with the United States as the only country unless you have more information.
- From Setup→Data Management→Data Integration Rules activate Geocodes for Account Shipping Address.
- Make sure the Bad Carrier Transportation Profile workflow rule is active or an equivalent method to invalidate unacceptable carriers.
- Turn off Matching Rules and Duplicate Rules for Accounts and Contacts as they can prevent auto-creation of accounts in the application.
- From TMS Admin→Configuration click on the Reset Reference Data button ONCE. Wait for this process to complete.
- From TMS Admin→Configuration fill out all the fields in the top section with valid values.
- Create a global (broker) transportation profile as the global default and set it from TMS Admin→Configuration.
- Set the four load board equipment types by visiting and filling out all information on each Equipment Type record.
- From Setup→Chatter Settings enable Chatter.
- From Setup→CSP Trusted Sites add an entry for ALK Maps:

- Make sure these custom Account fieldsare displayed for TMS users, properly secured: a. TMS Type
- Transportation Profile
- DBA Name
- Customer Sales Rep
- Default Payment Method
- Posting City
- Posting State/Province
- Timezone
- Make sure the Transportation Role field is displayed for TMS users on the Contact page layout.
- Provide appropriate CRUD access to each user profile for each TMS table.
- Tailor page layouts and lightning record pages as appropriate for each profile.
- Please read the Revenova TMS User Guide for a detailed description of other configuration settings and customizations available in the application.
Initial Accounting Seed Installation
- Install the Accounting Seed managed package and follow their configuration instructions.
- Install the TMS-Accounting Seed extension package.
- Add “Transportation” to the Product table ProductFamily field as a picklist choice.
- Make the new TMS Accounting Admin tab visible to the system administrators.
- From the TMS Accounting Admintab:
- Set all the Global Default fields you can and click Save.
- Click the Create Default Products button if you do not have default products available or selected on the right side of the Global Defaults section.
- If the Unlinked Items sections is not empty:
- Click the Create/Match Products for Unlinked Accessorials button to associate products to all your unlinked accessorials.
- Click the Create/Match Products for Unlinked Taxes button to associate products to all your unlinked sales taxes.
- After clicking these two buttons the Unlinked Items section should be empty.
- Provide access to appropriate internal users for the following Visualforce pages/data:
- TMSAccountingAdmin
- Add as a visible tab for appropriate internal user profiles.
- BillingAutoCreation
- Add the Create Billing button to the Customer Quote related list on the Load page layout.
- BillingTaxUpdate
- Add the Calc TMS Tax button to the Billing page layout.
- BillingEDISend
- Add the Send via EDI button to the Billing page layout.
- BillingGenerateAndSend
- Add the Send Invoices button to the Billing tab list view
- BillingBatchPost
- Add the Batch Post button to the Billing tab list view.
- BillingBatchUnpost
- Add the Batch Unpost button to the Billing tab list view.
- PayableAutoCreation
- Add the Create Payable button to the Carrier Quote related list on the Load page layout.
- PaymentProcessorSubmit
- Add the Submit to Payment Processor button to the Payable page layout.
- PaymentProcessorStatus
- Add the Payment Processor Status button to the Payable page layout.
- PaymentProcessorSubmitBulk
- Add the Submit to Payment Processor button to the Payable list views
- PaymentProcessorStatusBulk
- Add the Payment Processor Status button to the Payable list views.
- InvoiceAdjustment
- Add the Adjust button to the Payable page layout.
- PayableBatchPost
- Add the Batch Post button to the Payable tab list view.
- PayableBatchUnpost
- Add the Batch Unpost button to the Payable tab list view.
- EPaymentDetail
- Add the ePayment related list to the Load page layout.
- Add the New button to this related list.
- BatchPostAndPay
- Add the Post and Pay button to the Payable list view.
- TMSAccountingAdmin
- Drag all fields desired onto the Billing page layout.
- Drag all fields desired onto the Payable page layout. The Payment Processor XXX fields relate to the TriumphPay integration.
- From a list view, make sure all Product records have the appropriate Revenue GL Account and Expense GL Account values.
- Add the Unapplied Cash/Credit Memos field to the Shipper/Consignee Transportation Profile page layout right below the Credit Limit field.
- Remove all access and visibility to the Customer Invoice and Vendor Invoicetables:
- Remove related lists from Load page layout.
- CRUD access should be none for these tables for all profiles.
- Hide the Customer Invoice and Vendor Invoice tabs from all profiles.
- See the User Guide for instructions on setting up NACHA file generation.
- NO SECURITY PROFILES SHOULD HAVE DELETE RIGHTS ON THE EPAYMENT TABLE.
TMS Commissions – Installation Instructions
- Before installing the application,
- If the customer is using the Revenova Customer and Vendor Invoice objects then you will need to turn history tracking for the following tables/fields;
- rtms__CustomerInvoice__c.rtms__Invoice_Total__c
- rtms__CarrierInvoice__c.rtms__Accessorial_Charges__c
- rtms__CarrierInvoice__c.rtms__Adjustments__c
- rtms__CarrierInvoice__c.rtms__Line_Haul__c
- rtms__CarrierInvoice__c.rtms__Fuel_Surcharge__c
- If the customer is using Accounting Seed, then turn history tracking on for the following tables/fields;
- AcctSeed__Billing__History.AcctSeed__Status__c
- AcctSeed__Billing_Line__History.AcctSeed__Rate__c
- AcctSeed__Payable__History.AcctSeed__Status__c
- AcctSeed__Payable_Line__History.AcctSeed__Amount__c
- Obtain the current installation URL and password from your Revenova representative.
- Check the option to ‘Install for All Users’
- Check the ‘I acknowledge …’ checkbox
- Click the ‘Install button'

- Once the application is installed, assign licenses TMS Commission license to user who require access to the data.

- Setup the Incentive Payment Configuration
- Go to Setup > Develop > Custom Settings
- Click on the link RTMSIncentivePaymentConfiguration

- Click on the Manage button

- Click on the New button

- Enter the following information

NOTE: If you are installing the app in an org that has Accounting Seed then enter ASAccounting in the Accounting Management field.
- If you’re performing an upgrade, ensure that the Load field set ‘Commission’ has the following selected:

- You’re all set up!
- If the customer is using the Revenova Customer and Vendor Invoice objects then you will need to turn history tracking for the following tables/fields;
Upgrading from a Previous Version
You must perform each set of upgrade tasks (EXCEPT for the package installation step which can skip from any release to the latest) if you are upgrading from a release prior to the previous release.
Follow the upgrade steps from the oldest release to the newest release, in order, for any upgrades that span multiple releases.
Release 7.6 Upgrade Instructions
Release 7.6 TMS Upgrade Instructions (ETC: 90 minutes)
Items in blue can be skipped if the feature is not being used. Structural changes in red should always be done.
- You must install and test in the sandbox before upgrading production.
- You must have installed and completely configured Release 7.5 before installing this release.
- SFDC/TMS Pre-Configuration
- Turn off/review carefully de-duplication rules and Account/Contact validation rules as they may prevent automatic creation of accounts and contacts in various TMS pages.
- From Setup→Data Management→Data Integration Rules activate Geocodes for Account Shipping Address.
- Turn on State and Country Picklists unless there is a backward-compatibility issue with other packages or customizations.
- Make sure the customer has not added any values to the Load table’s Sales Status or Load Status picklist fields or the Stop table’s Stop Status picklist field.
- If you have trouble deleting items in the Lightning UI, change to the Classic UI to perform the deletions.
- Obtain the 7.6 installation URL and password from your Revenova representative.
- Install the upgrade. Wait for the “installation succeeded” email.
- From TMS Admin→Configuration click on the Reset Reference Data button ONCE and wait for the email indicating completion. The process does the following:
- Updates the new Quote Reply To Email Option and Tender Reply To Email Option fields on Document Options to “Default Email”.
- Creates a new “All Risk Insurance” Accessorial record.
- Back-populates the new Insurance Policy Status field based on the obsolete Cargo Insurance Offered and Cargo Insurance Authorized fields. NOTE – determine if the customer has any customizations built around those obsolete fields, and if so, work with them to transition to the new field.
- Initializes the new Customer Invoice PDF Pricing Options field on the Document Options records to “Show Accessorial Notes” (existing behavior).
- Deletes the obsolete PostEverywhere credentials record and adds the LoadBoard Network credentials record.
- Adds the Twilio credentials record.
- Delete the Cargo Insurance Offered and Cargo Insurance Authorized fields from the Load table.
- EDI Enhancements
- From TMS Admin→Credentials disable the credentials for the Custom EDI global service if you are not using it.
- The added EDI elements for this release may require minor coding changes to the Cleo implementations. Review the changes in the What’s New guide with the Persimmon Group dev team and test in the sandbox before migrating to production.
- From TMS Admin→Configuration populate the EDI Freight Charges Code and EDI Fuel Surcharge Code fields if you want to pass a charge code in EDI 210 customer invoice transactions.
- Add the Customer Charge Code field to the Accessorial layout and populate it for each record if you want to pass charge codes in EDI 210 customer invoice transactions.
- If you want to capture and communicate Loading/Unloading events in outbound EDI 214 load status transactions, add the Loading/Unloading Complete Date and Loading/Unloading Complete Time fields to the Stop layout and appropriate LWC widget field sets.
- If you are using a custom EDI implementation, enter your URLs and credentials for the Custom EDI global service from TMS Admin→Credentials. You must implement the web service calls exactly as defined in the EDI specification.
- Note that the Custom EDI connector also supports Basic Authentication.
- Add “Custom EDI” as a picklist choice for the following fields:
- Carrier Service: EDI Provider
- EDI Location: EDI Provider 210 Override
- EDI Location: EDI Provider 214 Override
- EDI Location: EDI Provider 990 Override
- EDI Transaction: EDI Provider
- Load: EDI Provider
- Customer and Vendor Invoice Accessorial Enhancement
- Three new fields are added to each table: Quantity, Unit and Unit Price. Grant CRUD access to these three fields in each table to the appropriate profiles.
- New Document Options setting: Customer Invoice PDF Pricing Options. This picklist value is defaulted to “Show Accessorial Notes”. Grant CRUD access to this field.
- When customer and vendor invoices are created, the Customer Invoice Accessorial and Vendor Invoice Accessorial records will store the Quantity, Unit and Unit Price as they exist in the Customer Quote Accessorial and Carrier Quote Accessorial records.
- The Customer Invoice PDF document has been updated to include these new fields. If a customer has a custom Customer Invoice document then consult with the customer to see if they want the document updated.
- EDI 210 SendLoadInvoices operation has been updated to include the Unit Price field in an element called . The element, which used to be defaulted to a “1”, and the element, which used to be defaulted to “Flat Rate”, will now use the values from the Customer Invoice Accessorial record.
- Container Tracking
- Two new tables – Container and Container Console Configuration – support container tracking. Provide CRUD access to these tables as appropriate, and add the Container Console tab access as appropriate.
- Add the Containers related list to the Load page with a mode-based visibility filter.
- Add to the page layout and check the Show Containers on Load Creation checkbox for each Mode record that requires container data entry during load creation.
- Populate the following Container Field Setsas appropriate:
- TMS1 – Default Container fields entered during load creation
- TMS2 – Default Container fields that appear on documents
- You can create mode-specific versions of these field sets. Name them by concatenating the mode name to the field set name. For example, “TMS1_Truckload”.
- The Load Map component will include a “Show Containers” icon button and breadcrumb map when a load has containers associated with it.
- From TMS Admin→Credentials enter credentials for the Project44 Tracking API (Unified Tracking API).
- Note that the webhook URL for Unified Tracking is automatically provided in the code. You will need to inform P44 of the webhook as they have to do provisioning on their side also.
- Container date, time, location, and status updates are provided via the API “push” mechanism.
- Add “Seaport Terminal” as a picklist choice for the Account table TMS Type field (after “Seaport”).
- Add “Domestic” as a picklist choice for the Load table Import/Export field.
- Add the following Asian time zones to the Timezones picklist value set:
Asia/BaghdadAsia/Baku
Asia/Bangkok
Asia/Brunei
Asia/Colombo
Asia/Damascus
Asia/Dubai
Asia/Gaza
Asia/Ho_Chi_Minh
Asia/Hong_Kong
Asia/Jakarta
Asia/Jerusalem
Asia/Kolkata
Asia/Kuala_Lumpur
Asia/Macau
Asia/Qatar
Asia/Riyadh
Asia/Seoul
Asia/Shanghai
Asia/Singapore
Asia/Taipei
Asia/Tokyo
- Make sure any other time zones you need for seaports are added to this picklist value set, using the IANA values.
- Set up all port facilities you will be using as accounts of TMS Type Seaport. Make sure to enter the Timezone and UN Location Code for all ports.
- Note that the following PDF documents now support an optional Containers section:
- Customer Rate and Load Confirmation
- Carrier RFQ
- Carrier Rate and Load Confirmation
- Driver Load Confirmation
- To start tracking a container:
- A valid Container Number or Booking Number, and SCAC must be provided.
- Change the Tracking field to On and save the record.
- The Queued Transaction Job will initiate the tracking session with Project44.
- The Container Tracking Provider and Tracking Number fields will be populated if the tracking session is properly initiated.
- Container status updates arrive via the “push” API mechanism.
- Note that container tracking is independent of load tracking. For example, you may track (via Project44) the container from Port of Hong Kong to Port of Long Beach, and then track the (dray) load from Port of Long beach to the Consignee using Macropoint.
- Change the Tracking field to Off to terminate tracking on a container.
- Carrier Application
- Three new fields have been added to the Document Options table:
- Carrier Application Email Template: there is an out of the box email template called “Carrier Application” in the TMS folder that contains the Revenova logo. Create a custom HTML email template for the client with their logo and verbiage, and configure here.
- Carrier Application Paym. Method Options: talk to the customer to see what options they want to see in the “Payment Method” field of the “Payment Information” section in the carrier application, and set accordingly.
- Carrier Application Reply To Email: talk to the customer to see what email to use for the carriers to reply to after they receive the carrier application.
- Grant read access to the “Carrier Application Paym. Method Options” field in the permission set or profile used for the carrier application.
- Three new fields have been added to the Document Options table:
- A Dispatch button is now available on the Freight Quote Assistant for Fleet loads.
- Falvey Shippers Insurance
- From the Lightning Record Page editor for the Load object, un-check the “Show Insurance Quote” checkbox on the Freight Quote Assistant LWC properties if you are not using Falvey Shippers Insurance. By default it is ON. Note that you must be using the Falvey API in order to use this new feature with v7.6.
- Update the Falvey Service URL and Test Service URL under the TMS Admin → Credentials page to be as follows:
- Service URL: https://ShipAssured.FalveyShippers.com
- Test Service URL: https://Sandbox.FalveyShippers.com
- Note that you may need to update the Remote Site Settings in the Salesforce Setup menu for these two remote sites as well
- Should you choose, you can add an optional “Insurance Program Name” to name-brand the Insurance Quote Section (e.g. those using Falvey may have a Policy Name established that they would like their users to offer)
- Add a new “Insurance” section to the Load record deta il page layout and add the “Insurance Policy Status”, “Insurance Policy Status as of”, “Insurance Certificate Number”, “Insurance Provider”, “Insurance Premium Amount”, “Insurance Shipment Id”, and “Insurance Premium Application” fields.
- From TMS Admin→Configuration, update the “Cargo Insurance Excluded Commodities” field to read as follows:
- Please contact the insurance provider to obtain a list of excluded commodities. Note that if an excluded commodity is included in the Item Description of your line item, the insurance request will be rejected and no certificate will be issued.
- Add the Tender Sent By field to Carrier Quote page layouts.
- Remove the Tender button from Carrier Quote page layouts.
- Customer Invoice Banner
- Add the Customer Invoice Banner component to Customer Invoice lightning page layouts.
- Remove the following buttons from Customer Invoice page layouts:
- Apply Terms
- Update Taxes
- Generate
- Generate and Send
- Send via EDI
- From Setup→Platform Cache allocate all unused cache to the “tms” org-level platform cache partition.
- Add the Effective Date field to the Tariff Schedule page layout and populate as needed.
- LoadBoard Network
- Add “LoadBoard Network” as a picklist choice for the Load Posting table Load Board field. (No space between “Load” and “Board”.)
- Deactivate “PostEverywhere” as a picklist choice.
- Enter your credentials for the LoadBoard Network, or disable the credentials if you are not using this API.
- Twilio API-to-Email Service
- From TMS Admin→Credentials disable the Twilio credentials if you are not using this API. Otherwise enter the User ID and Password1.
- User ID is the single verified sender email address from Twilio if you are using this option. If you have performed the Domain Authentication setup, enter “Revenova” for the User ID.
- Password1 is the API Key generated on the Twilio portal.
- RMIS - Important update for clients using the “CARB-TRU Compliant (California)” (available in TMS 7.6.8 and above):
Note: if the client was on TMS 7.5.13 or higher at the time of the 7.6 upgrade then the following steps are not necessary.RMIS does NOT provide CARB-TRU certification information. Instead, they provide CARB-Truck certification information.
Contact RMIS to ensure you are receiving this information in your packet. When the response from RMIS includes this section, the TMS will add or remove the new “CARB-Truck Compliant (California)” picklist option to/from the Other Carrier Capabilities field based on the business rules specified by RMIS.
The “CARB-TRU Compliant (California)” picklist option will NOT be added or removed from the Other Carrier Capabilities field in the TMS as it used to in previous versions.
Instructions when applying this patch:
- Add the new “CARB-Truck Compliant (California)” picklist option to the Other Carrier Capabilities field on the Transportation Profile and Load tables.
- Optional - based on the client’s approach to the “CARB-TRU Compliant (California)” field: deploy and test a custom batch job provided by Revenova that will change all carriers and loads that have the “CARB-TRU Compliant (California)” to “CARB-Truck Compliant (California)”. The batch job can be customized based on the client’s requirements.
- Make any other custom changes related to the “CARB-TRU Compliant (California)” and/or “CARB-Truck Compliant (California)” picklist value(s) (e.g. triggers, flows, validation rules, etc.).
- Apply the patch in the sandbox.
- Test.
Upon signoff, migrate all the changes from the sandbox to the production org, run the custom batch job (if needed) and apply the patch.
- Run all RTMS namespace unit tests to completion and investigate any failures.
- Make sure all relevant TMS batch jobs are running and/or scheduled. See User Guide for suggested run times.
Release 7.6 Field/Field Set Modification Summary – TMS
| Table | Field/Field Set | Action | Populated | Notes |
|---|---|---|---|---|
| Account | TMS Type | Modify | Manual | Add "Seaport Terminal" picklist choice |
Accessorial | Customer Charge Code | Add | Manual | EDI 210 Support |
Carrier Service | EDI Provider | Modify | Manual | Add “Custom EDI” picklist choice |
Container | New Table | Add | Manual/Auto | Container Tracking Support |
Container | TMS1 Field Set | Add | Manual | Container Tracking Support |
Container | TMS2 Field Set | Add | Manual | Container Tracking Support |
Container Console Configuration | New Table | Add | Manual | Container Tracking Support |
Document Options | Carrier Application Email Template | Add | Manual | Carrier Application enhancement |
Document Options | Carrier Application Paym Method Choices | Add | Manual | Carrier Application enhancement |
Document Options | Carrier Application Reply To Email | Add | Manual | Carrier Application enhancement |
Document Options | Customer Invoice PDF Pricing Options | Add | Manual | Customer Invoice enhancement |
Document Options | Quote Reply To Email Option | Add | Manual/Auto | Outbound Email Support |
Document Options | Tender Reply To Email Option | Add | Manual/Auto | Outbound Email Support |
EDI Location | EDI Provider 210 Override | Modify | Manual | Add “Custom EDI” picklist choice |
Carrier Quote | Tender Sent By | Add | Auto | Email Tender Support |
Carrier Quote Accessorial | Quote/Contract Id | Add | Auto | Falvey Insurance Support |
Customer Invoice Accessorial | Quantity | Add | Auto | Populated from Customer Quote Accessorial |
Customer Invoice Accessorial | Unit | Add | Auto | Populated from Customer Quote Accessorial |
Customer Invoice Accessorial | Unit Price | Add | Auto | Populated from Customer Quote Accessorial |
Customer Quote Accessorial | Quote/Contract Id | Add | Auto | Falvey Insurance Support |
EDI Location | EDI Provider 214 Override | Modify | Manual | Add “Custom EDI” picklist choice |
EDI Location | EDI Provider 990 Override | Modify | Manual | Add “Custom EDI” picklist choice |
EDI Transaction | EDI Provider | Modify | Manual | Add “Custom EDI” picklist choice |
Load | EDI Provider | Modify | Manual | Add “Custom EDI” picklist choice |
Load | Insurance Certificate Number | Add | Auto | Falvey Insurance support |
Load | Insurance Policy Status | Add | Auto | Falvey Insurance support |
Load | Insurance Policy Status as of | Add | Auto | Falvey Insurance support |
Load | Insurance Premium Amount | Add | Auto | Falvey Insurance support |
Load | Insurance Premium Application | Add | Add | Falvey Insurance support |
Load | Insurance Provider | Add | Auto | Falvey Insurance support |
Load | Insurance Shipment Id | Add | Auto | Falvey Insurance support |
Load | Cargo Insurance Offered | Delete | Manual | Cargo Insurance Support |
Load | Cargo Insurance Authorized | Delete | Manual | Cargo Insurance Support |
Load | Other Carrier Capabilities | Modify | Manual | Add “CARB-Truck Compliant (California)” picklist option (if not done in 7.5.13) |
Load Posting | Load Board | Modify | Auto | Add “LoadBoard Network”, deactivate “PostEverywhere” |
Mode | Show Containers on Load Creation | Add | Manual | Container Tracking Support |
Stop | Loading/Unloading Complete Date | Add | Manual/Auto | EDI 214 Support |
Stop | Loading/Unloading Complete Time | Add | Manual/Auto | EDI 214 Support |
Tariff Schedule | Effective Date | Add | Manual | SMC3 Quoting Support |
Vendor Invoice Accessorial | Quantity | Add | Auto | Populated from Carrier Quote Accessorial |
Vendor Invoice Accessorial | Unit | Add | Auto | Populated from Carrier Quote Accessorial |
Vendor Invoice Accessorial | Unit Price | Add | Auto | Populated from Carrier Quote Accessorial |
Transportation Profile | Other Carrier Capabilities | Modify | Manual | Add “CARB-Truck Compliant (California)” picklist option (if not done in 7.5.13) |
TMS Configuration | EDI Freight Charges Code | Add | Manual | EDI 210 Support |
TMS Configuration | EDI Fuel Surcharge Code | Add | Manual | EDI 210 Support |
Release 7.6 Accounting Seed Integration Upgrade Instructions (ETC: 15 Minutes)
Items in blue can be skipped if the feature is not being used. Important structural changes in red should always be done.
- You must install and test in the sandbox before upgrading production.
- You must have installed Release 7.5 before installing this release.
- Obtain the 7.6 installation URL and password from your Revenova representative.
- Install the upgrade. Wait for the “installation succeeded” email.
- Add the new Stop and Unit field to the Billing Line layout. Note that stop number and unit are now passed in EDI 210 transactions for accessorials.
- Add the new Unit field to the Payable Line layout.
- Run all RTMS2 namespace unit tests to completion and investigate any failures.
Release 7.6 Field/Field Set Modification Summary – Accounting Seed Integration
| Table | Field/Field Set | Action | Populated | Notes |
|---|---|---|---|---|
Billing Line | Stop | Add | Auto | EDI 210 Support |
Billing Line | Unit | Picklist | Auto | Costing unit of measure |
Payable Line | Unit | Picklist | Auto | Costing unit of measure |
Release 7.7 Upgrade Instructions
Release 7.7 TMS Upgrade Instructions (ETC: 60 minutes)
Accounting Package Compatibility
Prior to TMS package installation, confirm there is a compatible accounting package version for the options below.
Sage API (Sage 300)
Sage Flat File
Dynamics GP
Contact Professional Services with any questions.
Items in blue can be skipped if the feature is not being used. Structural changes in red should always be done.
- You must install and test in the sandbox before upgrading production.
- You must have installed and completely configured Release 7.6 before installing this release.
- SFDC/TMS Pre-Configuration
- Turn off/review carefully de-duplication rules and Account/Contact validation rules as they may prevent automatic creation of accounts and contacts in various TMS pages.
- From Setup→Data Management→Data Integration Rules activate Geocodes for Account Shipping Address.
- Turn on State and Country Picklists unless there is a backward-compatibility issue with other packages or customizations.
- Make sure the customer has not added any values to the Load table’s Sales Status or Load Status picklist fields or the Stop table’s Stop Status picklist field.
- If you have trouble deleting items in the Lightning UI, change to the Classic UI to perform the deletions.
- Obtain the 7.7 installation URL and password from your Revenova representative.
- Install the upgrade. Wait for the “installation succeeded” email.
- From TMS Admin→Configuration click on the Reset Reference Data button ONCE and wait for the email indicating completion. The process does the following:
- Updates the Kleinschmidt and Trucker Tools Service URLs.
- Populates the new MCP Mode field on the Mode table.
- Populates the new Category and Tariff fields on all Rate Entries.
- Delete the following obsolete Visualforce pages:
- APICredentialsList.page
- BrokerLoadStatus.page
- CustomerQuoteAndTender.page
- FreightPlan2.page
- FreightPlanTemplateSelection.page
- FuelSurcharge.page
- LoadHeader.page
- LoadLockStatus.page
- LoadPosting.page
- OceanSchedules.page
- RateIQ.page
- VGMSubmission.page
- From Subscriber mode, delete the following obsolete TMS Configuration custom setting fields:
- Auto_Offer_Carrier_Count__c
- Auto_Offer_Delivering_Radius__c
- Auto_Offer_Posting_Age__c
- Auto_Offer_Posting_Radius_Origin__c
- Auto_Offer_Radius_Units__c
- Auto_Tender_Book_It_Responses__c
- Carrier_Invoice_Upload__c
- Carrier_Monitor_Last_Run_Date__c
- EDI_Status_Update_Last_Run_Date__c
- Enable_Leg_Based_Quoting__c
- Enable_Tender_and_Assign__c
- Ocean_API_Enabled__c
- RMIS_Carrier_Remit_To_Sync__c
- Show_Linear_Feet_on_Freight_Planner__c
- Show_Volume_on_Freight_Planner__c
- Wait_Time_Between_Auto_Offer_Post_Min__c
- Attachment to Files Conversion
- This release manages Attachments and Files interchangeably. All new documents are created as Files.
- Replace the File Upload component with the File Viewer component on the Load detail page. Note that this new component can be added to any record detail page.
- From TMS Admin→Configuration set the Access Historical Attachments checkbox to checked for all customers that were on a previous release. New (7.7 and above) customers should leave this unchecked.
- For the Email Loop and Customer/Carrier Portal communities make sure this Administration→Preferences setting is checked to support viewing files: Let guest users view asset files and CMS content available to the site.
- If you use Revenova for customer invoice presentment, go to the invoice detail page and generate an invoice. If it downloads instead of displaying in the browser go to Setup→File Upload and Download Security and set the PDF file type to Execute in Browser.
- Mode-Specific Customer Invoice Documents
- From TMS Admin→Customer Invoice Documents create mode-specific entries, as needed.
- Drag the Load Map LWC component onto the customer portal load detail page if desired.
- Add Cleo as a picklist choice for the Carrier Service table EDI Provider field and update the dependent picklist controlling field matrix.
- From TMS Admin→Credentials→Cleo set the Carrier Tender checkbox appropriately. Note that the base Cleo implementation (on their side) does NOT support this feature and needs to be added/coded by them.
- Stored Rate Enhancements
- Note the 50+ new fields on the Rate Entry table due to the migration of the Tariff Schedule fields and additional fields to support LTL Rate Entries.
- Add the following new fields to the Carrier Exclusion page layout:
- Carrier Service
- Lane
- Effective Date iv. Expiration Date
- Set the new Lane Match Option field on Rate Entries, as needed.
- Set the new Fleet Loads Only field on Rate Entries, as needed.
- Add the new Credit Limit Calculation Error field to the Transportation Profile “Shipper/Consignee” page layout.
- From TMS Admin→Configuration check the Use Platform Events field if you need to improve the performance of the Queued Transaction Job. Talk to Revenova before doing this.
- If planning to use the AR Calculation override functionality, populate the name of the override Apex Class in the ‘Override AR Calculator Class’ field from TMS Admin→Configuration.
- NOTE** -if used, the overriding class must be reviewed by a Revenova technical representative to ensure proper functionality. This AR calculation is performed in multiple places at multiple times throughout the application, and it is imperative that a code review is completed by a Revenova technical representative to prevent issues.
- SMC3 LTL Tariff-Based Customer Quoting
- If planning to use the SMC3 LTL API integration for Customer pricing, create the appropriate “API” Type Customer Rate Entries with Lanes and Tariff Schedules (see User Guide for more details on setting up Lanes, Rate Entries and Tariff Schedules).
- Add the following new fields to the Customer Quote page layout in a Field Section that is conditionally rendered only when the Record > Rate Entry > Type Equals API. Grant appropriate field-level security to these fields.
- Deficit Charge
- Deficit Rate
- Deficit Weight
- Discount
- Discount Percent
- Freight Charge Applied
- Freight Surcharge
- Freight Surcharge Application
- Freight Surcharge Percentage
- Minimum Freight Charge Floor

- Review the new Lightning Record Pages for Rate Entry and Lane and update as needed.
- Check the properties of the LaneIQ LWC on the Rate Entry Lightning Record Page and make sure that the setting for the Truck-Load Match Section is set to blank/null:

- Verify the Rate Calculation Rule table Data Source field is set up like this:

- Verify the Rate Calculation Rule table Equipment Category controlling field is set up like this:

- Add “Contracted” as a picklist value and verify the Rate Calculation Rule table Paid/Posted controlling field is set up like this:

- Add “N/A” as a picklist choice and verify the Rate Calculation Rule table Lookback Days controlling field is set up like this:

- Verify the Rate Calculation Rule table Search Radius controlling field is set up like this:

- FreightWaves RateIQ Support
- From TMS Admin→RateIQ Calculations add FreightWaves as a data source if desired.
- Enable the FreightWaves Remote Site Setting.
- Enter your FreightWaves credentials or disable them if not used.
- MyCarrierPackets integration
- Update the Carrier page layout on the Transportation Profile to include the following MCP fields:
- Authority Risk Points
- Insurance Risk Points
- Operation Risk Points
- Overall Risk Points
- Safety Risk Points
- D&B DUNS Number
- Add “Tanker Endorsed” as a new picklist choice to the Other Carrier Capabilities field on the Transportation Profile and Load tables. Enable this new picklist option for the Carrier record types of the Transportation Profile object.
- Add “Unacceptable Review” and “Unacceptable Fail” as new picklist choices to the following Transportation Profile fields:
- Authority Risk
- Insurance Risk
- Operation Risk
- Overall Risk
- Safety Risk
Enable these two new picklist options for the Carrier record types of the Transportation Profile object.
- Verify that the “MCP Mode” field on the Mode table has been populated for 6 of the packaged modes: Air Freight, Drayage, Intermodal, LTL, Ocean FCL and Truckload as follows:

- Populate (or disable) the global Credentials for MyCarrierPackets. Note that the TMS will work with only one of the following integrations: RMIS, Saferwatch OR MyCarrierPackets (in that order based on the Enabled flag for each set of credentials).
- Update the Carrier page layout on the Transportation Profile to include the following MCP fields:
- Set the Rating Source field on any customer Transportation Profiles that should not “cascade” to the global TP when accessing stored rates.
- Confirm the new Kleinschmidt URL in the Credentials record:
- Confirm the Kleinschmidt Remote Site Setting:
- Confirm the new Trucker Tools URL in the Credentials record:
- Confirm the Trucker Tools Remote Site Setting:
- https://api.truckertools.com
- Trucker Tools Load Board / Capacity Search
- Enter your Trucker Tools credentials or disable them if not used.
- Add “Trucker Tools Load Board” as a picklist choice for the following fields:
- Carrier Quote table: Book It Source
- Load Posting table: Load Board
- Transportation Profile table: Allow Booking from Load Postings and Upload Complete
- Truck Posting table: Source
- If using Trucker Tools Capacity search, in network carriers will need to be added to the Trucker Tools portal using a CSV file to see their capacity. See the user guide for more details.
- If using the Trucker Tools Book It Now feature:
- Add the Allow Booking from Load Postings field to the carrier and shipper/consignee transportation profile page layouts.
- Add the Upload Complete field to the carrier transportation profile page layout as desired (read only).
- Add the Allow Booking field to the load posting page layout.
- Add the Book It Source field to the carrier quote page layout.
- Make sure that the Customer Invoice Banner LWC is on the Customer Invoice record page. The following custom detail buttons are obsolete and should not be used:
- Apply Terms
- Generate
- Generate & Email
- Send Via EDI
- Update Taxes
- Run all RTMS namespace unit tests to completion and investigate any failures.
- Make sure all relevant TMS batch jobs are running and/or scheduled. See User Guide for suggested run times.
Release 7.7 Field/Field Set Modification Summary – TMS
| Table | Field/Field Set | Action | Populated | Notes |
|---|---|---|---|---|
Carrier Exclusion | Carrier | Add | Manual | Stored Rate Support |
Carrier Exclusion | Lane | Add | Manual | Stored Rate Support |
Carrier Exclusion | Effective Date | Add | Manual | Stored Rate Support |
Carrier Exclusion | Expiration Date | Add | Manual | Stored Rate Support |
Carrier Quote | Book It Source | Modify | Auto | Added “Trucker Tools Load Board” |
Carrier Service | EDI Provider | Modify | Manual | Added “Cleo” |
Customer Invoice Document | Modes | Add | Manual | Mode-specific invoice documents |
Customer Quote | Deficit Charge | Add | Auto | SMC3 LTL Customer Rating Support |
Customer Quote | Deficit Rate | Add | Auto | SMC3 LTL Customer Rating Support |
Customer Quote | Deficit Weight | Add | Auto | SMC3 LTL Customer Rating Support |
Customer Quote | Discount | Add | Auto | SMC3 LTL Customer Rating Support |
Customer Quote | Discount Percent | Add | Auto | SMC3 LTL Customer Rating Support |
Customer Quote | Freight Charge Applied | Add | Auto | SMC3 LTL Customer Rating Support |
| Customer Quote | Freight Surcharge | Add | Auto | SMC3 LTL Customer Rating Support |
| Customer Quote | Freight Surcharge Application | Add | Auto | SMC3 LTL Customer Rating Support |
| Customer Quote | Freight Surcharge Percentage | Add | Auto | SMC3 LTL Customer Rating Support |
| Customer Quote | Minimum Freight Charge Floor | Add | Auto | SMC3 LTL Customer Rating Support |
| Equipment Type | Trucker Tools Posting | Add | Auto | Trucker Tools Load Board Support |
| Fleet Assignment | ELD Route Stop IDs | Add | Auto | Fleet Management Support |
| Load | Other Carrier Capabilities | Modify | Auto | Add “Tanker Endorsed” to picklist |
| Load Posting | Load Board | Modify | Auto | Added “Trucker Tools Load Board” |
| Mode | MCP Mode | Add | Auto | MyCarrierPackets integration |
| Queued Transaction | Fingerprint | Add | Auto | QT Job Performance Improvement |
Queued Transaction Event | New Platform Event (Table) | Add | Auto | QT Job performance Improvement |
| Rate Entry | Apply Discounts To | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Apply Surcharge To | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Category | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Fleet Loads Only | Add | Manual | Fleet Management Support |
| Rate Entry | Lane Match Option | Add | Manual | LTL Stored Rate Support |
| Rate Entry | LTL Surcharge | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Maximum Alternation Weight | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Minimum Charge Discount | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Minimum Charge Floor | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 100 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 110 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 125 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 150 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 175 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 200 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 250 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 300 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 400 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 50 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 500 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 55 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 60 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 65 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 70 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 77.5 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 85 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | NMFC Class 92.5 = | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Rate Adjustment Factor | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Tariff Description | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Tariff Effective Date | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Tariff Name | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | TL Surcharge | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 1 | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 1 Discount | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 2 | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 2 Discount | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 3 | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 3 Discount | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 4 | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 4 Discount | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 5 | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 5 Discount | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 6 | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 6 Discount | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 7 | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 7 Discount | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 8 | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 8 Discount | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 9 | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 9 Discount | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 10 | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 10 Discount | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 10 | Add | Manual | SMC3 LTL Rating Support |
| Rate Entry | Weight Break 11 Discount | Add | Manual | SMC3 LTL Rating Support |
| TMS Configuration | Access Historical Attachments | Add | Manual | Files/Attachments Support |
| TMS Configuration | Carrier Monitor Last Run | Add | Manual | RMIS and MyCarrierPackets |
| TMS Configuration | Carrier Monitor Last Run Date | Delete | Manual | RMIS |
| TMS Configuration | Carrier Remit To Sync | Add | Manual | RMIS and MyCarrierPackets |
| TMS Configuration | Fleet Management Pass Counter | Add | Manual | Fleet Management Debugging |
| TMS Configuration | Override AR Calculator Class | Add | Manual | AR Calculation Override Support |
| TMS Configuration | RMIS Carrier Remit To Sync | Delete | Manual | RMIS |
| TMS Configuration | Use Platform Events | Add | Manual | QT Job performance Improvement |
| Transportation Profile | Allow Booking from Load Postings | Modify | Auto | Added “Trucker Tools Load Board” |
| Transportation Profile | Authority Risk | Modify | Auto | Add “Unacceptable Review” and “Unacceptable Fail” to picklist |
| Transportation Profile | Authority Risk Points | Add | Auto | MyCarrierPackets integration |
| Transportation Profile | Credit Limit Calculation Error | Add | Auto | AR Calculation Error Handling |
| Transportation Profile | D&B DUNS Number | Add | Auto | MyCarrierPackets integration |
| Transportation Profile | Insurance Risk | Modify | Auto | Add “Unacceptable Review” and “Unacceptable Fail” to picklist |
| Transportation Profile | Insurance Risk Points | Add | Auto | MyCarrierPackets integration |
| Transportation Profile | Operation Risk | Modify | Auto | Add “Unacceptable Review” and “Unacceptable Fail” to picklist |
| Transportation Profile | Operation Risk Points | Add | Auto | MyCarrierPackets integration |
| Transportation Profile | Other Carrier Capabilities | Modify | Auto | Add “Tanker Endorsed” to picklist |
| Transportation Profile | Overall Risk | Modify | Auto | Add “Unacceptable Review” and “Unacceptable Fail” to picklist |
| Transportation Profile | Overall Risk Points | Add | Auto | MyCarrierPackets integration |
| Transportation Profile | Safety Risk | Modify | Auto | Add “Unacceptable Review” and “Unacceptable Fail” to picklist |
| Transportation Profile | Safety Risk Points | Add | Auto | MyCarrierPackets integration |
| Transportation Profile | Rating Source | Add | Manual | Rate Entry support |
| Transportation Profile | Upload Complete | Modify | Auto | Added “Trucker Tools Load Board” |
| Truck Posting | Source | Modify | Auto | Added “Trucker Tools Load Board” |
Release 7.7 Accounting Seed Integration Upgrade Instructions (ETC: 10-60 Minutes)
Accounting Seed customers must have BOTH the TMS and Accounting Seed Bridge packages before upgrading. Complete the TMS Upgrade installation before installing the Accounting Seed Bridge package.
Items in blue can be skipped if the feature is not being used. Structural changes in red should always be done.
- You must install and test in the sandbox before upgrading production.
- You must have installed Release 7.6 before installing this release.
- Obtain the 7.7 installation URL and password from your Revenova representative.
- Install the upgrade. Wait for the “installation succeeded” email.
- Add the new Stop field to the Billing Line layout. Note that stop number is now passed in EDI 210 transactions for accessorials.
- You may need to recode any custom invoice documents and replace this global Accounting class method:
getCustomerInvoiceDocumentsForLoads() with this method:
getCustomerInvoiceFilesForLoads() - NACHA enhancement: new preference field called “Bypass Carrier Remit To Mismatch” option in the TMS Accounting Admin page that allows the creation of a NACHA file when the Carrier Remit To on the Transportation Profile record of the carrier is different from the Alternate Payee on the Payable and associated Cash Disbursement. Default is false (no impact to existing clients). Set this preference to true for clients that want this option.
- Run all RTMS2 namespace unit tests to completion and investigate any failures.
Release 7.7 Field/Field Set Modification Summary – Accounting Seed Integration
| Table | Field/Field Set | Action | Populated | Notes |
|---|---|---|---|---|
Billing Line | Stop | Add | Auto | EDI 210 support |