BR-KSA-03: المعرّف الفريد للفاتورة (UUID) ناقص

النص الرسمي

The invoice must contain a unique identifier ("UUID") (KSA-1) given by the unit that issued the document (unique message identifier for interchange process). This value must contain only letters, digits, and dashes.

خطأ · المصدر: أداة الهيئة للتحقق من الفواتير (SDK)، الإصدار 238-R3.3.8 · معيار تطبيق XML للفاتورة الإلكترونية، الإصدار 1.2، 19 مايو 2023، §13.3.1، ص 47 · تاريخ التحقق: 26 أكتوبر 2026

المعنى

كل فاتورة لازم تحمل معرّفًا فريدًا (UUID) يولّده نظامك، ويكون فيه حروف وأرقام وشرطات فقط. هذا غير رقم الفاتورة التسلسلي.

متى يطلع

• الحقل موجود لكنه فاضي.
• النظام نسخ رقم الفاتورة في حقل UUID أو وضع فيه رموز غير مسموحة.
• قالب الفاتورة القديم ما فيه الحقل أصلًا.

الحل

1. ولّد UUID جديدًا لكل فاتورة لحظة إنشائها (النوع الرابع العشوائي هو المعتاد).
2. احفظه مع الفاتورة ولا تغيّره عند إعادة الإرسال.
3. لا تستخدم نفس المعرّف لفاتورتين.

مثال

<cbc:ID>SME00010</cbc:ID>
<cbc:UUID></cbc:UUID>

<cbc:ID>SME00010</cbc:ID>
<cbc:UUID>8e6000cf-1a98-4174-b3e7-b5d5954bc10d</cbc:UUID>

شغّلنا المثال الخاطئ على أداة الهيئة SDK 238-R3.3.8 بتاريخ 26 أكتوبر 2026 وطلع الكود BR-KSA-03. المثال مقطع من عينة الهيئة Simplified/Invoice/Simplified_Invoice.xml مع تغيير واحد، والعينة نفسها بدون التغيير ما يطلع فيها الكود.

أكواد قريبة

• BR-KSA-33 عدّاد الفاتورة (ICV) ناقص
• BR-02 An Invoice shall have an Invoice number (BT-1).
• BR-KSA-04 تاريخ الفاتورة بعد تاريخ اليوم

مصطلحات في هذا الكود

آخر تحديث: 26 أكتوبر 2026 · ما لا نفعله · المنهجية · صحّح لنا · سجل التحديثات

نُشر أول مرة 2026-10-26 · نسخة مؤرشفة