خطأ
ZATCA-00029 معرف فريد مكرر للفاتورة
فاتورة بنفس المعرف الفريد (UUID) تم تقديمها لزاتكا مسبقاً.
⚠️ ما سبب هذا الخطأ؟
الأسباب الشائعة لظهور ZATCA-00029
- ✗ إعادة تقديم فاتورة تم اعتمادها أو إبلاغها سابقاً
- ✗ خوارزمية توليد UUID لا تنتج قيم عشوائية حقيقية
- ✗ منطق إعادة المحاولة يقدم نفس الفاتورة مرتين
- ✗ خطأ نسخ ولصق يعيد استخدام UUID من الاختبار
✅ كيف تحل هذا الخطأ
اتبع هذه الخطوات لحل ZATCA-00029
1
أنشئ UUID v4 جديد
أنشئ UUID إصدار 4 (عشوائي) جديد لكل فاتورة — لا تعد استخدام UUIDs أبداً.
2
طبّق فحوصات عدم التكرار
تحقق مما إذا كان UUID قد تم تقديمه مسبقاً قبل الإرسال لزاتكا.
3
احتفظ بسجل التقديم
احتفظ بسجل محلي لجميع UUIDs المقدمة لمنع التكرار العرضي.
4
UUID جديد لإعادة التقديم
عند إعادة تقديم فاتورة مرفوضة بعد الإصلاح، أنشئ UUID جديداً دائماً.
حل أخطاء زاتكا تلقائياً
قيمة تتحقق من الفواتير قبل الإرسال وتمنع أخطاء ZATCA-00029 من الحدوث.