قيود: فحص ملف الفاتورة الإلكترونية

أسماء المنتجات تُذكر هنا لتعيين الأنظمة لا غير. ومطابق مستقل عن الشركات التي تنتجها، ولا يتبع أياً منها ولا يحمل تأييدها.

الملف الذي يحتاجه مطابق

يفحص مطابق الفاتورة الإلكترونية نفسها: ملف XML بصيغة UBL 2.1 الذي يُنشأ لكل فاتورة وإشعار دائن وإشعار مدين في المرحلة الثانية من الفوترة الإلكترونية لدى هيئة الزكاة والضريبة والجمارك، سواء أنشأه نظامك أو أنشأته إضافة أو خدمة تكامل للفوترة الإلكترونية مربوطة به. ويصلح كذلك ملف PDF يتضمن فاتورة بصيغة XML، أي ملف PDF/A-3. أما ملف PDF الذي لا يتضمن ذلك الملف، أو النسخة المطبوعة، أو التصدير إلى جدول بيانات، أو لقطة الشاشة، فليس فيها ما يستطيع مطابق فحصه.

ما تقوله الوثائق المنشورة

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

أين يوجد الملف عادةً

يتوقف مكان ملف XML على الطريقة التي تصل بها مستندات نظامك إلى الهيئة، لا على اسم النظام وحده، ولا يسمّي هذا الدليل شاشة أو قائمة إلا حيث تنصّ عليها وثائق المزوِّد نفسه، مع الإحالة إليها وتاريخ قراءتها. والمواضع المعتادة للبحث:

قسم الفوترة الإلكترونية أو قسم الهيئة في نظامك، أو في الإضافة التي تتولى الفوترة الإلكترونية له؛ فقد يعرض كل مستند مع حالته ويتيح عرض ملف XML الخاص به أو تنزيله.
بوابة مزوّد حلول الفوترة الإلكترونية، إن كان مزوّد يرسل مستنداتك إلى الهيئة نيابةً عنك؛ فكثيراً ما يُحفظ ملف XML هناك إلى جانب نتيجة تقديم كل مستند للاعتماد أو الإبلاغ عنه.
تصدير المستند أو تنزيله بعد تقديمه للاعتماد أو الإبلاغ عنه، وقد يأتي مع ملف PDF المرسل إلى العميل.
مزوّد حلول الفوترة الإلكترونية أو الجهة التي نفّذت النظام لديك. فإن لم يظهر الملف في أيٍّ مما سبق، فاطلب ملف XML بصيغة UBL للمستند كما أُنشئ للهيئة تماماً.

افحص الملف كما أنشأه نظامك. فالنسخة التي تُفتح وتُحفظ من جديد في برنامج آخر قد لا تبقى الملف الذي تتسلّمه الهيئة.

من أين أحصل على ملف XML من قيود؟

توثّق قيود المسار في قاعدة معرفتها (توضيح شروط ظهور خيار إصدار وحفظ الفواتير بصيغة XML). وهذه خطواته كما تذكرها قيود، وقد قُرئت الصفحة في 2026-10-14:

تأكد من تفعيل ربط المرحلة الثانية مع الهيئة: «الإعدادات» ثم «الربط الإلكتروني».
انتقل إلى «المبيعات» ثم «فواتير المبيعات»، واضغط «عرض» بجانب الفاتورة المطلوبة.
مرّر إلى الأسفل وستجد خيار «تحميل الصيغة XML».

وتقول قيود إن الخيار يظهر فقط إذا كان الربط مع الهيئة مفعّلاً بنجاح، وإن الفاتورة يجب أن تحتوي على جميع البيانات الإلزامية المطلوبة للربط؛ ولا تفرّق الصفحة بين الفاتورة الضريبية والفاتورة المبسطة. وتضيف ملاحظات تحديث قيود بتاريخ 2026-08-23 زر «تحميل XML» في صفحة عرض المستند للمنشآت المفعّلة للمرحلة الأولى من الفوترة الإلكترونية، للفواتير الضريبية والإشعارات الدائنة والمدينة المعتمدة أو المدفوعة كلياً أو جزئياً، ومنها الصادرة من قبل (تحديثات الفوترة الإلكترونية: تحميل XML). وتقول ملاحظات تحديثها بتاريخ 2026-05-24 إن ملف PDF الذي تنشئه قيود لعملاء الشركات المفعّل لديهم المرحلة الثانية يحمل ملف XML مضمَّناً فيه بصيغة PDF/A-3، ويقرأ مطابق هذا الملف أيضاً (دمج ملف XML داخل مستند PDF).

والقوائم تتغيّر، ولم يتحقق مطابق من هذه الشاشات بنفسه. فإن اختلف ما تراه، فاطلب من دعم قيود ملف XML للفاتورة، أو ملف PDF/A-3 يتضمنه.

ما الذي تتحقق منه في الملف المصدَّر

أرقام التسجيل في ضريبة القيمة المضافة: تحقّق من أن cac:PartyTaxScheme/cbc:CompanyID على البائع والمشتري كلٌّ منهما الأرقام الخمسة عشر وحدها، يبدأ بالرقم 3 وينتهي به. فالرقم الذي يبلغ خمسة عشر رقماً ويخطئ أوله أو آخره مرفوض كذلك؛ ويذكر MTB-BR-KSA-40 رقم البائع وMTB-BR-KSA-44 رقم المشتري.
تاريخ الإصدار: تحقّق من أن cbc:IssueDate ليس بعد يوم الفحص، وراجع المنطقة الزمنية لما يختمه: فالخادم الذي يعمل بمنطقة متقدّمة على توقيت المملكة يختم تاريخ الغد في ساعات المساء المتأخرة. ويذكر MTB-BR-KSA-04 التاريخ الواقع في المستقبل.
التوريدات الخاضعة بنسبة الصفر والمعفاة: يُقرأ رمز السبب من cac:TaxSubtotal/cac:TaxCategory/cbc:TaxExemptionReasonCode في التفصيل الضريبي، لا من البند. تحقّق من أن كل تفصيل مرمَّز Z أو E يحمل أحد رموز VATEX-SA المنشورة بلا مسافة فيه؛ ويذكر MTB-BR-KSA-CL-04 الرمز. أما التفصيل المرمَّز Z أو E الذي لا يحمل رمزاً أصلاً، أو يحمله فارغاً، فيذكره MTB-BR-KSA-69 وMTB-BR-KSA-23، وكلتاهما مصنَّفة تحذيراً لا خطأً في أداة الفحص الحالية لدى الهيئة.
عنوان المشتري: في الفاتورة الضريبية لعميل سعودي تقرأ الهيئة ستة عناصر تحت cac:AccountingCustomerParty/cac:Party/cac:PostalAddress: cbc:StreetName وcbc:BuildingNumber وcbc:CityName وcbc:PostalZone وcbc:CitySubdivisionName (الحي) وcac:Country/cbc:IdentificationCode. تحقّق من وجودها كلها غير فارغة؛ ويذكر MTB-BR-KSA-63 غياب أحدها، بدرجة تحذير.
يُقرأ معرِّف البائع من cac:PartyIdentification/cbc:ID للبائع مع السمة schemeID. تحقّق من أن السمة أحد الرموز CRN أو MOM أو MLS أو SAG أو OTH أو 700؛ ويذكر MTB-BR-KSA-08 ما عدا ذلك، بدرجة تحذير. ومعرِّف العميل في فاتورة لجهة حكومية أو منشأة هو نظيره عند المشتري، بقائمة أطول تضم NAT وTIN وCRN، ويذكره MTB-BR-KSA-14.
تحقّق من أن cbc:InvoiceTypeCode يحمل 388 أو 381 أو 383، ومن أن السمة name عليه سبعة محارف أو ثمانية أو تسعة تبدأ بـ 01 في الفاتورة الضريبية و02 في الفاتورة المبسطة، والمواضع الباقية كل منها 0 أو 1؛ ويذكر MTB-STRUCT-01 السمة.
وتحقّق من وجود مرجعي المستند ICV وPIH، ومن أن العدّاد في الأول أرقام لا غير ويزيد مع كل مستند، ومن أن البصمة في الثاني قيمة غير فارغة بترميز base64 معلَنة بنوع المحتوى text/plain.
وفي الفاتورة المبسطة، تحقّق من أن مرجع المستند QR يحمل حمولة غير فارغة بترميز base64، ومن أن اسم البائع ورقم التسجيل في ضريبة القيمة المضافة والطابع الزمني والإجمالي ومبلغ الضريبة في الحمولة تطابق ما في ملف XML حولها.

ما الذي تفعله بالملاحظات

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

المصادر

قُرئت الصفحتان الأوليان في 2026-09-11، ومقالة قاعدة المعرفة وملاحظتا التحديث في 2026-10-14. ووثائق المزوِّدين تتغيّر.

القواعد التي تقرؤها

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

افحص فاتورة

افحص فاتورة نموذجية في المتصفح