الفواتير الإلكترونية (هيئة الزكاة والضريبة والجمارك)

تشترط هيئة الزكاة والضريبة والجمارك (منظومة «فاتورة») أن تُنشأ كل فاتورة ضريبية إلكترونيًا بصيغة XML موحدة، وأن تحمل رمز استجابة سريعة، وأن تُوقَّع بشهادة تصدرها الهيئة لوحدة الفوترة الخاصة بمنشأتك، ثم تُرسل إليها: الفاتورة الضريبية (بين منشآت) تُعتمد قبل أن تصل إلى المشتري، والفاتورة المبسطة (للمستهلك) يُبلَّغ عنها خلال 24 ساعة. صفحة الفواتير (قسم المبيعات) تقوم بذلك كله: تكتب مسودة، وتضغط إصدار، فتحصل الفاتورة على رقمها وختمها ورمزها وتُرسل إلى الهيئة في الخطوة نفسها.

نطاق هذه الصفحة هو المستند نفسه: تُصدر المنصة الفاتورة المتوافقة وتتوقف عند ذلك. تسجيل المدفوعات، ومتابعة الذمم المدينة، والقيود المحاسبية كلها تبقى في برنامجك المحاسبي، الذي يستلم الفاتورة الصادرة من هنا (بصيغة PDF أو XML).

المسودة

أسرع طريقة هي زر إنشاء فاتورة في صفحة أمر البيع أو عرض السعر: يفتح النموذج معبّأً بالعميل والبنود بأسعارها وفئة ضريبتها. ويمكنك البدء من الصفر. تختار نوع المستند (فاتورة ضريبية، إشعار دائن، إشعار مدين) ونوعه (ضريبية بين منشآت أو مبسطة للمستهلك)، وتختار العميل من دليل العملاء فتُملأ كتلة المشتري (الاسم القانوني والرقم الضريبي أو المعرّف الآخر والعنوان الوطني) من ملفه، أو تدخل بيانات المشتري بيدك، ثم تاريخ التوريد، وطريقة الدفع، والبنود. كل بند يحمل فئة ضريبته: النسبة الأساسية 15%، أو نسبة الصفر مع سبب الإعفاء (الأدوية والمستلزمات الطبية هي VATEX-SA-35)، أو معفاة، أو خارج النطاق. اختيار منتج من الكتالوج يملأ الوصف والسعر وفئة الضريبة من بيانات المنتج.

ما تحتاجه الفاتورة قبل الإصدار

تعرض صفحة المسودة قائمة بما ينقصها وفق اشتراطات الهيئة، وزر الإصدار لا يعمل حتى تكتمل. جانب البائع يُضبط مرة واحدة في إعدادات المنشأة: الاسم القانوني، والرقم الضريبي (15 رقمًا يبدأ وينتهي بـ3)، والسجل التجاري، والعنوان الوطني (الشارع، ورقم المبنى المكوّن من 4 أرقام، والحي، والمدينة، والرمز البريدي المكوّن من 5 أرقام). جانب المشتري يعتمد على النوع: الفاتورة الضريبية تحتاج إلى الرقم الضريبي للمشتري أو معرّف آخر (سجل تجاري، هوية…) وعنوانه وتاريخ التوريد؛ الفاتورة المبسطة تكتفي باسم العميل. الإشعار الدائن أو المدين يحتاج إلى الفاتورة الصادرة التي يصحّحها وسبب الإصدار.

الإصدار

1. تحصل الفاتورة على رقمها المتسلسل وتاريخ ووقت الإصدار بتوقيت الرياض.
2. يُبنى ملف XML بصيغة الهيئة وتُحسب بصمته (SHA-256) مرتبطةً ببصمة الفاتورة السابقة (سلسلة PIH) مع عداد الفواتير (ICV).
3. تُوقَّع الفاتورة بمفتاح وحدة الفوترة الإلكترونية وشهادتها، ويُبنى رمز الاستجابة السريعة الذي يحمل البصمة والتوقيع والمفتاح العام.
4. تُجمَّد الفاتورة: لا يمكن تعديلها أو حذفها بعد ذلك، والتصحيح يكون بإشعار دائن أو مدين يشير إليها.
5. تُرسل إلى الهيئة: اعتماد للفاتورة الضريبية، وإبلاغ للفاتورة المبسطة. تظهر النتيجة على الفاتورة (معتمدة، مُبلَّغ عنها، مرفوضة مع رسائل الهيئة، أو بانتظار الهيئة إن تعذّر الوصول إليها، وعندها يعيد زر إعادة الإرسال إرسال الملف نفسه).

من صفحة الفاتورة تنزّل PDF الفاتورة المطبوعة (بالعربية مع الإنجليزية، مع رمز الاستجابة السريعة وجدول الضريبة) وXML الموقّع الذي استلمته الهيئة، ونسخة XML المعتمدة من الهيئة للفواتير الضريبية المعتمدة.

إعداد وحدة الفوترة الإلكترونية

الوحدة هي ما توقّع الفواتير باسم منشأتك، ويعدّها المالك من الإعدادات ← الفوترة الإلكترونية في أربع خطوات: توليد المفاتيح وطلب الشهادة، ثم طلب شهادة الامتثال برمز تحقق من منصة «فاتورة» (ربط وحدة حل جديدة)، ثم تشغيل فحوصات الامتثال الستة (فاتورة ضريبية ومبسطة وإشعار دائن ومدين لكل منهما)، ثم طلب شهادة الإنتاج. البيئة التجريبية تقبل رمز التحقق 123345 وتصدر شهادات اختبار، فهي الطريقة لتجربة الدورة كاملة قبل الإنتاج؛ الوحدة مرتبطة ببيئتها، فالانتقال إلى الإنتاج يكون بإعادة ضبطها والبدء من جديد.

سجل النشاط والأرشيف والتحقق

تشترط الهيئة أن يسجّل الحل المتوافق كل نشاط في عملية الفوترة دون إمكانية تعديله أو حذفه، وأن يتيح تصدير الفواتير إلى أرشيف خارجي، وأن يكشف أي تلاعب بالمستندات المخزّنة. بطاقة سجل النشاط أسفل كل فاتورة تعرض كل ما جرى لها: إنشاء المسودة وتعديلها، والإصدار، والإرسال إلى الهيئة مع ردّها، وتنزيل PDF أو XML، مع اسم العضو ووقت الإجراء والقناة (التطبيق، أو واجهة API التي يستخدمها المساعد). السجل يُكتب فقط، ولا يستطيع أحد تعديل قيد أو حذفه، حتى المنصة نفسها؛ وكل قيد مرتبط بسابقه ببصمة تجزئة، فتغيير ترتيب القيود أو محتواها ينكشف عند التحقق.

زر تنزيل الأرشيف أعلى قائمة الفواتير (للمدير والمالك) يعطيك ملف ZIP يحوي XML الموقّع لكل مستند صادر، كل ملف باسم يجمع الرقم الضريبي ووقت الإصدار ورقم الفاتورة (300000000000003_20260922T104500_INV-000001.xml) كما تشترط الهيئة للأرشفة، ونسخة الهيئة المعتمدة بجانبه بلاحقة .cleared.xml، وملف manifest.json يسرد الأرقام والمعرّفات والبصمات. حدّد فترة بتاريخ الإصدار إن كثرت المستندات.

بطاقة سلامة السجلات في الإعدادات ← الفوترة الإلكترونية (للمالك) تعيد حساب بصمة كل مستند صادر من ملف XML المخزّن وتقارنها بالمسجّل، وتتحقق من الختم بالشهادة الموجودة في الملف، ومن ارتباط كل فاتورة بسابقتها وتسلسل العدّاد، ومن مطابقة الملف للسجل، ومن عدّاد الوحدة وآخر بصمة لها، ومن سلسلة سجل النشاط نفسه. النتيجة تسمّي الفاتورة والمشكلة إن وُجدت. شغّلها قبل أي تدقيق.

الصلاحيات

• العرض: كل من يرى أسعار البيع (المالك والمدير ومندوبو المبيعات والمشتريات والمشاهد)؛ المشاهد دون أسعار والفني لا يرون الفواتير.
• المسودات: المبيعات والمشتريات فما فوق ينشئون المسودات ويعدلونها ويحذفونها.
• الإصدار وإعادة الإرسال: المدير والمالك فقط.
• وحدة الفوترة الإلكترونية والتحقق من السجلات: المالك فقط، مثل بقية إعدادات المنشأة.
• أرشيف XML: المدير والمالك، كبقية عمليات التصدير. سجل النشاط يقرؤه كل من يرى الفواتير.

الواجهة البرمجية وMCP

كل ما سبق متاح عبر واجهة REST وخادم MCP: invoices_list وinvoices_get وinvoices_create وinvoices_update وinvoices_delete وinvoices_issue وinvoices_submit وinvoice_pdf وinvoice_xml بالنطاقين invoices.read وinvoices.write، وinvoice_events_list لسجل النشاط وinvoice_archive_zip للأرشيف، وأدوات zatca_egs_* لإعداد الوحدة وzatca_chain_verify للتحقق بنطاقي الإعدادات. يعيد invoices_get قائمة readiness_issues بما ينقص المسودة قبل الإصدار، وهي ما يفترض أن يعرضه المساعد قبل أن يطلب الإصدار.