Fatoora Connect — نظرة عامة
فاتورة كونكت هي عرض الشريك السحابي. تدير محفظة مؤسسات، لكل منها ختم خادم خاص وبيانات TTN، وتفوتر على حصة اشتراكك.
هذه الفئة لمطوري الباقات partner-connect-starter وpartner-connect-business وpartner-connect-max. الفوترة والتوقيع والإرسال إلى TTN يستخدمان نفس واجهة Partner API.
الأطراف
- أنت (شريك كونكت) — منظمتك على fatoora.tn. تنشئ مؤسسات تابعة أو تربط حسابًا موجودًا.
- المؤسسة العميلة — منظمة مستقلة، بمعرّفها الجبائي وختمها وبيانات TTN.
- مالك حساب fatoora.tn الموجود — هو من يقبل الربط أو يرفضه من حسابه.
- TTN — فاتورة وحدها تتواصل مع الإدارة. كل فاتورة تصدر تُخصم من رصيد اشتراك كونكت.
طريقتان لإضافة مؤسسة
| الحالة | الإجراء |
|---|---|
| المعرّف الجبائي غير موجود | إنشاء المؤسسة |
| المعرّف يخص حساب fatoora.tn موجودًا | طلب الربط |
| المعرّف يخص كونكت آخر أو مكتب محاسبة أو حساب شريك | لا إنشاء ولا ربط (NOT_LINKABLE) |
فوترتك الخاصة
منظمة كونكت نفسها تنشئ وتوقّع وترسل فواتير معرّفها من الواجهة: المحرّر، الختم، مفاتيح API وسجل المهام. هذا الفضاء مستقل عن إدارة المؤسسات العميلة. clientId الشريك للمؤسسات العميلة، ومفاتيح API للمنظمة لمعرّفك أنت.
المصادقة
إدارة المؤسسات (القائمة، الإنشاء، الختم، TTN، الربط) تستخدم جلسة مدير كونكت: POST /api/auth/login ثم Authorization: Bearer. المالك والمديرون فقط يستدعون هذه المسارات.
الفوترة باسم مؤسسة عميلة تستخدم OAuth2 Client Credentials، كما في Partner API. احصل على رمز مرتبط بالمنظمة عبر clientId الشريك وorg_id المؤسسة، ثم اتبع الفواتير والتوقيع والمتابعة.
الباقات
| الباقة | المؤسسات | فواتير TTN / شهر |
|---|---|---|
partner-connect-starter | 10 | 500 |
partner-connect-business | 50 | 5 000 |
partner-connect-max | غير محدود | غير محدود |