تخطَّ إلى المحتوى
KSA-1

رقم التعريف الموحد عالمياً للفاتورة (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 يولّده الجهاز المُصدر، من حروف وأرقام وشَرطات فقط.

حقول ذات صلة

الحقول — الفوترة الإلكترونية في السعودية (فاتورة)

المصادر

  1. Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. Electronic Invoice Data Dictionary to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  3. E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
  4. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA

تاريخ المراجعة: 4 نوفمبر 2026. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.