ما هو ملف XML في الفاتورة الإلكترونية وصيغة UBL 2.1

ما هو ملف XML في الفاتورة الإلكترونية، ولماذا اختارت هيئة الزكاة صيغة UBL 2.1، وما الذي يحتويه الملف، وكيف يصل للعميل، ومتى تحتاج للتعامل معه بنفسك.

أكتوبر 19, 2026 0 10

ما هو ملف XML في الفاتورة الإلكترونية وصيغة UBL 2.1

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

هذا المقال جزء من دليل الفاتورة الإلكترونية في السعودية: الدليل الشامل للمنشآت.

لماذا لا يكفي ملف PDF؟

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

مثال مبسط جدًا لشكل البيانات داخل الملف:

الوسم (مبسط)	المعنى	مثال
ID	رقم الفاتورة	INV-2026-0154
UUID	المعرّف الفريد	3cf5ee18-…
IssueDate	تاريخ الإصدار	2026-10-20
AccountingSupplierParty	بيانات البائع	الاسم والرقم الضريبي والعنوان
AccountingCustomerParty	بيانات المشتري	الاسم والرقم الضريبي
InvoiceLine	بند الفاتورة	الصنف والكمية والسعر
TaxTotal	إجمالي الضريبة	150.00
LegalMonetaryTotal	الإجماليات	1,150.00

ما هو معيار UBL 2.1؟

UBL اختصار لـ Universal Business Language، وهو معيار دولي مفتوح لتبادل المستندات التجارية إلكترونيًا (فواتير، أوامر شراء، إشعارات). اختارته الهيئة لأنه:

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

وأضافت الهيئة على المعيار قواعد خاصة بها، مثل حقول العنوان الوطني والختم التشفيري ورمز QR، وتنشرها في مواصفاتها الفنية.

ماذا يحتوي ملف XML في المرحلة الثانية؟

إلى جانب بيانات الفاتورة المعتادة التي شرحناها في الحقول الإلزامية في الفاتورة الضريبية، يحتوي الملف على:

UUID: معرّف فريد لا يتكرر.
عداد الفاتورة (ICV): رقم يزيد مع كل فاتورة تصدرها وحدة الحل.
تجزئة الفاتورة السابقة (PIH): تربط الفاتورة بما قبلها في سلسلة واحدة.
الختم التشفيري: توقيع رقمي يثبت المصدر وعدم التعديل، وشرحناه في الختم التشفيري والتوقيع الرقمي.
رمز QR: مضمّن داخل الملف نفسه.
نوع الفاتورة ورمزها: قياسية أو مبسطة، فاتورة أو إشعار دائن أو مدين.

كيف يصل ملف XML إلى عميلك؟

هنا يقع كثيرون في الحيرة: هل أرسل لعميلي ملفًا لا يستطيع قراءته؟ الإجابة أن لديك خيارين:

إرسال XML مع نسخة مقروءة: يحتفظ العميل بالملف الإلكتروني الرسمي ويقرأ نسخة PDF عادية.
PDF/A-3 مع XML مضمّن: ملف واحد يبدو للعين PDF عاديًا، وبداخله ملف XML كمرفق. هذا الخيار الأكثر عملية، لأن العميل يفتحه كأي فاتورة، ونظامه المحاسبي يستطيع استخراج XML منه.

أما الفاتورة المبسطة للأفراد، فيكفي غالبًا أن يحصل العميل على الفاتورة المطبوعة أو الرقمية مع رمز QR، بينما يُرسل XML للمنصة ضمن عملية الإبلاغ.

فواتير إلكترونية معتمدة من أول يوميصدر فواتيرك الإلكترونية موقعة ومعها رمز QR، ويرسلها لمنصة فاتورة تلقائياً، ويعرض لك حالة كل فاتورة.اعرف أكثر ←

هل أحتاج لكتابة XML بنفسي؟

لا. صاحب المنشأة والمحاسب لا يتعاملان مع XML مباشرة. نظام الفوترة المتوافق هو الذي:

يُنشئ الملف من بيانات الفاتورة.
يتحقق منه قبل الإرسال.
يختمه ويرسله لمنصة فاتورة.
يحفظه للمدة النظامية.

لكن من المفيد أن تعرف الأساسيات لسببين: لتفهم سبب رفض بعض الفواتير، ولتقيّم البرامج التي تعرض عليك. البرنامج الذي يصدر PDF فقط دون XML لن يكون جاهزًا للمرحلة الثانية.

أسباب شائعة لرفض ملف XML

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

كيف يتعامل رودكس مع XML؟

رودكس يُنشئ ملف XML بصيغة UBL 2.1 تلقائيًا مع كل فاتورة، ويختمه ويرسله لمنصة فاتورة، ويحفظه مع نسخة PDF مقروءة يمكنك مشاركتها مع العميل برابط أو واتساب. وتظهر لك حالة كل فاتورة بوضوح: معتمدة أو مرفوضة مع سبب الرفض بلغة مفهومة.

الأسئلة الشائعة

هل يجب أن أرسل ملف XML لكل عملائي؟

للعملاء من المنشآت (الفاتورة القياسية) يُفضّل إرسال XML أو PDF/A-3 المضمّن فيه XML، لأنه النسخة الإلكترونية الرسمية. للأفراد تكفي الفاتورة المبسطة مع رمز QR.