الفوترة والمستندات
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 من الإصدار 5؟
مصطلحات ذات صلة
- الفوترة الإلكترونية الفوترة الإلكترونية هي إنشاء الفواتير وتبادلها ومعالجتها تلقائياً بتنسيق رقمي مهيكل بين المورد والمشتري، وغالباً ما تكون متكاملة مباشرة مع الهيئات الضريبية الحكومية.
- PINT OM PINT OM هي النسخة العُمانية من صيغة فاتورة Peppol الدولية، أي بنية XML ومجموعة القواعد التي يجب أن تتبعها كل فاتورة إلكترونية ضمن برنامج فوترة في سلطنة عُمان.
- رقم الفاتورة رقم الفاتورة هو رمز تسلسلي فريد يُخصص لمستند المبيعات لتحديد معاملة معينة، وتتبع المدفوعات، والاحتفاظ بسجلات محاسبية دقيقة.
- إشعار دائن الإشعار الدائن هو مستند تجاري يصدره البائع للمشتري، يقلل أو يلغي المبلغ المستحق في فاتورة صادرة مسبقاً بسبب أخطاء أو مرتجعات أو تلفيات.
- مزود الخدمة المعتمد مزود الخدمة المعتمد شركة وافقت عليها الجهة الضريبية لتستقبل الفواتير الإلكترونية للمنشأة وتتحقق منها وتسلّمها وتبلغ عنها نيابة عنها.
- إشعار مدين الإشعار المدين هو مستند تجاري يصدره المشتري لطلب رصيد دائن، أو البائع لزيادة المبلغ المستحق في فاتورة قائمة.