{"uid":"cap_dJvQFlXXcR2RARgTiIoj6","slug":"buy-x-get-y-free-merchandise-total-target-gap-calculator-20a585eb","name":"Buy-X-Get-Y-Free Merchandise Total — Target Gap Calculator","description":"Buy-X-get-Y-free merchandise total - Target gap calculation: Target gap calculation 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 target gap calculation report.","url":"https://market.datapackvibe.com/x402/assistant-ar-retail-multibuy-price-target-gap?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"target":{"type":"number","default":100,"maximum":1000000000000000000,"minimum":-1000000000000000000},"values":{"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}}},"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_hW-wX4t658UozUReZiXmP","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":"Calculates the gap between a target revenue figure and the actual merchandise total under a buy-X-get-Y-free promotional pricing structure.","exampleAgentPrompt":"I'm running a buy-2-get-1-free promotion with a unit price of $25, a basket of 10 units, and a revenue target of $100 — can you calculate the merchandise total and tell me how far off the target I am?","exampleUseCases":[{"title":"Promotional shortfall check before campaign launch","prompt":"We're launching a buy-3-get-1-free deal at $40 per unit for a basket of 12 units. Our target is $400 — can you tell me how big the gap is between our promotional total and that target?"},{"title":"BOGO pricing impact on weekly revenue goal","prompt":"I'm doing a buy-1-get-1-free promotion with a unit price of $15 and we expect to sell 20 units this week. Our weekly target is $200 — calculate the merchandise total and the target gap for me."},{"title":"Multibuy deal optimization for a sales target","prompt":"If I sell 50 units at $8 each under a buy-2-get-1-free structure, what's my effective merchandise total and how far does that put me from a $250 target?"}],"resultDescription":"Returns a bounded target gap calculation report showing the effective merchandise total under the buy-X-get-Y-free promotion (accounting for free units) and the numerical gap between that total and the supplied target figure. Limited to supplied retail figures only; no live rates, platform access, or order execution.","failureModes":["Invalid basket_units (negative or non-integer) returns a validation error","paid_units_per_group of zero is not permitted (minimum 1) and will be rejected","Target or unit_price values outside allowed numeric bounds return a schema error","Requests exceeding 200 records are not supported","Missing required fields (basket_units, paid_units_per_group, free_units_per_group, unit_price) return a 422 error","Payment failure or insufficient USDC balance prevents report generation"],"whenToPreferThis":"Choose this endpoint when you need a quick, bounded calculation of the effective merchandise total and revenue gap for a buy-X-get-Y-free retail promotion against a known target. It is purpose-built for multibuy promotional arithmetic (not general discount or coupon types) and is ideal for pre-campaign analysis, reporting, or agent-driven retail planning workflows where live order execution is not needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:47:22.359Z","isFirstParty":false,"canonicalSlug":"buy-x-get-y-free-merchandise-total-target-gap-calculator-20a585eb"}