كيف تصدر فواتير إلكترونية لهيئة الزكاة من نظامك عبر الواجهة البرمجية

الخطوات

1. افتح واجهة الفوترة

   اختر المبيعات ← «واجهة الفوترة البرمجية»: تعرض «العنوان الأساسي» و«بوابة زاتكا» التي يُصدر عبرها خادمك، واستدعاءات الشهر الفعلية والتجريبية.

2. أنشئ مفتاح اختبار

   تحت «مفاتيح الواجهة البرمجية» اختر «اختبار» و«السماح بالكتابة» ثم «إنشاء مفتاح». انسخ السر الآن: لن يظهر مجدداً.

3. أرسل فاتورة تجريبية

   أرسل «مثال على الطلب» مع ترويسة Idempotency-Key؛ وتكرار المفتاح نفسه يعيد الإجابة الأولى. صحّح ما تذكره الإجابة تحت zatca.issues.

4. انتقل إلى الفعلي

   بعد تفعيل جهاز هيئة الزكاة («التفعيل من صفحة الامتثال») أنشئ مفتاحاً «فعلي»: تُصدر فواتيره وتُرحَّل وتُرسل إلى الهيئة. وأضف وجهة في «الويب هوك» ليصلك الرد.

أدلة أخرى