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

تقسيم مبلغ نقدي إلى أوراق وعملات

تجد حاسبة الفئات النقدية هذه طريقة دقيقة لتكوين مبلغ إجمالي من الأوراق والعملات التي تحددها.

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

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

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

أدخل المبلغ والفئات التي يمكن استخدامها

ابدأ بإدخال إجمالي المبلغ النقدي المطلوب تجهيزه، ثم أضف قيم الأوراق والعملات المعدنية المتاحة. لا ترتبط الحاسبة بعملة محددة؛ فالقيم 20 و10 و5 و1 و0.25 و0.10 تناسب عملة عشرية، ويمكن لمجموعة مختلفة أن تمثل قسائم أو رموز فعاليات أو صندوقا تنقصه فئات معينة. يجوز أن يتضمن المبلغ والفئات منزلتين عشريتين كحد أقصى، وبذلك يجري الحساب بدقة بوحدة النقد الصغرى بدلا من السماح بانحرافات الفاصلة العائمة. يجب أن تكون كل فئة موجبة وغير مكررة. ترتب النتيجة الفئات المدخلة من الأكبر إلى الأصغر، وتعرض عددا لكل فئة، بما في ذلك الصفر عندما لا تكون فئة ما مطلوبة. لذلك يسهل نقلها إلى كشف صندوق أو قائمة تجهيز أو خطة سحب أو سجل مطابقة. تفترض الحاسبة توافرا غير محدود من كل فئة مدخلة؛ فالقائمة تحدد القيم الموجودة، ولا تحدد عدد القطع التي تملكها فعليا في الوقت الراهن.

لماذا تستخدم النتيجة أقل عدد فعلي من القطع

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

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

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

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

تجهيز مظاريف المدفوعات النقدية

حوّل كل دفعة دقيقة إلى قائمة تجهيز بأقل عدد من القطع باستخدام الفئات المعتمدة للتوزيع.

تخطيط إعادة تزويد صندوق النقد

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

توزيع القسائم أو رموز الفعاليات

استخدم مجموعة فئات غير قياسية واكتشف المبالغ التي لا تستطيع الرموز المتاحة تمثيلها بدقة.

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

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

نعم. تفحص المجاميع الجزئية الممكنة بالبرمجة الديناميكية وتعيد تركيبة دقيقة بأقل عدد إجمالي من القطع.

هل يمكن استخدام فئات عشرية للعملات المعدنية؟

نعم. يمكن أن يتضمن المبلغ والفئات منزلتين عشريتين كحد أقصى، مثل 0.25 أو 0.05.

ماذا يحدث إذا تعذر تكوين المبلغ بدقة؟

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

هل تراعي الحاسبة الكميات المحدودة في الصندوق؟

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

لماذا قد تختلف الإجابة عن اختيار أكبر فئة أولا؟

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

ما تكلفة طلب API؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/travel2/currency-cash-denomination-split

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

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

curl -X POST https://api.kit.forhosting.com/travel2/currency-cash-denomination-split \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":18.85,"denominations":[10,5,2,1,0.25,0.1,0.05]}'

const res = await fetch("https://api.kit.forhosting.com/travel2/currency-cash-denomination-split", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "amount": 18.85,
    "denominations": [
      10,
      5,
      2,
      1,
      0.25,
      0.1,
      0.05
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel2/currency-cash-denomination-split",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "amount": 18.85,
    "denominations": [
        10,
        5,
        2,
        1,
        0.25,
        0.1,
        0.05
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel2/currency-cash-denomination-split", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"amount":18.85,"denominations":[10,5,2,1,0.25,0.1,0.05]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"amount":18.85,"denominations":[10,5,2,1,0.25,0.1,0.05]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel2/currency-cash-denomination-split", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "amount": 18.85,
  "denominations": [
    10,
    5,
    2,
    1,
    0.25,
    0.1,
    0.05
  ]
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel2.currency_cash_denomination_split",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`max_denominations`	100
`max_normalized_amount`	250000

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

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