# دليل تفعيل Phase 2 للشركات (B2B)

هذا الدليل مكتوب على أساس أن استخدامك الأساسي هو **شركة إلى شركة**، وبالتالي نوع الفاتورة الافتراضي داخل النظام هو:

- **Standard Tax Invoice / الفاتورة القياسية**
- ومسار الإرسال المتوقع هو **Clearance**

## ما الذي أحتاجه بالضبط من الزكاة؟

ستحتاج 3 أشياء عملية:

### 1) OTP
هذا هو الكود الأول الذي ستأخذه من بوابة **Fatoora Portal** عند عمل onboarding للجهاز أو الـsolution unit.

ضعه داخل خانة **OTP** في صفحة Phase 2، ثم استخدم زر:

- **Request Compliance CSID**

### 2) Compliance CSID + Compliance Request ID
بعد أن تولد **CSR + Private Key** من داخل النظام، ستستخدم الـOTP لطلب **Compliance CSID**.

بعد نجاح هذه الخطوة، النظام سيحفظ لك:

- شهادة الـCompliance
- Compliance token / secret
- **Compliance Request ID**

ولو احتجت إدخال الـCompliance Request ID يدويًا، ضعه داخل خانة:

- **Compliance Request ID**

### 3) Production CSID أو Test Production CSID
بعد نجاح فحص الـCompliance ستحتاج بيانات الإرسال الفعلي، وهي:

- **Binary Security Token**
- **Secret**
- **Certificate PEM**

ضعهم داخل الخانات التالية في صفحة Phase 2:

- **Production / Test Production Binary Security Token**
- **Production / Test Production Secret**
- **Production / Test Production Certificate PEM**

> داخل بيئة Sandbox قد ترى اسم **Test Production CSID**.
> داخل البيئة الحقيقية سيكون المقصود **Production CSID**.

---

## الترتيب الصحيح للتفعيل

### الخطوة 1: أكمل بيانات الشركة
من صفحة **الإعدادات** أكمل:

- اسم الشركة
- رقم VAT للبائع
- العنوان
- السجل التجاري
- الشعار (اختياري لكن مفيد للهوية البصرية)

### الخطوة 2: افتح صفحة Phase 2
اضبط:

- **Environment = Sandbox** في البداية
- **Device UUID / ID**
- **QR Mode = Auto**

### الخطوة 3: ولّد CSR + Key
اضغط:

- **Generate CSR + Key**

النظام سيولد ويحفظ:

- CSR
- Private Key
- Public Key

### الخطوة 4: خذ OTP من بوابة الزكاة
من Fatoora Portal أو بيئة الـSandbox الخاصة بالربط:

- اعمل onboarding للجهاز
- ولّد OTP
- انسخه إلى النظام

### الخطوة 5: اطلب Compliance CSID
بعد وضع الـOTP اضغط:

- **Request Compliance CSID**

بعدها راجع حالة الجاهزية في أعلى الصفحة.

### الخطوة 6: نفّذ فحص الـCompliance
نفّذ الفحص المطلوب على الفواتير التجريبية من خلال بوابة الزكاة / الـSandbox.

### الخطوة 7: خذ Production CSID أو Test Production CSID
بعد نجاح فحص الـCompliance:

- انسخ الـToken
- انسخ الـSecret
- انسخ الـCertificate PEM
- الصقهم في صفحة Phase 2

### الخطوة 8: فعّل Phase 2
فعّل الاختيار:

- **تفعيل Phase 2 الآن**

ثم احفظ.

إذا كانت كل عناصر الجاهزية مكتملة، سيُفعَّل النظام بنجاح.

---

## كيف أستخدمه بعد التفعيل؟

بما أنك تصدر فواتير من **شركة إلى شركة**:

- اترك نوع الفاتورة على **Standard**
- أدخل **اسم العميل**
- أدخل **رقم VAT للعميل**
- أنشئ الفاتورة
- من الأرشيف ستجد زر **Clearance** لهذه الفاتورة

إذا كانت الفاتورة قياسية بدون رقم VAT صحيح للمشتري، سيمنعك النظام من الاعتماد عليها كفاتورة B2B.

---

## ملاحظات مهمة

- ابدأ دائمًا بـ **Sandbox**
- بعد نجاح الاختبارات انقل نفس المسار إلى **Production**
- لا تضع ملفات الشهادات داخل web root
- اترك **QR Mode = Auto** في أغلب الحالات
- هذا النظام أصبح مفصولًا بين:
  - **Compliance credentials**
  - **Submission credentials**

---

## ماذا أفعل لو البوابة رجعت لي بيانات ولم أعرف أين أضعها؟

استخدم هذا الجدول:

| من الزكاة | أين أضعه داخل النظام |
|---|---|
| OTP | خانة OTP |
| Compliance Request ID | خانة Compliance Request ID |
| Binary Security Token | خانة Production / Test Production Binary Security Token |
| Secret | خانة Production / Test Production Secret |
| Certificate PEM | خانة Production / Test Production Certificate PEM |
| Private Key PEM (لو عندك خارجيًا) | خانة Private Key PEM |

---

## المسار الأسرع الموصى به

1. الإعدادات
2. Generate CSR + Key
3. OTP
4. Request Compliance CSID
5. Compliance checks
6. Production / Test Production CSID
7. تفعيل Phase 2
8. إنشاء Standard invoice
9. Clearance من الأرشيف
