When you configure the product correctly and it is displayed as available on the product listing page, the item may become unavailable when added to the cart. Different logistics aspects may contribute to the product unavailability in the cart, and the following topics help us identify the potential reasons:
If your store uses the seller regionalization feature, the sellers able to ship the product to the customer's location must have the product available for sale. In addition, the status of these sellers must be active, as products from inactive sellers are not considered available.
Shipping Simulator
A product may be unavailable in the cart because your store's shipping strategy does not allow shipping to the customer's location or because there is not enough quantity of the product in the inventory, for example.
One way to test if there is a feasible delivery route is using the Shipping Simulator to validate specific logistical settings in your store and check your inventory.
See the article Shipping Simulator to learn how to simulate product shipping.
Inventory
By adopting any of the following inventory strategies, you can ensure product availability on the product listing page:
- Ensure sufficient item count for sales (reserved items are not considered available).
- In the VTEX Admin, go to Catalog > Inventory > Inventory Management and change the value in the
Update Count
column in the product row.
- In the VTEX Admin, go to Catalog > Inventory > Inventory Management and change the value in the
- Activate the unlimited inventory option for the product.
- In the VTEX Admin, go to Catalog > Inventory > Inventory Management and activate the toggle switch in the
Unlimited inventory
column in the product row.
- In the VTEX Admin, go to Catalog > Inventory > Inventory Management and activate the toggle switch in the
If future inventory is configured for the SKU, the supply of this item could take longer than expected. In this period, the unavailability could be due to a lack of stock.
If your store has franchise accounts, for the inventory of these accounts to be available for sale, the products must be linked to the same trade policy used in your storefront.
Shipping strategy
On VTEX, shipping strategy is the name of the relationship between the shipping policy, warehouse, and loading dock. When the platform calculates shipping for an order, at least one combination of these logistics entities must make it possible to ship the product for a shipping route to be considered valid.
In terms of shipping strategy, the list below shows the main situations that lead to the product being unavailable in the cart:
- Inactive shipping policy.
- Inactive warehouse.
- Inactive loading dock.
- Warehouse not associated with a dock.
- Loading dock not associated with the shipping policy.
- Loading dock not associated with the trade policy that determines the products displayed on the product listing page.
These situations must be considered in the context of the sale. Having an inactive warehouse does not make the product unavailable, but if it is the only one warehouse serving as the shipping route and is inactive, the product becomes unavailable in the cart.
Shipping policy settings
Shipping policy is a set of rules and settings that define the shipping options displayed to customers at checkout. The main shipping policy aspects that affect product availability in the cart are:
From the VTEX Admin, these settings are configured under Shipping > Shipping Strategy, in the Shipping Policies
tab, i.e., on the shipping policy editing page. To create or change a shipping policy via API, use the Create shipping policy and Update shipping policy by ID endpoints.
Carrier and shipping rate template
Each shipping policy is associated with a shipping rate template, where you add the carrier and its shipping rates.
The following list shows the main reasons for product unavailability in the cart related to carrier settings:
- The cart amount is below the minimum shipping value.
- The cart amount exceeds the maximum shipping value.
- The number of items in the cart does not meet the minimum number of items for shipping.
- The customer's postal code/location is not in the region served by the carrier.
The above situations must be considered in the context of the sale. If there is only one eligible shipping policy for shipping the product and the characteristics of this product are not within the settings accepted by the carrier, then there is no valid shipping route, and the product becomes unavailable.
Other carrier settings that can impact product availability are related to item weight and volume, as mentioned below.
Dimensions and cubic weight factor
For the cubic weight factor not to affect product availability, you must ensure that the product falls within the package dimensions configured in the shipping policy, which are:
- Sum of all dimensions.
- Largest edge.
- Cubic weight factor.
- Minimum weight factor.
If the product is not within any of the configured limits, it will become unavailable in the cart.
If two shipping policies are valid for the order, one for delivery and the other for pickup, but the product does not meet the package size limits of one of them, only one shipping method will be displayed at checkout. For example, if the product's weight is lower than the minimum weight value in the shipping policy for delivery but within the limits set for pickup, the customer will only be offered the option to pick up the order.
Modal
The modal is a configuration in the shipping policy that ensures products with special requirements are delivered by specialized carriers. For example, only a transportation company that offers refrigeration can deliver products requiring cooling.
The following situations related to the modal can make a product unavailable in the cart:
- There is no shipping policy for the type of modal configured in the product.
- The product has no modal configured, but there is no valid shipping policy for it, as the policies that would be valid have been configured only to deliver products with a modal.