{"uid":"cap_HVOMa_rO_ESXT3CFHywp8","slug":"buy-x-get-y-free-merchandise-total-batch-calculation-390bbcef","name":"Buy-X-Get-Y-Free Merchandise Total — Batch Calculation","description":"Buy-X-get-Y-free merchandise total - Batch calculation: Batch 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 batch calculation report.","url":"https://market.datapackvibe.com/x402/assistant-ar-retail-multibuy-price-batch?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","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},"default":[{"unit_price":25,"basket_units":10,"free_units_per_group":1,"paid_units_per_group":2},{"unit_price":27.500000000000004,"basket_units":11,"free_units_per_group":1,"paid_units_per_group":2}],"maxItems":200,"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_xHML_l8joDGeJq_gGaFb_","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 effective merchandise total for Buy-X-Get-Y-Free promotions across a batch of up to 200 retail line items, given unit prices, basket quantities, and deal group parameters.","exampleAgentPrompt":"Calculate the buy-2-get-1-free merchandise totals for these 3 product lines: 10 units at $25 each, 15 units at $18 each, and 8 units at $40 each — all with buy 2 get 1 free pricing.","exampleUseCases":[{"title":"Promotional pricing for product catalog","prompt":"I have 50 product lines all running a buy-3-get-1-free promotion — unit prices range from $10 to $120 and basket sizes vary. Can you batch-calculate the effective merchandise totals for all of them?"},{"title":"Checkout discount validation for retail basket","prompt":"A customer has 10 units of a $25 item in their cart with a buy-2-get-1-free deal. What's the total merchandise cost they should be charged?"},{"title":"Comparing multibuy deal structures across SKUs","prompt":"I want to compare buy-2-get-1-free vs buy-3-get-1-free outcomes for 5 SKUs — each has different unit prices and basket quantities. Can you run the batch calculation for all 10 rows?"}],"resultDescription":"A bounded batch calculation report containing the effective merchandise total for each supplied row, factoring in the buy-X-get-Y-free deal structure (paid units per group, free units per group, basket quantity, and unit price). Returns one result record per input row, up to 200 rows per call.","failureModes":["Row missing required fields (basket_units, paid_units_per_group, free_units_per_group, unit_price) — validation error returned","paid_units_per_group set to 0 — fails minimum constraint of 1","Batch exceeds 200 rows — rejected with maxItems error","unit_price or basket_units out of allowed range — schema validation failure","Malformed JSON body — 400 bad request","Payment not fulfilled via x402 protocol — 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need to compute effective retail totals for Buy-X-Get-Y-Free promotions in bulk (up to 200 rows) using only supplied figures — no live pricing feeds, platform integrations, or order execution involved. Ideal for offline pricing simulations, promotional validation, or building discount logic into a retail agent pipeline. Prefer this over single-row calculations when processing multiple SKUs or basket configurations simultaneously.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T00:38:46.094Z","isFirstParty":false,"canonicalSlug":"buy-x-get-y-free-merchandise-total-batch-calculation-390bbcef"}