Prerequisites

Before you follow the guide, please ensure you have completed the following prerequisites:

1. Installed the Multi-carrier app
2. Created a preference with your live credentials or test credentials
3. Created a lookup relationship to the object that you would like to ship to

Configure Rating

Make sure to map the Recipient Address Fields, the Preference Name Field, and Package Type Field in your Custom Address Source.

Quote based on Package data

If you want to quote based on package data you need to populate the Packages section with package dimensions using your values or by utilizing a child object:

Quote based on Product data

If you want to quote based on Product data you need to populate the Product details and utilize the Boxing Algorithm checkbox.

If you don't have any product dimensions yet, then please create the Weight, Length, Width, and Height fields.

Set up where to save the quote details

To save the information from the rate chosen back onto your original object, don't forget to set this under the Output for Rate Request section in the Custom Address Source.

Create the following fields if you do not have them yet:

• A currency type field to save the rate
• A text type field (55 characters) to save the quoted service type
• A date type field to save the expected delivery date

Add the Lightning Button

It's very simple to set up the Lightning Quote button on your object. Open a record and click on the gear icon and select Edit Page.

Drag the GetQuoteAction Lightning Button onto your page.

The make sure you add the Salesforce ID of the Custom Address Source you have set up for getting the rates. To get the Salesforce ID of your Custom Address Source you can find this by looking at the URL as below:

Hide/Show Negotiated Rates

If you have negotiated rates (only available with certain carriers), then these will also show up.

However, if you want to hide negotiated rates from quotes you need to check the "Hide negotiated rates" checkbox.

Limit Service Types Shown

Some customers do not want certain service types to be available for quoting. In this example we are going to remove UPS Ground from the available services.

Go to Zenkraft Settings / Bringg Settings > Permission Settings and add a new item. Select the Carrier (UPS in this case), then set the Type to "Disable". Permission object should be "Service Type", then insert the API value to the Value field. Each service type should go onto its own line.

Get a quote!

Once its all set up, test it and you should see this modal that shows you the rates. To save the quote details just click on the selected service in the rate table.

To be able to use the Get Quote lightning component you need to set up your domain. You can do that under Setup > My Domain. For more information please refer to this Salesforce Guide.

Configure CPQ Quoting

This section will explain how to set up rating for Salesforce CPQ.

Create a lookup relationship

Create a lookup relationship from the Multi-Carrier Shipment object to:

• CPQ Quote object - if your CPQ 'Quote Line Items' will ship to ONLY one location
• CPQ Quote Line Group object - if the CPQ 'Quote Line Items' ship to different locations

If you choose the second option you can set up Quote Line Groups that will ship to different addresses with the corresponding Quote Line Items.

Once this is set up you can follow the steps described in the section above to add the quoting button, or you can use automation to get rates.

Set Up Rating for Multiple Carriers

Make sure to follow the configuration steps described above and to create separate custom address sources for each carrier.

Next you need to edit the lightning record page layout of your object.

Then make sure you add the Salesforce IDs of the Custom Address Sources you have set up for getting the rates. To get the Salesforce ID of your Custom Address Source you can find this by looking at the URL as below:

Paste the Salesforce IDs after each other separated by a comma but no spaces.

Once it's all set up, test it and you should see this modal that shows you the rates for all carriers.

If you have negotiated rates (only available with certain carriers), then these will also show up.

If you need to, you can also implement filtering based on certain criteria. A common example is to choose the carrier based on a setting on your record.

Fastest, Cheapest, Delivered On

From v1.104.2 it is possible to quote with multiple carriers based on the fastest or cheapest services type, or based on a deliver by date.

Cheapest: It selects the cheapest option available regardless of the expected delivery time.
If the Delivery Date is specified, then it selects the cheapest option that delivers within that date.

Fastest: It selects the fastest option available. If there are multiple services that deliver on the same date then it selects the cheapest option from those.

Delivered on: It selects the cheapest option that delivers on the date specified in the Delivery date field.

1. Create the following (text) fields:

• Service type
• Shipping cost
• Preference ID

You can also set up these optional fields:

• Delivered Date Field
• A checkbox to get the process started
• Error handler field

2. Create a new Custom Address Source

Even if you have a custom address source already for another use case it is important to create a new, separate one for running the smart service process.
Once you create the custom address source fill in the basic mappings, such as the address, package, and product details.

3. Add the shipping preference IDs or names as static values

4. Map the Output Service Name Field to the Service type field you created in Step 1

5. Map the Output Preference ID Field to the Preference ID field you created in Step 1

6. Map the Output Net Charge Field

7. Select the Smart Service Type

If you choose Delivered On or want the cheapest service that delivers before a certain date then you also need to map a Delivered Date Field.

8. Build the flow

You need a trigger or an event to start the rating process. In this example we are going to use a Get Rate checkbox (from step 1).

Create a record triggered flow and run it when the record is updated.

In the criteria we define to run the process when the "Get Rates" checkbox is checked:

Add an immediate apex action of Get Rate (Multi Carrier). Set the customAddressId to the ID of the CAS where you added the field mappings. Set the recordID to reference the ID of the record/object you are using. In this example we are using the standard Order object.

9. Get Rate!

Once all the fields are mapped and your process is active you are ready to test.

Go to your test record and start the process. If it runs successfully you should see something like this:

Troubleshooting

You can find the troubleshooting steps to the most common issues with rating.

Rate service error: ERROR: Please select the Packaging Type

This error most commonly occurs when either the packaging type is missing because it is not mapped from the custom address source or the value is missing. The second most common reason is if the quantity is missing, either because the mapping is not there or the value is missing.

Get Quote button is greyed out

This is usually because the person or the profile does not have access to the relevant Visualforce pages.

Go to Setup > Profiles and edit the profile. Add the following Visualforce pages under Apex Class Access:

APEX CPU Time Limit error

This error message usually appears when the record is too complex for the boxing algorithm to calculate the packages. Please refer to the requirements in our Boxing Algorithm guide.