--- title: "TMS 7.12 Quote Wizard Setup" slug: "712-quote-wizard-setup-1" tags: ["Compiled from User Guide", "Admin", "LWC", "Customer Portal", "7.12"] updated: 2024-10-29T13:53:49Z published: 2024-10-29T13:53:49Z canonical: "documents.revenova.com/712-quote-wizard-setup-1" --- > ## 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. # TMS 7.12 Quote Wizard Setup ## **Overview** ## **Quote Wizard** The Quote Wizard Lightning Web Component (LWC) is located in the Customer Portal. There are two child LWCs on the Quote Wizard, the Stop Configuration Portal LWC and the Location Account Name Lookup LWC. Customer-created LTL and non-LTL loads follow the same flow through the Quote Wizard LWC: 1. Configure the load. 2. Retrieve a list of quotes: 1. For LTL loads a list of marked-up carrier quotes from stored rate and API Carriers. 2. For non-LTL loads a single customer quote from a stored rate. 3. Select one quote from the list. 4. Complete the load configuration. 5. Tender the load. LTL loads have a status of **Tendered** or **Assigned** when there is an accepted Customer Quote and an accepted Carrier Quote. For non-LTL loads, the load is in an **Unassigned** status with an accepted Customer Quote. LTL **API-quoted** loads can be **tendered** in one of two ways: - Via an API - Via email ### **Initial Setup** To initially configure the Quote Wizard LWC, a new Standard Page must be created in the Portal. The Name/URL of the page can be anything, but the API Name must be **QuoteWizard**. ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image-1696022308620.png) From the *Custom Components* drag the **Quote Wizard** onto the page. A new tab is added to the Navigation Menu for the page, as well. See the **Portal Text Configuration** page for initial text setup. > [!NOTE] > If elements in the UI overlap, open the Builder and click the **Theme Settings** tab. Increase the Max Page Width with the slider. ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image-1701356110518.png)![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image-1701356088253.png) ### **Mode Selection Page** On the mode selection page, users select a mode for new loads. ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image-1696022533104.png) For configuration: 1. Modes that have **Customer Portal Selection** checked will be available for selection. 2. A custom image can be used for each mode by: 1. Uploading an image into a publicly accessible document directory. 2. Populating the mode **Customer Portal Icon** field with the Salesforce 18-character ID of the image. 3. Note the image is designed for the following dimensions: width: 109 px, height: 50 px. 3. The mode’s description can be set by populating the mode’s **Customer Portal Description** field. ### **Load Entry Page** From the load entry page, users can enter load, stop, and line item details. Then, they can either get quotes or save the load. Additionally, if an insurance API is enabled, users can select **Show Cargo Insurance Options** to see the insurance options on their quotes. ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Quote Wizard - 2(1).png) > [!NOTE] > When creating Loads in the Quote Wizard, the currency picklist is set by the Load currency field. > > - In single currency organizations, the value is the currency of the organization. > - In multi-currency organizations, the value is set by the Customer account record. For configuration: 1. Excluding **Mode** and **Customer**, additional fields can be added to this section using Load field set TMS10 (mode-specific field sets supported). 2. Country Filtering options for each stop. 3. Additional stop fields can be added to the stop sections using Stop field set TMS4 (mode-specific field sets supported). 4. Configure Limited Access Accessorial charges for each Stop location. When *Checked*, a picklist renders with all Limited Access Accessorial charges. 5. From **TMS Admin →** **Accessorials**, Load and Stop accessorial charges can be enabled for the Portal by checking the **Customer Portal Selection** field. 6. Additional Line Item fields can be added to the line item sections using Line Item field set TMS6 (mode-specific field sets supported). 7. The **Cargo Insurance Option** picklist field on the customer’s Transportation Profile: 1. If blank or “Hide,” **Show Cargo Insurance Options** is not visible with the two links. 2. If “Opt In,” **Show Cargo Insurance Options** is checked by default. 3. If “Opt Out,” **Show Cargo Insurance Options** is unchecked by default. #### Stop Configuration Quote Wizard users are presented with a 1 Pickup and 1 Delivery route. Additional Stop locations may be added with the **+** down arrow button below each Stop. ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Quote Wizard - 2(2).png) Select *Add Pickup* or *Add Delivery* to include additional Stops of that type. The Quote Wizard supports creating a Load with the same Account location for multiple Stops. > [!NOTE] > The first Stop location can not be a Delivery type. The last Stop location can not be a Pickup type. Re-order Stops in the route with the Up/Down arrow button. ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Quote Wizard - 3.png) A modal opens and displays the Stop locations. Use the arrow buttons to move Stop locations up and down in the route. ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Quote Wizard - 4.png) When Stop locations are properly routed click **Done**. > [!WARNING] > LTL Loads created in the Quote Wizard only support 1 Pickup and 1 Delivery route configurations. #### Country Filtering Two fields may be configured in TMS Admin → Configuration → Global Settings for finer control of account searching. *Check* the **Country Picklist Location** box to place the Country picklist first in the list of fields. ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Quote Wizard - 1(1).png) The **Default Country for Load Creation** picklist contains 4 options to control account searching when creating Loads. - -- None -- - US - CA - MX Selecting *-- None --* applies no country filtering to account searching and results are not limited. Choose a country from the picklist to limit customer search results to the selected country. #### Requesting Faster Transit Time The **Request Faster Transit** feature allows Customer Portal users to request expedited transit time when the Carrier's published delivery timeline does not meet their requirements. This eliminates the need to rely on email communication with their customer support representative. The requests are logged on the Load records and may be used in record-triggered Flows and list views for more efficient management of each request. When the Customer Portal user clicks **Request Faster Transit**, a modal to enter **Requested Delivery Date**, **Requested Delivery Time**, and **Comments** fields. These fields are available on the Load record trigger email notifications and available in list views. > [!NOTE] > The **Request Faster Transit** button is only available for LTL Modes. (LTL must be *Checked*.) ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image(18).png) **Quote Selection Page** On the Quote Selection page, users can select an LTL or non-LTL quote, refresh quotes, return to the Load Entry page, and/or filter LTL quotes. Additionally, if API cargo insurance was requested, the user can include or exclude the insurance and see the price difference. LTL load: ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image-1696023364789.png) Non-LTL load: ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image-1696023371489.png) Configuration: 1. A custom image can be used for each carrier service by: 1. Uploading an image into a publicly accessible document directory. 2. Populating the Carrier Service **Logo Document Id** field with the Salesforce 18-character ID of the image. 3. Note the image is designed for the following dimensions: width: 109 px, height: 50 px. 2. The Carrier Service **Service Notes** fields can be used to add additional information about the Carrier Service. 3. Additional Carrier quotes fields can be added using Carrier Quote field set TMS6 (mode-specific field sets supported). 4. A reseller markup can be utilized by populating the **Reseller Markup Group** field with a Carrier markup group on the customer’s Transportation Profile or global Transportation Profile (see **Carrier Markup Groups**). 5. The **LTL Quote Refresh** field can be populated on the customer’s Transportation Profile which prevents the selection of LTL quotes if the timeframe has passed. 6. When selecting an LTL quote, the **Customer Portal Tender Options** picklist field on the user object will: 1. If blank or “Any Quotes,” allow the user to select any quote with no other input. 2. If “Any Quote With Reason,” allow the user to select any quote, but require a reason* if the quote is not the lowest cost. 3. If “Lowest Quote Only,” only allow the user to select the quote of the lowest cost. *reasons for selecting a quote are managed by the **Selection Reason** field on the Carrier Quote which is where the information is also stored. 7. For LTL loads, a portal customer can click the **Request Faster Transit** button if the transit times on the quotes provided are not fast enough. A dialog box opens and allows the user to enter a date, a time, and comments. Internal users need to handle these special requests. The portal users inputs are saved to the Load record. Workflows, triggers, or special list views may be set up to facilitate management of these Faster Transit Requests. There is an additional user picklist field, **Customer Portal Quote Visibility**, which limits LTL quote visibility to the user: 1. If “Lowest Quote Only,” the user will only be able to see the lowest cost quotes. 2. If “Fastest Transit Only,” the user will only be able to see quotes with the lowest transit times. 3. If blank or “All Quotes,” the user will see all quotes. ### **Load Tender Page** On the Load Tender page: - Finalize stop details (locations and contacts). - Enter additional load details. - Enter additional load references. - Perform the final authorization for API insurance. - Tender the load. Users can additionally navigate back to the Load Entry page or choose a different quote. Line items, accessorials, and the selected quote are displayed on the page for review. ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image-1696023894112.png) ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image-1696023908554.png) ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image-1696023931245.png) > [!NOTE] > Portal users receive an error when attempting to Save or Tender a load with a ship date in the past. Adjust the date to tender the load. For configuration: 1. Additional stop fields can be added using Stop field set TMS10 (mode specific field sets supported) 2. Additional line item fields can be added using Line Item field set TMS4. 3. Additional load fields can be added using Load field set TMS7 (mode specific field sets supported) 4. See **Load Entry References** section for setting up dynamic load references. ### **Tender Failures** > [!WARNING] > Warning: > > **If the tender fails for some reason, the customer is NOT made aware of this fact. The behavior of the Portal is the same whether the tender succeeds or fails – it is assumed that the failure of a valid quote’s tender operation is a technical “glitch” that can be resolved.** The Load remains in **Quotes Received** status, and an **alert email** is sent to the designated address: ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image-1696024153807.png) The same behavior is mimicked for API insurance authorization. If the API insurance authorization fails, the customer will not see the error, and an alert email is sent to the designated address. A feature in Salesforce that enhances the user experience by providing interactive and customizable components within Salesforce applications. Revenova uses Lightning Web Components to deliver features that can be tailored to suit your specific needs and preferences.