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

حاسبة رسوم معالجة الطلب الثابتة والنسبية

تجمع حاسبة رسوم معالجة الطلب بين مبلغ ثابت ونسبة مئوية من المجموع الفرعي، ثم تعرض الرسم الكامل وإجمالي الدفع.

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

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

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

أدخلوا المجموع الفرعي وجزأي الرسم

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

افهموا طريقة الحساب والتقريب

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

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

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

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

إعداد الدفع في المتجر

احسبوا الرسم المجمع بدقة لتطبيق سياسة تجمع مبلغًا ثابتًا ونسبة مئوية.

اختبار جدول رسوم مقترح

قارنوا رسوم المعالجة عبر مجاميع فرعية نموذجية قبل نشر سياسة تشغيل جديدة.

مطابقة الطلبات المكتملة

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

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

ما المجموع الفرعي الذي ينبغي إدخاله؟

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

هل يمكن حساب رسم ثابت فقط؟

نعم. اجعلوا percentage_fee صفرًا أو احذفوه؛ وعندئذ يساوي رسم المعالجة المبلغ الثابت.

كيف تعالج كسور أصغر وحدة نقدية؟

يقرّب المبلغ النسبي إلى منزلتين عشريتين قبل جمعه مع الرسم الثابت، كما يقرّب الرسم الإجمالي والمبلغ النهائي.

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

لا. تحسب رسم المعالجة من المجموع الفرعي المقدم فقط، ويجب حساب بقية التعديلات على حدة.

ما كلفة واجهة API؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/ecom/handling-fee

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

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

curl -X POST https://api.kit.forhosting.com/ecom/handling-fee \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subtotal":125.5}'

const res = await fetch("https://api.kit.forhosting.com/ecom/handling-fee", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "subtotal": 125.5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ecom/handling-fee",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "subtotal": 125.5
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"subtotal":125.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/handling-fee", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "subtotal": 125.5
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.handling_fee",
  "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 الكامل ←