BR-KSA-63 👤 بيانات وعناوين المشتري error

BR-KSA-63: العنوان الوطني للمشتري إلزامي عندما تكون الدولة السعودية (SA)

BR-KSA-63: Buyer Saudi National Address Mandatory When Country is 'SA'

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

في الفواتير الضريبية B2B إذا كان المشتري داخل المملكة (SA)، يلزم تعبئة: اسم الشارع، رقم المبنى، الرمز البريدي (5 أرقام)، المدينة، الحي، ورمز الدولة SA.

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

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

إذا كان رمز دولة المشتري 'SA' في الفاتورة الضريبية القياسية، فإن جميع عناصر العنوان الوطني السعودي للمشتري تصبح إلزامية.

English Description: If buyer country code is 'SA' on a Standard Tax Invoice, street name, building number, postal code (5 digits), city, district, and country code are all mandatory.

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

  • إدخال عنوان جزئي للعميل داخل السعودية (مثل كتابة اسم المدينة والدولة فقط)
  • إغفال رقم مبنى المشتري أو اسم الحي
  • الرمز البريدي للمشتري لا يتكون من 5 أرقام (BR-KSA-67)

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

1

تسجيل العنوان الوطني الكامل للعميل B2B

اطلب العنوان الوطني المعتمد للعميل التجاري (الشارع، رقم المبنى المكون من 4 أرقام، الحي، المدينة، الرمز البريدي 5 أرقام).

2

تعبئة العناصر الستة في عنوان المشتري

تأكد من إدراج كافة العناصر الستة تحت <cac:AccountingCustomerParty>/<cac:Party>/<cac:PostalAddress>.

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

❌ النموذج الخاطئ (مرفوض من زاتكا) Invalid XML
<cac:AccountingCustomerParty>
  <cac:Party>
    <cac:PostalAddress>
      <cbc:CityName>Jeddah</cbc:CityName>
      <cac:Country><cbc:IdentificationCode>SA</cbc:IdentificationCode></cac:Country>
    </cac:PostalAddress>
  </cac:Party>
</cac:AccountingCustomerParty>
✓ النموذج الصحيح (المعتمد رسمياً) Valid UBL 2.1
<cac:AccountingCustomerParty>
  <cac:Party>
    <cac:PostalAddress>
      <cbc:StreetName>Al Andalus Road</cbc:StreetName>
      <cbc:BuildingNumber>4567</cbc:BuildingNumber>
      <cbc:CitySubdivisionName>Al Rawdah</cbc:CitySubdivisionName>
      <cbc:CityName>Jeddah</cbc:CityName>
      <cbc:PostalZone>23432</cbc:PostalZone>
      <cac:Country><cbc:IdentificationCode>SA</cbc:IdentificationCode></cac:Country>
    </cac:PostalAddress>
  </cac:Party>
</cac:AccountingCustomerParty>

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

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

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

هل تنطبق القاعدة إذا كان المشتري خارج المملكة؟

لا، إذا كان العميل خارج السعودية (رمز دولة غير SA)، يكتفى باسم الشارع والمدينة ورمز الدولة وفق القاعدة BR-KSA-10.

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

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