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

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

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

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

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

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

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

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

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

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

من أين أحصل على ملف XML من دفترة؟

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

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

يُقرأ رقم التسجيل في ضريبة القيمة المضافة للبائع من cac:PartyTaxScheme/cbc:CompanyID. تحقّق من أنه الأرقام الخمسة عشر وحدها، يبدأ بالرقم 3 وينتهي به، وتحقّق من رقم أي فرع كُتب حين يصدر المستند من فرع غير الفرع الرئيس؛ ويذكر MTB-BR-KSA-40 رقم البائع.
ويُقرأ رقم التسجيل في ضريبة القيمة المضافة للمشتري من cac:PartyTaxScheme/cbc:CompanyID للمشتري، ويُقرأ السجل التجاري أو غيره من المعرِّفات من cac:PartyIdentification/cbc:ID للمشتري مع السمة schemeID. تحقّق من أن الرقم الأول خمسة عشر رقماً يبدأ بالرقم 3 وينتهي به، ومن أن التعريف يحمل schemeID من القائمة التي تقبلها الهيئة للمشتري؛ ويذكر MTB-BR-KSA-44 الرقم وMTB-BR-KSA-14 التعريف.
ويُقرأ العنوان الوطني من العناصر الستة تحت cac:PostalAddress: cbc:StreetName وcbc:BuildingNumber وcbc:CityName وcbc:PostalZone وcbc:CitySubdivisionName (الحي) وcac:Country/cbc:IdentificationCode. تحقّق من وجود الستة كلها غير فارغة على البائع، ويذكرها MTB-BR-KSA-09، وعلى المشتري السعودي في الفاتورة الضريبية، ويذكرها MTB-BR-KSA-63، وكلاهما بدرجة تحذير. والعنوان المكتوب سطراً واحداً في cbc:StreetName يترك العناصر الخمسة الأخرى خالية.
الإجماليات. فحص الهيئة على إجمالي المستند، MTB-BR-CO-14، يقارن cac:TaxTotal/cbc:TaxAmount بمجموع قيم cac:TaxSubtotal/cbc:TaxAmount مقارنة صارمة بلا هامش تسامح، بينما يسمح فحص كل فئة MTB-BR-S-09 بهامش ضيّق. تحقّق من أن إجمالي الضريبة في الترويسة كُتب مجموعاً للتفصيل ولم يُعَد حسابه على إجمالي الفاتورة.
وحيث خُصمت دفعة مقدَّمة، فهي تُقرأ من cbc:PrepaidAmount في الإجماليات. تحقّق من أن cbc:PayableAmount يساوي cbc:TaxInclusiveAmount مطروحاً منه ذلك المبلغ المدفوع مقدَّماً؛ ويذكر MTB-BR-CO-16 المبلغ المستحق المنقول من الإجمالي مباشرة مع إغفال الدفعة المقدَّمة.
تحقّق من أن كل مبلغ ضريبة مكتوب بمنزلتين عشريتين على الأكثر، بما في ذلك cac:TaxTotal/cbc:TaxAmount داخل كل cac:InvoiceLine؛ فضريبة البند المحسوبة بمنازل أكثر والمكتوبة كما حُفظت هي ما يذكره MTB-BR-DEC-13.
وتحقّق من أن cbc:InvoiceTypeCode يحمل 388 أو 381 أو 383، ومن أن السمة name عليه سبعة محارف أو ثمانية أو تسعة تبدأ بـ 01 في الفاتورة الضريبية و02 في الفاتورة المبسطة؛ ويذكر MTB-STRUCT-01 السمة.
وتحقّق من أن cbc:UUID في مرجع ICV عدد صحيح مجرَّد يزيد مع كل مستند يصدره الفرع، ومن أن مرجع PIH يحمل قيمة غير فارغة بترميز base64 معلَنة بنوع المحتوى text/plain، في أول مستند في سلسلة كل فرع كذلك.

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

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

المصادر

قُرئت هذه الصفحات في 2026-09-11. ووثائق المزوِّدين تتغيّر.

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

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

افحص فاتورة

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