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

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

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

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

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

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

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

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

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

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

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

لا تنشر زد مساراً لذلك. ففي 2026-10-15 كان مقال الربط ومقال إعدادات الفاتورة يصفان الربط بمنصة «فاتورة» وإعدادات الفاتورة، ولا يذكران شيئاً عن عرض ملف XML للفاتورة أو تنزيله أو تصديره، ولا عن نسخة PDF/A-3 تحمله. وما في يد تاجر زد هو الفاتورة المُعطاة للمشتري، مطبوعة أو ملف PDF، وهذا جائز في الفاتورة المبسطة، وليس فيه ما يفحصه مطابق (ما الذي يفحصه مطابق في ملف PDF).

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

ما الذي تتحقق منه في ملف XML

بيانات البائع، وتأتي من معلومات المتجر في الخطوة الأولى من الربط لا من الطلب: تحقّق من أن cac:PartyTaxScheme/cbc:CompanyID للبائع هو الأرقام الخمسة عشر وحدها، يبدأ بالرقم 3 وينتهي به (ويذكر MTB-BR-KSA-40 الرقم الفارغ)، ومن وجود cbc:StreetName تحت cac:PostalAddress للبائع (MTB-BR-KSA-09): فالعنوان المُدخل سطراً واحداً من النص الحر هو السبب المعتاد.
شكل الفاتورة المبسطة: تحقّق من أن cbc:InvoiceTypeCode يحمل 388 في البيع و381 في الاسترداد، ومن أن السمة name عليه تبدأ بـ 02 (ويذكر MTB-STRUCT-01 السمة)، ومن وجود مرجع المستند QR بحمولة غير فارغة بترميز base64 (MTB-BR-KSA-27).
النسبة: تحقّق من أن كل تفصيل خاضع للنسبة الأساسية يحمل cbc:Percent بالقيمة 15؛ ويذكر MTB-BR-KSA-84 أي نسبة أخرى تحت الفئة S.
الاسترداد: الطلب المستردّ يصدر إشعاراً دائناً. تحقّق من أنه يحمل سبباً في cac:PaymentMeans/cbc:InstructionNote (MTB-BR-KSA-17) ورقم الفاتورة الأصلية في cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID (MTB-BR-KSA-56).

والتاجر على منصة مستضافة يغيّر اسم المتجر ورقم التسجيل في ضريبة القيمة المضافة والعنوان ولا شيء غيرها. فالملاحظة على ما سوى ذلك ليست لك لتصلحها: أرسل التقرير إلى دعم المنصة مع معرِّف القاعدة ومسار العنصر.

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

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

المصادر

قُرئت الصفحتان في 2026-10-15؛ وآخر تحديث من زد لمقال الربط في 2026-08-03، ومقال إعدادات الفاتورة مؤرَّخ في 2023-09-10. ووثائق المزوِّدين تتغيّر.

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

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

افحص فاتورة

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