حاسبة رسوم وقود الشحن
حوّلوا أجرة الشحن الأساسية ونسبة الوقود الحالية إلى المبلغ الذي تفوترونه: أساس قدره 48.5 بنسبة 12.5 % يضيف رسوما قدرها 6.06 ليصبح إجمالي الشحن 54.56. أنتم تدخلون الرقمين ولا يستعلم عن أي جدول. مجانا في متصفحكم.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- السعر الأساسي
- 48.5
- النسبة الإضافية (%)
- 12.5
- مبلغ الرسوم الإضافية
- 6.06
- إجمالي الشحن
- 54.56
تنشر شركات النقل وشبكات الطرود رسوم الوقود كنسبة مئوية من رسوم النقل الأساسية، لذا فإن المبلغ الذي تفوتره للعميل ليس مجرد تعريفة القائمة من جدول المناطق. تحتاج فرق العمليات وبائعو الأسواق ووسطاء الشحن إلى خطوة حتمية واحدة تحوّل أجرة أساسية معروفة ونسبة الوقود الحالية إلى مبلغ الرسوم وإجمالي الشحن الشامل.
كيف تحوّل رسوم الوقود النسبية الأجرة الأساسية إلى إجمالي الشحن
تُعبَّر رسوم الوقود غالبًا كنسبة مئوية من رسوم النقل أو الشحن الأساسية لمستوى خدمة وشريحة وزن ومنطقة وجهة معيّنة. إذا أظهر عرض الناقل أو جدول أسعارك أجرة أساسية قدرها ثمانية وأربعون فاصلة خمسة وحدات نقدية وكان عامل الوقود المنشور اثني عشر فاصلة خمسة بالمئة، فإن مبلغ الرسوم هو الأساس مضروبًا في النسبة مقسومًا على مئة، وإجمالي الشحن هو الأساس زائد تلك الرسوم—أو ما يعادله الأساس مضروبًا في واحد زائد النسبة على مئة.
الحساب يدويًا سهل لطرد واحد ومؤلم عند مطابقة فاتورة أسبوعية بمئات البنود، لكل منها أساس مختلف ونفس جدول الوقود الأسبوعي. تنفّذ هذه القدرة تلك الهوية ذات الخطوتين دون استعلام شبكة الناقل ودون جدول يعتمد على التاريخ: تقدّم الأجرة الأساسية التي تعرفها مسبقًا ونسبة الرسوم التي تنطبق على الفترة التي تسعّر لها. تُقرَّب المخرجات النقدية half-up إلى منزلتين عشريتين بحيث تصبح الوسائط ذات الفاصلة العائمة مثل ستة فاصلة صفر ستة اثنان خمسة ستة فاصلة صفر ستة للرسوم وأربعة وخمسين فاصلة خمسة ستة للمجموع، بما يوافق أعراف المحاسبة وبنود الفاتورة.
عقد الإدخال وشكل الاستجابة وسلوك التحقق
تُحدَّ الأجرة الأساسية بتريليون وحدة نقدية ونسبة الرسوم بألف بالمئة حتى لا تفيض مسارات العرض من أتمتة جارية. أساس مئة مع ثمانية بالمئة يعطي رسومًا ثمانية ومجموعًا مئة وثمانية. الطلبات غير الصالحة لا تُفوتر.
اربط هذه النقطة بخطوتك الخاصة لتعريفة المنطقة أو الوزن الحجمي إن احتجت اشتقاق الأساس؛ تطبق هذه الحاسبة نسبة الوقود فقط بعد معرفة الأساس.
أين تفيد حاسبة رسوم وقود الشحن
تستخدم منصات التجارة الإلكترونية حاسبة رسوم وقود حتى يعرض الدفع وأدوات المكتب الخلفي شحنًا مستقرًّا يطابق نشرات الناقل الأسبوعية دون ترميز ثابت جديد كل يوم اثنين. يحتاج مشغّلو اللوجستيات من الطرف الثالث ووسطاء الشحن إلى مرجع حتمي لرسائل عروض الأسعار وجداول الأسعار وفحوص الهامش عندما يظهر نفس الأساس تحت جداول وقود مختلفة حسب المنطقة أو الخدمة. تستفيد مواقع المحتوى التي تترتب على حاسبة رسوم وقود الشحن من ودجت مجاني في المتصفح تطابق نتائجه مسار الأتمتة المدفوع بايتًا ببايت على نفس الوحدة النقية.
أبقِ الأساس والنسبة المدخلين الوحيدين، وثبّت الحقول النقدية المقربة في الاختبارات، لتحصل على إجماليات شحن قابلة للتكرار للأسواق وإضافات WMS والعُمّال الطرفية دون بناء محرك تسعير كامل خاص بك.
حالات الاستخدام
الدفع وعرض الشحن المستقر
اعرض للمتسوقين أو عملاء B2B رسوم الشحن الشاملة بتطبيق نسبة وقود الناقل الحالية على أجرة الشحن الأساسية المعروضة قبل الدفع.
بنود الفاتورة وتدقيق الناقل
أعد بناء الرسوم وإجمالي الشحن لكل بند أساسي عند مطابقة فواتير الناقل الأسبوعية مع جدول الوقود المنشور لتلك الفترة.
رسائل عروض الأسعار وجداول الأسعار
أنشئ عروض وسيط أو 3PL تسرد الأجرة الأساسية ومبلغ رسوم الوقود وإجمالي الشحن من نسبة مئوية واحدة مشتركة عبر كثير من وحدات SKU.
الأسئلة الشائعة
هل تُستعلم جداول وقود الناقل مباشرة؟
لا. أنت تقدّم النسبة التي تنطبق على الفترة التي تسعّر لها. المعالج parse نقي بلا شبكة، فتبقى النتائج حتمية للاختبارات والتدقيق.
كيف تحسب رسوم وقود الشحن؟
اضربوا الأجرة الأساسية في نسبة الوقود واقسموا على مئة، ثم أضيفوا الناتج إلى الأساس لتحصلوا على الإجمالي. أساس قدره 100 بنسبة 8 % يعطي رسوما قدرها 8 تضاف بعد ذلك إلى الأساس.
كيف تقرب الرسوم والإجمالي؟
يقرب كلاهما إلى منزلتين عشريتين مع تقريب النصف إلى الأعلى، كما في بنود الفواتير المعتادة. لذلك يعطي أساس قدره 48.5 بنسبة 12.5 % رسوما قدرها 6.06 وإجماليا قدره 54.56.
هل يمكن أن تكون الأجرة الأساسية أو النسبة صفرا؟
نعم. إذا كانت إحداهما صفرا فالرسوم صفر ويساوي الإجمالي الأساس. ولا تقبل القيم السالبة، ولا يجوز أن تتجاوز نسبة الوقود ألفا في المئة.
هل أكتب 12.5 أم كسرا عشريا لنسبة 12.5 %؟
اكتبوا 12.5. يقرأ رقم الوقود كنسبة مئوية من الأجرة الأساسية كما تنشره شركات الشحن في جداولها، فلا حاجة إلى تحويله إلى كسر عشري أولا.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/ecom/fuel-surcharge \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"base_rate":48.5,"surcharge_percent":12.5}'const res = await fetch("https://api.kit.forhosting.com/ecom/fuel-surcharge", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"base_rate": 48.5,
"surcharge_percent": 12.5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/fuel-surcharge",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"base_rate": 48.5,
"surcharge_percent": 12.5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/fuel-surcharge", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"base_rate":48.5,"surcharge_percent":12.5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"base_rate":48.5,"surcharge_percent":12.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/fuel-surcharge", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"base_rate": 48.5,
"surcharge_percent": 12.5
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.fuel_surcharge",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
تقبل حاسبة رسوم وقود الشحن هذه أجرة الشحن الأساسية ونسبة رسوم الوقود، وتضرب الأساس في النسبة مقسومة على مئة لمبلغ الرسوم، ثم تضيفه إلى الأساس لإجمالي الشحن، وتقرب الحقول النقدية half-up إلى منزلتين عشريتين حتى تتوافق الفواتير وعملاء API. يُسمح بأساس صفر أو نسبة صفر وينتجان رسومًا صفرية؛ وتفشل المدخلات السالبة بـ invalid_input دون فوترة. يشغّل نفس الوحدة النقية ودجت المتصفح المجاني ومسار API المدفوع مسبقًا بسعر $0.002 لكل استدعاء ناجح.
كيف تحوّل رسوم الوقود النسبية الأجرة الأساسية إلى إجمالي الشحن
يعيد الرد المدخلات المرسلة ويعيد surcharge_amount و total_freight ويتضمن سلسلة formula قصيرة يمكن عرضها في الواجهة أو سجل التدقيق بجانب الأرقام.
عقد الإدخال وشكل الاستجابة وسلوك التحقق
أرسل جسم JSON عبر POST برقمين متناهيين غير سالبين مطلوبين: base_rate وهو مبلغ الشحن أو النولون قبل الوقود (مقبول أيضًا بالأسماء البديلة shipping_rate و rate و base_shipping_rate و freight_base)؛ و surcharge_percent نسبة الوقود مثل اثني عشر فاصلة خمسة لاثني عشر فاصلة خمسة بالمئة (بدائل fuel_surcharge_percent و percent و fuel_percent و surcharge_pct). قد يصل كل حقل كرقم JSON أو سلسلة رقمية؛ وتفشل السلاسل الفارغة والحقول الناقصة والقيم غير المتناهية والسوالب بـ invalid_input مع تسمية الحقل. عند النجاح يتضمن الجسم base_rate و surcharge_percent كأرقام موحّدة، و surcharge_amount و total_freight كنقود half-up بمنزلتين، و formula يعيد صياغة الهوية. مثال: base_rate ثمانية وأربعون فاصلة خمسة و surcharge_percent اثنا عشر فاصلة خمسة يعطيان surcharge_amount ستة فاصلة صفر ستة و total_freight أربعة وخمسين فاصلة خمسة ستة.
أين تحقق واجهة برمجة رسوم وقود الشحن قيمتها
تستدعي بدائل الجداول والأتمتة منخفضة الكود واجهة API حتى يعيد المالية تسعير الشحنات التاريخية عند تدقيق بند فاتورة متنازع عليه استخدم عامل وقود الشهر الماضي. ولأن التنفيذ parse نقي من المستوى A، يكلف كل استدعاء ناجح السعر الأساسي المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة.
أسئلة تقنية
كيف أحسب رسوم وقود الشحن؟
أرسل base_rate و surcharge_percent غير سالبين. تعيد API القيمة surcharge_amount = base_rate × surcharge_percent / 100 و total_freight = base_rate + surcharge_amount مع تقريب نقدي half-up لمنزلتين.
ما الوحدات التي أستخدمها لـ base_rate؟
أي وحدات نقدية متسقة (USD أو EUR وغيرها). الحاسبة محايدة للوحدة: تضرب وتقرب؛ ولا تحوّل العملات ولا تبحث في جداول الناقل.
هل يجوز أن يكون surcharge_percent صفرًا أو أكبر من 100؟
الصفر مسموح وينتج رسومًا صفرية. القيم فوق 100 مقبولة حتى 1000 للجداول المؤقتة القصوى؛ وتُرفض النسبة السالبة بـ invalid_input.
ما تكلفة حاسبة رسوم وقود الشحن؟
أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل استدعاء ناجح؛ والمدخل غير الصالح لا يُفوتر.