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

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

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

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

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

توثّق Oracle الفوترة الإلكترونية المطلوبة من الهيئة في NetSuite بوصفها امتداداً من Oracle يُثبَّت في النظام؛ فمتى كان مثبَّتاً، يُنشأ ملف XML داخل NetSuite (الفوترة الإلكترونية في المملكة العربية السعودية).
وتقرأ الوثائق بيانات البائع من سجل الشركة التابعة، أو من سجل الموقع حين يُختار موقع في المعاملة، وبيانات المشتري من سجل العميل (الشركة التابعة؛ الموقع؛ العميل). فقيمة البائع التي تبدو صحيحة في أحد السجلين قد تكون خاطئة في الملف، لأن المستند بُني من الآخر.
وتقول إن ملف XML المولَّد يُرسل إلى العميل بالبريد الإلكتروني مع ملف PDF (توليد المستند الإلكتروني الصادر لمعاملة وإرساله).

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

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

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

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

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

السمة name على cbc:InvoiceTypeCode سبعة محارف أو ثمانية أو تسعة: 01 للفاتورة الضريبية أو 02 للفاتورة المبسطة، ثم خمس رايات للطرف الثالث والتوريد الصوري والتصدير والفاتورة الملخَّصة والفوترة الذاتية، ثم رايتان أخريان على الأكثر للتوريد المستمر والجهة الحكومية، كل منها 0 أو 1. تحقّق من أن السمة بلا فاصل؛ ويذكرها MTB-STRUCT-01.
يُقرأ رقم التسجيل في ضريبة القيمة المضافة للبائع من cac:PartyTaxScheme/cbc:CompanyID. تحقّق من أنه الأرقام الخمسة عشر وحدها، يبدأ بالرقم 3 وينتهي به، ومن أن المستند بُني من الشركة التابعة أو الموقع الذي تتوقعه؛ ويذكر MTB-BR-KSA-40 الصورة.
ويُقرأ معرِّف كل طرف من cac:PartyIdentification/cbc:ID والسمة schemeID عليه. تحقّق من أن رمز البائع أحد الرموز CRN أو MOM أو MLS أو SAG أو OTH أو 700، ورمز المشتري أحد الرموز الأحد عشر التي تقبلها الهيئة (وتزيد NAT وTIN وIQA وPAS وGCC)؛ ويذكر MTB-BR-KSA-08 تعريف البائع وMTB-BR-KSA-14 تعريف المشتري.
ويُقرأ العنوان من cbc:StreetName وcbc:BuildingNumber وcbc:CityName وcbc:PostalZone وcbc:CitySubdivisionName (الحي) وcac:Country/cbc:IdentificationCode. تحقّق من وجود الستة كلها على البائع، ويذكرها MTB-BR-KSA-09، وعلى المشتري السعودي في الفاتورة الضريبية، ويذكرها MTB-BR-KSA-63، وكلاهما بدرجة تحذير.
وفي كل مستند 381 و383، تحقّق من أن cac:PaymentMeans/cbc:InstructionNote يحمل سبب الإشعار، ويذكره MTB-BR-KSA-17، ومن أن cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID يسمّي الفاتورة التي يصحّحها، ويذكره MTB-BR-KSA-56.
وفي التفصيل الخاضع بنسبة الصفر أو المعفى، تحقّق من أن cac:TaxSubtotal/cac:TaxCategory/cbc:TaxExemptionReasonCode أحد رموز VATEX-SA المنشورة؛ ويذكر MTB-BR-KSA-CL-04 الرمز غير المدرج، بدرجة تحذير. وأداة الفحص الحالية لدى الهيئة تطلب الرمز وحده، لا نص السبب إلى جواره.
وفي الفاتورة الضريبية، تحقّق من وجود cac:PaymentMeans/cbc:PaymentMeansCode ومن أن الرمز في قائمة الهيئة؛ ويذكره MTB-BR-KSA-16.
تحقّق من أن cbc:UUID في مرجع ICV عدد صحيح مجرَّد يزيد مع كل مستند تصدره الوحدة، ومن أن مرجع PIH يحمل قيمة غير فارغة بترميز base64 معلَنة بنوع المحتوى text/plain.
وتحقّق من أن cac:TaxTotal/cbc:TaxAmount على مستوى المستند يساوي مجموع قيم cac:TaxSubtotal/cbc:TaxAmount تحته، ومن أن كل مبلغ مكتوب بمنزلتين عشريتين على الأكثر، ومن أن cbc:PayableAmount، حيث خُصمت دفعة مقدَّمة، يساوي cbc:TaxInclusiveAmount مطروحاً منه cbc:PrepaidAmount.

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

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

المصادر

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

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

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

افحص فاتورة

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