ForHosting KIT · المال والتمويل

احسب المبلغ المتبقي للحصول على الشحن المجاني

أخبروا المتسوق بدقة كم ينقصه حتى لا يدفع رسوم الشحن: سلة قيمتها 42.50 مع حد قدره 60 تحتاج إلى 17.50 إضافية، والسلة التي بلغت الحد تحصل على صفر. مجانا في متصفحكم.

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

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

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

مثال محلول

إذا أدخلت

الإجمالي الحالي: 42.5
حد الشحن المجاني: 60

تحصل على

المبلغ المطلوب: 17.5

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

احسب الإنفاق المتبقي من قيمتين

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

لا تطلب الأداة رمز العملة لأن عملية الطرح واحدة في جميع العملات، لكن عليك تنسيق النتيجة بالرمز والمنازل العشرية المناسبة. ولا تجري الأداة بحثاً في الكتالوج أو تحويلاً للعملات أو تقريباً خفياً يغيّر القيم المرسلة.

تعامل بصورة صحيحة مع السلال المؤهلة بالفعل

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

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

حوّل النتيجة إلى رسالة مفيدة في السلة

تعامل مع الرقم المعاد بوصفه نتيجة حساب، ثم طبّق قواعد العرض والتسويق الخاصة بمتجرك. يمكن تحويل الفرق الموجب إلى رسالة مثل «أضف 12.00 أخرى للحصول على الشحن المجاني»، مع تنسيق العملة واللغة المناسب. ويمكن للصفر تفعيل رسالة «لقد تأهلت للشحن المجاني».

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

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

رسالة تقدم داخل السلة

اعرض للعميل المبلغ المؤهل الدقيق الذي ما زال مطلوباً للحصول على الشحن المجاني.

التحقق من الأهلية عند الدفع

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

إجابات فريق خدمة العملاء

زوّد الموظفين بحساب سريع وقابل للتكرار عندما يسأل العميل عن سبب استمرار رسوم الشحن.

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

ماذا يحدث إذا كانت السلة مؤهلة بالفعل؟

بلوغ الحد أو تجاوزه نتيجة ناجحة وليس خطأ.

هل تشمل الحاسبة الضرائب أو الخصومات؟

طبّق مسبقاً قواعد متجرك المتعلقة بالأهلية والضرائب والخصومات والاستبعادات.

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

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

ما المدخلات التي تُرفض؟

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

هل تقرب الحاسبة المبلغ المتبقي؟

لا. تطرح الحاسبة قيمة السلة من الحد وتعيد الفرق كما هو، فطرح 42.50 من 60 يعطي 17.50. أما رمز العملة وعدد المنازل العشرية فتضبطها صفحة السلة أو صفحة الدفع لديكم.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/ecom/free-shipping-threshold-gap

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

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

curl -X POST https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"current_total":42.5,"free_shipping_threshold":60}'

const res = await fetch("https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "current_total": 42.5,
    "free_shipping_threshold": 60
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "current_total": 42.5,
    "free_shipping_threshold": 60
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"current_total":42.5,"free_shipping_threshold":60}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"current_total":42.5,"free_shipping_threshold":60}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "current_total": 42.5,
  "free_shipping_threshold": 60
}

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

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

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

احسب الإنفاق المتبقي من قيمتين

أدخل إجمالي السلع الحالي في current_total، والقيمة الدنيا المطلوبة في free_shipping_threshold. تطرح الحاسبة الإجمالي الحالي من الحد وتعيد الفرق في amount_needed.

تعامل بصورة صحيحة مع السلال المؤهلة بالفعل

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

حوّل النتيجة إلى رسالة مفيدة في السلة

قبل الاستدعاء، احسب current_total من المنتجات المؤهلة للعرض فقط. تبلغ كلفة كل طلب API مقدار $0.002، في حين تنفذ نسخة المتصفح الحساب النقي نفسه مجاناً، مما يسهّل تدقيقه واختباره ودمجه.

أسئلة تقنية

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

تبلغ كلفة كل طلب API مقدار $0.002. وتنفذ نسخة المتصفح الحساب الحتمي نفسه مجاناً.

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

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

مثال محلول

احسب الإنفاق المتبقي من قيمتين

تعامل بصورة صحيحة مع السلال المؤهلة بالفعل

حوّل النتيجة إلى رسالة مفيدة في السلة

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

رسالة تقدم داخل السلة

التحقق من الأهلية عند الدفع

إجابات فريق خدمة العملاء

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

احسب الإنفاق المتبقي من قيمتين

تعامل بصورة صحيحة مع السلال المؤهلة بالفعل

حوّل النتيجة إلى رسالة مفيدة في السلة

أسئلة تقنية

شكرًا