.svg)
حل مشكلات الفواتير والتكامل
ابدأ بالمرحلة التي حدث فيها الفشل. اجمع الأدلة قبل إعادة المحاولة، أو تغيير بيانات الاعتماد، أو طلب إرسال المستند مرة أخرى من شريك تجاري.
قبل البدء
- معرف المعاملة أو التسليم، والوقت التقريبي، والخطأ الظاهر.
الخطوات
- حدد ما إذا كانت المشكلة تتعلق بتسجيل الدخول، أو التحقق من صحة المستند، أو تسليم الشبكة، أو نظام المستلم (MLS)، أو إعداد التقارير للهيئة الاتحادية للضرائب (FTA)، أو تسليم نظام تخطيط موارد المؤسسات (ERP)/إشعار Webhook (webhook).
- افتح شاشة التفاصيل ذات الصلة وسجل رمز/رسالة الخطأ الدقيقة والمعرفات.
- استخدم إرشادات المطابقة أدناه. أعد التحقق من محتوى المستند المعدل قبل أي إرسال معتمد.
- إذا كان قد تم تقديم المستند بالفعل، فابحث عنه أولاً. اطلب من المسؤول التقني لديك إجراء المطابقة حسب المعاملة/الرسالة/مرجع التكرار (idempotency).
- قم بتصعيد المشكلات التي لم يتم حلها مع إرفاق حزمة أدلة واضحة والنتيجة المحددة التي كنت تتوقعها.
تم حل المشكلة الأصلية في المرحلة الصحيحة، ولم يتم إنشاء فاتورة مكررة كأثر جانبي لعملية استكشاف الأخطاء وإصلاحها.
ملاحظات واستكشاف الأخطاء وإصلاحها
الأعراض والفحوصات الأولية
| العرض | الإجراء |
|---|---|
| تفاصيل الشركة مفقودة | أكمل ملف تعريف الشركة المحدد، بما في ذلك التسجيل والإمارة |
| ibr-190-ae / عدم تطابق ضريبة القيمة المضافة القياسية | راجع بند السعر القياسي المعتمد وقاعدة نسبة الـ 5% المعروضة؛ قم بالتصحيح وإعادة التحقق |
| إشعار دائن يفتقر إلى مرجع | حدد سبب إشعار الدائن. رقم الفاتورة الأصلية مطلوب باستثناء خصم الكمية، حيث يجب أن يظل فارغاً؛ تاريخ الفاتورة الأصلية اختياري. |
| عدم تطابق المشارك أو نقطة النهاية | تحقق من ملكية المرسل/الشبكة وعنوان Peppol الخاص بالمشتري؛ لا تخلط بين رقم التعريف الضريبي (TIN) ورقم التسجيل الضريبي (TRN) |
| استجابة واجهة برمجة التطبيقات (API) 401 / 403 | تحقق من حالة المفتاح ونطاق العملية الحالية؛ لا تكشف عن السر |
| في قائمة الانتظار لفترة غير معتادة | افحص الخطوة الأخيرة وحالة النظام. إذا لم يحدث أي تقدم لأكثر من ساعة مع عدم وجود بلاغ عن حادث، تواصل مع Azdan؛ وتحقق من أي فشل صريح على الفور. |
| جاري الإرسال / في الحجر الصحي | تحقق مما إذا كانت المشكلة مستمرة؛ لا تقم بإعادة إرسال فاتورة قد تكون سُلّمت بالفعل تلقائياً |
| تم التسليم ولكن تم الرفض | افحص استجابة FTA مقابل MLS الخاص بالمستلم؛ إيصال النقل لا يعني القبول الكامل |
| تم رفض FTA / يحتاج إلى إجراء | صعّد مرحلة TDD؛ لا تقم بإعادة بناء TDD بنفسك |
| لم يتم تحديث نظام تخطيط موارد المؤسسات (ERP) | تحقق من حالة خطاف الويب (webhook) المتوقف، وحالة OAuth، وسجل المحاولات، وسجلات المستلم |
| انتهت صلاحية رابط التنزيل | اطلب رابطاً جديداً من خلال البوابة الإلكترونية |
| سجلات مفقودة أو إجماليات غير متطابقة | تحقق من عوامل التصفية، وصلاحيات الوصول للشركة، وتغطية حسابات الدائنين (AP) فقط قبل افتراض وجود فقدان في البيانات |
أرسل هذا الدليل إلى فريق الدعم
- الحساب والشركة المتأثرة، والبيئة/الشبكة، وتفاصيل الاتصال الخاصة بك.
- رقم الفاتورة بالإضافة إلى المعاملة، أو رسالة AS4، أو معرف تسليم إشعار Webhook (webhook).
- الخطأ الدقيق والطابع الزمني متضمناً المنطقة الزمنية.
- المرحلة التي فشلت، والنتيجة المتوقعة، وما إذا كانت المشكلة تتكرر.
- لقطة شاشة للحالة ذات الصلة غير السرية والخطوات التي تمت تجربتها بالفعل.
الأسئلة ومتطلبات الحقول
تم رفض فاتورتي قبل إرسالها. ماذا أفعل الآن؟
يسرد رفض التحقق قبل الإرسال الحقول أو القواعد التي تحتاج إلى تصحيح، مثل رقم تسجيل ضريبي (TRN) مفقود، أو فئة ضريبة قيمة مضافة غير صالحة، أو إجماليات غير متسقة. قم بتصحيح البيانات المصدرية وتحقق منها مرة أخرى. عندما يؤكد السجل صراحةً الرفض قبل الإرسال، فهذا يعني أنه لم يتم تسليم أي شيء. في حالة انتهاء المهلة أو نتيجة إرسال غير مؤكدة، ابحث عن المعاملة الموجودة قبل إعادة المحاولة.
مستند في حالة "جاري الإرسال" منذ فترة طويلة. هل فُقد؟
افتح المستند في "المعاملات" (Transactions) وافحص أحدث خطوة له والطابع الزمني. قد يستغرق تسليم Peppol وقتاً أطول عندما يكون المزود المستلم غير متاح؛ حيث تتم إعادة محاولة التسليم تلقائياً. تحقق من صفحة حالة النظام العامة المرتبطة من البوابة الخاصة بك. إذا لم يحدث أي تقدم لأكثر من ساعة ولم تكن هناك حادثة معلنة تفسر ذلك، تواصل مع Azdan مع ذكر رقم المستند. تحقق من أي رفض أو فشل صريح على الفور. لا تنشئ فاتورة ثانية بينما قد تكون الأولى قد تم تسليمها بالفعل.
هل المشكلة من جانبي أم لدى Azdan؟
تحقق من صفحة حالة النظام العامة المرتبطة من البوابة لمعرفة الحوادث التي تؤثر على البوابة، أو واجهات برمجة التطبيقات (APIs)، أو Peppol، أو SMP، أو التكامل مع الهيئة الاتحادية للضرائب (FTA). إذا لم تكن هناك حادثة مدرجة، استمر في فحص المستند وعنوان الشبكة والحساب. لا يعني ظهور حالة النظام باللون الأخضر عدم وجود مشكلة تؤثر على مستند واحد أو عميل بعينه.
كيف أتواصل مع دعم Azdan، وما الذي يجب أن أدرجه في رسالتي؟
راسل support@azdanapps.com من عنوان البريد الإلكتروني المرتبط بحسابك في Azdan. أدرج اسم شركتك، ورقم المستند أو عنوان Peppol المعني، وما قمت به، والنتيجة المتوقعة، وما حدث فعلياً، والتوقيت. في حال وجود مشكلة في الربط مع الهيئة الاتحادية للضرائب (FTA)، أضف رقم التعريف الضريبي (TIN). لا ترسل أبداً كلمات المرور أو رموز المصادقة أو مفاتيح واجهة برمجة التطبيقات (API keys): فشركة Azdan لا تطلبها مطلقاً.
مرجع سير عمل المنتج: مركز مساعدة Azdan، تمت المراجعة في 1 نوفمبر 2026. الأمثلة توضيحية.
أدلة ذات صلة
وثائق الفاتورة الإلكترونية من Azdan في الإمارات العربية المتحدة · سير عمل محايد لنظام تخطيط موارد المؤسسات (ERP). تأكد من تسميات النشر الحالية، والأذونات، وعقد واجهة برمجة التطبيقات (API) قبل إجراء أي تغييرات.