--- title: "Revenova TMS Installation Guide" slug: "revenova-tms-installation-guide" tags: ["Admin", "TMS Admin"] updated: 2026-11-02T16:58:36Z published: 2026-11-02T16:58:36Z canonical: "documents.revenova.com/revenova-tms-installation-guide" --- > ## Documentation Index > Fetch the complete documentation index at: https://documents.revenova.com/llms.txt > Use this file to discover all available pages before exploring further. # Revenova TMS Installation Guide ## Initial Summer ‘26 (26.3) TMS Installation Use these instructions only if you’re installing Revenova TMS for the first time. See the Upgrading from a Previous Version section to perform the upgrade from the previous release. Items in **blue** are optional and may be skipped if the feature is not used. 1. From **Setup → Lightning Email Templates**, toggle *Folders and Enhanced Sharing* to **On**. 2. Create a new Permission Set: 1. From **Setup → Permission Sets**, select the **New** button at the top of the Permission Sets list. 2. Label the new Permission Set as **Manage Public Lightning Email Templates and Drag-and-Drop Content Builder**. 3. Select **Save**. 4. Select the link for System Permissions and select the **Edit** button. 5. Search for these two permissions and add them to the Permission Set: - **Manage Public Lightning Email Templates** - **Access drag-and-drop content builder** 6. On the Permission Changes Confirmation modal, select **Save**. 7. Assign the **Manage Public Lightning Email Templates and Drag-and-Drop Content Builder** Permission Set to the logged-in user completing the installation. 3. Obtain the URL and install the package using the **Install for all Users** option. 4. Wait a few minutes for the application to complete the installation process. You will receive an email once the installation is complete. 5. From **Setup** → **Installed Packages**, select the **Manage Licenses** link for the TMS package and assign licenses to users. 6. From **Setup** → **State and Country/Territory Picklists**, turn on **Country/State Picklists**. Start with the **United States** as the only country unless you have more information. 7. From **Setup** → **Data Integration Rules**, activate **Geocodes for Account Shipping Address**. 8. From **Setup → Enhanced Email**, confirm that the Enhanced Email setting is enabled. 9. From **Setup** → **Flows**, set up and activate the packaged **TMS Auto-Reject Carrier Template** as a new flow or use an equivalent method to invalidate unacceptable carriers: 1. Select the **TMS Auto-Reject Carrier Template** flow. 2. In the Flow Builder, select the **Save As New Flow** button. 3. Set the **Flow Label** as “TMS Auto-Reject Carrier” and **API Name** as “TMS_Auto_Reject_Carrier”. 4. Select **Save**, then **Activate**. 10. From **Setup** → **Duplicate Rules**, turn off **Matching Rules** and **Duplicate Rules** for Accounts and Contacts, as they can prevent auto-creation of accounts in the application. 11. From **Setup → Session Settings**, *check* the **Use Lightning Web Security for Lightning web components and Aura components** setting to ensure all components meet Salesforce security standards. If this feature is not enabled, **all** Lightning Web Components may encounter errors during use. Select **Save**. 12. From **Object Manager**, for each object listed, select the **Edit** button. Under the Optional Features section, *check* the box for **Track Field History**. Select **Save**. - Carrier Quote - Carrier Quote Accessorial - Claim - Container - Customer Quote - Customer Quote Accessorial - Customer Quote Tax - Driver - EPayment - Fleet Asset - Line Item - Load - Load Accessorial - Load Reference - Sales Tax - Stop - Transportation Profile 13. (**For Fleet orgs**) Enable Feed Tracking for the following objects. This enables the Chatter feature across Fleet Management. 1. From **Setup** → **Feed Tracking**, select the following objects. 2. *Check* **Enable Feed Tracking**. 3. Select **Save**. - Driver - Fleet Asset - Load - Trip Plan 14. (**For Artimus AI orgs**) Set the Modes that use the Artimus AI feature for creating Load or Truck Posting records. From **TMS Admin → Modes**, *check* the **AI Enabled** field for **all** Modes that use the Artimus AI feature. A default **AI Load Field Version** is generated during Step 15. > [!WARNING] > **Note**: Do **not** *check* this field for Modes that should not be used by the Artimus AI feature. 15. From **TMS Admin** → **Configuration**, select the **Reset Reference Data** button ONCE. Wait for this process to complete. 1. This process deploys the Platform Event subscriber configuration settings for the following events. > [!WARNING] > **Note:** A red error banner displays on TMS Admin → Configuration if any of the configuration settings are not installed. Navigate to **Setup → Configuration** to confirm that the Platform Events are configured correctly. If any Event is not installed, the following error is displayed. > > ![Error message indicating Platform Events are not installed and require the Reset Reference Data job.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Release Update Job - Missing PE Configs - 1.png) 1. EDI Event 2. Fleet Management Event 3. Queued Transaction Event 16. From **TMS Admin → Configuration**, fill out all the fields in the [Global Settings](/v1/docs/global-settings) section with valid values. 17. Create a global Transportation Profile as the [Global Default](/v1/docs/global-default-transportation-profile) and set it in **TMS Admin** → **Configuration**. 18. From **TMS Admin → Equipment Types**, set the four load board equipment types by visiting and filling out all information on each **Equipment Type** record. 19. From **Setup → Chatter Settings**, enable Chatter. 20. From **Setup → Trusted URLs**, add a new trusted URL for ALK Maps:![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image(21).png) 21. Ensure these custom Account fields are displayed for TMS users and are properly secured: - TMS Type - Transportation Profile - DBA Name - Customer Sales Rep - Default Payment Method - Posting City - Posting State/Province - Time zone 22. Make sure the **Transportation Role** field is displayed for TMS users on the Contact page layout. 23. Provide appropriate CRUD (Create, Read, Update, Delete) access to each user profile for each TMS object. 24. Customize page layouts and Lightning Record Pages as appropriate for each profile. Salesforce requires that user email addresses be verified to enhance accountability and security when sending emails. When an org is updated to the Salesforce Spring ’25 release, a reminder email is no longer sent. If you’re encountering issues with users’ ability to send email messages, confirm that the email address is verified. The [Getting Started with Revenova](/v1/docs/getting-started-with-revenova) article contains steps to confirm that an email address is verified. See additional Salesforce information here. Please refer to the Getting Started with Revenova article and the Revenova Document Base for detailed descriptions, configuration settings, and customizations available in the application. ## Upgrading from a Previous Version ### Second Generation Managed Packages Revenova is converting all supported packages from 1GP to Salesforce [Second Generation Package Management](https://developer.salesforce.com/docs/atlas.en-us.pkg2_dev.meta/pkg2_dev/sfdx_dev_dev2gp.htm). All packages must be converted to 2GP before upgrading the TMS package to 2GP. In preparation for this upgrade, install the following conversion packages for any existing installed packages. - TMS Accounting/Accounting Seed bridge Winter 26 package (Version 26.2). - Sage Flat File - Sage API - Dynamics GP Any third party packages that are not 2GP are not supported once the TMS is upgraded to 2GP. Customers with the Accounting Seed package installed should complete the conversion package installation before installing the Summer ‘26 upgrade. ### Release Summer ’26 (26.3) TMS Upgrade Instructions (ETC: 15 minutes) Perform each set of upgrade tasks (EXCEPT for the package installation step, which can be skipped 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 release order for any upgrades that span multiple releases. **Accounting Package Compatibility** Prior to the TMS package installation, confirm there is a compatible accounting package version for the options below: - Sage API (Age 300) - Sage Flat File - Dynamics GP Contact Professional Services with any questions. > [!CAUTION] > No package was created for the **Summer ‘26 TMS Analytics** and **Summer ‘26 PayIQ** packages for the Summer ‘26 TMS release. Continue to use the existing releases for these packages until a future compatible release is provided. > > > > - 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. See the Accounting Seed Bridge installation instructions for more information. 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. See the Accounting Seed Bridge installation instructions for more information. **Items in** **blue** **are optional and may be skipped if the feature is not used. Structural changes in** **red** **are required.** > [!WARNING] > Security enhancements added to the Revenova package likely impact current User setup and should be validated in the sandbox before proceeding with a Production upgrade to prevent business disruption. See the [Final Steps](/v1/docs/revenova-tms-installation-guide-1#final-steps) section below for identifying user permissions. #### SFDC/TMS Pre-Configuration **Install and test in a sandbox environment** BEFORE upgrading to the production environment. You must have installed and completely configured the **Spring ’26 Release** before installing this release. Salesforce requires that user email addresses be verified to enhance accountability and security when sending emails. When an org is updated to the Salesforce Spring ’25 release, a reminder email is no longer sent. If you’re encountering issues with users’ ability to send email messages, confirm that the email address is verified. The [Getting Started with Revenova](/v1/docs/getting-started-with-revenova) article contains steps to confirm that an email address is verified. See additional Salesforce information here. For Accounting Seed customers, do **NOT** install this TMS release until you have obtained the Accounting Seed Bridge package URL as well. **They must be upgraded simultaneously**. 1. From **Setup → Duplicate Rules**, turn off **Matching Rules** and **Duplicate Rules** for Accounts and Contacts, as they can prevent auto-creation of accounts in the application. 2. From **Setup → Data Integration Rules**, activate **Geocodes for Account Shipping Address**. 3. From **Setup → State and Country/Territory Picklists**, turn on **Country/State Picklists**. Start with the **United States** as the only country unless you have more information. These picklists should be enabled unless there is a backward-compatibility issue with other packages or customizations. 4. From **Setup → Session Settings**, *check* the **Use Lightning Web Security for Lightning web components and Aura components** setting to ensure that all components meet Salesforce security standards. Select **Save**. > [!WARNING] > **Note**: Thoroughly test any custom Lightning Web Components when enabling this setting. All TMS components are tested to support this functionality. 5. From the **Object Manager**, make sure no values were added to the Load object’s **Sales Status** or **Load Status** picklist fields or the Stop object’s **Stop Status** picklist field. > [!NOTE] > **Salesforce Note**: To resolve issues when deleting items in the Lightning UI, change to **Classic UI** to perform the deletions. #### Upgrade Installation Steps 1. Obtain the **Summer ’26 installation URL and password** from your Revenova representative. Install the upgrade: 1. Choose *Install for All Users.* 2. Select **Upgrade**. 3. If prompted, *check* the **Yes, grant access to these third-party web sites** box. 4. Select **Continue**. 5. From **Setup → Deployment Status**, select the link to view the progress of the installation. 6. Wait for the **Installation succeeded** email. Verify the following picklist field prior to running the Release Update job step below. - Navigate to **Setup → Object Manager**. - Choose the API Accessorial object and click the *Fields & Relationships* tab. - Select the **API Provider** field. - From the *Values* section, confirm that the WWEX SpeedShip picklist value is entered exactly as entered below - *including capitalization*. - *WWEX SpeedShip* - If the value is different, click the **Edit** link and update the entry to the above value. - Once completed, proceed to the next step. > [!NOTE] > **Upgrade Note**: Several new objects and fields are included in the TMS Summer ’26 release. Set CRUD (Create, Read, Update, Delete) access for the objects and/or fields accordingly. > [!CAUTION] > Warning > > Upgrade installations do not add any objects or fields to **custom** permission sets. Add new fields as necessary to any custom permission sets. New fields are added automatically to Revenova packaged permission sets and do not require additional setup. > > Custom permission sets are commonly used for the following [Experience Cloud](https://help.salesforce.com/s/articleView?id=experience.networks_overview.htm&type=5) Sites: > > - Appointment Request Email Loop > - Carrier Application > - Carrier Email Loop > - Customer Email Loop > - Fleet Email Loop 1. From **TMS Admin → Configuration**, select the **Reset Reference Data** button ONCE and wait for the email indicating completion. This process completes the following tasks: 1. Two functions are completed for the Samsara credential card **Require Arrival In Sequence** field. 1. The value of the field is copied to the new **TMS Admin → Configuration** field, **Require Arrival In Sequence**. 2. The field is removed from the Samsara credential card. 3. **NOTE**: This step is completed to account for users that installed [Spring ‘26 Patch 2](/v1/docs/revenova-tms-patch-information#spring-26-patch-11) for the Samsara functionality. 2. All Accessorial records with an **API Provider** field value of *WWEX SpeedShip* are updated as described below. No new API Accessorial records are created. 1. All API Accessorial records with a **Code** field that matches any of the following codes is updated to the following values (Existing **Code** → New **Code**). 1. AIRDEL or AIRUP → AIRPORT 2. CONDEL or CONPU → CONSTRUCTION 3. LTDDEL or LTDPU → LIMITED_ACCESS 4. RESDEL or RESPU → RESIDENTIAL 5. CNVDEL or CNVPU → TRADESHOW 2. The Accessorial **Location Type** field is *Checked* for each matching API Accessorial **Code**. 3. Completes a migration configuration for the **AR Calculate Balances** field setting on **TMS Admin → Configuration**. 1. *Any customers that enabled this feature from previous patches (*[*Fall ‘25 Patch 5*](https://documents.revenova.com/previous-releases/docs/fall-25-revenova-tms-patch-information#ar-balance-calculation-performance-enhancement1)*,* [*Winter ‘26 Patch 3*](https://documents.revenova.com/previous-releases/docs/winter-26-revenova-tms-patch-information#ar-balance-calculation-performance-enhancement1)*, or Spring ‘26 Patch 1) must complete the Reset Reference Data step of the Upgrade Installation before running the ARCalculatorJob for the first time after upgrading to Summer ‘26.* 2. *This feature was enabled with the TMS Admin → Configuration setting* ***Use Queueables for: AR Calculate Balances****.* > [!WARNING] > **Note**: Any errors encountered while running the Release Update Job are sent to the email address of the User running the job. Errors can also be found in the Apex Jobs view. 1. Complete the following steps for the WWEX Speedship enhancements. Note that the *WWEXSpeedship* value may not be present. If the value is already deleted, continue to the next picklist value. 1. Remove the obsolete picklist values from the following field. 1. Navigate to **Setup → Object Manager**. 2. Choose the API Accessorial object and select the *Fields & Relationships* tab. 3. Select the **API Provider** field. 4. Scroll to the *Values* section. 5. Click the **Del** link for the *WWEXSpeedship* value (**API Name** *WWEXSpeedship*). 6. Confirm the delete. 7. Choose the *Replace value on records with* radio and select *WWEX Speedship* from the picklist. 8. Click **Save**. 9. Click the **Del** link for the *Worldwide Express* value (**API Name** *Worldwide Express*) if it exists. 10. Confirm the delete. 11. Choose the *Replace value on records with blank value* radio. 12. Click **Save**. 2. Revenova recommends deleting any API Accessorial records with an **API Provider** field with no value. #### Optional Brokerage and Fleet Setup Freight Brokerage and Fleet orgs should complete the following optional steps as requested: 1. SMC3 EVA users must complete the following actions. See documentation for configuring functionality for the [SMC3 EVA](/v1/docs/smc3-eva) integration. 1. NOTE: Only complete this step (3a) in the production environment. Resetting the API connection in a sandbox environment incorrectly sends Status Updates and Documents only to the sandbox. Current SMC3 EVA customers must complete the following action to reset the API connection. 1. Navigate to **TMS Admin → Credentials**. 2. Choose the *Global Services* tab. 3. Select the **SMC3 EVA** card. 4. Confirm credentials are included in the fields. Existing users do not need to add any additional information. 5. Click **Save**. 6. Choose the SMC3 EVA card. 7. Confirm the **Callback Endpoint Created** field is *Checked*. 2. Add the following fields to the appropriate Lightning Record Pages (LRP). Navigate to a Vendor Invoice record. 1. Select **Setup → Edit Page**. 2. Drag the following fields onto the LRP. 1. **Discount Percent** 2. **Incoming Net Freight Charge** 3. **Transaction Id** 2. Configure the customer org to use four LWCs ([RateIQ](/v1/docs/rateiq), [Customer Shipment Tracking](/v1/docs/email-loop-setup#customer-shipment-tracking-lwc), [Text to Load](/v1/docs/artimus-ai-lwcs#text-to-load-lwc), and/or [Text to Truck Posting](/v1/docs/artimus-ai-lwcs#text-to-truck-posting-lwc)) in a Gmail or Outlook email inbox. Complete the following steps to access the LWCs. See additional setup and configuration information [here](/v1/docs/email-integration-support). 1. Enable the Gmail integration and/or the Outlook integration in the customer org. 2. [Create and customize an Email Action Pane](https://help.salesforce.com/s/articleView?id=sales.email_int_setup_custom_pane_build.htm&type=5). 1. Assign the Email Action Pane to the appropriate user Profiles or set as the org default. 3. Google email users must install the Salesforce browser extension for [Chrome](https://chromewebstore.google.com/detail/salesforce/jjghhkepijgakdammjldcbnjehfkfmha). 4. Outlook email users must install the [Salesforce extension](https://marketplace.microsoft.com/en-us/product/office/wa104379334?tab=overview). 3. The new Payment Terms feature auto-populates the Carrier Payment Terms fields into newly-created Carrier Quote records when they are populated on the corresponding Carrier Transportation Profile. No existing records are back-populated. 1. Create [Payment Terms](/v1/docs/payment-terms-setup) records as necessary. Select the desired Payment Terms on the appropriate Transportation Profiles. 2. The Payment Terms feature supports the global Transportation Profile for adding Payment Terms to each Carrier Quote. If desired, add The Payment Terms feature to the global Transportation Profile. 1. Navigate to the global Transportation Profile. 2. Select **Setup → Edit Page**. 3. Choose the *Fields* tab. 4. Find the **Carrier Payment Terms** field and drag it onto the page where desired. 5. Click **Save.** **Activate** the page, if necessary. 6. Find the **Carrier Payment Terms** field. 7. Choose the appropriate Payment Terms record. 8. **Save** the global Transportation Profile. 4. Complete the following steps to configure accessorial charges for the [WWEX Speedship](/v1/docs/worldwide-express-speedship) integration. 1. Navigate to **TMS Admin → Accessorials**. 2. Configure accessorial charges to properly send and receive information from WWEX Speedship. 3. See the linked [information](/v1/docs/worldwide-express-speedship#accessorial-flag-mapping) for Accessorial Code, API Accessorial, and Location Type settings. #### Final Steps 1. Revenova has included additional security functionality for many fields in the TMS. 1. See the [Required Field Scanner](/v1/docs/required-field-scanner) LWC to search by user and determine if additional objects and fields are required for customer permission sets. 1. Navigate to **TMS Admin → Required Field Scanner**. 2. Set or adjust User permissions as necessary. 2. The **TMS Baseline Required Fields** permission set contains all impacted field permissions. *It is* ***not*** *recommended to assign this permission set to all users, as it may provide unwanted permissions to fields.* - Fields are added to the permission set with each TMS release. 1. Confirm all required TMS batch jobs are running and/or scheduled. See the [Batch Processes](/v1/docs/batch-processes) article for suggested run times. ### Release Summer ’26 Field/Field Set Modification Summary - TMS > [!NOTE] > **Field Note**: Review fields added by the installation and set CRUD access as needed. | **Object** | **Field/Field Set** | **Action** | **Notes** | | --- | --- | --- | --- | | API Accessorial | API Provider | Modify | Changed *WWEXSpeedship* picklist value to new *WWEX Speedship* value. Removed *Worldwide Express* value. | | API Accessorial | Location Type | Add | Support for WWEX Speedship accessorial charges. | | Vendor Invoice | Discount Percent | Add | Support for SMC3 EVA invoices. | | Vendor Invoice | Incoming Net Freight Charge | Add | Support for SMC3 EVA invoices. | | Vendor Invoice | Transaction id | Add | Support for SMC3 EVA invoices. |