ظهرت رسالة «تعذر الإرسال» بعد اعتماد فاتورة، فضغط الموظف الزر مرة أخرى ثم أنشأ فاتورة بديلة. بعد عودة الاتصال وجد المحاسب مستندين للعملية نفسها، ولم يعرف أيهما وصل إلى الجهة الخارجية. هذا موقف تشغيلي افتراضي يوضح لماذا يحتاج خطأ الفوترة إلى سجل وأدلة، لا إلى تكرار المحاولة بلا تشخيص.
سجل الاستثناءات ليس قائمة حمراء للوم المستخدمين. وظيفته أن يجيب عن أربعة أسئلة: ما المستند المتأثر؟ ما الذي نعرفه يقينًا عن حالته؟ ما الإجراء الآمن التالي؟ وما الدليل الذي يسمح بإغلاق الحالة؟ افصل هذه الأسئلة عن تفاصيل الخطأ التقنية الطويلة، مع الاحتفاظ بمرجع آمن يمكّن المختص من الرجوع إليها.
انقطع الاتصال: هل رفضت الفاتورة؟
انتهاء مهلة الطلب يعني أن التطبيق لم يحصل على جواب في الوقت المتوقع؛ لا يثبت وحده قبول الفاتورة أو رفضها. تحقق من سجل المحاولة ومن الاستجابة المحفوظة إن وجدت، واتبع آلية التحقق أو إعادة المحاولة التي تدعمها واجهة التكامل والمواصفات الرسمية. لا تفترض وجود استعلام حالة عام لكل مزود أو مسار.
احتفظ بهوية المستند ومرجع المحاولة وتوقيتها وبصمة الملف المرسل، إن كانت متاحة في التصميم، حتى لا تتحول إعادة المحاولة إلى بيع جديد. امنع ضغط الزر المتكرر من إطلاق عمليات متزامنة غير مضبوطة، وأظهر للمستخدم أن النتيجة غير محسومة بدل عرض نجاح تخميني. وعند تعذر التحقق، صعّد الحالة للمسؤول مع المستندات اللازمة بدل محوها من القائمة.
وصل رد بخطأ: من يملك التصحيح؟
خطأ بيانات المشتري يختلف عن خطأ حساب الضريبة أو خلل صلاحية الاتصال. الأول قد يحتاج مراجعة بيانات العميل ومصدرها، والثاني يحتاج فحص أساس الحساب والتقريب وتصنيف البنود، والثالث يذهب إلى مسؤول التكامل. التصنيف الصحيح يختصر الوقت الذي تضيع فيه الفاتورة بين المحاسب والدعم.
لا تكتفِ بحالة اتصال HTTP أو رسالة مختصرة من الوسيط؛ افحص نتيجة معالجة المستند وتفاصيل التحقق وفق الواجهة المستخدمة. وإن تضمن الرد تحذيرًا، فاحفظه وتعامل معه وفق معناه والمواصفة، لا بافتراض أنه رفض دائم أو أمر يمكن تجاهله دائمًا. تختلف المعالجة بحسب نوع المستند والمسار والمرحلة المنطبقة.
عند التصحيح، لا تعدّل ملفًا معتمدًا ثم تحتفظ بهوية أو توقيع لم يعد يطابق محتواه. حدد أولًا هل المستند لم يجتز المسار المطلوب، أم سبق إصداره أو قبوله وتحتاج الواقعة إلى إجراء تصحيحي موثق. راجع ضوابط الهيئة الخاصة بالحالة قبل إعادة الإصدار أو إنشاء الإشعار المناسب. هذا السجل لا يمنح استثناءً من متطلبات الفوترة.
ماذا نكتب في السطر الواحد؟
استخدم حقولًا قليلة نافعة: مرجع المستند ونوعه، وبيئة التشغيل، ووقت أول فشل وآخر محاولة، وفئة المشكلة، والحالة المثبتة، والمسؤول، والخطوة التالية وموعد متابعتها. اربط الخطأ برسالة أصلية منقحة وبمرجع التذكرة عند التصعيد. لا تحفظ كلمة مرور أو مفتاحًا خاصًا أو رمز اتصال في حقل الملاحظات، ولا ترسل ملف عميل كاملًا إذا كانت عينة منقحة تكفي للتشخيص.
حالة الاختبار لا تثبت سلامة الإنتاج. تتيح هيئة الزكاة والضريبة والجمارك أدوات ومواصفات للتحقق من الملفات، لكنها لا تجعل نجاح فحص محلي بديلًا عن استيفاء متطلبات المسار الفعلي. احتفظ بتمييز واضح بين تجربة التكامل والمستند التجاري الحقيقي، ولا تستخدم فواتير العملاء لتجريب إصلاح غير متحقق.
متى تُغلق الحالة فعلًا؟
تغلق بعد توثيق النتيجة النهائية المطلوبة للمستند، وتسوية أي أثر محاسبي أو تشغيلي ناتج عن المحاولة، وتحديد المستند الصحيح إذا وجدت نسخ أو محاولات متعددة. تغيير لون الصف إلى الأخضر لا يكفي، وإخفاء التنبيه ليس حلًا للمشكلة.
راجع دوريًا أقدم الحالات غير المحسومة والأسباب الأكثر تكرارًا، لا عدد الأخطاء الإجمالي فقط. عشرون حالة ناتجة عن حقل واحد قد تعالج بتحقق مسبق، بينما حالة واحدة قديمة بمبلغ كبير تستدعي تصعيدًا عاجلًا. ضع حدود المتابعة بحسب المخاطر والمواعيد النظامية المنطبقة، ولا تخترع مهلة موحدة من داخل السجل.
المراجع الرسمية أدناه تحدد المتطلبات؛ أما طريقة توزيع المسؤوليات والمتابعة هنا فهي اقتراح تنظيمي. ولا تعني المقالة أن نظام والي حاصل على اعتماد أو أن تكاملًا بعينه منفذ أو جاهز دون تحقق مستقل.
مصادر ومراجع للقراءة
راجع المصدر الأصلي للتوسع في المفهوم أو متابعته في سياقه.
محتوى تعليمي عام. تختلف المعالجة المناسبة باختلاف النشاط والسياسات المحاسبية المطبقة؛ راجع المختص بالمحاسبة عند تطبيقه على بيانات منشأتك.

