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

حاسبة الطوابع البريدية

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

● Betaمجاني · داخل متصفحك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

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

أدخل تكلفة البريد والطوابع المتاحة لديك

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

كيفية اختيار أفضل تشكيلة

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

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

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

تجهيز ظرف بريدي

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

استخدام فئات طوابع متنوعة

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

أتمتة تعليمات غرفة البريد

حوّل تكلفة تقدمها شركة النقل إلى تفصيل قابل للتكرار حسب الفئات لاستخدامه في الشحن أو البريد الإداري.

ما تكلفة استخدام الحاسبة؟

يمكنك تشغيلها مجانًا في المتصفح. تبلغ تكلفة كل طلب عبر API مقدار $0.002.

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

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

هل يمكن الجمع بين طوابع من فئات مختلفة؟

نعم. أدخل الفئة الأساسية وأضف القيم الأخرى المتاحة في additional_denominations.

لماذا يجب أن تكون جميع الفئات موجبة؟

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

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

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

هل تراعي الحاسبة عدد الطوابع المحدود في المخزون؟

لا. يُفترض أن كل فئة مدخلة متاحة دون حد للكمية.

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

POSThttps://api.kit.forhosting.com/date/postage-stamp-count

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

curl -X POST https://api.kit.forhosting.com/date/postage-stamp-count \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"total_postage":2.73,"denomination":0.68}'
{
  "total_postage": 2.73,
  "denomination": 0.68
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.postage_stamp_count",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

لكل طلب$0.002

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

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

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