مزوّد حلول الفوترة الإلكترونية يُنشئ ملفك: ما الذي تطلبه وما الذي تتحقق منه

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

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

ما تقوله المتطلبات المنشورة

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

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

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

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

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

من أين أحصل على ملف XML من المزوِّد؟

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

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

ما الذي تتحقق منه في ملف المزوِّد

• كتلة البائع، التي يبنيها المزوِّد من سجل منشأتك: تحقّق من أن cac:PartyTaxScheme/cbc:CompanyID هو الأرقام الخمسة عشر وحدها، يبدأ بالرقم 3 وينتهي به (ويذكر MTB-BR-KSA-40 الرقم الفارغ)؛ ومن أن cac:PartyIdentification/cbc:ID يحمل السمة schemeID بقيمة مثل CRN (MTB-BR-KSA-08)؛ ومن وجود cbc:StreetName تحت cac:PostalAddress للبائع (MTB-BR-KSA-09).
• نوع المستند، الذي يربطه المزوِّد بأنواعك: تحقّق من أن cbc:InvoiceTypeCode يحمل 388 أو 381 أو 383 (MTB-BR-KSA-05) مع السمة name تبدأ بـ 01 في الفاتورة الضريبية و02 في الفاتورة المبسطة (MTB-STRUCT-01).
• العدّاد والبصمة، وهما لوحدة المزوِّد: تحقّق من وجود مرجعي المستند ICV وPIH (MTB-BR-KSA-33 وMTB-BR-KSA-61)؛ وفي ملفات الشهر ينبغي أن يزيد العدّاد واحداً لكل مستند من الوحدة نفسها.
• كتلة المشتري في الفاتورة الضريبية، التي يبنيها المزوِّد من قائمة عملائك: تحقّق من أن cac:PartyTaxScheme/cbc:CompanyID للمشتري هو الأرقام الخمسة عشر وحدها (MTB-BR-KSA-44) ومن أن cac:PostalAddress للمشتري السعودي يحمل اسم الشارع (MTB-BR-KSA-63): وكلاهما متعلق بالعميل، فتوقَّعهما في بعض المستندات دون سائرها.
• الإجماليات، التي يحسبها المزوِّد: تحقّق من أن كتلة cac:TaxTotal التي تحمل تفصيل الضريبة تحمل كذلك عنصر cbc:TaxAmount خاصاً بها (MTB-BR-CO-14).

وما تعيده إلى المزوِّد هو التقرير: فملف CSV المصدَّر يسرد كل ملاحظة مع معرِّف القاعدة ومسار العنصر وصفحة القاعدة، وهو ما يحتاجه مُنفِّذ الربط لديهم ليجد السطر. وليس فيه قيمة من قيم الفاتورة.

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

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

المصادر

• الهيئة: قرار الفوترة الإلكترونية (النسخة الإنجليزية، 2023-05-19)
• الهيئة: أنظمة الفوترة الإلكترونية ولوائحها

قُرئت الصفحتان في 2026-10-15. والوثائق المنشورة تُراجَع وتُحدَّث.