Menu
Feedback
Start here
Tutorials


Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Shipping
Shipping Strategy
How shipping calculation works
5 min read

During the shopping experience, when the customer enters their location at checkout, the VTEX platform analyzes the shipping strategies suitable for the order and displays the available shipping options to the customer.

In the window display stage of the shopping flow, when the customer has not yet informed their address, the products displayed belong to the sellers already configured as comprehensive sellers or using the Region feature. These sellers are able to ship orders to all regions covered by the marketplace operation.

This article presents a general overview of the shipping calculation and is divided into the following sections:

Selecting logistics combinations

To determine which combination of logistics steps configured by the store is the best option for order fulfillment, the VTEX platform makes a selection of logistics combinations for each shipping method:

  • Delivery: The customer receives the order at their address.
  • Pickup: The customer picks up the order from a pickup point.

Both delivery and pickup have the same selection criteria. However, the pickup option has one additional criterion, described further on in this article.

The selection of logistics combinations is made according to the criteria below, applied in the following order:

  1. Logistics route validation: The logistics route combines the shipping policy, loading dock and warehouse able to cover the order criteria, including item availability and customer location. The VTEX platform analyzes which logistics routes cover the shipping in this first validation step. The following aspects are taken into account:
  • Shipping rate template attributes:i.e., size, weight, ZIP code range and modal. The shipping rate template is filled out according to the carrier’s service-providing contract. The carrier must fulfill the order per item features and customer location coverage.
  • Inventory availability: The stock is the physical location where items are stored, while inventory is the list of SKUs of available stocks for sale. This criterion confirms the order items are available in a stock, and that the stock has at least one loading dock available.

In case of a kit shipment, there are two conditions:

  • The kit components must have the same loading dock.

  • The kit components must be available in the inventory.

For more information, please see the article How to calculate the kit shipping rate.

  1. Inventory prioritization: The previously selected logistics routes are organized with the inventory as a priority criterion. The lower the order of SKU quantity in stock, the higher the priority of the logistics route selection. So inventories with small item quantities are not blocked out. The logistics routes are listed in order, placing the top priority item in the first place and the lowest priority item in the last place.
  2. Package grouping: The VTEX platform calculates how the item orders may be split into packages to estimate the division into packages and consignments.
  3. Calculating price and shipping time: The VTEX platform calculates the package price and shipping time, reordering the priority list of logistics routes according to the criteria below, in the following order:

When there is a tie between loading docks, the tiebreak criterion is the overhead, which represents a value in number of days that will determine the most advantageous loading dock for a given shipment. The lower the overhead, the higher the chances for a loading dock to be selected. Please note that the overhead is not considered when calculating the shipping time.

  1. Exclusive criterion for the pickup option: There is an additional step in the selection when analyzing pickup points. The VTEX platform creates a list of eligible pickup points, using as criterion the shortest distance between the pickup point and the customer's location.

The final result of the logistics configuration selection is an ordered list of eligible logistics routes. During checkout, however, the customer will be able to choose from up to two carrier options for each shipping method:

  • Delivery: The fastest and cheapest option.
  • Pickup: The fastest and cheapest option.

Configuring logistics priorities

You can configure different priorities and criteria for logistics-related steps in the VTEX Admin:

  • Loading docks: Priorities are configured when adding a new loading dock.
  • Shipping rates: The shipping rate prices are configured in the shipping rates, except for the loading dock rate, which is an optional value, configured when adding a new loading dock to a warehouse.
  • Delivery time: The shipping time is configured in the SLA estimate.
  • Package splitting: The adopted criteria are configured in the Checkout module. Learn more in package splitting.

Shipping time estimate

SLA stands for Service Level Agreement, and in logistics it refers to the shipping time estimate for a customer's order, which must agree with the terms established during purchase.

The SLA is calculated using the following fields and parameters:

A shipping time estimate can be obtained using the Shipping simulator, which considers the VTEX store shipping strategies.

The Shipping simulator result is only an approximation since the determining factors are only provided at checkout, such as carrier availability at the time of purchase, payment confirmation time and white label sellers' selection result.

Learn more

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
How to prevent a carrier from meeting a certain ZIP code range?
« Previous
Logistics in the Grocery Segment (supermarkets)
Next »
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback