حاسبة طوابع البريد اللازمة
إذا كانت أجرة البريد 1.50 وقيمة الطابع 0.73 فأنت تحتاج إلى 3 طوابع: 2.19 على الظرف و0.69 زيادة عن المستحق. أدخل الأجرة وقيمة طابع واحد لتعرف أقل عدد صحيح يغطيها. مجانًا في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- أجرة البريد
- 1.5
- قيمة الطابع
- 0.73
- مُلصق بالفعل
- 0
- أجرة البريد المتبقية
- 1.5
- الطوابع المطلوبة
- 3
- إجمالي الطوابع
- 3
لا تغادر الرسالة أو الطرد الشبّاك إلا حين تُغطى أجرة البريد المستحقة بطوابع من فئة معلومة. تقبل حاسبة طوابع البريد اللازمة هذه الأجرة الواجبة والقيمة الاسمية لطابع واحد، ثم تُرجع أصغر عدد صحيح من الطوابع يبلغ تلك الأجرة أو يتجاوزها، ومجموع القيمة الاسمية الذي ستلصقونه فعلًا، والزيادة فوق المبلغ المستحق. تُطرح الطوابع الملصقة مسبقًا —وهي اختيارية— من الباقي الواجب تغطيته حتى تُتموا ظرفًا يحمل أصلًا طابع Forever أو تذكارية فائضة. تُعامل المبالغ وحدات نقدية تُقرَّب إلى منزلتين عشريتين؛ ويبقى عدد الطوابع عددًا صحيحًا.
معنى «الطوابع اللازمة» للرسالة أو الطرد
تنشر جهات البريد أجرة مستحقة لكل مُرسَلة: دالة في الوزن والحجم والوجهة والخدمة، معبَّرًا عنها بالمال. نادرًا ما يقدّم الزبون ذلك المبلغ بعينه بقطع نقدية مختلطة. بل يلصق طوابع كاملة من فئة واحدة أو أكثر حتى يبلغ مجموع تلك القيم الاسمية الأجرة المستحقة على الأقل.
حين تكون كل الطوابع على الظرف من الفئة ذاتها —كتيّب طوابع Forever، أو لفيفة من الدرجة الثانية، أو إعادة طبع تذكارية— ينكمش المشكل إلى سقف واحد: كم نسخة من تلك الفئة تلزم لتغطية المستحق. إن كانت الأجرة دولارًا وخمسين سنتًا وقيمة كل طابع ثلاثة وسبعين سنتًا، فإن طابعين لا يعطيان سوى دولار وستة وأربعين، وهو نقص، فيلزم ثلاثة طوابع وتكون التسعة عشر سنتًا الزائدة زيادة يحتفظ بها المشغّل.
الهوية نفسها تصح في أي عملة: الطوابع اللازمة هي سقف الأجرة المتبقية مقسومة على قيمة الطابع، والأجرة المتبقية هي المستحق ناقص أي طوابع ملصقة أصلًا على القطعة. أجرة متبقية صفرًا تعني صفر طوابع إضافية. هذه الصفحة ذلك العدّ، لا جدول تعريفة.
لا تستعلم تعريفات USPS أو Royal Mail أو La Poste من الوزن والمنطقة؛ تجيب الحاسبات الشقيقة مثل الوزن القابل للفوترة وتكلفة الشحن حسب المنطقة عن تلك البحوث.
أين ينفع عدّ الطوابع اللازمة
تستخدم البيوت والمكاتب الصغيرة حاسبة طوابع البريد اللازمة قبل الذهاب إلى الصندوق حتى لا تُعاد بطاقة تهنئة سميكة أو ظرف مبطّن لأجرة ناقصة. يستطيع تجّار التجارة الإلكترونية الذين ما زالوا يشحنون جزءًا من الطلبات رسائل مطبوعة —عقودًا وملصقات إرجاع وإخطارات قانونية— أن يأخذوا الأجرة المسعَّرة والفئة المخزونة في المستودع ويطبعوا «ألصقوا N طوابع» على إذن التعبئة. تستطيع فرق المالية التي تطابق درج الطوابع مع الأجرة الآلية إعادة تشغيل كل مبلغ مستحق بالصيغة نفسها لترى إن كان العاملون قد ألصقوا زيادة.
تستفيد مواقع المحتوى التي تترتب على حاسبة طوابع البريد اللازمة أو كم طابعًا لتغطية الأجرة من أداة حيّة يتطابق مسارها المجاني في المتصفح بايتًا ببايت مع الأتمتة المدفوعة مسبقًا على الوحدة الخالصة نفسها. لا يستهلك فشل التحقق الرصيد. وثّقوا الفئة التي تملكونها فعلًا —القيمة الاسمية الجارية لطابع Forever أو طابع الأونصة الثانية أو عادية محلية— إلى جانب الأجرة المستحقة، وأبقوا عملة واحدة في الحقلين، فتحصلون على عدّ قابل لإعادة الإنتاج للظروف والطرود وأوراق التدقيق دون إقامة محرّك تسعير بريدي خاص بكم.
حالات الاستخدام
رسائل وبطاقات تهنئة على مائدة المنزل
اطلعوا على أجرة بطاقة تهنئة أو ظرف سميك، وأدخلوا القيمة الاسمية لطوابع الكتيّب، وألصقوا العدّ المُرجع حتى لا تُعاد القطعة لأجرة ناقصة.
أذون مستودع للرسائل المطبوعة
حوّلوا الأجرة المسعَّرة والفئة المخزونة على منضدة التعبئة إلى عدّ صحيح مطبوع على الإذن، بما في ذلك أي طابع موجود أصلًا على ظرف مدفوع سلفًا.
الأسئلة الشائعة
كم طابعًا أحتاج لتغطية أجرة البريد؟
اقسموا الأجرة المتبقية على القيمة الاسمية لطابع واحد وقرّبوا إلى الأعلى حتى الطابع الصحيح التالي. الأجرة المتبقية هي المستحق ناقص طوابع تلك الفئة الموجودة أصلًا على القطعة. تُرجع هذه الحاسبة ذلك العدّ ومجموع القيمة الاسمية والزيادة.
ماذا لو لم يكفِ طابعان؟
العدّ سقف لا أرضية. إذا كان postage يساوي 1.50 وكل طابع 0.73، فإن طابعين يغطيان 1.46 فقط، فالنتيجة ثلاثة طوابع وزيادة 0.69. تحتفظ جهات البريد بالباقي.
هل تستعلم هذه الأداة التعريفات البريدية الرسمية حسب الوزن؟
لا. أنتم تقدّمون الأجرة المستحقة من الناقل أو جدول التعريفة أو ميزان مكتب البريد. تجيب هذه الأداة فقط عن عدد طوابع فئة واحدة يغطي ذلك المستحق. لا تحوّل العملات ولا تخلط الفئات.
هل يمكنني خصم الطوابع الملصقة على الظرف مسبقًا؟
نعم. أدخل عدد الطوابع من الفئة نفسها الملصقة بالفعل، فتُطرح قيمتها من أجرة البريد قبل العد. وإذا كانت تغطي الأجرة كاملة، تكون النتيجة صفر طوابع إضافية.
كم سأدفع زيادة عند استخدام طوابع كاملة؟
تعرض النتيجة المبلغ الزائد عن أجرة البريد. مع أجرة 1.50 وطوابع بقيمة 0.73، تبلغ ثلاثة طوابع 2.19، فتدفع 0.69 زيادة، وهو مبلغ يحتفظ به مشغل البريد.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/ecom/stamps-needed \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"postage":1.5,"stamp_value":0.73}'const res = await fetch("https://api.kit.forhosting.com/ecom/stamps-needed", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"postage": 1.5,
"stamp_value": 0.73
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/stamps-needed",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"postage": 1.5,
"stamp_value": 0.73
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/stamps-needed", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"postage":1.5,"stamp_value":0.73}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"postage":1.5,"stamp_value":0.73}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/stamps-needed", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"postage": 1.5,
"stamp_value": 0.73
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.stamps_needed",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
تشغّل الدالة الخالصة نفسها أداة المتصفح المجانية وواجهة API، فلا يختلف مساعد الدفع عن فحص ملصق المستودع على قسمة سقف. تُحاسب الدعوة الناجحة بالسعر المنشور $0.002؛ ولا تُحاسب المدخلات غير الصالحة.
عقد الإدخال وحساب القروش الصحيحة وجسم الاستجابة
تُقبل سلاسل الأرقام التي تُفسَّر أعدادًا منتهية حتى لا يحتاج مجموع دفع ملصوق تحويلًا ثانيًا. يجري الحساب بقروش صحيحة حتى يكون ثلاثة أمثال ثلاثة وسبعين سنتًا دولارين وتسعة عشر سنتًا تمامًا، لا باقيًا ثنائيًا عائمًا. أرسلوا جسم JSON بمبلغين غير سالبين إلزاميين بعملة واحدة: postage (الأجرة المستحقة للرسالة أو الطرد) وstamp_value (القيمة الاسمية لطابع واحد من الفئة التي ستستخدمونها). أرسلوا اختياريًا already_affixed عددًا صحيحًا من تلك الطوابع الموجودة أصلًا على القطعة؛ وإن أُغفل فالقيمة الافتراضية صفر. تُقبل الأسماء البديلة postage_due وpostage_amount وamount_due وrequired_postage وpostage_due_amount للحقل الأول؛ وdenomination وstamp_denomination وface_value وstamp وvalue للثاني؛ وaffixed وstamps_on_hand وexisting_stamps وstamps_affixed للعدّ. الحقول الناقصة والسلاسل الفارغة والنص غير العددي وNaN وInfinity والقيم السالبة وما فوق الحدود المنشورة تفشل بـ invalid_input مع تسمية الحقل، ولا تُفوتر تلك الإخفاقات. يجب ألا يقل stamp_value عن سنت واحد بعد التقريب إلى منزلتين. عند النجاح يعيد الجسم المدخلات المقرَّبة، ويبلّغ postage_remaining بوصفها المستحق غير المغطى بعد الطوابع الملصقة، وstamps_needed بوصفها الطوابع الصحيحة الإضافية المطلوبة، وstamps_total بوصفها already_affixed زائد stamps_needed، وvalue_needed وvalue_total بوصفهما ذينك العدّين مضروبين في الفئة، وoverpay بوصفها value_total ناقص postage، وcovers_exactly حين تكون تلك الزيادة صفرًا. يعيد حقل formula الصيغة stamps_needed = ceil(max(0, postage − already_affixed × stamp_value) / stamp_value) لعرضها إلى جانب النتيجة. مثال: postage دولار وخمسون سنتًا وstamp_value ثلاثة وسبعون سنتًا بلا شيء ملصق أصلًا يعطي ثلاثة طوابع ومجموع دولارين وتسعة عشر وزيادة تسعة وستين سنتًا. سعر العنصر الناجح مبلغ ثابت $0.002.
أين ينفع عدّ الطوابع اللازمة
يحتاج بائعو الأسواق الذين يشترون طوابع على طراز Forever بالجملة سقفًا حتميًا لا يعتمد على بقاء واجهة API للناقل حيّة ساعة التعبئة. ولأن التنفيذ parse خالص من tier A، تكلف كل دعوة ناجحة السعر الأساس المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة.
حالات التكامل
مطابقة درج الطوابع
أعيدوا تشغيل أجرة كل مُرسَلة بالصيغة السقفية نفسها لتفسير فراغ درج طوابع متماثلة أسرع مما توحي به الأجرة الآلية.
أسئلة تقنية
هل يمكن طرح الطوابع الموجودة أصلًا على الظرف؟
نعم. أرسلوا already_affixed عددًا صحيحًا غير سالب. تُقوَّم تلك الطوابع بـ stamp_value وتُطرح من postage قبل السقف. إن غطت المستحق أصلًا فإن stamps_needed صفر.
كم تكلفة حاسبة طوابع البريد اللازمة؟
أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع ملفًا بسعر $0.002 لكل دعوة ناجحة؛ ولا تُفوتر المدخلات غير الصالحة.