{"uid":"cap_vp0T0RA5X431zI1q9pTjJ","slug":"buy-x-get-y-free-merchandise-total-named-scenario-comparison-a4212eb6","name":"Buy-X-Get-Y-Free Merchandise Total — Named Scenario Comparison","description":"Buy-X-get-Y-free merchandise total - Named scenario comparison: Named scenario comparison for Buy-X-get-Y-free merchandise total. Supplied retail figures only, up to 200 records. No platform access, live rates or order execution. One of 25 new profiles across 20 shared operations in this industry. 0.01 USDC includes one bounded named scenario comparison report.","url":"https://market.datapackvibe.com/x402/assistant-ar-retail-multibuy-price-scenario?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"baseline":{"type":"object","default":{"unit_price":25,"basket_units":10,"free_units_per_group":1,"paid_units_per_group":2},"required":["basket_units","paid_units_per_group","free_units_per_group","unit_price"],"properties":{"unit_price":{"type":"number","default":25,"maximum":1000000000000,"minimum":0},"basket_units":{"type":"integer","default":10,"maximum":1000000,"minimum":0},"free_units_per_group":{"type":"integer","default":1,"maximum":1000000,"minimum":0},"paid_units_per_group":{"type":"integer","default":2,"maximum":1000000,"minimum":1}},"additionalProperties":false},"scenarios":{"type":"array","items":{"type":"object","required":["label","overrides"],"properties":{"label":{"type":"string","maxLength":80,"minLength":1},"overrides":{"type":"object","properties":{"unit_price":{"type":"number","default":25,"maximum":1000000000000,"minimum":0},"basket_units":{"type":"integer","default":10,"maximum":1000000,"minimum":0},"free_units_per_group":{"type":"integer","default":1,"maximum":1000000,"minimum":0},"paid_units_per_group":{"type":"integer","default":2,"maximum":1000000,"minimum":1}},"minProperties":1,"additionalProperties":false}},"additionalProperties":false},"default":[{"label":"Supplied alternative","overrides":{"basket_units":11}}],"maxItems":20,"minItems":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Vx8fAUGSXh8jY5VcV4Gg1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares named retail pricing scenarios for buy-X-get-Y-free promotions, calculating merchandise totals across a baseline and up to 20 labeled override scenarios.","exampleAgentPrompt":"Compare three buy-X-get-Y-free scenarios for a product priced at $25 per unit with a basket of 10 units: baseline is buy 2 get 1 free, then compare buy 3 get 1 free labeled 'Conservative Promo', and buy 1 get 1 free labeled 'Aggressive BOGO'.","exampleUseCases":[{"title":"Retail promo structure evaluation","prompt":"I'm deciding between buy-2-get-1-free and buy-3-get-1-free for my $40 unit-price product with a typical basket of 12 units — can you compare those two scenarios against my current buy-2-get-1-free baseline and tell me the merchandise totals for each?"},{"title":"BOGO vs standard multibuy comparison","prompt":"Model three promotion structures for a $15 item where customers usually buy 8 units: baseline is buy 3 get 1 free, then compare buy 1 get 1 free labeled 'BOGO Deal' and buy 4 get 1 free labeled 'Light Discount' — what are the merchandise totals for each?"},{"title":"Basket size sensitivity across deals","prompt":"I want to see how a buy-2-get-1-free deal at $20 per unit holds up across different basket sizes — compare a baseline of 10 units against a scenario labeled 'Small Basket' with 6 units and one labeled 'Large Basket' with 20 units."}],"resultDescription":"A named scenario comparison report containing the merchandise total for the baseline configuration and each labeled override scenario, showing the financial impact of different buy-X-get-Y-free promotional structures across up to 20 named scenarios. No live rates, order execution, or platform data is included.","failureModes":["Validation error if paid_units_per_group is less than 1","Error if scenarios array is empty or exceeds 20 items","Error if scenario label exceeds 80 characters or is empty","Error if overrides object has no properties specified","Numeric overflow if unit_price or basket_units exceed maximums","Malformed request if required baseline fields (basket_units, paid_units_per_group, free_units_per_group, unit_price) are missing"],"whenToPreferThis":"Choose this endpoint when you need to compare multiple named buy-X-get-Y-free promotional structures side-by-side using supplied retail figures, without needing live pricing data or order execution. Ideal for offline retail promotion modeling, pricing team reports, and scenario planning where up to 20 labeled configurations must be evaluated against a common baseline. Prefer this over generic discount calculators when the multibuy (quantity-gated free units) mechanic is specifically required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T19:08:56.482Z","isFirstParty":false,"canonicalSlug":"buy-x-get-y-free-merchandise-total-named-scenario-comparison-a4212eb6"}