Quote Wizard Setup

Prev Next

The Quote Wizard Lightning Web Component (LWC) is located in the Customer Portal. There are two detail LWCs on the Quote Wizard: the Stop Configuration Portal LWC and the Location Account Name Lookup LWC.

Customize and configure the Quote Wizard, including any associated LWCs, using custom Field Sets, Digital Experience Sites, and API Insurance integrations.

Create a Standard Page

To configure the Quote Wizard LWC, create a new Standard Page in the Customer Portal. The Name and URL fields of the page do not need to be labeled anything specific, but the API Name field must be QuoteWizard.

""

Select the Components menu (the lightning bolt). In the Custom Components section, drag the Quote Wizard LWC onto the page.

See the Customer Portal Configuration article for initial text setup.

Note: If elements in the UI overlap, open the Experience Builder and select Theme → Theme Layout Settings. Increase the Max Page Width with the slider.""

Customer Community Plus license users, by default, do not have the ability to see all Contacts associated with an Account.

To enable users to see Contacts, enable the following setting:

  1. Navigate to Setup.

  2. Search for and select Digital Experiences.

  3. Click Settings.

  4. In the Role and User Settings section, check the Allow users to see contacts that have not been enabled for partner or customer accounts box.

""

Mode Selection Page

Customer-created LTL and non-LTL Loads follow the same flow in the Quote Wizard LWC.

  1. Configure the Load.

  2. Retrieve a list of quotes.

    For LTL Loads, there is a list of marked-up Carrier Quotes from stored rate and API carriers. For non-LTL Loads, there is a single Customer Quote from a stored rate.

  3. Select a quote from the list.

  4. Complete the Load configuration.

  5. Tender the Load.

LTL Loads have a status of Tendered or Assigned when both a Customer Quote and a Carrier Quote are accepted. For non-LTL Loads, the Load is in an Unassigned status with an accepted Customer Quote.

LTL API-quoted Loads can be tendered in two ways:

On the Mode Selection Page, select a Mode for the new Load.

""

To set up Modes in the Mode Selection Page, go to TMS Admin → Modes and configure the following fields for each record:

  1. Customer Portal Selection: When checked, this Mode will be available for selection.

  2. Customer Portal Icon: Upload a custom image to use for this Mode by following the below steps:

    1. Upload an image to a publicly accessible document directory in your TMS.

    2. Enter the Salesforce 18-character ID of the image into the field.

      Note: For the best image rendering, the image should have the following dimensions: Width → 109px and Height → 50px.

  3. Customer Portal Description: Enter a description for this Mode.

""

Display Load Tender Banners in the Customer Portal

While not required, Load pickup or tender status messages can be displayed to Customer Portal users. Find these settings in the TMS Admin → Modes.

  • Cust Portal Same-Day Pickup Msg: Displays when a Load can be picked up on the same day as the Expected Ship Date.

  • Cust Portal Same-Day Tender Disabled Msg: Displays when the tender cut-off time was missed on a Carrier Quote.

  • Cust Portal Past Date Tender Msg: Displays when the pickup date on the Load is set in the past.

""

These messages appear as orange banners with a caution icon to the left of the message in the Customer Portal.

""

Note: These Customer Portal messages only appear to users if the Load Status is one of the following:

  • Unassigned

  • Quotes Requested

  • Quotes Received

Additionally, the Pickup Cutoff Time or Same-Day Tender Cutoff Time must have a time value in the Carrier Service record. For more information, see the Carrier Pickup Cutoff Time Notifications article.

Additionally, these settings are defined by Mode. For example, if there are a set of messages that should show in the Customer Portal for only LTL Loads, ensure to edit the Customer Portal message fields for the LTL Mode.

Load Entry Page

In the Load Entry Page, users can enter Load, Stop, and Line Item details to either get quotes or save the Load. Additionally, if an insurance API integration is enabled, users can select Show Cargo Insurance Options to view the insurance options on their quotes.

Configure the following settings and fields to impact the options on the Load Entry Page:

Icon Number

Fields/Field Set

Setting Location

Description

1

Load TMS10 Field Set

Setup → Object Manager → Load → Field Sets

Include additional fields to the Shipment Details section. Mode-specific field sets are supported.

2

Country Picklist Location and Default Country for Load Creation

TMS Admin → Configuration (Global Settings)

Filter Account addresses by country. See the Country Filtering section in this article.

3

New Shipper/Consignee Account

Account Setup

Create Shipper/Consignee Accounts during Load Entry.

4

Stop TMS4 Field Set

Setup → Object Manager → Stop → Field Sets

Add fields to the Stops section. Mode-specific field sets are supported.

5

Limited Access

TMS Admin → Accessorials

When checked, a picklist renders with all Limited Access Accessorial charges.

6

Customer Portal Selection

TMS Admin → Accessorials

When checked, these accessorial charges are available in the Customer Portal.

7

Line Item TMS6 Field Set

Setup → Object Manager → Line Item → Field Sets

Add fields to the Line Items section. Mode-specific field sets are supported.

8

Cargo Insurance Option

Customer Transportation Profile → Portal

Display or hide the Show Cargo Insurance Options field with the two links and if the field is checked by default or not.

Form for LTL shipment details including stops, line items, and load accessories.

Note: When creating new Loads in the Quote Wizard, the currency is set by the Default Load Currency field in TMS Admin → Configuration:

  • 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.

See the Currency Settings article for more information about configuring currencies.

Stop Configuration

Customer Portal users are presented with a Pickup and a Delivery Stop that contains location information, hours and appointment information, and a list of accessorial charges for each Stop location. The Expected Date field is stored in the user’s time zone when creating Loads.

The Stop Configuration Detailed LWC in the Quote Wizard of a Customer Portal.

Note: The Stop Configuration in the Quote Wizard is based on the Stop Configuration Detailed LWC in the TMS. For more information on creating new Stop locations and Stop accessorial charges, refer to the Stop Configuration Detailed LWC article.

Country Filtering

For more refined Account searching, configure two fields in the Global Settings section in TMS Admin → Configuration: Country Picklist Location and Default Country for Load Creation.

Check the Country Picklist Location box to place the Country field first in the list.

The Stop Configuration Detailed LWC highlighting the country picklist selection location.

The Default Country for Load Creation picklist contains four options to control account searching when creating Loads:

  • -- None --

  • US

  • CA

  • MX

Selecting --None-- applies no country filtering when searching Customer Accounts. Selecting a value auto-populates the Country field with that value.

Select a country from the picklist to limit the account search results to the selected country. For example, selecting US will only return Customer Accounts with a United States billing address.

Quote Selection Page

In the Quote Selection Page, users can:

  • Select an LTL or non-LTL quote

  • Refresh quotes

  • Return to the Load Entry Page

  • Filter LTL quotes

Additionally, if cargo insurance was requested via API, the Customer Portal user can include the insurance, exclude the insurance, and/or view the price difference.

Request Faster Transit

Note: The Request Faster Transit feature is only available for LTL Modes. Configure this setting by navigating to the TMS Admin → Modes, and check the LTL box for each LTL Mode.

The Request Faster Transit feature allows Customer Portal users to request expedited transit time when the Carrier's proposed delivery timeline does not meet their requirements.

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 user clicks Request Faster Transit, a modal appears to enter the 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.

""

LTL Carrier Quote Configuration

Configure the following settings and fields to impact the options on the Quote Selection Page for LTL Loads:

""

Icon Number

Fields/Field Set

Setting Location

Description

Available Picklist Options to Select

1

Show Itemized Charges in Portal

Setup → Users

When checked, each quote displays an Itemized Transaction Details table describing the freight, fuel, and accessorial charges.

2

Logo Document Id

TMS Admin → Carriers → Carrier Services

An 18-digit Salesforce ID of an image uploaded in an org’s Library to use for a Carrier Service.

3

Service Notes

TMS Admin → Carriers → Carrier Services

Provides additional information about the Carrier Service.

4

Carrier Quote TMS6 Field Set

Setup → Object Manager → Carrier Quote → Field Sets

Add fields to the Carrier Quotes. Mode-specific field sets are supported.

5

Reseller Markup Group

Customer Transportation Profile → Rates → Customer Product and Pricing Information

Displays the Reseller Price based on the Carrier Markup Group selected. If this field is blank, the logic cascades to the Global Default Transportation Profile.

6

LTL Quote Refresh

Customer Transportation Profile → Portal

Prevents users from selecting a quote after a certain number of minutes elapsed. Users must refresh quotes after the time limit.

7

Portal Quote Direct/Interline Filter

Customer Transportation Profile → Portal

Prevents displaying Carrier Quotes to Customer Portal users based on the Direct/Interline field in the Carrier Quote, which is filtered by Carrier Quotes with or without a Carrier Markup Group. See the Direct/Interline section for more information.

Note: Carrier Quotes hidden from the Customer Portal user are available in the TMS. These quotes have the Filter from Portal field in the Carrier Quote set to checked.

To display hidden Customer Quotes to the user, go to the Carrier Quote records, uncheck the Filter from Portal field and select Save. The next time the user selects the Get Quotes button for the Load, the Customer Portal displays the unfiltered Carrier Quote.

  • Direct

  • Interline

  • Partner

  • Unspecified

Customer Portal Tender Options

Setup → Users

Controls the selection of LTL quotes for each user. See the Customer Portal Tender Options section for more information.

  • Blank or Any Quotes: The user can select any quote with no other input.

  • Any Quote With Reason: The user can select any quote, but a reason is required if the quote is not the lowest cost.

    • Reasons for selecting the quote are managed and stored in the Selection Reason field on that Carrier Quote.

  • Lowest Quote Only: The user is only allowed to select the lowest cost quote.

Customer Portal Quote Visibility

Setup → Users

Limits LTL quote visibility for each user. See the Customer Portal Quote Visibility section for more information.

Note: If no transit time is provided with a quote, these options are available at the end of the list, sorted by cost.

  • —None—: The user sees all quotes.

  • Lowest Quote Only: The user is only able to see the lowest cost quotes.

  • Fastest Transit Only: The user is only able to see quotes with the shortest transit times.

  • All Quotes - Sort by Lowest Cost: The user sees the lowest cost quotes first.

  • All Quotes - Sort by Fastest Transit: The user sees the shortest transit quotes first. Quotes are next sorted based on cost.

Load Tender Page

Warning: Customer Portal users receive an error when attempting to save or tender a Load with an expected ship date in the past. Adjust this date to tender the Load.

On the Load Tender Page, Customer Portal users can do the following:

  • Finalize Stop details (Locations and Contacts)

  • Enter additional Load details

  • Enter additional Load Entry References

  • Perform the final authorization for API insurance

    • This action is available only when the Includes Cargo Insurance Fee field is checked for the selected quote.

  • Tender the Load or submit for review

Users can also navigate back to the Load Entry Page or select a different quote. Line items, accessorial charges, and the selected quote are displayed on the page for review.

Configure the following settings and fields to impact the options on the Load Tender Page:

Icon Number

Field Set/Records

Setting Location

Description

1

Stop TMS10 Field Set

Setup → Object Manager → Stop → Field Sets

Add fields to each Stop location. Mode-specific field sets are supported.

2

Line Item TMS4 Field Set

Setup → Object Manager → Line Item → Field Sets

Add columns to the Line Item section.

3

Load TMS7 Field Set

Setup → Object Manager → Load → Field Sets

Add fields to the Load Details section. Mode-specific field sets are supported.

4

Load Entry References

Customer Transportation Profile → Portal

Load Entry Reference records that have the Type set to Customer are available to add information in the Customer Portal. If the Load Reference value isn’t required, the Load Reference can be deleted.

""

Review Before Tender

The Review Before Tender field is located on the User record. When checked, Customer Portal users view LTL tenders in the following ways:

  • The Load is not tendered.

  • The selected Carrier Quote is Accepted (LTL only).

  • The Review Before Tender field on the Load is checked.

  • The Review Before Tender Message is displayed to the Customer Portal user.

  • If insurance was requested:

    1. The Insurance Policy Status field on the Load is set to Authorized.

    2. The Insurance Policy Status as of field on the Load is blank.

Note: When the Review Before Tender box is checked on the User record, the Customer Portal user does not see a Tender button. Instead, users select Submit to alert the necessary party that a Load is ready for review.

The Customer Portal user is no longer able to access the Load through the Quote Wizard. An internal user must tender the Load and authorize the insurance (if applicable). Custom flows and triggers may be used based on the Review Before Tender field on the Load to set notifications.

Configure the Review Before Tender Message displayed to the Customer Portal user from the TMS Admin → Configuration in the Customer Portal Configuration section.

""

Tender Failures

Warning: If the tender fails, the Customer Portal user is not made aware of the failure. The Customer Portal behaves the same whether the tender succeeds or fails.

If tendering a Load to a Carrier fails, the Load Status remains in Quotes Received, and two (2) alert emails are sent to the email address set in the Tender Failed Alert Email in the Customer Portal Configuration section of the TMS Admin → Configuration. Both emails have the same subject line but contain different information regarding the error messages.

The API insurance authorization follows the same behavior. If the API insurance authorization fails, the customer won’t see the error, and an alert email is sent to the designated address.

The following images are an example of the Customer Portal Tender Failure emails.

""

""

API Insurance

If an API Insurance integration is enabled, Customer Portal users may request and authorize additional cargo insurance in the Quote Wizard LWC. Currently, only Falvey Insurance is supported. For more information, see the Insurance article.

Cargo insurance options are set on the Customer Transportation Profile → Portal → Cargo Insurance Option field. The following fields are available for selection in the Cargo Insurance Option field:

  • --None-- (Cargo Insurance Option is not configured for the Load configuration in the Customer Portal.)

  • Hide (Show Cargo Insurance Options is hidden, and customers are unable to select cargo insurance.)

  • Opt In (Show Cargo Insurance Options is checked, and the cost of cargo insurance is provided with each quote.)

  • Opt Out (Show Cargo Insurance Options is available, and customers may select cargo insurance but is not required.)

When a Customer Portal user creates a Load and checks the Show Cargo Insurance Options box, the Cargo Value field is required before retrieving quotes or saving the Load. The Cargo Insurance Offered field on the Load is checked, and (if getting quotes) the price of the insurance is listed.

The Insurance Provider Fee and Insurance Service Fee fields do not display in any view in the Customer Portal.

""

If a user chooses the insurance, an additional panel is displayed on the Quote Wizard Tender Page with a checkbox that must be checked before tendering the Load.

The Cargo Insurance Certificate URL may be added to the Load Options LWC in the Customer Portal. For setup and other information, see the Load Options LWC documentation.

Note: The insurance authorization can still apply even if tendering to the Carrier fails. Errors are sent to the Customer Sales Representative (CSR) on the Load by email. If there is no CSR associated with the Load, the user that edited the Customer Quote is sent the email. If no internal user edited the Customer Quote, the owner of the Load is sent the email.

Restricted Cargo

Some insurance APIs have restricted cargo which is not covered; this is NOT enforced by Revenova.

It is crucial that the Cargo Insurance Excluded Commodities and Cargo Insurance Authorization fields are configured properly, so the users are aware of any restrictions.