يفحص مطابق ملف XML للفاتورة الإلكترونية في المرحلة الثانية قبل إرساله: تحقق مسبق وفق متطلبات هيئة الزكاة والضريبة والجمارك المنشورة، لا اعتماداً من الهيئة. وتشرح هذه الصفحة قاعدة واحدة هي BR-KSA-09.
خمس عمليات فحص شهرياً في باقة المجان. يُفحص الملف في الذاكرة ولا يُحفظ.
الرسالة كما تنشرها هيئة الزكاة والضريبة والجمارك
[BR-KSA-09]-Seller address must contain street name (BT-35), building number (KSA-17), postal code (BT-38), city (BT-37), district (KSA-3), country code (BT-40). For more information please access this link: https://splonline.com.sa/en/national-address-1/
ما الذي يذكره مطابق
مدخل لكل حالة تُذكر فيها هذه القاعدة في التقرير.
صورة القيمة في التقرير
صورة القيمة التي وُجدت — empty وnot_15_digits وما شابههما — لا القيمة نفسها.
عنوان البائع لا يحمل اسم الشارع
صورة القيمة في التقريرstreet_name_missingلا اسم شارع
ما الخلل
العنوان البريدي للبائع لا يحمل العنصر cbc:StreetName. وتشترط القاعدة BR-KSA-09 ستة حقول في العنوان البريدي للبائع تحت cac:AccountingSupplierParty/cac:Party/cac:PostalAddress: اسم الشارع BT-35 في العنصر cbc:StreetName، ورقم المبنى KSA-17 في cbc:BuildingNumber، واسم المدينة BT-37 في cbc:CityName، والرمز البريدي BT-38 في cbc:PostalZone، والحي KSA-3 في cbc:CitySubdivisionName، ورمز الدولة BT-40 في cac:Country/cbc:IdentificationCode. وتُرصد هذه الحالة بوصفها مخاطرة لا سبب رفض. وكانت هذه القاعدة، في إصدار حزمة أدوات التطوير SDK الذي قرأته الحزمة قبل الإصدار 2.0.0 (أي 3.0.8)، الفحصَ الوحيد الذي صنّفته الهيئة تحذيراً لا خطأً؛ أما الإصدار 3.4.8 الذي تقرؤه الحزمة الآن فيصنّف أكثر فحوصه تحذيرات، والقاعدة BR-KSA-09 باقية بينها: تسجّل الهيئة النقص ولا ترفض المستند من أجله، ولا تقلب هذه الملاحظة نتيجة التقرير إلى إخفاق. وكان الإصدار 3.0.8 يطلب كذلك الرقم الإضافي KSA-23 في cbc:PlotIdentification، ولا يطلبه الإصدار 3.4.8. ويصف قاموس البيانات حقول العنوان بالإلزامية، وهذا لا يغيّر تصنيف الفحص نفسه. والفحص فحص وجود لا غير، فالعنصر الموجود الفارغ يجتازه؛ ويتوقف عند أول حقل غائب بترتيب الهيئة نفسه، وهو اسم الشارع ثم رقم المبنى ثم اسم المدينة ثم الرمز البريدي ثم الحي ثم رمز الدولة، فقد يغيب أكثر من حقل من الستة ولا يُسمّى هنا إلا أولها. ويسري هذا على الفاتورة الضريبية والفاتورة المبسطة سواء.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
اسم الشارع يأتي عادةً من السطر الأول في عنوان منشأتك أو فرعك؛ وهذا عنوانك أنت لا عنوان العميل، فموضع المعالجة سجل المنشأة لا سجل العميل. والسبب الأشيع أن نظامك يحفظ العنوان كتلةً نصية حرة واحدة، فلا يجد الربط ما يضعه في cbc:StreetName بعينه، فيكتب الكتلة كلها في العنصر الذي وُجّه إليه ويترك بقية العناصر خالية. وراجع كل فرع أو وحدة تُصدر منها فواتير لا المركز الرئيس وحده، فالفرع المُنشأ بعد إعداد وحدة الفوترة الإلكترونية كثيراً ما يبقى عنوانه في حقل ملاحظات لا يقرؤه أي ربط.
عنوان البائع لا يحمل رقم المبنى
صورة القيمة في التقريرbuilding_number_missingلا رقم مبنى
ما الخلل
العنوان البريدي للبائع لا يحمل العنصر cbc:BuildingNumber. وتشترط القاعدة BR-KSA-09 ستة حقول في العنوان البريدي للبائع تحت cac:AccountingSupplierParty/cac:Party/cac:PostalAddress: اسم الشارع BT-35 في العنصر cbc:StreetName، ورقم المبنى KSA-17 في cbc:BuildingNumber، واسم المدينة BT-37 في cbc:CityName، والرمز البريدي BT-38 في cbc:PostalZone، والحي KSA-3 في cbc:CitySubdivisionName، ورمز الدولة BT-40 في cac:Country/cbc:IdentificationCode. وتُرصد هذه الحالة بوصفها مخاطرة لا سبب رفض. وكانت هذه القاعدة، في إصدار حزمة أدوات التطوير SDK الذي قرأته الحزمة قبل الإصدار 2.0.0 (أي 3.0.8)، الفحصَ الوحيد الذي صنّفته الهيئة تحذيراً لا خطأً؛ أما الإصدار 3.4.8 الذي تقرؤه الحزمة الآن فيصنّف أكثر فحوصه تحذيرات، والقاعدة BR-KSA-09 باقية بينها: تسجّل الهيئة النقص ولا ترفض المستند من أجله، ولا تقلب هذه الملاحظة نتيجة التقرير إلى إخفاق. وكان الإصدار 3.0.8 يطلب كذلك الرقم الإضافي KSA-23 في cbc:PlotIdentification، ولا يطلبه الإصدار 3.4.8. ويصف قاموس البيانات حقول العنوان بالإلزامية، وهذا لا يغيّر تصنيف الفحص نفسه. والفحص فحص وجود لا غير، فالعنصر الموجود الفارغ يجتازه؛ ويتوقف عند أول حقل غائب بترتيب الهيئة نفسه، وهو اسم الشارع ثم رقم المبنى ثم اسم المدينة ثم الرمز البريدي ثم الحي ثم رمز الدولة، فقد يغيب أكثر من حقل من الستة ولا يُسمّى هنا إلا أولها. ويسري هذا على الفاتورة الضريبية والفاتورة المبسطة سواء.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
رقم المبنى حقل من حقول العنوان الوطني السعودي، من أربع خانات، ولا عمود له في الأنظمة المصمَّمة خارج المنطقة. والسبب الأشيع أن الرقم يُكتب داخل سطر الشارع نفسه، فيراه قارئ العنوان المطبوع ويبقى العنصر cbc:BuildingNumber غائباً في ملف XML. أضف حقلاً مستقلاً في سجل المنشأة أو الفرع واربطه بهذا العنصر مباشرة، ولا تستخرجه من نص الشارع، فالاستخراج يخفق عند أول عنوان يُكتب بترتيب مختلف.
عنوان البائع لا يحمل الرقم الإضافي
صورة القيمة في التقريرplot_identification_missingلا رقم إضافي
ما الخلل
العنوان البريدي للبائع لا يحمل العنصر cbc:PlotIdentification، وهو الحقل الذي تسمّيه رسالة هيئة الزكاة والضريبة والجمارك الرقم الإضافي KSA-23. ولا ترصد هذه الملاحظة إلا حزم القواعد السابقة للإصدار 2.0.0: فالقاعدة BR-KSA-09 في الإصدار 3.0.8 من حزمة أدوات التطوير SDK التي تنشرها الهيئة كانت تطلب الرقم الإضافي بين سبعة حقول لعنوان البائع، والإصدار 3.4.8 الذي تقرؤه حزمة القواعد 2.0.0 لم يعد يطلبه، فلا يحمل هذه الملاحظة تقرير صادر عن الحزمة 2.0.0. وكانت تحذيراً حينها كذلك، فلم تقلب نتيجة تقرير إلى إخفاق وحدها.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
الرقم الإضافي هو الجزء المكوَّن من أربع خانات الذي يلي رقم المبنى في العنوان الوطني السعودي، وهو أكثر حقول العنوان سقوطاً لسببين: أولهما أن معيار EN 16931 لا يحمل له مصطلحاً أصلاً، فالقالب المشتق من تصميم فاتورة أوروبية لا يحمل له موضعاً؛ وثانيهما أن اسم العنصر في UBL، وهو cbc:PlotIdentification، لا يدل على معناه، فيسهل إغفاله حين يُكتب الربط من أسماء العناصر. خذ القيمة من بطاقة العنوان الوطني للمنشأة واربطها بهذا العنصر صراحةً.
عنوان البائع لا يحمل اسم المدينة
صورة القيمة في التقريرcity_name_missingلا اسم مدينة
ما الخلل
العنوان البريدي للبائع لا يحمل العنصر cbc:CityName. وتشترط القاعدة BR-KSA-09 ستة حقول في العنوان البريدي للبائع تحت cac:AccountingSupplierParty/cac:Party/cac:PostalAddress: اسم الشارع BT-35 في العنصر cbc:StreetName، ورقم المبنى KSA-17 في cbc:BuildingNumber، واسم المدينة BT-37 في cbc:CityName، والرمز البريدي BT-38 في cbc:PostalZone، والحي KSA-3 في cbc:CitySubdivisionName، ورمز الدولة BT-40 في cac:Country/cbc:IdentificationCode. وتُرصد هذه الحالة بوصفها مخاطرة لا سبب رفض. وكانت هذه القاعدة، في إصدار حزمة أدوات التطوير SDK الذي قرأته الحزمة قبل الإصدار 2.0.0 (أي 3.0.8)، الفحصَ الوحيد الذي صنّفته الهيئة تحذيراً لا خطأً؛ أما الإصدار 3.4.8 الذي تقرؤه الحزمة الآن فيصنّف أكثر فحوصه تحذيرات، والقاعدة BR-KSA-09 باقية بينها: تسجّل الهيئة النقص ولا ترفض المستند من أجله، ولا تقلب هذه الملاحظة نتيجة التقرير إلى إخفاق. وكان الإصدار 3.0.8 يطلب كذلك الرقم الإضافي KSA-23 في cbc:PlotIdentification، ولا يطلبه الإصدار 3.4.8. ويصف قاموس البيانات حقول العنوان بالإلزامية، وهذا لا يغيّر تصنيف الفحص نفسه. والفحص فحص وجود لا غير، فالعنصر الموجود الفارغ يجتازه؛ ويتوقف عند أول حقل غائب بترتيب الهيئة نفسه، وهو اسم الشارع ثم رقم المبنى ثم اسم المدينة ثم الرمز البريدي ثم الحي ثم رمز الدولة، فقد يغيب أكثر من حقل من الستة ولا يُسمّى هنا إلا أولها. ويسري هذا على الفاتورة الضريبية والفاتورة المبسطة سواء.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
كل سجل عنوان تقريباً يحمل مدينة، فغيابها في المخرجات يدل عادةً على أن الربط يقرأ سجلاً غير المقصود لا على نقص في البيانات: كعنوان شحن أو عنوان مراسلة أو جدول عناوين قديم بدل عنوان المنشأة المسجَّل. تحقّق من العنوان الذي يقرؤه التصدير لطرف البائع، وتحقّق أنه العنوان نفسه لكل أنواع المستندات؛ فبعض عمليات التصدير تقرأ عنوان الفرع في الفواتير وعنوان المنشأة الافتراضي في الإشعارات.
عنوان البائع لا يحمل الرمز البريدي
صورة القيمة في التقريرpostal_zone_missingلا رمز بريدي
ما الخلل
العنوان البريدي للبائع لا يحمل العنصر cbc:PostalZone. وتشترط القاعدة BR-KSA-09 ستة حقول في العنوان البريدي للبائع تحت cac:AccountingSupplierParty/cac:Party/cac:PostalAddress: اسم الشارع BT-35 في العنصر cbc:StreetName، ورقم المبنى KSA-17 في cbc:BuildingNumber، واسم المدينة BT-37 في cbc:CityName، والرمز البريدي BT-38 في cbc:PostalZone، والحي KSA-3 في cbc:CitySubdivisionName، ورمز الدولة BT-40 في cac:Country/cbc:IdentificationCode. وتُرصد هذه الحالة بوصفها مخاطرة لا سبب رفض. وكانت هذه القاعدة، في إصدار حزمة أدوات التطوير SDK الذي قرأته الحزمة قبل الإصدار 2.0.0 (أي 3.0.8)، الفحصَ الوحيد الذي صنّفته الهيئة تحذيراً لا خطأً؛ أما الإصدار 3.4.8 الذي تقرؤه الحزمة الآن فيصنّف أكثر فحوصه تحذيرات، والقاعدة BR-KSA-09 باقية بينها: تسجّل الهيئة النقص ولا ترفض المستند من أجله، ولا تقلب هذه الملاحظة نتيجة التقرير إلى إخفاق. وكان الإصدار 3.0.8 يطلب كذلك الرقم الإضافي KSA-23 في cbc:PlotIdentification، ولا يطلبه الإصدار 3.4.8. ويصف قاموس البيانات حقول العنوان بالإلزامية، وهذا لا يغيّر تصنيف الفحص نفسه. والفحص فحص وجود لا غير، فالعنصر الموجود الفارغ يجتازه؛ ويتوقف عند أول حقل غائب بترتيب الهيئة نفسه، وهو اسم الشارع ثم رقم المبنى ثم اسم المدينة ثم الرمز البريدي ثم الحي ثم رمز الدولة، فقد يغيب أكثر من حقل من الستة ولا يُسمّى هنا إلا أولها. ويسري هذا على الفاتورة الضريبية والفاتورة المبسطة سواء.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
الرمز البريدي في المملكة خمس خانات، ويُخلط كثيراً بالرقم الإضافي أو برقم صندوق البريد، ولكلٍّ حقله. والسبب الأشيع أن الحقل اختياري في نظامك فتُرك خالياً عند إنشاء سجل المنشأة، أو أنه محفوظ ملتصقاً باسم المدينة في سطر واحد. املأه في سجل المنشأة أو الفرع واربطه بالعنصر cbc:PostalZone وحده.
عنوان البائع لا يحمل الحي
صورة القيمة في التقريرcity_subdivision_missingلا حي
ما الخلل
العنوان البريدي للبائع لا يحمل العنصر cbc:CitySubdivisionName، وهو ما تسمّيه رسالة هيئة الزكاة والضريبة والجمارك الحي KSA-3. وتشترط القاعدة BR-KSA-09 ستة حقول في العنوان البريدي للبائع تحت cac:AccountingSupplierParty/cac:Party/cac:PostalAddress: اسم الشارع BT-35 في العنصر cbc:StreetName، ورقم المبنى KSA-17 في cbc:BuildingNumber، واسم المدينة BT-37 في cbc:CityName، والرمز البريدي BT-38 في cbc:PostalZone، والحي KSA-3 في cbc:CitySubdivisionName، ورمز الدولة BT-40 في cac:Country/cbc:IdentificationCode. وتُرصد هذه الحالة بوصفها مخاطرة لا سبب رفض. وكانت هذه القاعدة، في إصدار حزمة أدوات التطوير SDK الذي قرأته الحزمة قبل الإصدار 2.0.0 (أي 3.0.8)، الفحصَ الوحيد الذي صنّفته الهيئة تحذيراً لا خطأً؛ أما الإصدار 3.4.8 الذي تقرؤه الحزمة الآن فيصنّف أكثر فحوصه تحذيرات، والقاعدة BR-KSA-09 باقية بينها: تسجّل الهيئة النقص ولا ترفض المستند من أجله، ولا تقلب هذه الملاحظة نتيجة التقرير إلى إخفاق. وكان الإصدار 3.0.8 يطلب كذلك الرقم الإضافي KSA-23 في cbc:PlotIdentification، ولا يطلبه الإصدار 3.4.8. ويصف قاموس البيانات حقول العنوان بالإلزامية، وهذا لا يغيّر تصنيف الفحص نفسه. والفحص فحص وجود لا غير، فالعنصر الموجود الفارغ يجتازه؛ ويتوقف عند أول حقل غائب بترتيب الهيئة نفسه، وهو اسم الشارع ثم رقم المبنى ثم اسم المدينة ثم الرمز البريدي ثم الحي ثم رمز الدولة، فقد يغيب أكثر من حقل من الستة ولا يُسمّى هنا إلا أولها. ويسري هذا على الفاتورة الضريبية والفاتورة المبسطة سواء.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
الحي جزء من العنوان الوطني السعودي لا نظير له في صيغ العناوين التي تأتي بها معظم الأنظمة، فهو إما غير مُلتقط أصلاً وإما مدموج في سطر الشارع. ابحث في سجل المنشأة أو الفرع عن حقل للحي؛ فإن لم يوجد فإن إضافة حقل مخصّص وربطه بالعنصر cbc:CitySubdivisionName هي المعالجة الصحيحة، أما تفكيكه من نص الشارع فليس كذلك.
عنوان البائع لا يحمل رمز الدولة
صورة القيمة في التقريرcountry_code_missingلا رمز دولة
ما الخلل
العنوان البريدي للبائع لا يحمل العنصر cac:Country/cbc:IdentificationCode. وتشترط القاعدة BR-KSA-09 ستة حقول في العنوان البريدي للبائع تحت cac:AccountingSupplierParty/cac:Party/cac:PostalAddress: اسم الشارع BT-35 في العنصر cbc:StreetName، ورقم المبنى KSA-17 في cbc:BuildingNumber، واسم المدينة BT-37 في cbc:CityName، والرمز البريدي BT-38 في cbc:PostalZone، والحي KSA-3 في cbc:CitySubdivisionName، ورمز الدولة BT-40 في cac:Country/cbc:IdentificationCode. وتُرصد هذه الحالة بوصفها مخاطرة لا سبب رفض. وكانت هذه القاعدة، في إصدار حزمة أدوات التطوير SDK الذي قرأته الحزمة قبل الإصدار 2.0.0 (أي 3.0.8)، الفحصَ الوحيد الذي صنّفته الهيئة تحذيراً لا خطأً؛ أما الإصدار 3.4.8 الذي تقرؤه الحزمة الآن فيصنّف أكثر فحوصه تحذيرات، والقاعدة BR-KSA-09 باقية بينها: تسجّل الهيئة النقص ولا ترفض المستند من أجله، ولا تقلب هذه الملاحظة نتيجة التقرير إلى إخفاق. وكان الإصدار 3.0.8 يطلب كذلك الرقم الإضافي KSA-23 في cbc:PlotIdentification، ولا يطلبه الإصدار 3.4.8. ويصف قاموس البيانات حقول العنوان بالإلزامية، وهذا لا يغيّر تصنيف الفحص نفسه. والفحص فحص وجود لا غير، فالعنصر الموجود الفارغ يجتازه؛ ويتوقف عند أول حقل غائب بترتيب الهيئة نفسه، وهو اسم الشارع ثم رقم المبنى ثم اسم المدينة ثم الرمز البريدي ثم الحي ثم رمز الدولة، فقد يغيب أكثر من حقل من الستة ولا يُسمّى هنا إلا أولها. ويسري هذا على الفاتورة الضريبية والفاتورة المبسطة سواء.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
هذا الحقل وحده ليس عنصراً مباشراً تحت العنوان كإخوته الستة، بل يقع داخل كتلة cac:Country، وهذا وحده سبب شائع لغيابه: فالربط يكتب حقول العنوان المباشرة ولا يُخرج الكتلة المتفرعة. والقيمة رمز من حرفين بحسب ISO 3166-1، وهو SA للمملكة، وليست اسم الدولة؛ فتحقّق من أن التصدير يكتب الرمز لا الاسم المحفوظ في حقل وصف الدولة.
الفحص الذي يُنفَّذ
منقول حرفياً من ملفات قواعد التحقق التي تنشرها الهيئة، عند الملف والسطر المذكورين أدناه. والتعبير المُنفَّذ هو ما يُقيَّم على المستند، أما التعبير المذكور في التقرير فهو ما يظهر عند الإخفاق، وهما لا يتطابقان دائماً.
التعبير المُنفَّذ
not(exists(cbc:StreetName) and exists(cbc:BuildingNumber) and exists(cbc:CityName) and exists(cbc:PostalZone) and exists(cbc:CitySubdivisionName) and exists(cac:Country/cbc:IdentificationCode))
التعبير المذكور في التقرير
exists(cbc:StreetName) and exists(cbc:BuildingNumber) and exists(cbc:PlotIdentification) and exists(cbc:CityName) and exists(cbc:PostalZone) and exists(cbc:CitySubdivisionName) and exists(cac:Country/cbc:IdentificationCode)
كما يرد في الإصدار 3.4.8 من حزمة أدوات التطوير SDK التي تنشرها الهيئة: النسخة المقتبسة هنا هي الملف الذي يتضمنه ذلك الإصدار بايتاً ببايت. والتاريخ في اسم الملف هو الاسم الذي تعطيه الهيئة للملف، أما القواعد فيه فهي قواعد الإصدار 3.4.8.
مثال عملي
مستند اصطناعي من مجموعة الاختبار المقيسة تُرصد عليه هذه القاعدة، تُعرض منه الأسطر التي يختلف فيها عن مستند اجتاز الفحص. ولا يذكر تقرير مطابق سوى صورة القيمة، لا القيمة نفسها.