ForHosting KIT · المال والتمويل

إجمالي الدفع عند الاستلام

اعرفوا بدقة المبلغ الذي يحصله المندوب عند التسليم: بضاعة بقيمة 120 وشحن بقيمة 15 ورسوم دفع عند الاستلام قدرها 5 تعطي 140 للتحصيل، مع مجموع فرعي قدره 135 للطلب والشحن. مجانا في متصفحكم.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

مثال محلول

إذا أدخلت

قيمة البضائع: 120
الشحن: 15
رسوم الدفع عند الاستلام: 5

تحصل على

البضائع مع الشحن: 135
إجمالي المبلغ المطلوب تحصيله: 140

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

ما إجمالي COD ولماذا تُفصل البضاعة والشحن والرسوم

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

الشحن هو أجرة النقل أو التسليم التي وافق العميل على دفعها، وقد تكون صفرًا عند عتبات الشحن المجاني. رسوم COD رسم إضافي لقبول الدفع عند التسليم: بعض الناقلين يفوترون رسم تحصيل ثابتًا، وبعضهم نسبة من الفاتورة، وبعض التجار يتحملونها مع إبقاء الصفر للشفافية. فصل المدخلات الثلاث مهم للمحاسبة وتواصل العملاء.

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

لا تخترع رسوم COD من جدول نسب: تمرّرون الرسوم التي حسبتموها مسبقًا من عقد الناقل أو قائمة الأسعار، فيبقى الطرف حتميًا وخاليًا من قواعد سياسة مخفية.

أين تضيف حاسبة إجمالي الدفع عند الاستلام قيمة حقيقية

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

يطابق محللو المالية واللوجستيات ملفات تحويلات الناقل مع سجل الطلبات بإعادة تشغيل المكونات الثلاثة عبر الصيغة نفسها بدل هندسة عكسية لإجماليات ملصوقة. مواقع المحتوى التي تستهدف «حاسبة إجمالي الدفع عند الاستلام» أو مبلغ COD للتحصيل تستفيد من ودجت حي يطابق مساره المجاني في المتصفح مسار الأتمتة المدفوع على الوحدة النقية نفسها. فشل التحقق لا يستهلك الرصيد.

وثّقوا كيف تستخرجون رسوم COD في أدلة التشغيل، واحفظوا العملة بجانب كل طلب، فتحصلون على مبالغ تحصيل مندوب قابلة للتكرار لقسائم التعبئة وتدقيقات SLA والعاملين على الحافة دون بناء محرك مدفوعات كامل خاص بكم.

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

الدفع وتذكيرات الرسائل

اعرضوا إجمالي تحصيل المندوب بعد إضافة الشحن وعلاوة COD حتى يجهّز المشتري المبلغ الصحيح قبل التسليم.

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

كيف يُحسب إجمالي الدفع عند الاستلام؟

تستخدم جميع المبالغ وحدات العملة نفسها التي تقدّمونها.

هل تحسب هذه الأداة رسوم COD من نسبة مئوية؟

لا. مرّروا الرسوم التي حسبتموها مسبقًا من الناقل أو السياسة. الحاسبة تضيف فقط قيمة البضاعة والشحن وتلك الرسوم حتى تبقى النتائج حتمية.

أي عملة يجب استخدامها؟

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

هل يمكن أن يكون الشحن أو رسوم الدفع عند الاستلام صفرا؟

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

لماذا يطلب المندوب أكثر من سعر المنتج؟

لأن مبلغ التحصيل يضيف عادة الشحن ورسوم الدفع عند الاستلام إلى قيمة البضاعة. فمع بضاعة بقيمة 120 وشحن بقيمة 15 ورسوم قدرها 5 يحصل المندوب 140 لا 120.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/ecom/cod-total

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

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

curl -X POST https://api.kit.forhosting.com/ecom/cod-total \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"goods_value":120,"shipping":15,"cod_fee":5}'

const res = await fetch("https://api.kit.forhosting.com/ecom/cod-total", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "goods_value": 120,
    "shipping": 15,
    "cod_fee": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ecom/cod-total",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "goods_value": 120,
    "shipping": 15,
    "cod_fee": 5
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"goods_value":120,"shipping":15,"cod_fee":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/cod-total", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "goods_value": 120,
  "shipping": 15,
  "cod_fee": 5
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.cod_total",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

المنطق النقي نفسه يشغّل الأداة المجانية في المتصفح وواجهة API، فلا تختلف معاينات الدفع أو طباعة WMS أو الأتمتة المدفوعة مسبقًا على مجموع من ثلاثة حدود.

ما إجمالي COD ولماذا تُفصل البضاعة والشحن والرسوم

تنفّذ هذه الحاسبة المجموع القياسي total_collect يساوي goods_value زائد shipping زائد cod_fee، وتعيد أيضًا goods_plus_shipping حتى تُظهر الملصقات «الطلب والتسليم» منفصلين عن علاوة الدفع.

عقد الإدخال وحقول الاستجابة وسلوك التحقق

المبالغ الضخمة جدًا فوق تريليون بالمقدار المطلق تُرفض خارج النطاق. سلسلة formula قصيرة تعيد صياغة القاعدة للعرض بجانب النتيجة. اربطوا الاستجابة برمز عملتكم وتنسيق محلكم؛ هذا الطرف لا يحوّل العملات ولا يطبّق معدلات ضريبية — ضريبة القيمة المضافة وGST والرسوم يجب دمجها في المدخلات إن كانت ضمن النقد الذي يحصّله السائق. أرسلوا جسم JSON بثلاثة أعداد منتهية غير سالبة إلزامية: goods_value (المجموع الفرعي لبضائع الطلب)، وshipping (أجرة الشحن أو التسليم؛ استخدموا صفرًا للشحن المجاني)، وcod_fee (رسوم أو علاوة الدفع عند الاستلام؛ استخدموا صفرًا عندما يكون COD مجانيًا). قد يصل كل حقل كعدد JSON أو كسلسلة رقمية؛ الحقول الناقصة والسلاسل الفارغة والقيم غير المنتهية والسوالب تفشل بـ invalid_input مع تسمية الحقل، وتلك الإخفاقات لا تُفوتر. عند النجاح يعيد الجسم المدخلات الثلاث مقرّبة إلى منزلتين عشريتين، ويبلّغ goods_plus_shipping كـ goods_value زائد shipping، وtotal_collect كـ goods_plus_shipping زائد cod_fee — المبلغ الذي يجب أن يحصّله المندوب. مثال: بضاعة مئة وعشرون، شحن خمسة عشر، رسوم COD خمسة تنتج goods_plus_shipping مئة وخمسة وثلاثين وtotal_collect مئة وأربعين. تُقبل أسماء بديلة مثل order_value وfreight وcollection_fee للراحة. أبقوا الطلبات صغيرة، وثبّتوا الإجماليات ذات المنزلتين في الاختبارات، وأعيدوا استخدام الوحدة نفسها في المتصفح وAPI حتى تطابق المعاينات المجانية الأتمتة المدفوعة مسبقًا بايتًا ببايت على كل قسيمة COD.

أين تضيف حاسبة إجمالي الدفع عند الاستلام قيمة حقيقية

ولأن التنفيذ parse خالص من المستوى A، تكلف كل مكالمة ناجحة السعر الأساسي المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة.

حالات التكامل

قسائم التعبئة وقوائم COD

اطبعوا البضاعة والشحن ورسوم COD وtotal_collect على كل قسيمة حتى يرى السائقون والعملاء الرقم نفسه للتحصيل.

مطابقة التحويلات

أعيدوا تشغيل مكوّنات الطلب عبر total_collect = goods + shipping + COD fee عند مطابقة ملفات تسوية الناقل مع الطلبات.

أسئلة تقنية

هل يمكن أن يكون الشحن أو رسوم COD صفرًا؟

نعم. استخدموا shipping 0 للتسليم المجاني وcod_fee 0 عندما لا تفرضون علاوة تحصيل. تُرفض السوالب بوصفها invalid_input.

كم تكلفة حاسبة إجمالي الدفع عند الاستلام؟

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

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

شغّل الأداة مجانًا

مثال محلول

ما إجمالي COD ولماذا تُفصل البضاعة والشحن والرسوم

أين تضيف حاسبة إجمالي الدفع عند الاستلام قيمة حقيقية

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

الدفع وتذكيرات الرسائل

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

ملاحظات تقنية

ما إجمالي COD ولماذا تُفصل البضاعة والشحن والرسوم

عقد الإدخال وحقول الاستجابة وسلوك التحقق

أين تضيف حاسبة إجمالي الدفع عند الاستلام قيمة حقيقية

حالات التكامل

قسائم التعبئة وقوائم COD

مطابقة التحويلات

أسئلة تقنية

شكرًا