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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

للمطوّرين — الوصول عبر 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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

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