رقم التعريف الموحد عالمياً للفاتورة (UUID)
معرّف من 128 بت يولّده الحل التقني لكل مستند، فلا يتكرر في أي مكان في العالم.
الـ UUID معرّف تقني يولّده جهاز الإصدار نفسه، وليس رقماً يختاره البائع. وظيفته أن يميز المستند في التبادل مع منصة فاتورة، ولهذا يُرسل مع كل طلب إبلاغ أو اعتماد إلى جانب الـ hash.
القاعدة BR-KSA-03 تشترط وجوده وألا يحتوي إلا على حروف وأرقام وشَرطات، وتذكر أن نظام ويندوز يسميه GUID. مثاله في قاموس البيانات: 3cf5ee18-ee25-44ea-a444-2c37ba7f28be.
إذا رُفض مستند وأُعيد إصداره بعد تصحيحه فهو مستند جديد: تذكر الإرشادات الفنية أنه لا يجوز إعادة استخدام الـ UUID ولا قيمة العداد للمستند المرفوض.
| المعرّف | KSA-1 |
|---|---|
| المسار في المستند | /Invoice/cbc:UUID |
| التكرار | 1..1 |
| نوع البيانات | Identifier |
| ينطبق على | الفاتورة الضريبية (القياسية) والفاتورة الضريبية المبسطة |
في جوداكس
مبنييولّد البرنامج UUID عشوائياً (الإصدار 4) لكل مستند عند إصداره، ويمنع ملف البيانات تكراره.
crates/jdx-einvoice-sa/src/unit.rs
ينطبق على
| فاتورة ضريبية | إشعار مدين | إشعار دائن | مبسطة | مدين مبسط | دائن مبسط |
|---|---|---|---|---|---|
| إلزامي | إلزامي | إلزامي | إلزامي | إلزامي | إلزامي |
القواعد التي تفحصه
- BR-KSA-03 · يجب أن يحمل المستند UUID يولّده الجهاز المُصدر، من حروف وأرقام وشَرطات فقط.
حقول ذات صلة
الحقول — الفوترة الإلكترونية في السعودية (فاتورة)
المصادر
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Electronic Invoice Data Dictionary to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
تاريخ المراجعة: 4 نوفمبر 2026. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.