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