--- title: "Promotion Calculator" slug: "promotion-calculator" description: "The user manual provides comprehensive guidance on using the Antavo Promotion Engine UI for managing promotions." updated: 2025-11-13T14:43:46Z published: 2025-11-13T14:43:46Z canonical: "docs.antavo.com/promotion-calculator" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.antavo.com/llms.txt > Use this file to discover all available pages before exploring further. # Promotion Calculator ### What is the Promotion Calculator? The **Promotion Calculator** is a dedicated page within the Promotion Engine that allows you to safely and quickly test**which configured promotions apply to a specific cart setup**. It enables you to verify your promotion rules **without creating real orders or affecting live data**. This tool helps you ensure your promotions work as expected in real business scenarios, provides**immediate feedback on valid promotions** for your test cart, and lets you experiment freely****since tests do not impact usage limits or reporting. > [!NOTE] > For a detailed explanation of how the engine evaluates, orders, and applies multiple promotions (including stacking logic, discount type priority, and prevention of invalid prices), see the [Discount Calculation](/engine/docs/discount-calculation) article. ### How to use it? #### 1. Build your cart On the left side of the page, create your test cart by entering the cart details. **Cart Request** - Enter a **Cart Id** or click**Generate Cart ID** to generate one. The system recognizes that the requests originate from the Calculator tool to avoid conflicts with real carts provided in cart requests. - Add the**Store Group** and **Store**where you want to test promotions. - Select a **rounding strategy**, options include: - Mathematical: All decimal values will be rounded according to general mathematical rounding rules. - Ceiling: All decimal values will be rounded up. - Floor: All decimal values will be rounded down. - Enter the**precision** value, the number of decimal places to use when rounding numbers (e.g., 2 means prices are rounded to 2 decimal places, like 12.34). - Select cart **currency.** Promotions might behave differently depending on currency configuration, so choose the one matching your test scenario. Price values of items within the cart will be considered in this currency. - Select the cart**timezone.** Time-based promotions depend on timezone settings for accurate activation and expiry times, so choose the timezone relevant to your test case. **Cart items** - Click**Add Cart Item +** to start adding an item to the cart. You must add at least one product to the cart. - Enter the cart item**product category**for the item you are adding. This helps the system identify the product’s classification, which can affect promotion eligibility. - Enter the specific **product**. This uniquely identifies the product you want to test within the cart. - Specify how many units (**quantity**) of the product you want in the cart. This number affects promotions that depend on quantity thresholds. - Enter the **price** for a single unit of the product before tax. The currency will always match the cart currency you selected earlier. - Enter the **tax** amount applied to a single unit of the product. This also uses the cart currency. You can use the **Add Cart Item +** to add further items to the cart. **Promo Code** If your promotion requires a promo code, enable this option and enter the code here. This lets you test promotions that only activate when a specific code is used. ![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/calculator.png) #### 2. Run the test - Once your cart details are complete, click the **Calculate** button to see which promotions apply. The Promotion Engine will recognize this as a test, so it will: - **Not save the request data in the database** - **Exclude this request from usage counts and reports** To understand how promotions are selected, prioritized, and combined during this step, see [**Discount Calculation**](/engine/docs/discount-calculation) for a detailed explanation of the evaluation logic and ordering process used by the engine. #### 3. View results On the right side of the page, the **Show Discounts** view displays the list of promotions applicable to your test cart, along with details on how they would apply. You can switch to the **Show Response** view to see the full JSON response that would be returned by the [/cart](https://developers.antavo.com/reference/post_v1-cart#/) Promotion Engine API endpoint for a request with the provided details. Use the toggle button to switch back and forth between **Show Discounts** and **Show Response** views anytime. This allows you to easily review both a user-friendly summary of applicable promotions and the exact API response for deeper inspection. ![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/applicable_promotions.png) Show Discounts view ![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/cart_reponse.png) Show response view ### Tips for effective testing with the Calculator - Use realistic cart data that closely resembles what your customers purchase to get accurate results. - Test different promo codes, product combinations, quantities, and prices to cover as many scenarios as possible. - After updating or creating new promotion rules, run tests regularly to catch configuration errors early. - Try testing recurring promotions with different dates and times to verify timing settings work as expected. - If a promotion is not applying as expected, double-check store and store group settings, currency, and timezone selections in your test cart. - Remember, tests do not affect your live promotion limits or analytics.