Region is the functionality responsible for searching the white label sellers of a marketplace according to delivery regions and defining which of them are able to fulfill the customer's order according to their location. In addition, through it it is also possible to filter prices and the availability of items in stock regionally.
When the customer accesses the store pages, their location is recorded by the VTEX Session. This data is forwarded to Checkout, which in turn generates a list of sellers enabled for that delivery region, called regionId.
To check which sellers have been considered for a particular region in your store, go to the Get sellers by region endpoint.
Differences between availability and price
The items and prices shown in a store's window are based on the catalog registration carried out by the retailer. During the purchase process, situations may occur in which one or more items have differences in delivery availability and prices (including promotions) between the store's window and the cart at Checkout.
A delivery availability divergence (item available in the store's window, but indicated as “Sold Out” in the cart), occurs when:
- There are no sellers that deliver the item in that region.
- There is no available stock of the item at sellers serving that region.
The price/promotion divergence (different values between the store's window and the cart) can occur when the sellers selected for delivery (due to a greater quantity of items in the cart in stock or for logistical optimization reasons) have different specific commercial conditions (price/promotion) from the marketplace and comprehensive sellers.
With the use of Region, if the customer logs in to the store during the selection process of the items in the window, the following changes occur:
- Availability divergence: there will not be this divergence. Only those items that have availability for delivery (stock) at your address will be displayed as “Available”.
- Price divergence: decrease or elimination of divergence. There will only be a difference in price/promotion if the seller with the best logistical optimization is chosen in relation to the one with the largest stock of the item.
Activate Region
To activate Region in your store, you need to perform the following steps:
Region is currently available for use in all VTEX stores in v2. Learn more in Region v2.