أخطاء الفوترة الإلكترونية في أودو (زاتكا): دليل التشخيص الكامل

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

أين يعرض أودو أخطاء زاتكا

قبل أي تشخيص، لا بد من معرفة موقع الرسالة. يعرض أودو هذه الأخطاء في ثلاثة مواضع منفصلة، وكثيراً ما يُبحث في الموضع الخطأ:

• معالج الإعداد على اليومية. تظهر فيه جميع مشكلات الشهادة وطلب الشهادة، وليس على الفاتورة.
• حالة الفاتورة وسجل المحادثة. تظهر فيه أخطاء التحقق واستجابات الإرسال، ومنها نص الرفض الخام.
• نافذة نقطة البيع. أخطاء نقطة البيع تظهر للكاشير ولا تظهر في المكتب الخلفي لحظة حدوثها.

1. تجميد السلسلة: فاتورة واحدة توقف جميع ما بعدها

هذا أكثر سلوك يفاجئ المستخدمين، وأول ما يجب فهمه.

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

كيف تتعرف عليه

يوضح أودو الأمر مباشرة. تحمل الفاتورة مرجعاً لرأس السلسلة، وتوجد رابطة الفاتورة المعيقة التي تنقلك إلى المتسبب مباشرة. وإذا ظهرت رسالة تفيد أن الفاتورة محجوبة بسبب فاتورة أقدم، فلا تعدل الفاتورة المعروضة أمامك.

الحل

انتقل إلى الفاتورة المعيقة وعالجها وحدها. وبمجرد معالجتها ينتظم الطابور تلقائياً. أما محاولة إصلاح الفواتير اللاحقة واحدة بواحدة فهي مضيعة للوقت بلا أي نتيجة.

2. المقاصة أم الإبلاغ؟ يتحدد من ملف العميل

نسبة كبيرة من استجابات الإرسال المحيرة سببها حقل واحد لا علاقة له بالفاتورة نفسها.

يختار أودو مسار الإرسال من نوع الشركة في ملف العميل. العميل المسجل كـ فرد ينتج عنه فاتورة مبسطة تُرسل للإبلاغ، والعميل المسجل كـ شركة ينتج عنه فاتورة ضريبية تُرسل للمقاصة. ولا يوجد إعداد منفصل على الفاتورة.

وإذا كان هذا الحقل خاطئاً، يُرسل المستند إلى المسار الخطأ، فتظهر استجابات توحي بمشكلة شبكة أو إعداد، بينما السبب الحقيقي قائمة منسدلة واحدة في ملف العميل. وإذا كان عميل معين يفشل باستمرار فيما ينجح الباقون، فراجع نوع الشركة لديه قبل أي شيء آخر.

3. الإعداد وطلب الشهادة

تولد خطوة الإعداد طلب توقيع الشهادة، وهي أكثر أجزاء التركيب عرضة للأخطاء.

حد 64 حرفاً

حقول طلب الشهادة محكومة بسقف صارم مقداره 64 حرفاً، وهو قيد من معيار الشهادات نفسه وليس من أودو. والأسماء الطويلة، وخاصة الاسم القانوني العربي الكامل مع نوع الكيان، تتجاوزه فيفشل الطلب. اختصر القيمة المستخدمة في حقول الشهادة، إذ لا يلزم أن تطابق الترويسة المطبوعة حرفياً.

مشكلة الرسالة العامة

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

التعامل مع كود OTP

الكود الصادر من بوابة فاتورة قصير العمر ولاستخدام واحد، وكل يومية تحتاج كوداً خاصاً بها. وطلب الكود ثم الانقطاع والعودة لاحقاً هو أشهر أسباب فشل الإعداد في المحاولة الثانية.

يوميات ناقصة الإعداد

إذا فشل الإعداد في منتصفه، فقد تبقى اليومية في حالة غير متسقة تجعل المحاولات التالية تسلك سلوكاً غير متوقع. وفي أودو فحص مخصص لهذه الحالة تحديداً. فإذا فشل إعداد يومية أكثر من مرة، راجع حالتها قبل إعادة الخطوات نفسها.

4. انتهاء الشهادة

مشكلتان منفصلتان يكثر الخلط بينهما:

• التجديد يجب أن يسبق الانتهاء. لا توجد فترة سماح. فالتجديد والشهادة لا زالت سارية إجراء بسيط، أما تركها حتى تنتهي فيعني العودة للإعداد من البداية.
• الشهادة المنتهية وقت الإرسال تُفشل جميع المستندات فوراً وبالشكل نفسه. فإذا توقف كل شيء في يوم واحد دون أي تغيير، فراجع تاريخ الشهادة أولاً.

ضع تنبيهاً في التقويم قبل تاريخ الانتهاء. فهذا موقف يمكن تجنبه تماماً، وهو يوقف الفوترة بالكامل عند وقوعه.

5. الفحوص التي يجريها أودو قبل الإرسال

تفشل هذه الفحوص داخل أودو ولا ترى زاتكا المستند أصلاً، وهذا في مصلحتك: لم يدخل شيء السلسلة ولم يتعطل شيء.

صيغة الرقم الضريبي

يجب أن يكون الرقم الضريبي السعودي 15 رقماً يبدأ وينتهي بالرقم 3. ويجري التحقق من رقم البائع، ومن رقم المشتري أيضاً في الفواتير الضريبية. ويظهر ذلك كمخالفة لقاعدة BR-KSA في النطاق 39 إلى 40.

المبيعات المعفاة التي تتطلب رقم هوية

تتطلب أكواد الإعفاء الخاصة بالقطاع الصحي والتعليمي رقم الهوية الوطنية للمشتري، وليس الرقم الضريبي وحده. فإذا كنت تبيع خدمات معفاة في هذين القطاعين ولم تسجل سوى السجل التجاري، فلن تجتاز الفاتورة التحقق.

فخ المنطقة الزمنية

يخزن أودو الأوقات بتوقيت UTC، بينما تتحقق زاتكا مقابل توقيت الرياض المتقدم عليه بثلاث ساعات. وفاتورة مُرحلة متأخراً في اليوم قد تحمل وقتاً يُقرأ كأنه في المستقبل بعد التحويل، والفواتير المؤرخة مستقبلاً تُرفض. فإذا تجمعت حالات الرفض لديك في نهاية اليوم، فهذا السبب.

الإشعارات الدائنة والمدينة

يجب أن يشير كل إشعار دائن أو مدين إلى الفاتورة الأصلية ويوضح السبب، ويمنع أودو الإرسال عند غياب المرجع. وإنشاء إشعار دائن مستقل دون ربط لن ينجح.

6. الاستجابات الواردة من زاتكا

تستحق حالة انتهاء المهلة تركيزاً خاصاً. فالفاتورة المسجلة كاستثناء ليست فاتورة فاشلة، والنتيجة مجهولة فعلاً. وإعادة الإرسال دون تحقق تخاطر بتكرار، وتركها يجمد اليومية. تحقق من البوابة أولاً، ثم تصرف عن قصد.

7. قيود لا يمكن الرجوع عنها

توجد قيود موضوعة لأغراض التدقيق وتُفهم خطأ على أنها أعطال:

• الرجوع إلى مسودة ممنوع بعد إرسال الفاتورة. وهو قيد مقصود يطابق متطلب أن المستندات المرسلة غير قابلة للتعديل، والتصحيح يتم بإشعار دائن.
• مرفقات XML المرفوضة محمية ولا يمكن حذفها، لأنها دليل على ما أُرسل ومتى أُرسل.
• التحول إلى وضع الإنتاج لا رجعة فيه. فمتى انتقلت اليومية من المحاكاة إلى الإنتاج فلا يوجد طريق للعودة. أكمل جميع الاختبارات أولاً، ومنها جميع أنواع الفواتير والإشعارات الدائنة والمدينة.

8. إعداد الضرائب

يجب إعداد ضريبة الاستقطاع بقيمة سالبة. وإذا أُعدت بقيمة موجبة تظهر أخطاء تحقق تبدو غير متصلة بإعداد الضرائب، وهو ما يجعل تتبعها صعباً للغاية.

9. نقطة البيع

تختلف نقطة البيع بما يكفي لإفراد قسم خاص بها، وأخطاءها تصل إلى الكاشير وليس إلى المحاسب.

• قد تُمنع الجلسات من الفتح عندما يكون إعداد زاتكا ناقصاً، والتحذير يوجهك إلى الإعدادات المطلوب إصلاحها، فاقرأه ولا تتجاهله.
• تظهر نافذة خطأ تحقق للكاشير أثناء البيع. درب الموظفين على معناها، وإلا وردتك مكالمات دعم تصف توقف نقطة البيع.
• لا تخلط أنواع التسوية داخل الجلسة الواحدة، فهو ينتج أخطاء لا تظهر إلا عند الإقفال، أي بعد السبب بوقت طويل.
• تُولد ملفات PDF للفواتير بشكل مؤجل وليس فورياً. وهو سلوك مقصود يشبه العطل تماماً، ويظهر المستند بعد انتهاء المعالجة.

خريطة تشخيص سريعة

متى تطلب مساعدة

إذا استمر فشل الإرسال أكثر من 48 ساعة، فأنت لا تواجه خطأ واحداً بل مشكلة إعداد جذرية. وتوقف إصدار الفواتير لفترة طويلة له تبعات تنظيمية، فلا تدع الأمر يطول.

دليل ربط أودو مع منصة فاتورة يشرح الإعداد السليم من البداية.

عد إلى الدليل الكامل لمتطلبات زاتكا

هذا المحتوى لأغراض التوعية ولا يغني عن المواصفات الرسمية لهيئة الزكاة والضريبة والجمارك. وقد يختلف السلوك بين إصدارات أودو.