اختبار الاتصال
نتأكد أولاً أن واجهة الاختبار تستطيع الوصول إلى API من خلال فحص health الرسمي.
لا تحتاج لإدخال أي بيانات هنا. هذه الخطوة فقط تتأكد أن API يعمل.
بيانات CSR
هذه البيانات تنشئ ملف توقيع اختباري. القيم الحالية قيم محاكاة ويمكن تغييرها عند اختبار عميل حقيقي لاحقاً.
سنرسل CSR الذي تم إنشاؤه في الخطوة السابقة إلى ZATCA Sandbox بصيغة base64 فقط.
بيانات الفاتورة
اكتب بيانات عادية مثل أي فاتورة. سيحوّلها API إلى XML في الخطوة نفسها.
سيتم استخدام بيانات البائع من ملف المحاكاة الحالي حتى تتطابق الفاتورة مع شهادة الاختبار.
سيقوم API بتوقيع XML بشهادة Compliance CSID، إنشاء طلب الفاتورة، ثم إرسالها إلى Compliance Invoice API.
لا توجد بيانات جديدة هنا. سنستخدم Compliance Request ID وشهادة الامتثال لإكمال onboarding في بيئة المحاكاة.
هذه خطوة اختبار دورة الحياة. سننشئ CSR جديد داخلياً ثم نرسل PATCH إلى Production CSID Renewal API.
سيتم توقيع XML الأصلي باستخدام شهادة المحاكاة الحالية والمفتاح الخاص المطابق لها.
سنستخرج QR من XML الموقّع باستخدام SDK ثم نتحقق من TLV/Base64 محلياً.
سنحوّل XML الموقّع إلى طلب JSON يحتوي على invoiceHash و uuid و invoice.
سيتم تشغيل compliance guard ثم الإرسال إلى ZATCA مع Clearance-Status كما يتطلب sandbox.
القيم التقنية المتقدمة
Diagnostics
النتيجة
هنا تظهر نتيجة الخطوة الحالية فقط.
جاهز للاختبار...
الحالة
- CSR
- -
- Private Key
- -
- Generated XML
- -
- Compliance Invoice
- -
- Signed XML
- -
- QR
- -
- Invoice Request
- -