> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# الفوترة الاشتراكية والفواتير المتكررة في AgencyHandy

> كيف يتعامل AgencyHandy مع الفوترة الاشتراكية المتكررة — الفواتير التلقائية ودورات الفوترة وطرق الدفع والإلغاء وروابط الدفع عبر Wise.

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

## كيف تعمل الفوترة الاشتراكية

تمر دورة حياة الاشتراك في AgencyHandy بست مراحل رئيسية.

<Steps>
  <Step title="إنشاء خدمة اشتراكية">
    انتقل إلى **الخدمات** وانقر على **إنشاء خدمة جديدة**. اختر **اشتراك** كنوع الخدمة.

    حدّد:

    * **دورة الفوترة** — يومية أو أسبوعية أو شهرية أو سنوية
    * **سلوك التجديد** — إنشاء طلب جديد أو تحديث الطلب الموجود أو الإبقاء على الوضع الراهن
    * **التسعير وطريقة الدفع** — PayPal أو Stripe أو يدوي

    انقر على **نشر** لإتاحة الخدمة.
  </Step>

  <Step title="شراء العميل للاشتراك">
    يختار العميل خدمة الاشتراك ويتابع إلى الدفع ويختار طريقة الدفع.

    يقوم AgencyHandy تلقائيًا بـ:

    * إنشاء **معرّف اشتراك**
    * توليد **طلب**
    * إصدار **فاتورة**

    بالنسبة لمدفوعات **PayPal أو Stripe**، تُعيَّن الفاتورة على **مدفوعة** فورًا. بالنسبة للـ**دفع اليدوي**، تبقى الفاتورة **مفتوحة** حتى تؤكد الوكالة الاستلام.
  </Step>

  <Step title="الفوترة المتكررة التلقائية">
    في كل تاريخ تجديد، تعالج AgencyHandy الدفع تلقائيًا (لـ PayPal/Stripe) وتُولّد الفاتورة التالية.

    إذا نجح الدفع، تُعيَّن الفاتورة على **مدفوعة**. إذا فشل:

    * تبقى الفاتورة **مفتوحة**
    * يتلقى العميل **إشعار فشل الدفع**
    * تتلقى الوكالة تنبيهًا لإعادة المحاولة أو طلب بيانات دفع محدّثة
  </Step>

  <Step title="إدارة الاشتراكات النشطة">
    انتقل إلى **إدارة الاشتراكات** في الشريط الجانبي الأيسر لعرض جميع الاشتراكات النشطة وغير النشطة. اختر أي اشتراك لعرض تفاصيله الكاملة.
  </Step>

  <Step title="معالجة الإلغاءات">
    عند إلغاء اشتراك، يمكنك اختيار:

    * **الإلغاء الكامل** — إيقاف جميع الفواتير والطلبات المستقبلية
    * **الإبقاء على آخر طلب نشط** — السماح للعميل بالاستمرار في تلقي الخدمة حتى الموعد النهائي للفترة الحالية

    لحذف خدمة كليًا، يجب إلغاء جميع الاشتراكات النشطة على تلك الخدمة أولاً.
  </Step>

  <Step title="الإشعارات">
    يرسل النظام تلقائيًا:

    * **تذكيرات التجديد** قبل تاريخ الفوترة التالي
    * **تأكيدات الدفع** بعد الرسوم الناجحة
    * **تنبيهات فشل الدفع** لكل من العميل ومديري الوكالة
  </Step>
</Steps>

## صفحة تفاصيل الاشتراك

تمنحك صفحة تفاصيل الاشتراك صورة كاملة عن أي اشتراك فردي — من الخدمة والباقة وصولاً إلى كل فاتورة وإدخال في سجل الأحداث.

### كيفية الوصول

1. انتقل إلى **الاشتراكات** في الشريط الجانبي الأيسر
2. انقر على أي اشتراك من القائمة لفتح صفحة تفاصيله

### ما يمكنك رؤيته

<Tabs>
  <Tab title="معلومات الاشتراك">
    * **اسم الخدمة** و**اسم الباقة**
    * **اسم العميل**
    * **دورة الفوترة** (مثلاً: شهرية، سنوية)
    * **تاريخ الانطلاق** و**تاريخ الانتهاء**
    * **حالة** الاشتراك (نشط أو غير نشط)
  </Tab>

  <Tab title="تفاصيل الدفع">
    * **رسوم الاشتراك**
    * **إجمالي عدد المدفوعات** المُنجزة حتى الآن
    * **طريقة الدفع** (Stripe، PayPal، Wise، التحويل البنكي اليدوي، إلخ.)
    * **تاريخ الدفع التالي**
  </Tab>

  <Tab title="سجل الطلبات">
    * **معرّف الطلب**
    * **الحالة** (مثلاً: جارٍ، مكتمل)
    * **تاريخ الانطلاق** و**تاريخ الاستحقاق** لكل طلب
  </Tab>

  <Tab title="سجل الفواتير">
    * **معرّف الفاتورة**
    * **المبلغ**
    * **الحالة** (مفتوحة، مدفوعة، إلخ.)
    * **تاريخ الدفع** و**تاريخ الاستحقاق**
  </Tab>

  <Tab title="سجلات الأحداث">
    مسار تدقيق زمني لجميع الأنشطة المتعلقة بالاشتراك — تغييرات الحالة وأحداث الدفع والإلغاءات وغيرها.
  </Tab>
</Tabs>

<Note>
  يمكن أن يحتوي اشتراك واحد على طلبات وفواتير متعددة مرتبطة به. تُحدَّث الفواتير المرتبطة بالاشتراكات ديناميكيًا عند استلام المدفوعات.
</Note>

## دعم Wise لفواتير الاشتراك اليدوية

إذا كنت تجمع مدفوعات دولية، يمكنك تضمين **رابط دفع Wise** مباشرةً في فواتير الاشتراك. يمنح هذا العملاء طريقة مريحة للدفع دون الحاجة إلى إعداد تحويل بنكي يدوي.

### المتطلبات

* حساب AgencyHandy نشط
* حساب **Wise** نشط مع رابط دفع صالح تم إنشاؤه

### خطوات إضافة رابط Wise إلى فاتورة

<Steps>
  <Step title="فتح قسم الفواتير">
    انقر على **الفواتير** في الشريط الجانبي الأيسر، ثم انقر على **+ إنشاء فاتورة**.
  </Step>

  <Step title="اختيار العميل والطلب">
    اختر العميل من القائمة المنسدلة. ستظهر جميع معرّفات الطلبات المرتبطة. حدد معرّف الطلب ذي الصلة وأدخل المبلغ وأي بنود تُصدر الفاتورة عنها.
  </Step>

  <Step title="تطبيق الخصومات والضرائب">
    أضف أي نسبة خصم قابلة للتطبيق ومبلغ الخصم والمبلغ المدفوع والمبلغ المستحق وتفاصيل ضريبة القيمة المضافة/الضريبة. أضف عنوان الفوترة والملاحظات حسب الحاجة.
  </Step>

  <Step title="إضافة رابط الدفع عبر Wise">
    في قسم **طريقة الدفع**، حدد **Wise** كخيار الدفع. الصق رابط دفع Wise في الحقل المخصص.
  </Step>

  <Step title="حفظ الفاتورة">
    انقر على **حفظ** لإنهاء الفاتورة. سيظهر رابط دفع Wise في الفاتورة حتى يتمكن العميل من الدفع مباشرةً.
  </Step>
</Steps>

<Tip>
  تحقق دائمًا من رابط دفع Wise وإجماليات الفاتورة قبل الحفظ. تأكد من دقة تفاصيل الطلب والخصومات ومعلومات الضريبة لتجنب أخطاء الفوترة.
</Tip>

## ملاحظات مهمة حول الفوترة الاشتراكية

<Accordion title="من يستطيع إلغاء الاشتراكات؟">
  يمكن للـ**مديرين العامين** و**المديرين** فقط إلغاء الاشتراكات. لا يمكن للعملاء إلغاء اشتراكاتهم بأنفسهم — يجب عليهم طلب الإلغاء عبر الوكالة.
</Accordion>

<Accordion title="معرّفات الاشتراكات دائمة">
  بمجرد إنشاء اشتراك، لا يمكن تعديل معرّف الاشتراك الخاص به. هذا يضمن التتبع المتسق طوال عمر الاشتراك.
</Accordion>

<Accordion title="المدفوعات الفاشلة وإنشاء الطلبات">
  عند فشل الدفع، تبقى الفاتورة مفتوحة ويُنشأ طلب جديد للفترة الفاشلة. تظل حالة الاشتراك **نشطة** حتى يعيد المدير محاولة الدفع يدويًا أو يلغي الاشتراك.
</Accordion>

<Accordion title="طلبات الدفع اليدوي">
  إذا دفع العميل خارج نطاق Stripe أو PayPal (مثلاً عبر تحويل بنكي)، يجب على المدير تعيين الفاتورة يدويًا على **مدفوعة** في AgencyHandy. لا يفعل النظام ذلك تلقائيًا للمدفوعات اليدوية.
</Accordion>

<Accordion title="محاولات الدفع الذاتي غير المكتملة">
  إذا بدأ عميل الدفع لاشتراك لكنه لم يكمل عملية الدفع، يبقى في النظام كـ**عميل محتمل** حتى يشترك بنجاح.
</Accordion>

<Accordion title="تواريخ استحقاق الفواتير">
  تُحدَّد تواريخ استحقاق فواتير الاشتراك تلقائيًا بناءً على دورة الفوترة التي أعددتها (مثلاً: تستحق الفواتير الشهرية بعد شهر من تاريخ الانطلاق).
</Accordion>