--- title: "Carrier Guest Setup" slug: "carrier-guest" tags: ["Admin", "Load Tracking", "Community-Sites", "Carrier Quoting", "LWC"] updated: 2026-10-07T15:49:04Z published: 2026-10-07T15:49:04Z canonical: "documents.revenova.com/carrier-guest" --- > ## 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. # Carrier Guest Setup The Carrier Guest Lightning Web Component (LWC) enables Carriers to enter Driver information, send status updates, upload documents, and view settlement information without requiring a login to the Email Loop site. Throughout the Carrier Portal, there are text areas to instruct the Carrier Guest user. > [!WARNING] > **Note**: Configure the messages, instructions, and footer text displayed in this LWC in the Community Configuration section in the **TMS Admin →** [Document Options](/v1/docs/customize-email-templates-and-community-configuration-settings#community-configuration-settings). See the [Email Loop Setup](/v1/docs/email-loop-setup#carrier-guest-access) article for more information on creating and configuring Digital Experiences Site pages. ## Permission Set Access > [!CAUTION] > **Warning**: The TMS supports specific default objects and fields to ensure LWCs accurately render with the applicable information. Ensure that *Read-only* access is provided to the **Account** and **Contact** objects. > > > > Change or create custom permissions for objects and fields to best fit business needs by cloning the permission set and navigating to **Setup** **→ Users → Permission Sets → TMS Carrier Email Loop → View Summary**. Additionally, because the object and field permissions are provided for external access, take caution when editing object and field permissions to ensure sensitive data is not compromised. The Carrier Guest user operates like an unauthenticated user. When the Carrier Guest user is automatically created after the creation of the [Email Loop Digital Experiences Site](/v1/docs/digital-experiences-sites#email-loop-digital-experiences-site), the **TMS Carrier Email Loop** permission set is assigned to the Email Loop Digital Experiences Site. The TMS Carrier Email Loop permission set grants the Carrier Guest user limited *Read* and *Create* permissions on specific objects and fields to process data from transactions that match to fields populated in the TMS. ## Carrier Guest User LWCs The Carrier Guest displays multiple LWCs to guest users. The following are LWCs the Carrier Guest user can view. ### **Request for Quote (RFQ)** Use the **Carrier Quote** LWC to enable Carriers view, accept, or decline a quote. Quote requests are sent from the TMS, and Carriers can submit a quote with their proposed terms using the **submitCarrierQuote** LWC. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Carrier Quote LWC.png) | Number | Field(s) Name | Field(s) Description | Notes | | --- | --- | --- | --- | | **1** | Load Summary | Load fields are displayed in this 4-column section. Add fields to the [Load TMS12](/v1/docs/field-set-summary#load) field set to include additional fields to this section. | | | **2** | Load Posting Description | Load fields are displayed in this 1-column section. Add fields to the [Load TMS13](/v1/docs/field-set-summary#load) field set to include additional fields to this section. | | | **3** | Load Accessorial Charges | Any accessorial charges associated with the Load that appears as gray pills. | | | **4** | Submit Carrier Quote Charge Information | Proposed Carrier charges to tender the Load, including freight charges, fuel surcharges, and accessorial charges. | > [!WARNING] > **Note**: Accessorial charges associated with a Stop are identified with the Stop number. | | **5** | Carrier Total Amount | A calculated field that populates the sum of the Carrier’s proposed total amount for freight, fuel, and accessorial charges. | > [!WARNING] > **Note**: For multi-currency orgs, select the appropriate currency from the picklist. | | **6** | Submit Button | Sends the Carrier Quote to the TMS. | > [!WARNING] > **Note**: The [QueuedTransactionJob](/v1/docs/batch-processes#queued-transaction-job) must be running to process Carrier Quote submissions. | | **7** | [Carrier Quote Footer](/v1/docs/customize-email-templates-and-community-configuration-settings#community-configuration-settings) | Legal or general text related to the submitCarrierQuote LWC. | | Once a quote is submitted, the Carrier Guest user receives a success message. The quote is then processed as a Queued Transaction and is available in the [Carrier Quote List](/v1/docs/carrier-quote-list). ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Carrier Quote List LWC Submitted Carrier Quote.png) If a Carrier attempts to submit a quote for a Load already assigned to another Carrier, the following message appears in the Carrier Quote LWC: ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Carrier Quote Submission No Longer Available.png) ## Accept/Decline Load Tender Load tenders are sent from the TMS, and Carriers may *Accept* or *Decline* the tender in the Carrier Accept/Decline Tender LWC. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Carrier Tender Accept-Decline LWC.png) If the Carrier accepts the tender and the **Enable RFQ Load Boards** field **isn’t** *checked* in their Carrier Transportation Profile, the Carrier Accept/Decline Tender LWC displays an acceptance message: ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Carrier Tender Accept-Decline LWC Accept Message.png) If the Carrier declines the tender, the Carrier Accept/Decline Tender LWC displays a decline message: ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Carrier Tender Accept-Decline LWC Decline Message.png) If the Carrier attempts to *Accept* or *Decline* the tender but the Load has been already accepted, declined, or assigned to another Carrier, an error message states that the Load link is obsolete: ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Carrier Tender Accept-Decline LWC Obsolete Link Error.png) ### **Load Field Sets** If the [Load Field Set **TMS30**](/v1/docs/field-set-summary) has no added fields, a Carrier is directed to the Tender Accept/Decline page with the message above depending on if the Carrier clicked *Accept* or *Decline*. If the Load Field Set **TMS30** has added fields, the Carrier is directed to a more detailed version of the Tender Accept/Decline page after clicking either the *Accept* or *Decline* link. Additional information and/or input fields are available to the Carrier, and the Carrier can *Accept* or *Decline* the Load tender on this page. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/carrier_guest_tender_lwc.png) The detailed Tender Accept/Decline page can be customized with the following features. - Load field set **TMS30** is the output fields displayed in the four-column section on the left. - Load field set **TMS31** is the output fields displayed in the one-column section on the left. - Load field set **TMS32** is the Load input fields displayed on the right. - Custom Mode-specific field sets may be used (e.g. TMS30 Truckload). - The **Load Tender Page Settings** field on the Carrier Service object provides the ability to set the following: - Email Signature: The Carrier Quote **Tender Accepted By** and **Tender Accepted By Email** fields are displayed and required prior to Tendering the Load. - Carrier Details: the input fields from **TMS32** are visible. Additionally, the Carrier Guest user requires additional permissions on the Detailed Tender Accept/Decline page. - Load input fields: **Create** permissions on the Load object and **Edit** permissions to all fields in field set **TMS32**. - Accepted by fields: **Create** permissions on the Carrier Quote object and **Edit** permissions to the Carrier Quote **Tender Accepted By** and **Tender Accepted By Email** fields. - Decline fields: **Create** permissions on the Carrier Quote object and **Edit** permissions to the Carrier Quote **Tender Declined Reason** and **Tender Declined Comments** fields. > [!CAUTION] > **Warning**: If a Carrier clicks on Accept/Decline links, and the following error appears: > > `Error - Carrier Tender INVALID_FIELD: rtms_Load__r.SystemModstamp, rtms_Carrier_Service__r.rtms_Carrier_r.Name^ERROR at row 1` > > This error message is permissions-related. > > > > The Email Guest User is missing the **TMS Carrier Email Loop Permission Set** and *Read-only* access for the **Account** object. > > > > The Carrier Guest Site user may need access to the following Apex Classes: > > - rtms.CarrierLoadListController > - rtms.CarrierQuote > - rtms.CarrierQuoteController > - rtms.CarrierSettlementController > - rtms.CarrierTenderAcceptDeclineController > - rtms.LightningUtilController > - rtms.StopStatusController > - rtms.Constants > > Ensure any corresponding Email Loop Permission Sets are chosen in the Members section of the [Email Loop](/v1/docs/digital-experiences-sites#email-loop-digital-experiences-site) site. ## **Request Carrier Status** Loads with an *In Transit* status can be submitted in the Assigned Loads LWC. The Carrier’s Status can be retrieved in two ways: - Manually providing the Carrier with the Carrier Status Link located in the Load Summary Details Tab - Clicking the Request Carrier Status button ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image(34).png) on the Load Summary record. The first page is the Carrier Load List LWC, comprised of all Loads assigned to the Carrier. This list is split into *In Transit* and *Delivered* Loads. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/carrier_load_list_instructions(1).png) 1. Click the **Load Number** link to view Load updates. 2. Once a Load record opens, the following actions can be taken: 1. Add or update Driver information 2. Add or update Load statuses 3. Add and upload Load documents ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/stop_status.png) The Carrier can click the **Return to Load List** button to return to the Carrier Load List LWC. ## **Stop Status** Carriers can submit updated Stop location information on the Route/Stop Status LWC. 1. Click the **En Route**/**Arrived**/**Departed** stage on the Load path to enter Load status information. 2. Enter all necessary information in the Route/Stop Status fields. Include additional **Comments** as applicable. 3. Click **Send Update**. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Carrier Guest Load Status - 2.png) Load and Stop status information submitted in the Route/Stop Status LWC updates the **Last Tracking Update** field. ### **Tracking Updates** When Carriers provide a Stop status, specific fields are displayed by default and are provided as tracking updates within the TMS. | Stop Status Selected by User | Fields Displayed by Default | Updated TMS Fields | | --- | --- | --- | | En Route | *Where are you now?* > [!WARNING] > **Note**: No default values display if no location information was previously received. | - Carrier ETA Date - Carrier ETA Time - Stop Status - Carrier Status - Carrier Status Comments - Last Reported City - Last Reported State/Province - Last Reported Country | | Arrived | Arrival Date and Arrival Time | - Stop Status (Arrived) - Carrier Status - Carrier Status Comments - Last Reported fields > [!WARNING] > **Note**: For the **Last Reported Fields**, the Last Reported *City*, *State/Province*, and *Country* fields are associated with the Stop location. | | Departed | Arrival Date, Arrival Time, Departure Date, and Departure Time | - Stop Status (Departed) - Arrival Date - Arrival Time - Departure Date - Departure Time - Stop Status - Carrier Status - Carrier Status Comments > [!WARNING] > **Note**: For the **Last Reported Fields**, the Last Reported *City*, *State/Province*, and *Country* fields are associated with the Stop location. | Carrier tracking updates are processed by the QueuedTransactionJob. Default values aren’t available in the Carrier Guest LWC until the batch job completes processing updates. ### Upload Load Documents Depending on the configuration of the document settings, Load documents may be uploaded when the **Load Status** is *Delivered*. When the Carrier selects a Load with a *Delivered* status, the option to upload documents is available. > [!NOTE] > From **TMS Admin** → [Customer Invoice Documents](/v1/docs/customer-invoice-documents) list, set the **Carrier Upload** field to *checked* to allow Carriers to upload select documents and document types. Each file is limited to a size of 2GB. 1. Select the appropriate document type from the picklist. 2. Click **Upload Files** to select an image or drop files into this space. 1. The Stop Status LWC supports uploading the following image types: 1. PNG 2. JPG 3. GIF 3. Click **Send Update**. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Carrier Guest Load Status - 4.png) When Carriers upload documents, the Load **Carrier Uploads** field is set to *POD*, *BOL*, or *Invoice* depending on the file type selection. - Files are named based on the Document Type and File Type selected in the component. - **Example**: ., such as Carrier Invoice.png. - All image files are evaluated to determine if the Customer Invoice Document requirements are met. - When all criteria are met, the **Customer Invoice Documents Received** field is *checked*. - For Delivery Receipt file selections, the Load **POD Received** field is *checked*. ## **Carrier Settlement** Use the Carrier Settlement LWC to prompt Carriers to upload documents and request payment. Once the Carrier chooses the **Request Payment** button or the Load is *Delivered*, Carriers see the Carrier Settlement LWC. Carriers may enter invoice information and upload invoice documentation. > [!NOTE] > Each file is limited to a size of 2GB. 1. Click the **Upload Files** button under the Attach Invoice field. 2. Select the appropriate invoice file to submit for the Load. 3. The Carrier Settlement LWC invoice attachment supports uploading the following file types: 1. PNG 2. JPG 3. GIF 4. PDF ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Carrier Guest Load Status - 3.png) When Carriers upload documents, the Load **Carrier Uploads** field is set to *POD*, *BOL*, or *Invoice* depending on the file type selection. - Files are named based on the Document Type and File Type selected in the component. - **Example**: ., such as Carrier Invoice.pdf. - All image files are evaluated to determine if the Customer Invoice Document requirements are met. - When all criteria are met, the **Customer Invoice Documents Received** field is *checked*. - For Delivery Receipt file selections, the Load **POD Received** field is *checked*. Carriers can upload additional required documents on the Carrier Settlement LWC. For example, Stop-specific POD documents may be required. The options available in the picklist is determined by the Global Default Customer Invoice Document settings. Any selections on the Global Default with the **Carrier Upload** field *checked* appears in the picklist. 1. Select the document type from the picklist. 2. Select the appropriate image to submit for the Load. 3. The Carrier Settlement LWC required documents section supports uploading the following file types: 1. PNG 2. JPG 3. GIF When a Carrier attached all required documents, they can select **Submit for Payment** to send all attached Load financial documentation for approval. ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image(43).png) 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.