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

مقدمة عن ربط الأنظمة مع هيئة الزكاة والضريبة والجمارك

عملية ربط نظام الفوترة الإلكترونية مع منصة فاتورة التابعة لهيئة الزكاة والضريبة والجمارك هي الركيزة الأساسية للمرحلة الثانية. هذا الربط يضمن أن كل فاتورة تُصدرها منشأتك يتم إرسالها والتحقق منها واعتمادها من الهيئة بشكل آلي وفوري.

قد تبدو العملية معقدة من الناحية التقنية، لكن مع الفهم الصحيح للمتطلبات واستخدام الأدوات المناسبة، يمكن إتمامها بسلاسة. في هذا الدليل، سنشرح العملية بأكملها خطوة بخطوة.

المتطلبات الأساسية قبل البدء

قبل الشروع في عملية الربط، تأكد من توفر المتطلبات التالية:

1. تسجيل ضريبي ساري المفعول

يجب أن تكون منشأتك مسجلة في ضريبة القيمة المضافة لدى هيئة الزكاة والضريبة والجمارك. رقم التسجيل الضريبي (TIN) مطلوب في جميع مراحل الربط.

2. نظام فوترة إلكترونية متوافق

النظام يجب أن يدعم معايير المرحلة الثانية، بما في ذلك إصدار فواتير بصيغة UBL 2.1 XML، والتوقيع الرقمي، وتوليد رموز QR.

3. بيئة تقنية مناسبة

يحتاج الربط إلى اتصال إنترنت مستقر وبيئة خادم آمنة (أو نظام سحابي) قادرة على معالجة طلبات API بشكل موثوق.

خطوات عملية الربط

المرحلة الأولى: التسجيل في بوابة المطورين

الخطوة الأولى هي تسجيل نظام الفوترة الخاص بك في بوابة مطوري هيئة الزكاة والضريبة والجمارك. هذه البوابة توفر الوثائق التقنية وبيئة الاختبار (Sandbox) اللازمة لعملية الربط.

عند التسجيل، ستحصل على:

• مفاتيح API للوصول إلى بيئة الاختبار
• وثائق تقنية شاملة لجميع نقاط النهاية (Endpoints)
• أمثلة على الفواتير المتوافقة

المرحلة الثانية: الحصول على شهادة التوقيع الرقمي

عملية التوقيع الرقمي تتطلب شهادة CSID (Compliance Solution Identifier). للحصول عليها:

1. يقوم النظام بإنشاء طلب توقيع شهادة (CSR) يحتوي على بيانات المنشأة

2. يُرسل الطلب إلى منصة فاتورة عبر API المخصص

3. تصدر الهيئة شهادة التوافق المبدئية (Compliance CSID)

4. بعد اجتياز اختبارات التوافق، تُصدر شهادة الإنتاج (Production CSID)

المرحلة الثالثة: بناء الفاتورة الإلكترونية المتوافقة

الفاتورة الإلكترونية المتوافقة تتضمن:

• بيانات البائع والمشتري كاملة
• تفاصيل البنود والأسعار
• حسابات ضريبة القيمة المضافة
• التوقيع الرقمي باستخدام CSID
• رمز QR بصيغة TLV
• تجزئة الفاتورة (Hash) للربط مع الفواتير السابقة

المرحلة الرابعة: إرسال الفاتورة واستلام الاعتماد

بعد بناء الفاتورة وتوقيعها:

1. يُرسل النظام الفاتورة بصيغة XML إلى منصة فاتورة

2. تقوم الهيئة بالتحقق من صحة البيانات والتوقيع

3. في حالة القبول، يُرسل رد بحالة "مقبولة" مع ختم التشفير

4. في حالة الرفض، يُرسل رد يوضح أسباب الرفض لتصحيحها

تبسيط العملية مع فاتورة برو

كل هذه الخطوات التقنية المعقدة يتولاها نظام فاتورة برو تلقائياً. كمستخدم، كل ما عليك فعله هو إدخال بيانات منشأتك مرة واحدة، وسيتولى النظام:

• إنشاء وتجديد شهادات التوقيع الرقمي
• بناء الفواتير بصيغة XML المتوافقة تلقائياً
• إرسال الفواتير إلى الهيئة واستلام الاعتمادات
• توليد رموز QR وتجزئة الفواتير
• حفظ سجل كامل لجميع المعاملات

وفر وقتك وجهدك — دع فاتورة برو يتولى الجانب التقني بينما تركز أنت على نمو أعمالك.