قواعد المال والضريبة والعمولة

تذكر هذه الصفحة ما يفعله الكود اليوم. وحيث تكون القاعدة مؤقتة أو غير مبنية، تقول ذلك صراحة. لا شيء هنا توصية؛ قواعد العمل يقررها المالك وتُسجَّل في docs/handoff.md.

العملة والمبالغ

  • عملة المنصة: الريال القطري (QAR) افتراضيًا. الرموز المدعومة: QAR وEGP وSAR وAED وUSD وEUR وGBP.
  • المبالغ أعداد صحيحة بأصغر وحدة للعملة (الدرهم للريال القطري)، وليست كسورًا عشرية أبدًا؛ وفي الواجهة البرمجية تنتقل كنصوص. النسب أعداد صحيحة بنقاط الأساس (100 نقطة = 1%).
  • أسعار الصرف للعرض فقط. لا يُحصَّل أي مبلغ بعملة محوّلة.

الضريبة

  • تُضبط نسب الضريبة حسب الدولة (واختياريًا الولاية والرمز البريدي) مع تواريخ سريان، وخيار شمول السعر للضريبة، وما إذا كان الشحن خاضعًا للضريبة. تُطبَّق النسبة الأكثر تحديدًا؛ وتُقرَّب الضريبة لكل سطر.
  • مع الأسعار الشاملة يدفع المشتري السعر المعروض بالضبط، والضريبة جزء منه.
  • قطر: 0%، الأسعار شاملة، والشحن خاضع (بتأكيد المالك). مصر: مهيأة بضريبة قيمة مضافة 14%، شاملة، والشحن خاضع.
  • لا يمكن شراء منتج بلا فئة ضريبية.

رسوم الشحن

  • يُسعَّر الشحن لكل شحنة بائع، حسب منطقة التوصيل والطريقة. أنواع الأسعار: ثابت، حسب الوزن، حسب السعر، ومجاني، مع شرائح اختيارية وأسعار لكل قسم وحد للشحن المجاني.
  • إعدادات قطر: منطقة واحدة لكل الدولة، العادي 25.00 ريال والسريع 50.00 ريال.
  • لا يوجد حد للشحن المجاني مضبوط اليوم (دُرس ثم أُزيل). ويمكن للقسائم منح شحن مجاني.

العمولة

  • لكل بائع خطة عمولة: نسبة افتراضية بنقاط الأساس، وقواعد اختيارية لكل قسم (تُطبّق الأكثر تحديدًا) مع حد أدنى وأقصى للرسوم لكل سطر، ورسم ثابت اختياري. يدير الخطط المسؤول الأعلى؛ وسقف النسبة 50%.
  • الخطة المهيأة افتراضيًا 8.5%.
  • تُحسب العمولة على قيمة بضائع البائع — قبل الضريبة والشحن، وقبل أي خصم تموّله المنصة — وتُثبَّت عند تأكيد الدفع.
  • البائع بلا خطة لا يستطيع البيع.

دفتر الأستاذ

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

قيد دفتر الأستاذ عند دفع الطلب PAYMENT_GATEWAY_CLEARINGمدين · بوابة الدفع أو النقد في الطريق SELLER_PAYABLEدائن · مستحق للبائع PLATFORM_REVENUEدائن · إيراد العمولة SHIPPING_REVENUEدائن · إيراد الشحن PLATFORM_TAX_PAYABLEدائن · ضريبة مستحقة ما دفعه المشتري
عند دفع الطلب يُقيَّد حساب بوابة الدفع (أو النقد في الطريق للدفع عند الاستلام) مدينًا، ويُوزَّع المبلغ على مستحقات البائع والعمولة وإيراد الشحن والضريبة. وتُقيَّد حسابات العروض وبطاقات الهدايا والولاء مدينة حيث تنطبق.

متى يُعدّ الطلب «مدفوعًا»

يُحصَّل الدفع فور تفويضه، فينتقل الطلب إلى PAID. في الدفع عند الاستلام تعني PAID أن الالتزام النقدي قد سُجّل على التوصيلة — وليس أن النقد في اليد. ويُتابَع النقد كـنقد في الطريق حتى يسلّمه السائق.

طرق الدفع

الطريقةما يفعله الكود
الدفع عند الاستلاممفعّل. يُرفض للسلع الرقمية، وخارج الدول المفعّلة (قطر ومصر افتراضيًا)، وفوق حد أقصى لقيمة الطلب (20,000.00 افتراضيًا).
البطاقة عبر Stripeتكامل حقيقي، والمنصة هي التاجر المسجّل، بلا تقسيم للمدفوعات. يدعم USD وEUR وGBP وEGP وSAR وAED — وليس QAR — ويحتاج مفتاحًا سريًا ليعمل.
Paymobغير منفّذ؛ المحوّل يرفض كل عملية دفع.
البطاقة التجريبيةللتطوير فقط؛ مرفوضة في الإنتاج.
بطاقات الهدايا ونقاط الولاءتُطبَّق بعد الضريبة، بطاقات الهدايا أولًا ثم النقاط.

مستحقات البائعين

القاعدةالقيمة
فترة الاحتجاز7 أيام من تقييد الربح
الحد الأدنى للدفعة100.00 (‏10,000 وحدة صغرى)
موافقة إضافيةالدفعات فوق 50,000.00 تحتاج موافقة شخص
الحساب البنكييجب أن يكون متحققًا منه
الإطلاقيدوي: تبدأ المالية دورة دفع. لا جدول تلقائي.
التحويليدوي: ترسل المالية التحويل البنكي خارج النظام، ثم تحدد الدفعة كمدفوعة.

حالات الدفعة: مجدولة ← بانتظار الموافقة ← معتمدة ← قيد التنفيذ ← مدفوعة أو فاشلة أو ملغاة. ويُصدر كشف تسوية عند دفع الدفعة.

تسوية الدفع عند الاستلام

يسجّل السائق النقد عند الباب؛ وعند تسليمه يسجّل المرسِل التسوية ويُخرجه دفتر الأستاذ من حساب النقد في الطريق. يُسجَّل العجز ويُبلَّغ للمالية ولا يُرفض. السائق الذي حد نقده 0 لا يتلقى مهام نقدية.

المبالغ المستردة

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

القسائم وبطاقات الهدايا والولاء

  • القسائم (منفّذة): نسبة مئوية، مبلغ ثابت، شحن مجاني، واشترِ كذا واحصل على كذا، مع قواعد الجمع وحدود الاستخدام؛ تموّلها المنصة أو البائع أو مناصفة.
  • بطاقات الهدايا (منفّذة): يصدرها المسؤول مع سبب (بيع أو مجاملة) وتُستخدم عند الدفع. لا يستطيع المشتري شراء بطاقة هدية من الموقع بعد.
  • نقاط الولاء (منفّذة بقيم مؤقتة): نقطة لكل 100 وحدة صغرى مدفوعة، تُكتسب عند دفع الطلب؛ النقطة = وحدة صغرى واحدة؛ وتغطي النقاط 50% كحد أقصى من الطلب.
  • الحملات باشتراك البائعين موجودة في قاعدة البيانات لكنها غير منفّذة.
مفتوح أو مؤقت اليوم
  • الدفع بالبطاقة بالريال القطري (Stripe لا يقبل QAR هنا؛ وPaymob غير مبني).
  • دورات الدفع المجدولة والتحويلات البنكية الآلية.
  • صرف المبالغ المستردة آليًا لطلبات الدفع عند الاستلام.
  • أجور السائقين وقيم الولاء (مؤقتة حتى توجد وحدة إعدادات).
  • مقاصة النقد بحوزة السائق مقابل مستحقاته.
  • التحصيل بعملة غير عملة السعر.
  • احتفاظ المنصة بأموال البائعين بصفتها التاجر المسجّل مسألة ترخيص وضرائب معروضة على المستشار القانوني في قطر ومصر.