Sultan Mohammed Sunyur Contracting Company

Phase 2

Prepare B2B clearance credentials step by step, then activate ZATCA integration.
Activated
Phase 2 6/9
Language:
Arabic English

جاهزية الربط B2B مع الزكاة

بما إنك هتطلع فواتير من شركة إلى شركة، فالمسار الأساسي هنا هو Standard / B2B ثم Clearance بعد اكتمال التهيئة.
6/9
بعد OTP احفظ Compliance Request ID، أو الصق بيانات Test Production CSID مباشرة إذا استخرجتها من البوابة.
  • بيانات الشركة الأساسية اسم الشركة ورقم VAT للبائع مطلوبان.
    جاهز
  • عنوان الشركة العنوان مطلوب عمليًا قبل التفعيل والإرسال.
    جاهز
  • امتدادات PHP يلزم OpenSSL و cURL على السيرفر.
    جاهز
  • Environment و Device ID حدّد البيئة وأدخل Device ID / UUID.
    جاهز
  • CSR ولّد CSR قبل طلب أي CSID.
    جاهز
  • Private Key المفتاح الخاص يجب أن يكون محفوظًا داخل التخزين الآمن.
    جاهز
  • OTP / Compliance Request ID بعد OTP احفظ Compliance Request ID، أو الصق بيانات Test Production CSID مباشرة إذا استخرجتها من البوابة.
    ناقص
  • Test Production CSID Certificate الصق شهادة Test Production CSID PEM داخل الصفحة أو احفظها يدويًا.
    ناقص
  • Test Production CSID Token + Secret الإرسال الفعلي للفواتير يحتاج Binary Security Token و Secret الخاصة بـ Test Production CSID.
    ناقص

المطلوب منك من موقع الزكاة

البرنامج جهزته بحيث يفصل بين Compliance و Test Production CSID؛ أنت فقط هتجيب الأكواد من البوابة أو الـSandbox وتحطها هنا.
1) OTP من Fatoora Portal من البوابة: افتح onboarding للجهاز أو الـsolution unit وولّد OTP، ثم استخدمه خلال مدته في خطوة طلب Compliance CSID.
2) Compliance CSID بعد توليد CSR من هنا، اطلب Compliance CSID عبر OTP. النظام سيحفظ لك شهادة الـCompliance وطلب الـCompliance Request ID.
3) Test Production CSID بعد نجاح فحص الـCompliance، هتحتاج التوكن + الـSecret + الشهادة الخاصة بخطوة الإرسال الفعلي. الصقهم في النموذج بالأسفل.
4) تشغيل B2B / Clearance بمجرد اكتمال الجاهزية وتفعيل Phase 2، الفواتير القياسية هتظهر لك في الأرشيف بزر Clearance لأن ده مسار شركة إلى شركة.
EnvironmentSandbox
ActivationDisabled
QR Modeauto
CSRReady
ComplianceMissing
Test Production CSIDMissing
CSR Pathphase2/certificate.csr
Private Key Pathphase2/private_key.pem
Compliance Cert Path
Test Production CSID Cert Path
Last API Response

تشخيص الاستضافة وQR

لو واجهت مشكلة في ظهور QR أو حفظ الأرشيف، راجع المؤشرات دي أولًا.
6/7
  • Storage writable/home/bas6407/public_html/bk-invoice-data
    جاهز
  • Archive writable/home/bas6407/public_html/bk-invoice-data/archive
    جاهز
  • QR cache writable/home/bas6407/public_html/bk-invoice-data/qr-cache
    جاهز
  • cURL availableمطلوب للإرسال ولتحميل QR الخارجي على أغلب الاستضافات.
    جاهز
  • OpenSSL availableمطلوب لـ CSR والتوقيع.
    جاهز
  • External QR modeQuickChart proxy enabled
    جاهز
  • Local QR runtimeاختياري فقط. عدم توفره لا يمنع ظهور QR بعد هذا التحديث.
    راجع

إعدادات التفعيل

احفظ البيانات الآن براحتك. التفعيل نفسه لن يثبت إلا بعد اكتمال العناصر المطلوبة.
ابدأ بـ Sandbox للتجربة، وبعدها انقل نفس المسار إلى Production ببياناته الحقيقية.
مهم لربط نفس الجهاز أو الـEGS unit داخل البوابة وداخل الـCSR.
انسخه من البوابة ثم استخدمه في زر Request Compliance CSID.
للاستخدام اليومي خليها Auto، وسيستخدم Phase 2 تلقائيًا لما تبقى الشهادة جاهزة.
الحالة الحالية
مدخلات التفعيل أو الاستبدال عند الحاجة
الأسرار والمفاتيح لا تُعرض هنا نصًا. أنت فقط تشوف حالة الحفظ وتستبدل القيم عند الحاجة.

أدوات الجاهزية

رتبت لك الخطوات بحيث ما تحتاجش تلف بين الشاشة والوثائق. اعملهم بالترتيب ده.
أ) Generate CSR + Key شغّل الزر مرة واحدة لكل جهاز أو بيئة. لو بيئة الخادم تدعم EC، النظام يفضّل ECDSA P-256 تلقائيًا.
ب) Request Compliance CSID بعد ما تحط OTP فوق، اطلب الـCompliance مباشرة من هنا. هيتم حفظ الشهادة والـtoken والـsecret داخل مجلد البيانات الآمن.
CSR Preview
-----BEGIN CERTIFICATE REQUEST----- MIIBXzCCAQQCAQAwgaExCzAJBgNVBAYTAlNBMTMwMQYDVQQKDCpTdWx0YW4gTW9o YW1tZWQgU3VueXVyIENvbnRyYWN0aW5nIENvbXBhbnkxDjAMBgNVBAsMBVpBVENB MRgwFgYDVQQDDA8zMTA1NzYxNzM3MDAwMDMxHDAaBgNVBAUTE2RldmljZS0wMzc1 MzlmMDkwM2MxFTATBgNVBAcMDERlZmF1bHQgQ2l0eTBZMBMGByqGSM49AgEGCCqG SM49AwEHA0IABGaJDgQWlw1DN7I4c3heKyIr34fTqjj5hJznd3U3lghqK5eImzSQ hn+NQJ0K4Z2Ug2ORKg4pMNt1jKWPflmGrMOgADAKBggqhkjOPQQDAgNJADBGAiEA 8xWMh1ymtGiVubs5jqV4M8+fgzUMfz5L8+Cn/kJS82ECIQDqCnqza0fpzFaQom78 BmHEZht1ivlGhHQy3XXHown8Bw== -----END CERTIFICATE REQUEST-----
المسار العملي المختصر:
  1. أكمل بيانات الشركة والعنوان من صفحة الإعدادات.
  2. ولّد CSR والمفتاح.
  3. هات OTP واطلب Compliance CSID.
  4. نفّذ فحص الـCompliance في بوابة الزكاة أو الـSandbox.
  5. هات Test Production CSID والصقه هنا.
  6. فعّل Phase 2 وابدأ Clearance للفواتير القياسية B2B.
💬WhatsApp Support