فواتير الاشتراك — فوترة سحابة صناديق
إصدار المنتج: 1.0.0+1 آخر تحديث: 2026-10-02 الجمهور المستهدف: مستخدمون بصلاحية
billing:read(billing:updateللدفع)
هذه فواتير الاشتراك (رسوم الخطة وفواتير تحديث السعة)، وليست فواتير العملاء/المبيعات.
أ. قائمة الفواتير
المسار: /billing/invoices.
أزرار دفع التحديث قد تفتح القائمة مسبقة التصفية بحالة open.
| التصفية | الخيارات |
|---|---|
| البحث | رقم الفاتورة / المعرف |
| الحالة | الكل، مسودة، مفتوحة، مرسلة، مدفوعة، متأخرة، فشل، ملغاة، مستردة، ملغاة القيمة |
| التواريخ | من / إلى |
الأعمدة
الرقم، الحالة، تاريخ الإصدار، الاستحقاق، الإجمالي.
الفواتير الملغاة القيمة
عند حذف مؤسسة، تحول كل فاتورة لم تدفع بعد (مسودة أو مفتوحة أو مرسلة أو متأخرة أو فشل دفعها) إلى حالة ملغاة القيمة (voided) ولا يمكن دفعها بعد ذلك. تبقى الفواتير المدفوعة دون تغيير ضمن سجل الفوترة.
ب. تفاصيل الفاتورة
المسار: /billing/invoices/:id (أو مسار التفاصيل الذي يستخدمه التطبيق).
- إجماليات الرأس والحالة
- جدول البنود (الوصف، الكمية، سعر الوحدة، إجمالي البند)
- ادفع عند عدم الدفع → Stripe Checkout بوضع الدفع (
POST /invoices/{id}/checkout) - يمكن تعديل الفواتير غير المدفوعة (الملاحظات، تاريخ الاستحقاق، الضريبة، الخصم) أو حذفها عند توفر الصلاحية
يمكن لتطبيق Flutter فتح PDF عند وجود document_url في حمولة الفاتورة. واجهة الفوترة لا تنتج حاليا document_url، لذا يكون تنزيل PDF غالبا غير متاح إلى أن يملأ هذا الحقل بتغيير مستقبلي.
بنود الاشتراك النموذجية
عندما تبني خدمة الفوترة فاتورة اشتراك من أسعار الخطة، تتضمن البنود عادة:
| البند | الكمية | سعر الوحدة |
|---|---|---|
| الرسوم الشهرية الأساسية | الأشهر المختارة | rate_per_month |
| رسوم لكل موظف | الموظفون / المقاعد المختارة | rate_per_employee |
| رسوم التخزين (GB فوق المسموح المجاني) | GB القابل للفوترة فقط | rate_per_gb |
GB القابل للفوترة = max(selected storage GB − plan free_storage_gb, 0). إذا كان صفرا يحذف بند التخزين.
تعديل الاشتراك ينشئ فاتورة غير مدفوعة لـ رسوم التحديث ببنود مفصلة (زيادات المقاعد/التخزين مقسطة و/أو مكونات الأشهر المضافة — راجع الاشتراك)؛ دفعها يفعل القيم المجهزة. لا يعاد احتساب الفواتير السابقة. فواتير التحديث غير المدفوعة الأقدم المنشأة قبل التفصيل قد تعرض بندا واحدا "تحديث الاشتراك" — احذفها وأعد التعديل لإعادة إنشائها.
لا توجد صفحة سجل مدفوعات منفصلة؛ يتم الدفع من الخطط، أو الاشتراك/المركز، أو تفاصيل الفاتورة عبر Checkout.