دليل متطلبات المعرف الفريد (UUID) وعداد الفواتير (ICV) من هيئة الزكاة والضريبة والجمارك
تعرف على المتطلبات التقنية للمرحلة الثانية من الفوترة الإلكترونية في السعودية. شرح مفصل للرقم الفريد UUID وعداد الفواتير ICV وكيفية ضمان الامتثال.
مقدمة عن المعرفات التقنية في نظام “فاتورة”
مع تعمق المملكة العربية السعودية في المرحلة الثانية (مرحلة الربط والتكامل) من مشروع الفوترة الإلكترونية “فاتورة”، زاد التعقيد التقني لمتطلبات الفواتير. بالنسبة للمنشآت الصغيرة والمتوسطة، لم يعد الامتثال مجرد إصدار فاتورة PDF تحتوي على رمز استجابة سريعة (QR Code)، بل أصبح يتعلق بضمان احتواء كل ملف XML يتم إرساله إلى منصة “فاتورة” على معرفات محددة وغير قابلة للتغيير.
من أهم هذه المكونات التقنية: المعرف الفريد عالمياً (UUID) و قيمة عداد الفواتير (ICV). جنباً إلى جنب مع الرمز التجزئي للفاتورة السابقة (PIH)، تشكل هذه العناصر سلسلة غير قابلة للكسر تمنع التلاعب بالبيانات وتضمن سلامة السجلات المالية في النظام الضريبي السعودي.
في هذا الدليل، سنشرح هذه المصطلحات، ولماذا هي إلزامية، وكيف يقوم مركز زكاة وقيمة بأتمتة هذه العمليات المعقدة لمنشأتك.
1. ما هو المعرف الفريد عالمياً (UUID)؟
الـ UUID هو رقم مكون من 128 بت يُستخدم لتمييز كل فاتورة بشكل فريد على مستوى المملكة. على عكس رقم الفاتورة الداخلي (الذي قد يتكرر بين الشركات المختلفة)، فإن الـ UUID فريد عالمياً ولا يمكن أن يتطابق لفاتورتين أبداً.
✅ المتطلبات التقنية للـ UUID
- الصيغة: يجب أن يتبع معيار RFC 4122 (الإصدار الرابع).
- الهيكل: سلسلة من 36 حرفاً تشمل أرقاماً ست عشرية وشرطات (مثال:
550e8400-e29b-41d4-a716-446655440000). - الموقع: في ملف XML الخاص بالهيئة، يوجد تحت الوسم
cbc:UUID. - عدم القابلية للتغيير: بمجرد تخصيص UUID لفاتورة وإرسالها للهيئة، لا يجوز تغييره أبداً. حتى لو تم رفض الفاتورة واحتاجت لتعديل، يجب إصدار UUID جديد للنسخة المصححة.
⚠️ لماذا يعتبر الـ UUID حيوياً؟
تستخدم الهيئة هذا المعرف لتتبع دورة حياة المستند. إذا حاولت إرسال فاتورتين مختلفتين بنفس الـ UUID، سيرفض النظام العملية فوراً. هذا يضمن عدم تكرار المعاملات أو اختلاطها في قاعدة البيانات الوطنية.
2. فهم قيمة عداد الفواتير (ICV)
عداد الفواتير (ICV) هو قيمة رقمية تسلسلية تُخصص لكل فاتورة يتم إصدارها من خلال حل تقني محدد (جهاز أو كاشير).
القواعد الأساسية للعداد (ICV):
- التسلسل الصارم: يجب أن يبدأ العداد من رقم 1 لأول فاتورة يصدرها الجهاز، ويزداد بمقدار 1 بالضبط لكل مستند تالٍ (سواء كانت فاتورة، إشعار دائن، أو إشعار مدين).
- عدم وجود فجوات: لا يُسمح بتخطي الأرقام (مثلاً الانتقال من 10 إلى 12 مباشرة).
- عدم التصفير: لا ينبغي إعادة ضبط العداد عند بداية شهر أو سنة جديدة؛ بل يستمر طوال فترة صلاحية شهادة التشفير (CSID) المرتبطة بالجهاز.
📋 مقارنة بين رقم الفاتورة الداخلي وعداد ICV
| الخاصية | رقم الفاتورة الداخلي | عداد الفواتير (ICV) |
|---|---|---|
| الغرض | تتبع الأعمال المرجعي | ضمان تسلسل الفواتير للهيئة |
| الصيغة | مرنة (مثال: INV-2024-001) | رقمي فقط (مثال: 1، 2، 3) |
| الإلزامية | اختياري حسب رغبة المنشأة | إلزامي في المرحلة الثانية |
| وسم XML | cbc:ID | additional:Item |
3. “سلسلة الثقة”: الربط بين UUID و ICV و PIH
قدمت المرحلة الثانية مفهوم تسلسل الفواتير (Invoice Chaining). تضمن هذه الآلية عدم إمكانية حذف أو إدراج فواتير بأثر رجعي دون اكتشاف ذلك.
كيف تعمل السلسلة؟
- الفاتورة (ن): تحتوي على الـ UUID والـ ICV الخاصين بها.
- الرمز التجزئي للفاتورة السابقة (PIH): يجب أن تحتوي الفاتورة (ن) أيضاً على بصمة رقمية (Hash) لملف XML الخاص بالفاتورة السابقة (ن-1).
- النتيجة: إذا حاولت تغيير الفاتورة رقم 5، فإن البصمة المخزنة في الفاتورة رقم 6 لن تتطابق، مما يؤدي لكسر السلسلة ورفض النظام.
💡 نصيحة خبراء قيمة: إدارة هذه العملية يدوياً مستحيلة. لهذا السبب، يعد استخدام برنامج محاسبي سحابي معتمد مثل “قيمة” أمراً ضرورياً، حيث يقوم نظامنا تلقائياً بحساب بصمة الفاتورة السابقة ودمجها في الفاتورة الحالية في أجزاء من الثانية.
4. أخطاء شائعة في الـ UUID والـ ICV عند الربط مع “فاتورة”
عند الربط التقني، قد تظهر بعض رموز الأخطاء من بوابة الهيئة:
- KSA-1: UUID مكرر. يظهر عند إرسال فاتورة بمعرف موجود مسبقاً في قاعدة بيانات الهيئة.
- KSA-9: ICV غير صالح. يظهر عند وجود كسر في التسلسل (مثلاً إرسال ICV 5 بينما كان آخر رقم مسجل هو 3).
- KSA-13: الرمز التجزئي للسابق غير صحيح. يظهر عندما لا يتطابق الـ PIH المقدم مع البصمة الفعلية للمستند السابق.
يمكنك استخدام أداة فحص XML الخاصة بنا للتأكد من هيكلة ملفاتك.
5. قائمة التحقق لأصحاب الأعمال في السعودية
لضمان بقاء منشأتك ممتثلة لمتطلبات المرحلة الثانية، اتبع الآتي:
- تأكد من اعتماد البرنامج: تحقق أن مزود الحل التقني مدرج في قائمة الهيئة.
- مراجعة التسلسل: تأكد أن نظامك الحالي لا يسمح بوجود “فجوات” في أرقام الفواتير.
- التعامل مع تعدد الأجهزة: إذا كان لديك عدة فروع أو نقاط بيع، يجب أن يكون لكل جهاز رقم تسلسلي فريد وعداد ICV مستقل.
- حفظ البيانات: تأكد من قدرة النظام على أرشفة الـ UUID والـ PIH لمدة 6 سنوات على الأقل وفقاً للأنظمة السعودية.
كيف يساعدك نظام “قيمة” في الامتثال؟
المصطلحات التقنية مثل UUID و ICV قد تكون مربكة، لكن مع قيمة، لا داعي للقلق بشأن التفاصيل البرمجية. لقد صممنا نظامنا ليتولى كل هذه التعقيدات خلف الكواليس.
- تسلسل تلقائي: يقوم قيمة بتوليد الـ UUID وإدارة عداد الـ ICV لكل عملية بيع تلقائياً.
- تحقق فوري: يقوم النظام بفحص الفاتورة مقابل قواعد الهيئة قبل إرسالها لتجنب أخطاء الرفض.
- ربط سلس: سواء كنت تصدر فاتورة ضريبية مبسطة (B2C) أو فاتورة ضريبية (B2B)، نضمن لك امتثالاً بنسبة 100%.
- تكامل مالي: بالإضافة للامتثال، احصل على رؤية كاملة لأداء عملك من خلال وحدة المحاسبة والمالية.
لا تخاطر بالغرامات أو توقف أعمالك.
اكتشف حلول قيمة للمرحلة الثانية | استعرض خطط الأسعار | تواصل مع خبرائنا