الخلاصة السريعة: معظم أخطاء زاتكا في أودو لا تصل لزاتكا أصلاً. بيمسكها فحص داخلي قبل الإرسال، أو قيود مرحلة الإعداد، أو سلسلة الفواتير. لما تعرف إنت واقف في أي طبقة من التلاتة، الحل بيبقى واضح فورًا. الدليل ده بيمشي على كل نقطة فشل في تكامل أودو مع الفوترة الإلكترونية السعودية، بترتيب حدوثها.
فين بيظهر الخطأ في أودو
قبل أي تشخيص، اعرف تبص فين. أودو بيعرض أخطاء زاتكا في تلات أماكن منفصلة، والناس بتدور في المكان الغلط:
- معالج الإعداد على اليومية. كل مشاكل الشهادة وطلب الشهادة بتظهر هنا، مش على الفاتورة.
- حالة الفاتورة وسجل المحادثة. أخطاء التحقق واستجابات الإرسال، بما فيها نص الرفض الخام.
- نافذة نقطة البيع اللي بيشوفها الكاشير. أخطاء نقطة البيع ما بتظهرش في المكتب الخلفي وقت حدوثها.
1. تجميد السلسلة: فاتورة واحدة بتوقف كل اللي بعدها
ده أكتر سلوك بيفاجئ الناس، وأول حاجة لازم تفهمها.
زاتكا بتطلب إن كل فاتورة تكون مربوطة باللي قبلها عن طريق عدّاد تصاعدي. وأودو بيطبق ده بصرامة: الفواتير بتتبعت بترتيب محكوم على كل يومية. لو فاتورة واحدة علقت، غالبًا لأن الإرسال انتهت مهلته واتسجلت كاستثناء مش كفشل، كل فاتورة اتعملت بعديها على نفس اليومية بتقف. مفيش حاجة بايظة ومفيش حاجة مرفوضة. هي بس مصطفة ورا اللي عالقة.
التعرف عليه
أودو بيقولك مباشرة. الفاتورة بتحمل مرجع لرأس السلسلة، وفي رابط الفاتورة المعيقة بيوديك للمتسبب على طول. لو شفت رسالة بتقول إن الفاتورة محجوبة بسبب فاتورة أقدم، متلمسش الفاتورة اللي قدامك.
الحل
روح للفاتورة المعيقة وحلها هي. أول ما تتفك الطابور بيمشي لوحده. محاولة إصلاح الفواتير اللي وراها واحدة واحدة بتضيع ساعات من غير أي نتيجة.
2. مقاصة ولا إبلاغ؟ بيتحدد من ملف العميل
نسبة كبيرة من استجابات الإرسال المحيرة سببها حقل واحد ملوش أي علاقة بالفاتورة نفسها.
أودو بيختار مسار الإرسال من نوع الشركة في ملف العميل. عميل مضبوط على فرد بينتج فاتورة مبسطة بتروح لمسار الإبلاغ. وعميل مضبوط على شركة بينتج فاتورة ضريبية بتروح لمسار المقاصة. مفيش إعداد منفصل على الفاتورة.
لو الحقل ده غلط، المستند بيروح للمسار الخطأ وبتطلع استجابات بتبان زي مشكلة شبكة أو إعداد، والسبب الحقيقي قائمة منسدلة واحدة في ملف العميل. لو عميل معين بيفشل باستمرار والباقي شغال، راجع نوع الشركة بتاعه قبل أي حاجة.
3. الإعداد وطلب الشهادة
خطوة الإعداد بتولّد طلب توقيع الشهادة، وهي أكتر جزء بيحصل فيه أخطاء في التركيب كله.
حد الـ 64 حرف
حقول طلب الشهادة محكومة بسقف صارم 64 حرفًا، وده جاي من معيار الشهادات نفسه مش من أودو. الأسماء الطويلة، وخصوصًا الاسم القانوني العربي الكامل مع نوع الكيان، بتتجاوزه والطلب بيفشل. اختصر القيمة المستخدمة في حقول الشهادة. مفوش لزوم تطابق الترويسة المطبوعة حرفيًا.
مشكلة الرسالة العامة
في أكتر من سبب مش مرتبطين ببعض بيطلعوا بنفس الرسالة الغير محددة أثناء الإعداد. ولأن الرسالة ما بتقولش حاجة، امشي على الأسباب بترتيب الاحتمال: حدود طول الحقول، كود OTP مستخدم أو منتهي، يومية متسيبة نص مضبوطة من محاولة سابقة، واختلاف بيانات الشركة بين أودو وبوابة زاتكا.
التعامل مع كود OTP
الكود من بوابة فاتورة قصير العمر ولاستخدام واحد، وكل يومية محتاجة كودها الخاص. إنك تطلب كود ثم تتشتت وترجع بعديها هو أشهر سبب لفشل الإعداد في المحاولة التانية.
يوميات ناقصة الإعداد
لو الإعداد فشل في النص، اليومية ممكن تفضل في حالة غير متسقة وإعادة المحاولة بتدي نتايج محيرة. أودو فيه فحص مخصص للحالة دي بالظبط. لو يومية فشل إعدادها أكتر من مرة، راجع حالتها قبل ما تعيد نفس الخطوات.
4. انتهاء الشهادة
مشكلتين منفصلتين وبيتخلطوا كتير:
- التجديد لازم يحصل قبل الانتهاء. مفيش فترة سماح. جدّد والشهادة لسه سارية والعملية بسيطة. سيبها تنتهي وهترجع للإعداد من الأول خالص.
- شهادة منتهية وقت الإرسال بتفشّل كل المستندات فورًا وبنفس الشكل. لو كل حاجة وقفت في يوم واحد من غير أي تغيير، راجع تاريخ الشهادة أول حاجة.
حط تذكير في التقويم قبل تاريخ الانتهاء. ده موقف قابل للتجنب تمامًا وبيوقف الفوترة بالكامل لما يحصل.
5. فحوصات أودو قبل الإرسال
دي بتفشل جوّه أودو وزاتكا ما بتشوفش المستند أصلاً، ودي حاجة كويسة: مافيش حاجة دخلت السلسلة ومافيش حاجة اتعلقت.
صيغة الرقم الضريبي
الرقم الضريبي السعودي لازم يكون 15 رقمًا يبدأ وينتهي بـ 3. والتحقق بيتم على البائع، وعلى المشتري كمان في الفواتير الضريبية. بيظهر كمخالفة لقاعدة BR-KSA في النطاق 39 إلى 40.
المبيعات المعفاة اللي محتاجة رقم هوية
أكواد الإعفاء الخاصة بالقطاع الصحي والتعليمي بتطلب رقم الهوية الوطنية للمشتري، مش الرقم الضريبي بس. لو بتبيع خدمات معفاة في القطاعات دي ومسجّل السجل التجاري بس، الفاتورة مش هتعدي.
فخ المنطقة الزمنية
أودو بيخزن الأوقات بتوقيت UTC، وزاتكا بتتحقق مقابل توقيت الرياض اللي قدامه بتلات ساعات. فاتورة مترحّلة متأخر في اليوم ممكن تحمل وقت يتقرا إنه في المستقبل بعد التحويل، والفواتير المؤرخة مستقبلًا بتترفض. لو الرفض عندك متجمع في آخر اليوم، ده السبب.
الإشعارات الدائنة والمدينة
كل إشعار دائن أو مدين لازم يشير للفاتورة الأصلية ويوضح السبب. أودو بيمنع الإرسال لما المرجع ناقص. إنشاء إشعار دائن مستقل من غير ربط مش هيشتغل.
6. الاستجابات الراجعة من زاتكا
| اللي بتشوفه | معناه | التصرف |
|---|---|---|
| استجابة تكرار | المستند ده اتبعت قبل كده بنجاح | متعيدش الإرسال. طابق الحالة في أودو مع البوابة. |
| استجابة تحويل | مسار خاطئ، اختلاط بين المقاصة والإبلاغ | راجع نوع الشركة في ملف العميل (قسم 2) |
| انتهاء المهلة، والفاتورة مسجلة كاستثناء | النتيجة مجهولة، ممكن تكون اتقبلت | تحقق من البوابة قبل إعادة المحاولة، وحلّها بسرعة: بتجمد السلسلة |
| رفض بكود BR-KSA | مخالفة لقاعدة تحقق سعودية | اقرأ مسار الحقل في الاستجابة، مش نص الرسالة |
| رفض بكود BR أو BR-CL | قاعدة موروثة من المعيار الأوروبي الأساسي | غالبًا مشكلة في بنية المستند أو في قائمة الأكواد |
حالة انتهاء المهلة تستاهل تركيز. الفاتورة المسجلة كاستثناء مش فاتورة فاشلة. النتيجة فعلًا مجهولة. إعادة الإرسال عمياني بتخاطر بتكرار، وسيبها بيجمد اليومية. تحقق من البوابة الأول، ثم تصرف عن قصد.
7. حاجات أودو مش هيسيبك ترجع فيها
في قيود موجودة لأغراض التدقيق وبتتفهم غلط على أنها أعطال:
- الرجوع لمسودة ممنوع بعد إرسال الفاتورة. ده مقصود وبيطابق المتطلب التنظيمي إن المستندات المرسلة غير قابلة للتعديل. التصحيح بيتم بإشعار دائن.
- مرفقات XML المرفوضة محمية وما ينفعش تتمسح. دي دليل على إيه اتبعت وإمتى.
- التحول لوضع الإنتاج لا رجعة فيه. أول ما اليومية تتحول من المحاكاة للإنتاج، مفيش طريق رجوع. خلّص كل الاختبارات الأول، بما فيها كل أنواع الفواتير والإشعارات الدائنة والمدينة.
8. إعداد الضرائب
ضريبة الاستقطاع لازم تتضبط بقيمة سالبة. لو اتضبطت موجبة، بتطلع أخطاء تحقق بتبان ملهاش علاقة بإعداد الضرائب، وده بيخليها من أصعب الأخطاء في التتبع.
9. نقطة البيع
نقطة البيع بتتصرف بشكل مختلف يستاهل قسم لوحده، وأخطاؤها بتوصل للكاشير مش للمحاسب.
- الجلسات ممكن تتمنع من الفتح لما إعداد زاتكا ناقص. التحذير بيوديك للإعدادات المطلوب إصلاحها، فاقرأه بدل ما تقفله.
- نافذة خطأ تحقق بتظهر للكاشير وسط البيع. درّب الموظفين على معناها، وإلا هتوصلك مكالمات دعم بتوصف كاشير بايظ.
- متخلطش أنواع التسوية داخل الجلسة الواحدة. بيطلع أخطاء ما بتظهرش غير عند الإقفال، بعد السبب بوقت طويل.
- ملفات PDF للفواتير بتتأجل مش بتتولد فورًا. ده سلوك مقصود وبيبان زي العطل بالظبط. المستند بيظهر بعد ما تخلص المعالجة.
خريطة تشخيص سريعة
| العرض | ابدأ من هنا |
|---|---|
| كل حاجة وقفت في يوم واحد من غير تغيير | انتهاء الشهادة (قسم 4) |
| الفواتير مصطفة ومفيش حاجة بتتحرك | تجميد السلسلة (قسم 1) |
| عميل معين دايمًا بيفشل | نوع الشركة في ملف العميل (قسم 2) |
| الرفض متجمع في آخر اليوم | المنطقة الزمنية (قسم 5) |
| مش قادر تعدي مرحلة الإعداد أصلاً | حدود طلب الشهادة وكود OTP (قسم 3) |
| المشكلة في الكاشير بس | نقطة البيع (قسم 9) |
| مش قادر تصحح فاتورة غلط | عدم قابلية التعديل، استخدم إشعار دائن (قسم 7) |
إمتى تجيب مساعدة
لو الإرسال فاشل لأكتر من 48 ساعة، فإنت مش بتجري ورا خطأ واحد بل مشكلة إعداد جذرية. توقف إصدار الفواتير لفترة طويلة له تبعات تنظيمية، فمتسيبهوش يطول.
ارجع للدليل الكامل لمتطلبات زاتكا
هذا المحتوى لأغراض التوعية ولا يغني عن المواصفات الرسمية لهيئة الزكاة والضريبة والجمارك. قد يختلف السلوك بين إصدارات أودو.