الربط

إذا كان المعرّف الجبائي موجودًا على fatoora.tn، لا تفتح حسابًا ثانيًا. ترسل طلبًا. المالك يقبله أو يرفضه أو يوقفه لاحقًا، من تبويب الربط في منظمته، برمز يصل إلى بريده.

الشريك لا يستدعي إرسال الرمز ولا دخول المالك ولا التأكيد. هذه الخطوات موجودة فقط في حساب المالك.

إرسال طلب

POST /api/partner/link-requests
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{ "sourceOrganizationId": "UUID_DU_COMPTE_EXISTANT" }

يُنشأ الطلب بالحالة pending.

العرض والتصفية

GET /api/partner/link-requests
GET /api/partner/link-requests?status=pending

status	المعنى
pending	قيد الانتظار. يشمل أيضًا otp_sent.
expired	بلا رد منذ أكثر من 7 أيام. قيمة محسوبة وليست مخزّنة.
cancelled	ألغاه الشريك.
rejected	رفضه المالك.
approved	مقبول. تظهر المؤسسة في القائمة.
revoked	أوقف المالك الربط.

بدون status تُعاد كل الطلبات.

إلغاء طلب مفتوح

POST /api/partner/link-requests/{id}/cancel

ما دام الطلب مفتوحًا وغير منتهٍ. الطلب المنتهي أو المرفوض أو المقبول لا يُلغى (REQUEST_EXPIRED).

من جهة المالك

في المنظمة ← الربط، المالك:

1. يقبل — يُرسل رمز إلى بريده ويؤكده في التبويب نفسه؛
2. يرفض؛
3. بعد الربط، يوقف الربط — أيضًا برمز بريدي.

بعد القبول تُدار المؤسسة كغيرها: الختم وTTN ثم الفوترة عبر Partner API.