ما نفعله عنك
أنت ترسل بيانات الفاتورة، ونحن نتولى كل ما يخص الهيئة.
الخطوات الأربع
جاهز في أربع خطوات
سجّل حسابك
أنشئ حسابك ببيانات منشأتك: الاسمان والرقم الضريبي ورقم السجل التجاري والعنوان الوطني. تدخل هذه البيانات في طلب شهادتك لدى الهيئة وفي كل فاتورة، فيجب أن تطابق ما لدى الهيئة عنك.
سجّل لدى الهيئة
أنشئ رمزًا لمرة واحدة (OTP) من بوابة فاتورة وأدخله في لوحة التحكم. ننشئ مفاتيحك ونطلب شهادتك من الهيئة ونُكمل فحص الامتثال الخاص بها. يستغرق ذلك بضع دقائق: لا ترسل الطلب مرتين.
أنشئ الرمز (Token)
أنشئ رمز الـ API من لوحة التحكم، وأرسله كـ Bearer token مع كل استدعاء. إذا فقدته أنشئ رمزًا جديدًا ويتوقف القديم عن العمل.
أرسل فواتيرك
أرسل كل فاتورة بصيغة JSON إلى واجهة الفواتير. نردّ عليك بنتيجة الهيئة: الحالة وأي تحذيرات أو أخطاء، وملف XML الموقّع.
أنواع الفواتير
فاتورة ضريبية وفاتورة مبسّطة، وإشعارات دائنة ومدينة
الفاتورة الضريبية (B2B)
تُرسل إلى الهيئة للاعتماد: تفحصها الهيئة وتعيد الفاتورة مختومة. وفق قواعد الهيئة، بيانات المشتري ومنها العنوان مطلوبة.
الفاتورة المبسّطة (B2C)
يُبلَّغ بها الهيئة. وفق قواعد الهيئة، عنوان المشتري غير مطلوب.
الإشعارات الدائنة والمدينة تُرسل بالطريقة نفسها، للنوعين.
مفيد أن تعرف
إرسال الفاتورة نفسها مرتين آمن
أرسل رقم فاتورتك الخاص مع كل فاتورة. إذا كانت الهيئة قد قبلت هذا الرقم من قبل، تحصل على النتيجة المحفوظة ولا يُرسل شيء مرة أخرى.
ما تقوله الهيئة تراه
تحذيرات الهيئة وأخطاؤها تعود إليك في الرد كما هي، فتعرف بالضبط ما الذي يجب تصحيحه.
عربي أو إنجليزي
رسائلنا بالعربية. أضف lang=en إلى الاستدعاء لتصلك بالإنجليزية.
باقتك تحدد الحد
كل باقة تتيح عددًا من الفواتير. تواصل معنا للحصول على تجربة مجانية أو للانتقال إلى باقة أخرى.