--- title: "Revenova TMS 7.10 Installation Guide" slug: "revenova-tms-710-installation-guide" tags: ["7.10", "Admin", "End User"] updated: 2024-08-22T21:21:24Z published: 2024-08-22T21:21:24Z canonical: "documents.revenova.com/revenova-tms-710-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 7.10 Installation Guide ## **Overview** ## Initial TMS Installation 1. 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. 2. Obtain the URL and install the package, using the **Install for all Users** setting. 3. Wait a few minutes for the application to complete the installation process. You will receive an email upon completion of the installation. 4. From **Setup 🡪 Installed Packages** click on the **Manage Licenses** link for the TMS package and assign licenses to users. 5. Turn on **Country/State Picklists**. Start with the **United States** as the only country unless you have more information. 6. From **Setup 🡪 Data Management🡪Data Integration Rules** activate **Geocodes for Account Shipping Address**. 7. From **Setup 🡪 Enhanced Email**. Confirm that Enhanced Email is Enabled. 8. Make sure the **Bad Carrier** Transportation Profile workflow rule is active or an equivalent method to invalidate unacceptable carriers. 9. Turn off **Matching Rules** and **Duplicate Rules** for Accounts and Contacts as they can prevent auto-creation of accounts in the application. 10. From **TMS Admin 🡪 Configuration** click on the **Reset Reference Data** button ONCE. Wait for this process to complete. 11. From **TMS Admin 🡪 Configuration** fill out all the fields in the top section with valid values. 12. Create a global (broker) transportation profile as the global default and set it from **TMS Admin 🡪 Configuration**. 13. Set the four load board equipment types by visiting and filling out all information on each **Equipment Type** record. 14. From **Setup 🡪 Chatter Settings** enable Chatter. 15. From **Setup 🡪 CSP Trusted Sites** add an entry for ALK Maps:![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Initial%20Install%201.png) 16. Make sure these custom **Account fields** are displayed for TMS users, properly secured: 1. TMS Type 2. Transportation Profile 3. DBA Name 4. Customer Sales Rep 5. Default Payment Method 6. Posting City 7. Posting State/Province 8. Time zone 17. Make sure the **Transportation Role** field is displayed for TMS users on the Contact page layout. 18. Provide appropriate CRUD access to each user profile for each TMS table. 19. Tailor page layouts and lightning record pages as appropriate for each profile. 20. 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** 1. Install the **Accounting Seed managed package** and follow their configuration instructions. 2. Install the **TMS-Accounting Seed extension package**. 3. Add “**Transportation**” to the Product table **Product****Family** field as a picklist choice. 4. Make the new **TMS Accounting Admin** tab visible to the system administrators. 5. From the **TMS Accounting Admin** tab: 1. Set all the **Global Default** fields you can and click **Save**. 2. 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. 3. If the Unlinked Items sections is not empty: 1. Click the **Create/Match Products for Unlinked Accessorials** button to associate products to all your unlinked accessorials. 2. Click the **Create/Match Products for Unlinked Taxes** button to associate products to all your unlinked sales taxes. 4. After clicking these two buttons the **Unlinked Items** section should be empty. 6. Provide access to appropriate internal users for the following Visualforce pages/data: 1. **TMSAccountingAdmin** 1. Add as a visible tab for appropriate internal user profiles. 2. **BillingAutoCreation** 1. Add the **Create Billing** button to the Customer Quote related list on the Load page layout. 3. **BillingTaxUpdate** 1. Add the **Calc TMS Tax** button to the Billing page layout. 4. **BillingEDISend** 1. Add the **Send via EDI** button to the Billing page layout. 5. **BillingGenerateAndSend** 1. Add the **Send Invoices** button to the Billing tab list view 6. **BillingBatchPost** 1. Add the **Batch Post** button to the Billing tab list view. 7. **BillingBatchUnpost** 1. Add the **Batch Unpost** button to the Billing tab list view. 8. **PayableAutoCreation** 1. Add the **Create Payable** button to the Carrier Quote related list on the Load page layout. 9. **PaymentProcessorSubmit** 1. Add the **Submit to Payment Processor** button to the Payable page layout. 10. **PaymentProcessorStatus** 1. Add the **Payment Processor****Status** button to the Payable page layout. 11. **PaymentProcessorSubmitBulk** 1. Add the **Submit to Payment Processor** button to the Payable list views 12. **PaymentProcessorStatusBulk** 1. Add the **Payment Processor****Status** button to the Payable list views. 13. **InvoiceAdjustment** 1. Add the **Adjust** button to the Payable page layout. 14. **PayableBatchPost** 1. Add the **Batch Post** button to the Payable tab list view. 15. **PayableBatchUnpost** 1. Add the **Batch Unpost** button to the Payable tab list view. 16. **EPaymentDetail** 1. Add the **ePayment related list** to the Load page layout. 2. Add the **New** button to this related list. 17. **BatchPostAndPay** 1. Add the **Post and Pay** button to the Payable list view. 7. Drag all fields desired onto the **Billing** page layout. 8. Drag all fields desired onto the **Payable** page layout. The **Payment Processor XXX** fields relate to the TriumphPay integration. 9. From a list view, make sure all **Product** records have the appropriate **Revenue GL Account** and **Expense GL Account** values. 10. Add the **Unapplied Cash/Credit Memos** field to the Shipper/Consignee **Transportation Profile** page layout right below the **Credit Limit** field. 11. Remove all access and visibility to the **Customer Invoice** and **Vendor Invoice** tables: 1. Remove related lists from Load page layout. 2. CRUD access should be none for these tables for all profiles. 3. Hide the Customer Invoice and Vendor Invoice tabs from all profiles. 12. See the **User Guide** for instructions on setting up **NACHA file generation**. 13. **NO SECURITY PROFILES SHOULD HAVE DELETE RIGHTS ON THE EPAYMENT TABLE.** ## **TMS Commissions – Installation Instructions** 1. Before installing the application, 1. 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; 1. rtms__CustomerInvoice__c.rtms__Invoice_Total__c 2. rtms__CarrierInvoice__c.rtms__Accessorial_Charges__c 3. rtms__CarrierInvoice__c.rtms__Adjustments__c 4. rtms__CarrierInvoice__c.rtms__Line_Haul__c 5. rtms__CarrierInvoice__c.rtms__Fuel_Surcharge__c 2. If the customer is using Accounting Seed, then turn history tracking on for the following tables/fields; 1. AcctSeed__Billing__History.AcctSeed__Status__c 2. AcctSeed__Billing_Line__History.AcctSeed__Rate__c 3. AcctSeed__Payable__History.AcctSeed__Status__c 4. AcctSeed__Payable_Line__History.AcctSeed__Amount__c 1. Obtain the current installation URL and password from your Revenova representative. 2. Check the option to "Install for All Users" 3. Check the "I acknowledge…" checkbox 4. Click the "Install" button" ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20TMS%20Commissions%201.png) 5. Once the application is installed, assign licenses TMS Commission license to user who require access to the data.![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20TMS%20Commissions%202.png) 6. Setup the Incentive Payment Configuration. 1. Go to Setup > Develop > Custom Settings 2. Click on the link RTMSIncentivePaymentConfiguration![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20TMS%20Commissions%203.png) 3. Click on the Manage button![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20TMS%20Commissions%204.png) 4. Click on the New button![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20TMS%20Commissions%205.png) 5. Enter the following information ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20TMS%20Commissions%206.png)NOTE: If you are installing the app in an org that has Accounting Seed then enter ASAccounting in the Accounting Management field. 6. If you’re performing an upgrade, ensure that the Load field set ‘Commission’ has the following selected:![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20TMS%20Commissions%207.png) 7. You’re all set up! ## **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. **You must obtain an earlier version of this document if you are upgrading from a release earlier than 7.3.** ## Release 7.10 Upgrade Instructions ### Release 7.10 TMS Upgrade Instructions (ETC: 30 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 made.** 1. You must **install and test in the sandbox** before upgrading production. 2. You must have installed and completely configured **Release 7.9** before installing this release. 3. **SFDC/TMS Pre-Configuration** 1. For Accounting Seed customers, do not install this TMS release until you have the Accounting Seed Bridge package URL also. They must be upgraded at the same time. 2. 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. 3. From **Setup ****🡪**** Data Management **🡪** Data Integration Rules** activate **Geocodes for Account Shipping Address**. 4. **Turn on State and Country Picklists unless there is a backward-compatibility issue with other packages or customizations.** 5. 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. 6. If you have trouble deleting items in the Lightning UI, change to the **Classic UI** to perform the deletions. 4. Obtain the **7.10 installation URL and password** from your Revenova representative. 5. Install the upgrade. Wait for the “installation succeeded” email. 6. From **TMS Admin 🡪 Configuration** click on the **Reset Reference Data** button **ONCE** and wait for the email indicating completion. The process does the following: 1. Updates all **Lanes** with an Origin Type or Destination Type of State or Province with the country in this order: US, CA, and then MX. See below for examples: 1. If a Lane with MI is found, the country is set to US, not MX. 2. If a Lane with state/province BC is found, the country is set to CA, not MX. 3. Lanes will be renamed to include the country: “MI to BC” will be renamed to “MI US to BC CA.” 7. **Inbound EDI 210 Freight Charge Item Enhancements** If an org. is using or will use inbound EDI 210 transactions for Carrier invoices and would like to use itemized freight charges, complete the steps below. 1. Add the new Vendor Invoice fields (Origin/Destination fields listed below in the field summary table and shown below in the screenshot) to the **Vendor Invoice Page Layout(s)**. ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/EDI%20210%20Fields%20-%20Install%20Guide.png) 2. Add the Vendor Invoice Freight Charge Items *Related List* to the **Vendor Invoice Page Layout(s)**. Update the CRUD access to the new Vendor Invoice Freight Charge Item object and all the fields on it, as well as the new fields on the Vendor Invoice object. 3. If using Cleo as the EDI VAN to receive EDI 210 Carrier invoices with these itemized freight charges, you must contact them to confirm the configuration and mapping of the new itemized freight charge elements in the 210 is complete (see the [TMS 7.10 EDI Specification](/previous-releases/docs/revenova-tms-710-edi-specifications) document for details on the new elements). Note that you do NOT need to contact Kleinschmidt for this update if Kleinschmidt is the EDI VAN. The update has already been implemented on their side. 8. Delete the following obsolete Visualforce pages: 1. CarrierPaymentAction.page 2. EPayment.page 3. RateCalculationManagement.page 4. ZoneSetup.page 9. **LaneIQ Enhancements** 1. From the Object Manager, choose the **Lane** object and then select *Fields & Relationships*. 2. Click the **Destination State/Province** field and on the Controlling Field option click the *New* link. Choose **Destination Country** as the *Controlling Field* and **Destination State/Province** as the *Dependent Field*. Click **Continue**. Verify that the correct state selections appear in the US/MX/CA columns as shown in the screenshots below. *Note: Select View All to see all the available columns and to display the US column. The final screenshot is of the Canada and Mexico columns!* Click **Save** when the values have been verified. 3. Perform the same operation for the **Origin State/Province** field such that **Origin Country** is the *Controlling Field* and **Origin State/Province** is the *Dependent Field*. *Note: Select View All to see all the available columns and to display the US column. The final screenshot is of the Canada and Mexico columns!* Click **Save** when the values have been verified. **U.S.:** ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20Guide%20-%20US%20States%20-%201.png)![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20Guide%20-%20US%20States%20-%202.png)![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20Guide%20-%20US%20States%20-%203.png) **Canada:** ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20Guide%20-%20Canadian%20Provinces.png)**Mexico:** ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20Guide%20-%20Mexico%20States%20-%201.png)![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20Guide%20-%20Mexico%20States%20-%202.png)![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Install%20Guide%20-%20Mexico%20States%20-%203.png) Note:If LaneIQ is located on the home page or accessed via the standalone widget, it may not load Quote History information. An icon spins instead of rendering quote information. When this occurs:  1. Click on the Setup drop-down in the upper-right corner. 2. Choose **Edit Page** to open the Lightning App Builder. Do not change any settings. 3. Click **Save** in the upper-right corner. 4. Results now render in the Sales Quote History section of LaneIQ. 10. Make sure all relevant TMS **batch jobs** are running and/or scheduled. See **User Guide** for suggested run times. #### Release 7.10 Field/Field Set Modification Summary – TMS | **Object** | **Field/Field Set** | **Action** | **Populated** | **Notes** | | --- | --- | --- | --- | --- | | Document Cross Reference | Is POD | Add | Auto | HubTran Support | | Vendor Invoice | Destination City | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice | Destination Country | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice | Destination Name | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice | Destination Postal Code | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice | Destination State | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice | Destination Street | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice | Origin City | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice | Origin Country | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice | Origin Name | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice | Origin Postal Code | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice | Origin State | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice | Origin Street | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice Freight Charge Item | Freight Charge | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice Freight Charge Item | Freight Charge Item Number | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice Freight Charge Item | Item Description | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice Freight Charge Item | NMFC Class (Rated As) | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice Freight Charge Item | Quantity | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice Freight Charge Item | Rate | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice Freight Charge Item | Unit | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice Freight Charge Item | Vendor Invoice | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice Freight Charge Item | Weight | Add | Auto | Inbound EDI 210 Support | | Vendor Invoice Freight Charge Item | Weight Units | Add | Auto | Inbound EDI 210 Support | #### Release 7.10 Accounting Seed Integration Upgrade Instructions (ETC: 15 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 made.** 1. You must **install and test in the sandbox** before upgrading production. 2. You must have installed **Release 7.9** before installing this release. 3. Obtain the **7.10** installation URL and password from your Revenova representative. 4. Install the upgrade. Wait for the “installation succeeded” email. #### Release 7.10 Field/Field Set Modification Summary – Accounting Seed Integration | **Object** | **Field/Field Set** | **Action** | **Populated** | **Notes** | | --- | --- | --- | --- | --- | | | | | | |