بوابة العميل والمشاركة

بوابة العميل هي الجانب المواجه للعميل في Invotify — كل ما يراه ويفعله عميلك دون إنشاء حساب. تولّد رابط مشاركة آمنًا، ترسله لعميلك، ويحصل على صفحة نظيفة ذات علامة تجارية يمكنه فيها قراءة الفاتورة وتنزيل PDF والدفع إلكترونيًا (في Pro). في الوقت ذاته، تحصل على سجل هادئ بالضبط متى وأين فتحها.

ما تفعله البوابة:

• عرض الفاتورة العام — رابط قائم على رمز يفتح الفاتورة في المتصفح. لا تسجيل دخول، لا كلمة مرور، لا إزعاج للعميل.
• تنزيل PDF — يُنزّل العميل PDF دقيق الحجم بنقرة واحدة.
• الدفع الإلكتروني (Pro) — زر "ادفع الآن" يأخذ العميل إلى دفع آمن عبر Stripe.
• تتبع العرض — كل فتح مسجّل: متى، ومن أين، وعدد المشاهدات.
• تفضيلات البريد الإلكتروني — إلغاء اشتراك بنقرة واحدة وتحكم تفصيلي في الرسائل.

نوعا الروابط:

• رابط الفاتورة الواحدة (/invoice/{token}) — يعرض فاتورة واحدة محددة.
• رابط بوابة العميل (/portal/{token}) — عرض موحّد لفواتير العميل الأخيرة والرصيد المستحق الإجمالي وعلامة التأخر ورصيد إشعار الدائن.

الخطط: العرض العام وتنزيل PDF وتتبع العرض وإدارة تفضيلات البريد متاحة في كل خطة. الدفع الإلكتروني من البوابة يتطلب خطة Pro مع ربط Stripe.

مشاركة فاتورة تنشئ رمز مشاركة فريدًا يصعب تخمينه وتحوّله إلى رابط عام يمكن لعميلك فتحه دون تسجيل دخول. الرمز UUID عشوائي — لا يمكن تخمينه بترقيم تصاعدي.

كيف يعمل رمز المشاركة:

• توليد رابط ينشئ share_token للفاتورة ويُعيد رابطًا بالشكل https://your-app/invoice/{token}.
• إذا كان رمز موجودًا بالفعل لتلك الفاتورة، يُعيد Invotify نفسه — المشاركة مجددًا لن تُخرب الرابط الذي أرسلته.
• الرابط هو الوثيقة الوحيدة. يمكن لأي شخص معه عرض الفاتورة، لذا عامِله كرابط خاص.
• يمكنك إلغاء رابط مشاركة في أي وقت. الإلغاء يمسح الرمز والرابط القديم يتوقف عن العمل فورًا.

الأذونات: توليد رابط مشاركة أو إلغاؤه يتطلب إذن "إدارة الفواتير".

مشاركة PDF عبر WhatsApp وTelegram وSlack وغيرها: يُسلّم مربع حوار المشاركة على الفواتير والعروض ملف PDF المُصيَّر مباشرةً إلى ورقة مشاركة جهازك. انقر على WhatsApp أو Telegram أو Slack أو Messenger والـ PDF مرفق بالفعل.

عند فتح عميل لرابط مشاركة، يصل إلى صفحة نظيفة ومناسبة للجوّال لا تحتاج تسجيل دخول. هناك تجربتان حسب الرابط.

صفحة الفاتورة الواحدة (`/invoice/{token}`): يرى العميل الفاتورة كاملة — اسم شركتك وشعارها ورقم الفاتورة وحالتها وتواريخ الإصدار والاستحقاق وتفاصيل الفوترة وكل بند مع الكميات والإجماليات وأي ملاحظات أضفتها. في الأسفل الإجراءات: - تنزيل PDF — يولّد وينزّل PDF A4 احترافيًا. - ادفع الآن — يظهر فقط عند توفر رابط دفع والفاتورة غير مدفوعة أو ملغاة (Pro).

صفحة البوابة الموحّدة (`/portal/{token}`): نظرة عامة بأسلوب لوحة التحكم للعميل عبر جميع فواتيره معك: - الرصيد المستحق — الإجمالي لا يزال مستحقًا عبر كل فاتورة غير مدفوعة، مع علامة تأخر إذا كان أيٌّ منها متأخرًا. - رصيد إشعار الدائن — أي رصيد ائتمان يحمله. - قائمة الفواتير — فواتيره الأخيرة غير المسودة، مع رقم وتواريخ وحالة ومبلغ وإجراء دفع.

في خطة Pro مع ربط Stripe، تحوّل البوابة العرض إلى دفع. ينقر العميل على "ادفع الآن" ويصل إلى دفع Stripe المستضاف الآمن — لا يلمس Invotify تفاصيل بطاقته.

كيف يتدفق دفع البوابة: 1. يفتح العميل فاتورته أو البوابة الموحّدة وينقر على ادفع. 2. ينشئ Invotify جلسة Stripe Checkout لتلك الفاتورة ويُعيد توجيه العميل إليها. 3. يدفع العميل في صفحة Stripe المستضافة. بريده الإلكتروني مُعبأ مسبقًا لدفع أسرع. 4. عند النجاح يُعاد إليه صفحة تأكيد؛ عند الإلغاء يعود بسلاسة. 5. تؤكد Stripe الدفعة وحالة الفاتورة تُحدَّث إلى مدفوعة تلقائيًا.

مدفوعات كاملة أو جزئية: - بشكل افتراضي يدفع العميل الرصيد المستحق الكامل. - إذا مكّنت المدفوعات الجزئية على الفاتورة، يمكن للعميل دفع مبلغ أقل.

الضمانات المدمجة: - لا يمكن دفع فواتير مدفوعة بالفعل أو ملغاة — زر الدفع يختفي والطلب يُرفَض من جانب الخادم. - نقطة نهاية دفع البوابة محدودة السعر لمنع الإساءة.

مهم: الدفع الإلكتروني يتطلب خطة Pro وحساب Stripe متصل.

توقف عن التساؤل ما إذا كان عميلك فتح الفاتورة فعلًا. في كل مرة تُعرَض فيها فاتورة مشتركة، يسجّل Invotify ذلك — حتى تعرف بالضبط متى رآها، وكم مرة، ومن أين.

ما يُسجَّل في كل عرض: - الوقت — متى حدث العرض. - المصدر — من أين جاء: link (رابط مشاركة) أو email أو portal أو api. - IP الزائر — عنوان IP العميل، حتى تُفرّق بين فتحات متكررة من نفس المكان وفتحات جديدة. - وكيل المستخدم — سلسلة المتصفح/الجهاز، مُقتطعة لطول آمن.

إحصاءات إجمالية يحتفظ بها Invotify لكل فاتورة: - عدد المشاهدات — الإجمالي الجاري للفتحات. - أول عرض في — متى فُتحت الفاتورة لأول مرة (مُختوم مرة واحدة، لا يُكتب فوقه). - آخر عرض في — الفتح الأخير. - IPs الفريدة — كم عنوان IP متميز شاهدها.

أين تراه: تظهر إحصاءات العرض في صفحة تفاصيل الفاتورة — شارة مدمجة تعرض عدد المشاهدات، مع وقت العرض الأول والأخير عند التحوم.

حماية من الإساءة: نقطة نهاية التتبع محدودة السعر لكل IP ولكل رمز، لذا لا يمكن لعميل واحد يُعيد التحميل تضخيم عدد مشاهداتك.

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

ما يمكن للعملاء التحكم فيه: - رسائل المستندات — الفواتير والعروض والمستندات الأخرى المرسلة إليهم. - رسائل التذكير — تذكيرات التأخر والمدفوعات القادمة. - رسائل التسويق — أي رسائل ترويجية أو إعلانية.

كل فئة زر تبديل مستقل. عميل يريد الفواتير فقط لكن لا تذكيرات يمكنه الحصول على ذلك بالضبط — ليس الكل أو لا شيء.

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