ForHosting KIT · أدوات المطورين

حاسبة خصم حزمة المنتجات: السعر والتوفير

قد يبدو خصم الحزمة بسيطًا، لكن تعدد الأسعار والكسور والنسب الترويجية يتطلب تطابقًا دقيقًا بين واجهة المتجر وعرض السعر وصفحة الدفع.

● Betaمجاني · داخل متصفحك

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

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

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

أدخلوا أسعار المنتجات المشمولة في الحزمة

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

طبقوا الخصم وافهموا النتيجة

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

استخدموا الحساب في التسعير والأتمتة

قارنوا سعر الحزمة المحسوب بالتكلفة وهامش الربح المستهدف والعروض الحالية قبل نشر العرض. يفيد مبلغ التوفير في رسائل مثل «وفروا 15.00»، بينما يوفر المجموع الفرعي سعرًا مرجعيًا واضحًا. تستطيع فرق التجارة اختبار نسب مختلفة، ويمكن للمطورين استخدام API للتأكد من أن صفحة المنتج ونظام الدفع يطبقان العملية الحسابية نفسها. تبلغ تكلفة كل طلب عبر API مقدار $0.002، أما نسخة المتصفح فتصلح للفحص التفاعلي السريع. تقتصر الحاسبة على التخفيض النسبي من مجموع الأسعار الفردية؛ فلا تضيف الضرائب أو الشحن أو القسائم الثابتة أو الخصومات المتدرجة أو عروض الوحدات المجانية أو تحويل العملات. طبقوا تلك القواعد منفصلة وبالترتيب الصحيح لمتجركم. ولأن سياسات التقريب تختلف بين منصات التجارة، تحققوا مما إذا كان نظام الدفع يقرب مرة واحدة على مستوى الحزمة أم لكل بند؛ تقرب هذه الأداة المبالغ النهائية على مستوى الحزمة.

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

تخطيط حزمة موسمية

اختبروا عرضًا بنسبة مئوية على أسعار الكتالوج واعرفوا فورًا سعر العرض وقيمة التوفير المعلنة.

التحقق من أسعار المتجر

قارنوا الحساب المتوقع بالمجموع الفرعي والتوفير والسعر النهائي الظاهر في صفحة المنتج أو عند الدفع.

أتمتة عمليات التجارة

أنشئوا أسعار حزم متسقة من قوائم أسعار المنتجات قبل إرسال العروض المعتمدة إلى الكتالوجات أو الأدوات الداخلية.

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

كيف يُحسب سعر الحزمة؟

تُجمع الأسعار الفردية، وتُطبق نسبة الخصم على المجموع الفرعي، ثم يُطرح مبلغ التوفير الناتج منه.

ماذا يحدث إذا تجاوز الخصم 100%؟

يُرفض الطلب لأن نسبة خصم أعلى من 100% ستؤدي إلى سعر حزمة سالب.

هل يمكن استخدام أي عملة؟

نعم، بشرط استخدام العملة نفسها لجميع العناصر. لا تنفذ الأداة أي تحويل للعملات.

هل تشمل النتيجة الضرائب والشحن؟

لا. أدخلوا الأسعار المناسبة ثم احسبوا الضرائب والشحن والقسائم والتعديلات الأخرى بصورة منفصلة.

كم تبلغ تكلفة الحساب عبر API؟

تبلغ تكلفة كل طلب عبر API مقدار $0.002. ويمكنكم أيضًا إجراء الحساب مجانًا في المتصفح على هذه الصفحة.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/ecom/product-bundle-discount

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

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

curl -X POST https://api.kit.forhosting.com/ecom/product-bundle-discount \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_prices":[19.99,12.5,7.51],"discount_percentage":20}'

const res = await fetch("https://api.kit.forhosting.com/ecom/product-bundle-discount", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "item_prices": [
      19.99,
      12.5,
      7.51
    ],
    "discount_percentage": 20
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ecom/product-bundle-discount",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "item_prices": [
        19.99,
        12.5,
        7.51
    ],
    "discount_percentage": 20
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/product-bundle-discount", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"item_prices":[19.99,12.5,7.51],"discount_percentage":20}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"item_prices":[19.99,12.5,7.51],"discount_percentage":20}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/product-bundle-discount", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "item_prices": [
    19.99,
    12.5,
    7.51
  ],
  "discount_percentage": 20
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.product_bundle_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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

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