SAP Business One: فحص ملف الفاتورة الإلكترونية

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

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

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

• توثّق SAP المستندات الإلكترونية في SAP Business One بوصفها ملفات XML ينتجها إطار عام للمستندات الإلكترونية، تخصّصه بعض التوطينات للمتطلبات القانونية المحلية (المستندات الإلكترونية والتقارير).
• ووثائق توطين وسط الشرق الأوسط وشمال أفريقيا، وهي التي تشمل المملكة العربية السعودية، لم تكن تحمل موضوعاً عن الفوترة الإلكترونية المطلوبة من الهيئة حين قُرئت في 2026-09-11 (التوطين لوسط الشرق الأوسط وشمال أفريقيا). والمنشآت التي تعمل بـ SAP Business One في المملكة تُنشئ ملف XML للهيئة في الغالب عبر إضافة أو خدمة تكامل من أحد الشركاء، ولكلٍّ منها طريقتها في بناء الملف وفي ربط بيانات النظام بعناصره؛ فبعضها يستعمل إطار المستندات الإلكترونية لدى SAP وبعضها لا يستعمله. وهذا الربط لا يراه هذا الدليل، فلا يسمّي شاشة ولا حقلاً: الفحوص التالية على ملف XML، وتنطبق أيّاً كانت الإضافة التي كتبته.

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

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

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

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

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

• cbc:InvoiceTypeCode: تحقّق من أن النص 388 أو 381 أو 383، ومن أن السمة name عليه سبعة محارف أو ثمانية أو تسعة مثل 0100000. والربط الذي يحشو السمة إلى عرض ثابت، أو يكتب رمز النوع ورمز نوع المعاملة من بحثين منفصلين يعيد أحدهما قيمة خالية، ينتج القيم التي يذكرها MTB-BR-KSA-05 وMTB-STRUCT-01.
• cac:AccountingSupplierParty//cac:PartyTaxScheme/cbc:CompanyID: تحقّق من أنه رقم التسجيل في ضريبة القيمة المضافة بخمسة عشر رقماً، يبدأ بالرقم 3 وينتهي به، بلا مسافات ولا بادئة، ومن أنه رقم الشركة أو الفرع الذي أصدر المستند. ويذكر MTB-BR-KSA-40 الرقم الذي جاء بصورة أخرى.
• عدّاد الفواتير: تحقّق من وجود cac:AdditionalDocumentReference قيمة cbc:ID فيه ICV، ومن أن cbc:UUID فيه عدد صحيح مجرَّد لا رقم المستند ولا سلسلة ببادئة ولا معرِّف فريد. ويذكر MTB-BR-KSA-33 الكتلة الغائبة. واسم العنصر يوحي بحقل معرِّف فريد، والربط المكتوب على اسم العنصر لا على تعريف الحقل يضع فيه معرِّفاً فريداً.
• بصمة الفاتورة السابقة: تحقّق من أن مرجع PIH يحمل cac:Attachment/cbc:EmbeddedDocumentBinaryObject بالسمة mimeCode="text/plain" وقيمة غير فارغة بترميز base64، في أول مستند في السلسلة كذلك. ويذكر MTB-BR-KSA-61 الكتلة الغائبة أو قيمتها الغائبة.
• الفواتير المبسطة. مبيعات النقد ونقاط البيع فواتير مبسطة في الغالب، ورمز نوع معاملتها في السمة name يبدأ بـ 02، فافحص واحدة منها إلى جانب فاتورة ضريبية. وتحقّق من أنها تحمل مرجعاً ثالثاً قيمة cbc:ID فيه QR وفيه حمولة رمز الاستجابة السريعة بترميز base64 داخل cac:Attachment/cbc:EmbeddedDocumentBinaryObject، ويذكر MTB-BR-KSA-27 غيابه، ومن أنها تحمل كتلة cac:Signature، ويذكر MTB-BR-KSA-60 غيابها. والربط المبني للفواتير الضريبية ثم المستعمَل للمبسطة هو السبب المعتاد لغيابهما معاً.
• الإجماليات. تحقّق من أن cac:TaxTotal/cbc:TaxAmount على مستوى المستند يساوي مجموع قيم cac:TaxSubtotal/cbc:TaxAmount تحته، ومن أن cbc:TaxInclusiveAmount يساوي cbc:TaxExclusiveAmount مضافاً إليه تلك الضريبة. فإجمالي الترويسة والتفصيل كثيراً ما يأتيان من جدولين مختلفين، وفرق هللة ناتج عن تقريب كل فئة قبل الجمع هو ما يذكره MTB-BR-CO-14.
• المنازل العشرية. تحقّق من أن كل مبلغ ضريبة مكتوب بمنزلتين عشريتين على الأكثر، بما في ذلك cac:TaxTotal/cbc:TaxAmount داخل كل cac:InvoiceLine، فهي النسخة الأبعد عن المرور بالإجراء الذي ينسّق إجماليات الترويسة. ويذكر MTB-BR-DEC-13 المنزلة الثالثة في مبلغ ضريبة بعملة المستند.
• الإشعارات الدائنة والمدينة. تحقّق من أن المستند 381 أو 383 يحمل cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID مسمّياً الفاتورة الأصلية؛ فالإشعار المُنشأ على عميل لا على فاتورة لا يجد التصدير فيه ما يكتبه هناك، ويذكره MTB-BR-KSA-56.
• وتحقّق مما إذا كان الربط قد بُني لنوع مستند واحد ثم أُعيد استعماله لسائر الأنواع: فالإشعار الدائن الذي يخرج برمز نوع معاملة الفاتورة، أو بلا مرجع الفوترة، هو ذلك الاستعمال بعينه.

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

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

المصادر

• بوابة مساعدة SAP لإصدار SAP Business One 10.0: المستندات الإلكترونية والتقارير
• بوابة مساعدة SAP لإصدار SAP Business One 10.0: التوطين لوسط الشرق الأوسط وشمال أفريقيا (Central MENA/AE/EG/LB/OM/QA/SA)

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