BR-KSA-09 🏢 عناوين وبيانات البائع error

BR-KSA-09: نقص في الحقول الإلزامية للعنوان الوطني للبائع

BR-KSA-09: Seller Saudi National Address Mandatory Fields Missing

المواصفة التقنية المعتمدة من زاتكا:

يجب أن يتضمن عنوان البائع: اسم الشارع (BT-35)، رقم المبنى (KSA-17)، الرمز البريدي (BT-38)، اسم المدينة (BT-37)، اسم الحي (KSA-3)، ورمز الدولة (BT-40).

XPath Context: /ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PostalAddress

📌 نبذة عن القاعدة وسبب التدقيق

يجب أن يحتوي عنوان البائع على العناصر الستة الكاملة للعنوان الوطني السعودي: اسم الشارع، رقم المبنى، الرمز البريدي، المدينة، الحي، ورمز الدولة (SA).

English Description: Seller address must contain all 6 Saudi National Address elements: Street Name, Building Number, Postal Code, City, District, and Country Code ('SA').

⚠️ الأسباب الشائعة لظهور الخطأ ورفض الفاتورة

  • إغفال رقم المبنى <cbc:BuildingNumber> أو اسم الحي <cbc:CitySubdivisionName>
  • الرمز البريدي مفقود أو لا يتكون من 5 أرقام
  • رقم المبنى لا يتكون من 4 أرقام
  • رمز الدولة ليس SA

خطوات الحل وتصحيح الفاتورة

1

التحقق من العنوان الوطني الرسمي

راجع بيانات العنوان الوطني المسجل في البريد السعودي سبل (SPL) للحصول على رقم المبنى والرمز البريدي والحي بدقة.

2

تعبئة العناصر الستة في XML

تأكد من وجود: StreetName، BuildingNumber، CitySubdivisionName، CityName، PostalZone، وCountry/IdentificationCode.

💻 نموذج برمجي لمقارنة ملف XML (قبل وبعد التصحيح)

❌ النموذج الخاطئ (مرفوض من زاتكا) Invalid XML
<cac:PostalAddress>
  <cbc:StreetName>King Fahd Road</cbc:StreetName>
  <cbc:CityName>Riyadh</cbc:CityName>
  <cac:Country>
    <cbc:IdentificationCode>SA</cbc:IdentificationCode>
  </cac:Country>
</cac:PostalAddress>
✓ النموذج الصحيح (المعتمد رسمياً) Valid UBL 2.1
<cac:PostalAddress>
  <cbc:StreetName>King Fahd Road</cbc:StreetName>
  <cbc:BuildingNumber>1234</cbc:BuildingNumber>
  <cbc:CitySubdivisionName>Al Olaya</cbc:CitySubdivisionName>
  <cbc:CityName>Riyadh</cbc:CityName>
  <cbc:PostalZone>12211</cbc:PostalZone>
  <cac:Country>
    <cbc:IdentificationCode>SA</cbc:IdentificationCode>
  </cac:Country>
</cac:PostalAddress>

تحقق من صحة ملف الفاتورة الآن مجاناً

استخدم أدوات قيمة لفحص بنية XML والتأكد من عدم وجود أخطاء قبل إرسال الفواتير لمنصة زاتكا.

الأسئلة الشائعة حول BR-KSA-09

هل تنطبق متطلبات العنوان الوطني للبائع على الفواتير المبسطة؟

نعم، متطلبات العنوان الوطني الكامل للبائع (BR-KSA-09) إلزامية على جميع الفواتير الضريبية والمبسطة.

ودّع مشاكل الربط وأخطاء الفوترة مع برنامج قيمة

يتكفل نظام قيمة بكافة متطلبات هيئة الزكاة والضريبة والجمارك تلقائياً في الخلفية: اعتماد فوري للفواتير، توقيع رقمي، وربط كامل مع منصة فاتورة.