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

حاسبة باقي النقود

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

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

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

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

أدخل مبلغي المعاملة

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

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

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

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

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

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

مراجعة الباقي عند صندوق متجر

تأكد من المبلغ الواجب رده عندما يدفع العميل إجمالي الإيصال النهائي نقدًا.

تشغيل صندوق نقد مؤقت

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

أتمتة حساب نقطة البيع

أرسل النقود المستلمة وإجمالي البيع إلى API، ثم سجل النتيجة الحتمية لأغراض المطابقة.

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

ما الصيغة التي تستخدمها الحاسبة؟

تستخدم change_due = amount_tendered - purchase_total بعد تحويل المبلغين إلى أجزاء صحيحة من المائة.

ماذا يحدث إذا لم يدفع العميل نقدًا كافيًا؟

يعيد الطلب خطأ إدخال يبين المبلغ الناقص، لأن الدفع غير الكافي لا يمثل باقي نقود.

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

نعم، إذا استخدم المدخلان العملة نفسها وكانت ممثلة بمنزلتين عشريتين. ولا تتضمن النتيجة رمزًا للعملة عمدًا.

هل تحدد الأداة الأوراق النقدية والعملات المعدنية التي يجب ردها؟

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

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

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/life/change-due

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

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

curl -X POST https://api.kit.forhosting.com/life/change-due \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount_tendered":20,"purchase_total":13.47}'

const res = await fetch("https://api.kit.forhosting.com/life/change-due", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "amount_tendered": 20,
    "purchase_total": 13.47
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/life/change-due",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "amount_tendered": 20,
    "purchase_total": 13.47
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/change-due", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"amount_tendered":20,"purchase_total":13.47}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"amount_tendered":20,"purchase_total":13.47}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/change-due", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "amount_tendered": 20,
  "purchase_total": 13.47
}

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

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