دليل التكامل١ مارس ٢٠٢٦ · فريق إسناد
دليل تكامل فاتورة API — اربط نظامك بالمرحلة الثانية لزاتكا
ما هو تكامل فاتورة API؟
تكامل فاتورة API يعني أن برنامجك يستدعي منصات زاتكا لتسجيل EGS، وإدارة CSID، وإرسال XML الموقّع للإخلاء أو الإبلاغ. البوابة للتسجيل وOTP؛ الـ API للعمل اليومي.
مسارات التكامل
- تكامل مباشر مع فاتورة (تحكم كامل، تكلفة هندسية عالية)
- وحدة ERP / نقاط البيع من المورّد
- وسيط JSON مثل إسناد
الخطوة 1: بوابة فاتورة ووحدة EGS
سجّل الدخول، أكّد الموجة (انظر دليل الموجة 24)، وأضف وحدة لكل فرع/جهاز.
الخطوة 2: شهادات CSID
امتثال ثم إنتاج. تُجدَّد تقريباً كل سنة. OTP من فاتورة ينتهي خلال دقائق.
الخطوة 3: صيغة الفاتورة والتوقيع
UBL 2.1 السعودي، توقيع ECDSA، سلسلة PIH، وQR بـ TLV للفواتير المبسّطة.
الخطوة 4: الإخلاء (B2B) مقابل الإبلاغ (B2C)
اقرأ: B2B مقابل B2C.
الخطوة 5: من sandbox إلى الإنتاج
اختبر بمفاتيح zatca_test_ ثم انتقل إلى zatca_live_ بعد نجاح الامتثال.
شاهد اللوحة قبل أن تتكامل
استكشف العرض التجريبي لترى الفواتير وEGS والمفاتيح دون تسجيل.
متى يكون إسناد أسرع تكامل لفاتورة
إذا كنت تريد JSON مستقر دون صيانة XML والشهادات وانقطاع زاتكا — إسناد يمتص التغييرات. راجع واجهة زاتكا API.
تجاوز التعقيد التقني. استخدم واجهة إسناد.
أسرع طريقة لدمج امتثال زاتكا في أي نظام.