ForHosting KIT · المنزل والطبخ والهوايات

حاسبة خصم اشترِ واحصل

عند شراء خمس قطع في عرض اشترِ واحدة واحصل على أخرى، تدفع ثمن ثلاث وتحصل على اثنتين دون مقابل، ويكون الخصم الفعلي 40 بالمئة. أدخل سعر القطعة والكمية ورقمي العرض لترى الخصم والمبلغ المستحق. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

سعر الوحدة: 10
الكمية: 5
كمية الشراء: 1
كمية المجاني: 1

تحصل على

حجم المجموعة: 2
دورات العرض: 2
الباقي: 1
العناصر المدفوعة: 3

تبدو عروض التجزئة مثل اشترِ واحدًا واحصل على واحد مجانًا، واشترِ اثنين واحصل على واحد، وغيرها من ملصقات اشترِ-X-احصل-على-Y-مجانًا بسيطة على الرف وتصبح ضبابية عند الصندوق عندما لا تكون كمية السلة مضاعفًا نظيفًا لدورة العرض. يريد المتسوقون رقمًا صادقًا واحدًا: ما نسبة الخصم الفعالة التي أحصل عليها فعلًا، وما الإجمالي المستحق بعد تطبيق العناصر المجانية. تأخذ هذه الحاسبة سعر قائمة وحدويًا وكمية صندوق وX وY لعرض اشترِ-X-احصل-على-Y-مجانًا، وتعد كم عنصرًا مجانيًا مقابل مدفوعًا وفق نموذج الدورات الكلاسيكي، وتعيد إجمالي القائمة والإجمالي المستحق والتوفير ونسبة الخصم الفعالة. تُرفض الكميات غير الموجبة بخطأ تحقق واضح حتى لا تصبح السلات العبثية خصومات زائفة.

كيف تُحسب نسبة خصم اشترِ-X-احصل-على-Y

ابدأوا من سعر قائمة وحدوي واحد بعملة واحدة. ثم اختاروا quantity، عدد تلك العناصر المتطابقة التي تأخذونها إلى الصندوق، ويجب أن يكون عددًا صحيحًا موجبًا لأن الصندوق يعد وحدات كاملة. حجم مجموعة العرض هو X+Y.

دورات العرض الكاملة تساوي floor الصحيح لـ quantity مقسومًا على حجم المجموعة، والباقي quantity modulo حجم المجموعة. العناصر المجانية تساوي الدورات الكاملة×Y زائد باقي مجاني max(0, الباقي−X): ما زلتم تدفعون أول X من مجموعة ناقصة، وفقط العناصر بعد X في ذلك الباقي تصبح مجانية حتى Y لكل دورة كاملة. العناصر المدفوعة تساوي quantity ناقص المجانية.

نسبة الخصم الفعالة مئة×التوفير÷إجمالي القائمة عندما يكون إجمالي القائمة موجبًا، وصفر عندما يكون صفرًا حتى لا تخترع بضائع قائمة مجانية Infinity. القدرة لا تكدس كوبونات ولا تطبق ضريبة مبيعات ولا تنمذج سلات متعددة SKU مختلطة حيث تهم قاعدة الأرخص مجانًا ولا تحوّل العملات؛ تلك نوايا منتج منفصلة بصفحاتها عند اتساع التغطية.

أين تظهر حاسبات BOGO في العمل الحقيقي

يقارن متسوقو البقالة والملابس باستمرار ملصقات اشترِ واحدًا واحصل على واحد مع مبيعات النسبة المئوية ويحتاجون نسبة خصم فعالة تراعي أن حجم السلة لا يقع على مضاعف نظيف لدورة العرض. يريد التجار ومشغّلو التجارة الإلكترونية الذين يبنون صفحات العروض إجماليًا مستحقًا شفافًا حتى يطابق التوفير المعلن الصندوق ولا ترتفع المرتجعات من سوء فهم قواعد المجاني. تحوّل الصحافة ومواقع المقارنة التي تقيّم عروض السوبرماركت الأسبوعية عروض الرف إلى رقم نسبة خصم واحد ليصنّف القرّاء العروض بعدل.

إن احتجتم لاحقًا سلات متعددة SKU بأرخص مجانًا أو محركات كوبون مكدسة أو مجاميع شاملة للضريبة أو تحويل عملات متعددة، عاملوها كنوايا بحث وصفحات منفصلة بدل إثقال صفحة حاسبة خصم اشترِ واحصل هذه.

حالات الاستخدام

BOGO الرف مقابل مبيعات النسبة

حوّلوا ملصقات اشترِ-X-احصل-على-Y إلى نسبة خصم فعالة لكمية سلة حقيقية لمقارنتها بعروض نسبة ثابتة.

فحوصات صدق صفحات العروض

احسبوا الإجماليات المستحقة وأعداد المجاني لعروض BOGO المعلنة حتى تطابق صفحات التاجر حساب الصندوق.

الأسئلة الشائعة

كيف يعمل عد العناصر المجانية في اشترِ-X-احصل-على-Y؟

كل مجموعة كاملة من X+Y تمنح Y مجانًا. للباقي r الإضافات المجانية max(0, r − X). المدفوعة = quantity − المجانية.

ما نسبة الخصم الفعالة؟

هي النسبة الحقيقية عن القائمة بعد المجاني، لا ادعاء رف اسمي.

هل تتعامل مع أسعار مختلطة أو سلات متعددة SKU؟

قواعد «الأرخص مجانًا» متعددة SKU والكوبونات المكدسة خارج نطاق هذه الحاسبة.

لماذا لا أوفّر النصف عند شراء خمس قطع؟

لأن القطعة الخامسة تبدأ مجموعة جديدة لا تكتمل، وفي المجموعة غير المكتملة تدفع أولًا ثمن قطع الشراء. لذلك تدفع ثمن ثلاث من خمس قطع، فيكون الخصم الفعلي 40 بالمئة.

هل تدخل القسائم أو الضرائب في الحساب؟

لا. لا تجمع الحاسبة القسائم ولا تضيف ضريبة ولا تحوّل العملات. فهي تعمل بسعر واحد لقطع متطابقة وتعرض الخصم الناتج عن العرض وحده.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/life/bogo-discount

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/life/bogo-discount \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"unit_price":10,"quantity":5,"buy_qty":1,"free_qty":1}'

const res = await fetch("https://api.kit.forhosting.com/life/bogo-discount", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "unit_price": 10,
    "quantity": 5,
    "buy_qty": 1,
    "free_qty": 1
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/life/bogo-discount",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "unit_price": 10,
    "quantity": 5,
    "buy_qty": 1,
    "free_qty": 1
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/bogo-discount", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"unit_price":10,"quantity":5,"buy_qty":1,"free_qty":1}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"unit_price":10,"quantity":5,"buy_qty":1,"free_qty":1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/bogo-discount", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "unit_price": 10,
  "quantity": 5,
  "buy_qty": 1,
  "free_qty": 1
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "life.bogo_discount",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

كيف تُحسب نسبة خصم اشترِ-X-احصل-على-Y

ذلك الرقم هو unit_price: سعر الرف لعنصر متطابق قبل العرض، محفوظ بوحدة واحدة لكل الحساب حتى لا تتسلل تحويلات عملة صامتة. ثم عيّنوا buy_qty إلى X وfree_qty إلى Y لنص العرض اشترِ X واحصل على Y مجانًا. اشترِ واحدًا واحصل على واحد الكلاسيكي هو X=1 وY=1؛ واشترِ اثنين واحصل على واحد هو X=2 وY=1. إجمالي القائمة unit_price×quantity؛ الإجمالي المستحق unit_price×المدفوعة؛ التوفير إجمالي القائمة ناقص المستحق. المسار حساب فاصلة عائمة حتمي: بلا بذور عشوائية ولا طوابع ساعة ولا شبكة ولا انحراف نموذج، فنفس المدخلات تنتج دائمًا نفس JSON. يجب أن تكون quantity وbuy_qty وfree_qty أعدادًا صحيحة موجبة منتهية؛ الصفر أو السالب يفشل بـ invalid_input بدل اختراع خصم. unit_price السالب يفشل؛ والصفر مسموح ويعطي مجاميع ونسبة خصم صفر.

ما ترسلونه وما يعود

فحوصات كلاسيكية: سعر وحدة 10 وكمية 5 تحت اشترِ واحدًا واحصل على واحد: مجاني 2 ومدفوع 3 وقائمة 50 ومستحق 30 وتوفير 20 وخصم 40٪. وأخرى: سعر 12 وكمية 7 تحت اشترِ اثنين واحصل على واحد: مجاني 2 ومدفوع 5 وقائمة 84 ومستحق 60 وتوفير 24 وخصم نحو 28.57. أرسلوا أربعة حقول إلزامية. unit_price عدد منتهٍ أكبر من أو يساوي صفرًا لسعر قائمة عنصر واحد. quantity عدد صحيح موجب لعدد العناصر. buy_qty عدد صحيح موجب X لجانب الدفع في دورة العرض. free_qty عدد صحيح موجب Y لعناصر مجانية بعد كل كتلة دفع كاملة من X. الحقول الناقصة والسلاسل غير الرقمية وNaN وInfinity وحقول الكمية الكسرية والكميات الصفرية أو السالبة وunit_price السالب تفشل بـ invalid_input ولا تُحاسب. عند النجاح تعيد الاستجابة unit_price وquantity وbuy_qty وfree_qty منظفة، وتبلغ group_size كـ X+Y وdeal_cycles كمجموعات كاملة وremainder كعناصر متبقية وpaid_items وfree_items كتقسيم الصندوق وlist_total وpayable_total وsavings كمبالغ بنفس الوحدة وdiscount_percent كنسبة فعالة على إجمالي القائمة. deal_label سلسلة بشرية قصيرة مثل اشترِ 1 واحصل على 1 مجانًا، وmethod هو bogo_discount، وformula توثق free_items = floor(quantity/(X+Y))×Y + max(0, remainder−X) حتى تقتبس المدونات ورسائل العرض نفس التعبير. طلب كمية صفرية أو سالبة يفشل بـ invalid_input صارم يذكر الكميات غير الموجبة. تسعير استدعاءات API الناجحة هو الأساس المنشور $0.002 لكل عنصر؛ إخفاقات التحقق لا تستهلك الرصيد المدفوع مسبقًا.

أين تظهر حاسبات BOGO في العمل الحقيقي

يكلّف معلمو المالية الشخصية الذين يدرّسون رياضيات المستهلك أوراق BOGO ويحتاجون JSON حتميًا للمصححين الآليين بدل مجاميع يدوية تنحرف بالتقريب. تعيد فرق المنتج التي تشحن ودجات السلة استخدام نفس حساب الدورات في المتصفح وAPI حتى لا تختلف النماذج غير المتصلة والإنتاج. لأن هذه القدرة محرك parse نقي، تسعير API هو الأساس المنشور $0.002 لكل عنصر ناجح والتحقق الفاشل لا يستهلك الرصيد.

حالات التكامل

fixtures رياضيات المستهلك والمصححات الآلية

أنتجوا بالجملة إجماليات قائمة مقابل مستحق لمسائل BOGO الصفية وارفضوا الكميات غير الموجبة بـ invalid_input صارم.

أسئلة تقنية

ما المدخلات المرفوضة؟

quantity أو buy_qty أو free_qty غير موجبة أو غير صحيحة؛ unit_price سالب؛ حقول ناقصة؛ NaN أو Infinity. تفشل بـ invalid_input ولا تُحاسب.

كم التكلفة؟

أداة المتصفح مجانية وتعمل محليًا. طلبات API تستخدم رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل عنصر ناجح؛ الإدخال غير الصالح لا يُحاسب.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

مثال محلول

كيف تُحسب نسبة خصم اشترِ-X-احصل-على-Y

أين تظهر حاسبات BOGO في العمل الحقيقي

حالات الاستخدام

BOGO الرف مقابل مبيعات النسبة

فحوصات صدق صفحات العروض

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الأخطاء

ملاحظات تقنية

كيف تُحسب نسبة خصم اشترِ-X-احصل-على-Y

ما ترسلونه وما يعود

أين تظهر حاسبات BOGO في العمل الحقيقي

حالات التكامل

fixtures رياضيات المستهلك والمصححات الآلية

أسئلة تقنية

شكرًا