الفوترة والمستندات

UUID (UUID)

UUID (المعرّف الفريد العالمي) رمز بطول 128 بت يحدد مستنداً أو سجلاً واحداً، بحيث لا يشترك مستندان في أي مكان في المعرّف نفسه.

ما هو UUID؟

يُكتب UUID في صورة 32 حرفاً ست عشرياً في خمس مجموعات، مثل 8-4-4-4-12. ويحدد المعيار (RFC 4122) عدة إصدارات. الإصدار 4 عشوائي. أما الإصدار 5 فيُنشأ من اسم ونطاق أسماء باستخدام دالة تجزئة (hash)، لذا يعطي المُدخل نفسه دائماً UUID نفسه. وفي الفاتورة الإلكترونية، يكون UUID منفصلاً عن رقم الفاتورة. فالرقم موجه للأشخاص ويتبع تسلسلك. أما UUID فموجه للأنظمة: إذ يتيح للمزود والمشتري والجهة الضريبية التعرف على المستند نفسه دون أي شك. وتشترط PINT OM 1.0.1 العُمانية وجود UUID من الإصدار 5 في كل فاتورة.

كيف يعمل UUID في الفاتورة الإلكترونية

عندما يصدر نظامك الفاتورة، ينشئ UUID ويكتبه في ملف XML. ثم يرافق UUID المستند أينما ذهب: إلى مزودك، وإلى المشتري، وإلى التقرير الضريبي. ويذكر الإشعار الدائن أو المدين UUID الخاص بالفاتورة التي يصححها. وإذا أرسل نظامك الفاتورة نفسها مرتين بعد خطأ في الشبكة، يرى المزود UUID نفسه فيعرف أنها إعادة محاولة، لا عملية بيع ثانية.

  • يُنشأ مرة واحدة عند إصدار الفاتورة
  • يُكتب في ملف XML للفاتورة الإلكترونية
  • يُذكر في كل إشعار دائن أو مدين مقابل الفاتورة
  • يتيح للمزود اكتشاف إعادة إرسال الفاتورة نفسها
  • يبقى مع المستند طوال فترة الأرشفة

أهمية هذا لمشروعك

يحميك UUID من مشكلتين شائعتين في الفوترة الإلكترونية: فاتورة مكررة بعد إعادة المحاولة، وإشعار لا يمكن مطابقته مع فاتورته. والنظام الذي ينشئ UUID مرة واحدة ويحفظه مع الفاتورة الصادرة يتجنب المشكلتين. يصدر Paper & Pen كل فاتورة إلكترونية مرة واحدة مع UUID من الإصدار 5 ويحتفظ بذلك UUID في الفاتورة.

أسئلة

الأسئلة الشائعة

هل UUID هو نفسه رقم الفاتورة؟
لا. يتبع رقم الفاتورة تسلسلك الخاص ويُطبع ليقرأه الأشخاص. أما UUID فمعرّف نظام طويل لا يشترك فيه أي مستند آخر. وتحمل الفاتورة الإلكترونية كليهما. ويذكر الإشعار الدائن رقم الفاتورة الأصلية وتاريخها وUUID الخاص بها.
لماذا تطلب سلطنة عُمان UUID من الإصدار 5؟
تنص ملاحظات إصدار PINT OM 1.0.1 على أن الإصدار 4، وهو النوع العشوائي، لم يعد مقبولاً وأن الإصدار 5 مطلوب. ويُشتق UUID من الإصدار 5 من مُدخل ثابت عبر دالة تجزئة، لذا يحصل المستند نفسه دائماً على المعرّف نفسه.

مصطلحات ذات صلة

تصفح جميع المصطلحات

جاهز لإدارة عملك على Paper & Pen؟

أنشئ مساحة عملك المجانية في أقل من 5 دقائق. المبيعات والفوترة مجانية للأبد, دون الحاجة لبطاقة ائتمان.

مجاني للأبد · لا حاجة لبطاقة ائتمان · أضف وحدات في أي وقت