منصة فوترة تغذّي مزوِّداً: ما الذي تطلبه وما الذي تتحقق منه

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

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

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

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

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

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

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

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

من أين أحصل على ملف XML في هذا المسار؟

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

والعادة النافعة تصدير واحد كل شهر، يُفحص قبل أن يتغيّر ربط المزوِّد أو حقول العملاء في المنصة، ثم أول تصدير بعد أي تغيير. ولا تُحفظ الملفات هنا قط: فالفحص يجري في الذاكرة، والتقرير يحمل معرِّفات القواعد والمسارات والأعداد لا قيم الفواتير.

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

• المشتري في كل فاتورة ضريبية: تحقّق من أن cac:AccountingCustomerParty/cac:Party/cac:PartyLegalEntity/cbc:RegistrationName يحمل الاسم النظامي المسجَّل للعميل لا اسم العرض في الحساب (MTB-BR-KSA-42)؛ ومن أن cac:PartyTaxScheme/cbc:CompanyID للعميل السعودي هو الأرقام الخمسة عشر وحدها، بلا بادئة حفظتها المنصة للعرض (MTB-BR-KSA-44)؛ ومن أن أي cac:PartyIdentification/cbc:ID يحمل السمة schemeID (MTB-BR-KSA-14)؛ ومن أن cac:PostalAddress للمشتري السعودي يحمل اسم الشارع (MTB-BR-KSA-63). وكلٌّ من هذه متعلق بالعميل: فتوقَّعها في بعض المستندات دون سائرها.
• العملة، التي تحددها المنصة التي تفوتر بالدولار لكل فاتورة: تحقّق من أن cbc:DocumentCurrencyCode رمز تقبله الهيئة (MTB-BR-CL-04) ومن وجود cbc:TaxCurrencyCode بالقيمة SAR في كل مستند (MTB-BR-KSA-68).
• المبالغ، التي تمرّ بتحويل عملة وتقريب ثانٍ: تحقّق من أن كل مبلغ ضريبة مكتوب بمنزلتين عشريتين (MTB-BR-DEC-13) ومن أن كتلة cac:TaxTotal التي تحمل التفصيل تحمل كذلك عنصر cbc:TaxAmount خاصاً بها (MTB-BR-CO-14).
• التصدير والتوريدات المعفاة، التي تقررها قواعد الضريبة في المنصة: تحقّق من أن كل تفصيل مرمَّز Z أو E يحمل أحد رموز الأسباب المنشورة VATEX-SA (MTB-BR-KSA-CL-04).
• الاسترداد والإشعارات الدائنة، التي تنشئها المنصة تلقائياً: تحقّق من أن كل إشعار دائن يحمل سبباً في cac:PaymentMeans/cbc:InstructionNote (MTB-BR-KSA-17).

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

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

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

المصادر

• الهيئة: قرار الفوترة الإلكترونية (النسخة الإنجليزية، 2023-05-19)
• الهيئة: الأسئلة الشائعة عن الفوترة الإلكترونية (النسخة الإنجليزية، 2021-06-10)

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