UBL 2.1 (صيغة XML للفاتورة)

من فريق ماثل، مبني على مواصفات الهيئة و SDK 3.4.8 · آخر تحديث

UBL 2.1 هو معيار XML اللي تُكتب به فواتير المرحلة الثانية في زاتكا، وتتحقق منه الهيئة بالـ XSD وقواعد EN 16931 وقواعد السعودية.

UBL 2.1 (Universal Business Language) معيار XML مفتوح من OASIS لمستندات التجارة. في المرحلة الثانية، الفاتورة لازم تكون XML على هالمعيار، والهيئة أضافت عليه حقول سعودية مثل ICV وPIH والـ QR.

الفاتورة تمر على ثلاث طبقات تحقق في SDK الهيئة: مخطط XSD (أسماء العناصر وترتيبها)، وقواعد EN 16931 الأوروبية (تبدأ بـ BR- وBR-CO-)، وقواعد السعودية (تبدأ بـ BR-KSA-). وماثل يكتب الإشعارات الدائنة والمدينة بنفس الجذر Invoice، والفرق في InvoiceTypeCode.

أشياء سعودية تفاجئ اللي جاي من EN 16931: cbc:ProfileID لازم reporting:1.0 (BR-KSA-EN16931-01)، وcbc:TaxCurrencyCode لازم SAR (BR-KSA-EN16931-02)، وفيه عنصرين cac:TaxTotal: واحد فيه التفصيل حسب الفئة وواحد بدونه (BR-KSA-EN16931-08 و09). وأي خطأ في الحساب يطلع من قواعد BR-CO، مثل BR-CO-10 لو مجموع البنود ما يساوي الإجمالي.

في ماثل ما تكتب XML: ترسل JSON، وماثل يبني الـ UBL ويحسب المجاميع من البنود نفسها عشان قواعد BR-CO تنجح، والناتج يعدّي الطبقات الثلاث في SDK الهيئة.

مثال

<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" ...>
  <cbc:ProfileID>reporting:1.0</cbc:ProfileID>
  <cbc:ID>SME00010</cbc:ID>
  <cbc:UUID>8e6000cf-1a98-4174-b3e7-b5d5954bc10d</cbc:UUID>
  <cbc:IssueDate>2022-08-17</cbc:IssueDate>
  <cbc:IssueTime>17:41:08</cbc:IssueTime>
  <cbc:InvoiceTypeCode name="0200000">388</cbc:InvoiceTypeCode>
  <cbc:DocumentCurrencyCode>SAR</cbc:DocumentCurrencyCode>
  <cbc:TaxCurrencyCode>SAR</cbc:TaxCurrencyCode>

أسئلة شائعة

هل أقدر أرسل فاتورة PDF بدل XML؟

لا. الإرسال للهيئة يكون XML، والـ PDF/A-3 (فيه الـ XML) صيغة للمشاركة مع المشتري والحفظ.

وش الفرق بين قواعد BR- وBR-KSA-؟

BR- وBR-CO- من المعيار الأوروبي EN 16931، وBR-KSA- قواعد أضافتها الهيئة للسعودية.

قواعد الهيئة المرتبطة

مصطلحات قريبة

خلّ ماثل يتعامل مع هذا عنك

ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.

جرّب ماثل بدون تسجيل توثيق ماثل API