omni_bogo_buy_one_get_one_margin
Calculate real profit margin dilution for Buy One Get One Free or BOGO 50% Off promotions versus normal sales using unit price, COGS, discount depth, and shipping costs.
Instructions
BOGO (Buy One Get One) Promotional Profit Margin Calculator. Calculate the real profit margin dilution of Buy One Get One promotions (BOGO Free vs BOGO 50% Off) against normal non-discounted sales. Discipline: ECOMMERCE. Governing mathematical model / formula: Average Unit Realized Price = [Full Price + (Full Price × (1 - Discount Depth %))] / 2 | Margin % = (Profit / Revenue) × 100.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_bogo_checkout_price (Customer BOGO Checkout Total), combined_bogo_profit (Combined Net Profit (2 Units)), blended_realized_margin_pct (Effective Gross Profit Margin (%)), effective_price_per_item (Realized Average Price Per Unit) using single_unit_retail_msrp (Full Single Unit Retail MSRP in $), single_unit_cogs (Single Unit Manufacturing Cost (COGS) in $), bogo_second_unit_discount_pct (Second Item Discount Depth (%) in %), combined_fulfillment_shipping_cost (Combined Two-Unit Shipping Cost in $). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'BOGO (Buy One Get One) Promotional Profit Margin Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "bogo-buy-one-get-one-margin"
category (string): "ecommerce"
name (string): "BOGO (Buy One Get One) Promotional Profit Margin Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.total_bogo_checkout_price (Customer BOGO Checkout Total): Formatted display string (e.g. '$48.00 (2 Units)')
metrics.combined_bogo_profit (Combined Net Profit (2 Units)): Formatted display string (e.g. '+$16.80 Net Profit')
metrics.blended_realized_margin_pct (Effective Gross Profit Margin (%)): Formatted display string (e.g. '35.0%')
metrics.effective_price_per_item (Realized Average Price Per Unit): Formatted display string (e.g. '$24.00 / unit')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_bogo_buy_one_get_one_margin"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| single_unit_cogs | No | Single Unit Manufacturing Cost (COGS) ($). Landed wholesale cost per unit. Default: 11.5. Min: 1. Max: 200. | |
| single_unit_retail_msrp | No | Full Single Unit Retail MSRP ($). Normal selling price for one unit. Default: 48. Min: 5. Max: 500. | |
| bogo_second_unit_discount_pct | No | Second Item Discount Depth (%) (%). 100% = Buy One Get One Free; 50% = Buy One Get One Half Off. Default: 100. Min: 25. Max: 100. | |
| combined_fulfillment_shipping_cost | No | Combined Two-Unit Shipping Cost ($). Shipping cost to send two units in single package. Default: 8.2. Min: 2. Max: 50. |