{"section":"tutorials","requestedLocale":"en","requestedSlug":"shipping-simulation","locale":"en","slug":"shipping-simulation","path":"docs/en/tutorials/shipping/shipping-simulator/shipping-simulation.md","branch":"main","content":"The **Shipping Simulator** in the Admin simulates and analyzes available shipping options. The simulation checks the shipping conditions which enables the retailer to check availability of items, delivery methods, costs, and deadlines. \n\nThe simulator can also be used to validate the **[Shipping Strategy](/en/docs/tutorials/shipping-strategy)** settings before enabling the logistics process (Inventory, Dock, and [Shipping Policy](/en/docs/tutorials/shipping-policy)) considering:\n\n* **Item Availability**: the simulator checks if the item is in stock and whether it is possible to ship it (checks if there are carriers for that region, for example). If one of the criteria is not met, the simulator assumes that the item is unavailable.\n* **White Label Sellers Availability:** the simulator selects the white label seller that is closest to the shipping address (the logistics settings are calculated in the _White Label Seller’s_ environment, not in the main account). \n\n> ⚠️ There may be a discrepancy between the final price indicated by the simulator and the actual price in your store since the simulation does not take into account the following: <ul> <li>Promotions applied to the items. <li>Shipping discounts configured through promotions. <li>The Total Delivery Time shown in the simulation results does not take into account the field **Expected Delivery Date (pre-sale)**  [in the item’s information in the system.](/en/docs/tutorials/adding-or-editing-skus) </ul>\n\n## Simulating the shipping\n\n1. In the VTEX Admin, go to **Shipping > Shipping Strategy**, or type *Shipping Strategy* in the search bar at the top of the page.  \n 2. Click on `Shipping simulator`.\n 3. Select your `Country`.  \n 4. Select the desired `Trade Policy`.\n 5. Select the `product` by name or ID.  \n 6. Select the SKU `quantity`.  \n 7. Fill in the `Price`. This field is optional.\n\n > The simulator does not take into account the price registered in the Catalog module. Therefore, the calculation does not consider any current promotions for those SKUs, or shipping taxes for the shopping cart price, if there is any. This may result in a different rate from the real one in your store. To avoid this, we suggest that you manually enter the SKU’s exact rate with the applied promotions, which will make the simulator result more accurate.\n\n 8. Click on the `+` icon to add more than one product to the simulation.\nIf you want, you can check the `Simulate items individually` box.\n\n > This functionality is useful when items do not have compatible logistics configurations that allow shipping to be made by the same carrier.\n\n 9. Enter the **Zip code** for which you want to perform the simulation, or fill in the **Address**.\n\n > For the simulation to be made based on **Address** coordinates, it is necessary to configure a Google geolocation key. You can get this key on the [Google Developers Portal.](https://developers.google.com/maps/documentation/javascript/get-api-key) Once you have the key, go to **Store settings > Shipping > Settings**, or type *Shipping* in the search bar at the top of the page and select *Store settings / Shipping*. Fill in the **Google Geolocation API** field with the key.\n\n 10. Click on the `Shipping simulation` button.\n\n> ℹ️ The items measurements in the simulation result appear in centimeters and grams; however, the actual values for the Checkout are the measurement units registered in the SKU and [product registration fields](/en/docs/tutorials/adding-or-editing-products).\n\n## Simulation details\n\nThe shipping simulation shows all the shipping possibilities and availability for the items included in the simulation and describes [delivery details for an order](/en/docs/tutorials/order-details-page) or shipping cost and delivery time taking into account the factors below.\n\n* **Excluded carriers**: when running the simulation, some carriers may be unavailable because they do not meet the [Shipping Policy’s](/en/docs/tutorials/shipping-policy) criteria  (see[excluded carriers](#excluded-carrier) for more information).\n* **Simulation sharing**: the simulation can be shared by clicking `share shipping simulation` in the upper right corner of the page. When you click, a share link is copied to your clipboard. This feature makes it easy to get the VTEX team, or your store’s team, to resolve issues on specific orders. Only users who have access to the VTEX environment can view the share link.\n* **Shipping rate:** in simulations that have more than one SKU, the `shipping rate` is proportionally divided according to the weight of each SKU in the package. For example, consider a simulation with 2 SKUs (one weighs 2kg, and the other one weighs 3kg). Let us assume that the shipping rate with Carrier A is US 10 in total. In this case, the cost for the lighter SKU is US 4, and the cost for the heavier one is US 6. To learn more, check [How proportional shipping costs are calculated](/en/tutorial/como-e-feito-o-rateio-de-frete--frequentlyAskedQuestions_155?&utm_source=autocomplete).\n* **Package dimensions**: in simulations where the SKUs have more than 1 unit, the `dimensions` described next to the SKU on the simulation page do not change. The system will take into account that the total package dimensions increased.\n\n### Excluded carriers\n\n The most common reasons why a carrier is not available for simulation are listed below along with solutions for them. \n\n<table class=\"w-100 center mv7 bb b--gray\">\n    <thead class=\"w-100 center mv7 bb b--gray\">\n   <tr class=\"t-body fw5 c-muted-1 bb bw1 pa2 pb3 b--muted-3 tl\">\n            <th class=\"t-body fw5 c-muted-1 bb bw1 pa2 pb3 b--muted-3 tl\">\n                <em class=\"i\">**Reason**</em>\n            </th>\n            <th class=\"t-body fw5 c-muted-1 bb bw1 pa2 pb3 b--muted-3 tl\">\n                <em class=\"i\">Solution</em>\n            </th>\n      </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">The total weight of the cart exceeds the carrier limit.\n   </td>\n   <td class=\"t-body pa5\">You can meet the limit by using cargo splitting. See cargo splitting for more information. Also, check if there are any errors in the [product settings in the catalog](/en/docs/tracks/products-concept-definition).\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">The weight or size of the item is not supported by the carrier.\n   </td>\n   <td class=\"t-body pa5\">Check the settings in the s [hipping rate template](/en/docs/tutorials/shipping-rate-template) for the ***WeightStart***,***WeightEnd***, and ***MaxVolume*** fields. Also, check if there are any errors in the [ product settings in the catalog](/en/docs/tracks/products-concept-definition).\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">The weight of the kit exceeds the weight accepted by the carrier. Note: items that make up a kit or promotion cannot be separated into different packages.\n   </td>\n  <td class=\"t-body pa5\">Check the settings in the shipping rate template for the ***WeightStart*** and ***WeightEnd*** fields. Also, check if there are any errors in the [ product settings in the catalog](/en/docs/tracks/products-concept-definition)\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">Delivery scheduling options are not available.\n   </td>\n   <td class=\"t-body pa5\">Check the [ scheduled delivery](/en/docs/tutorials/scheduled-delivery)window settings and the hours of operation for the [shipping policy](/en/docs/tutorials/shipping-policy).The delivery windows may be blocked. Make sure that the correct windows are active.\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">The carrier does not offer service in that zip code.\n   </td>\n   <td class=\"t-body pa5\">Check the settings in the [shipping rate template](/en/docs/tutorials/shipping-rate-template) for the ***ZipCodeStart*** and ***ZipCodeEnd*** fields.You should also check the [shipping rates](/en/docs/tutorials/managing-shipping-rates) in the **Shipping** module.\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">The carrier was excluded due to priority criteria.\n   </td>\n   <td class=\"t-body pa5\">The priority criteria that the system calculates at checkout are:\n<ul>\n<li> Cheapest shipping.\n<li>Fastest shipping.\n<li>A combination of the best cost-benefit and shipping time.\n</ul>\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">The carrier is **inactive**.\n   </td>\n   <td class=\"t-body pa5\">Check the [shipping policy](/en/docs/tutorials/shipping-policy) in the system to make sure the carrier is active.\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">The price of the items does not meet carrier specifications.\n   </td>\n   <td class=\"t-body pa5\">Check the settings in the [shipping policy](/en/docs/tutorials/shipping-policy) to see the price limit that is accepted.\n   </td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">The carrier’s hours of operation do not meet the shipping schedule.\n   </td>\n   <td class=\"t-body pa5\">Check the hours of operation in the [shipping policy](/en/docs/tutorials/shipping-policy).\n </td>\n  </tr>\n</table>"}