قائمة قبول الفواتير الإلكترونية ثنائية اللغة لمشاريع أودو 19 السعودية
أنشئ حزمة دليل واحدة لكل سيناريو قبول
أنشئ سجل قبول بمعرف ثابت للسيناريو والكيان القانوني ودفتر المبيعات والبيئة ونوع المستند والمعاملة المصدر والمختبر والمراجع التجاري ووقت التنفيذ. أرفق أو اربط البيانات المصدر والمخرج المقروء وXML ومراجع طلب API واستجابته والحالة النهائية ومخرج المشاركة وقرار العيب. احجب بيانات الاعتماد والبيانات الشخصية غير اللازمة مع إبقاء القيم المطلوبة للمراجعة.
سجل النتائج المتوقعة قبل التنفيذ. يجب أن يستطيع المراجع التمييز بين شرط مسبق مفقود ومدخل اختبار غير صالح وعيب تهيئة وعيب عرض واستجابة مزود وسؤال نظامي لم يُحسم. لقطة شاشة ناجحة دون معاملتها المصدر واستجابتها ليست حزمة دليل مكتملة.
استخدم القائمة باللغتين مع معرفات السيناريو نفسها. يمكن للمراجعين العرب والإنجليز عندئذ مناقشة المستند والقرار نفسيهما دون إنشاء سجلات متوازية ومتعارضة.
غطِّ مصفوفة المستندات والأخطاء كاملة
أدرج كحد أدنى كل سيناريوهات الفواتير القياسية والمبسطة المستخدمة في المنشأة والإشعارات الدائنة والمدينة المرتبطة بها. افصل الفواتير المباشرة عن مستندات نقاط البيع وميز أطراف الأعمال والحكومة والمستهلكين عندما يؤثر ذلك في السيناريو.
أضف التعديلات الجزئية والكاملة والتوريدات الصفرية والمعفاة عند استخدامها ومعاملات العملات الأجنبية والبنود والمعالجات الضريبية المتعددة والخصومات والأوصاف العربية الطويلة وعينات تجاوز الصفحات والإرسالات المصححة أو المرفوضة. وأدرج الحالات الحدية من العمليات الفعلية بدلاً من اختيار أبسط فاتورة صالحة فقط.
اذكر في كل صف ما إذا كانت المقاصة أو الإبلاغ متوقعاً وبيئة فاتورة ودفتر أودو المعنيين والحالة النهائية المطلوبة ومن يقبل المخرج العربي والقيم المالية. إذا لم ينطبق سيناريو، سجل السبب التجاري والمراجع بدلاً من ترك فراغ غير مفسر.
أكد البيانات الرئيسية والتهيئة قبل الحكم على المخرجات
رُوجع في 5 نوفمبر 2026. يتطلب التوطين السعودي في أودو 19 بيانات دقيقة للشركة وجهات الاتصال للتهيئة. تحقق من معرفات البائع والمشتري والعناوين وأرقام ضريبة القيمة المضافة وعملة الريال السعودي وحقول السيناريو قبل اعتبار نتيجة API ذات دلالة.
أكد الكيان القانوني ودفتر المبيعات وإصدار أودو ونسخته التجارية والوحدات المثبتة وربط الضريبة وأسلوب التسلسل ومعالجة تاريخ الفاتورة ووقتها ومنطق مرجع الفاتورة الأصلية والبيئة. وسجل من قدم المعالجة الضريبية المتوقعة. تنطبق النسبة القياسية البالغة 15% فقط حيثما تكون واجبة نظاماً، ولا تُسند تلقائياً إلى كل توريد. والخيارات الصفرية والمعفاة سيناريوهات مراجعة منفصلة.
يحتاج كل دفتر متجه إلى الإنتاج إلى دليل تهيئة مستقل. ويوضح سجل البيئة ما إذا كانت Sandbox أو Simulation أو Production دون لبس في حزمة الدليل. فواتير Simulation ليست صالحة نظامياً، ولا تُعاد تسمية نتيجة غير إنتاجية بوصفها نتيجة إنتاج.
افحص المستند العربي المقروء بصرياً
يجب أن تكون الفواتير المقروءة والإشعارات المرتبطة بها بالعربية، مع جواز إضافة لغات. راجع المخرج الفعلي على الشاشة وكملف المشاركة المقصود، لا قيم الحقول في أودو فقط. واستخدم الخطوط ومسار العرض اللذين سيستخدمهما مستخدمو الإنتاج.
افحص تشكيل الحروف العربية واتصالها والمحاذاة من اليمين إلى اليسار وتضمين الخط أو توافره والرؤوس والتذييلات وموضع الشعار وفواصل الصفحات وتكرار عناوين الجداول والتفاف الأسطر والإجماليات. يجب أن تبقى أسماء الأطراف والعناوين وأوصاف المنتجات وأسباب التعديل الطويلة مقروءة دون قص أو تداخل.
تحقق من أسماء البائع والمشتري والمعرفات والعناوين وتواريخ الفاتورة والتوريد ورقم المستند وكميات البنود وأسعار الوحدات والخصومات والمبالغ الخاضعة ومبالغ الضريبة والإجماليات وأسباب الإشعارات. ولا ينبغي للرموز مختلطة الاتجاه مثل ZATCA وCSID وXML وUBL ورموز المنتجات أن تعيد ترتيب الأرقام أو علامات الترقيم المجاورة. وعند تضمين الإنجليزية كلغة إضافية، قارن معناها بالعربية بدلاً من افتراض التطابق.
قارن XML المنظم بالمعاملة والفاتورة المرئية
إرسال API في المرحلة الثانية يكون بصيغة XML. يقارن المراجعون الحمولة المنظمة بمعاملة أودو المعتمدة والمخرج المقروء. ويعد مركز مواصفات زاتكا والدليل التفصيلي المرجعين الأساسيين للقواعد التقنية الحالية.
تتبع معرفات المستند وتواريخ الإصدار والتوريد وأطراف البائع والمشتري والمعرفات الضريبية والعملة وقيم البنود والبدلات أو الرسوم وفئات الضريبة والإجماليات. وتحقق من ظهور مراجع الفاتورة الأصلية والأسباب في حمولات الإشعارات الدائنة والمدينة. يمكن أن تكون عناصر XML التقنية بالإنجليزية بينما تبقى معلومات العميل المقروءة بالعربية.
استخدم التحقق البنيوي أو التقني عند توفره، ثم أجرِ مقارنة تجارية أيضاً. فالحمولة الصحيحة بنيوياً قد تحتوي على طرف أو مبلغ خاطئ. وسجل إصدار أداة التحقق ومخرجاتها عند استخدامها، واربط أي اختلاف بحقل المصدر أو الربط أو التهيئة المسؤولة.
افصل أدلة XML وPDF/A-3 وQR وختم التشفير
يمكن لأودو 19 إنشاء PDF/A-3 مع UBL 2.1 مدمجاً من خلال Send. يمكن أن يدعم هذا المخرج مسار المشاركة، لكنه ليس حمولة مقاصة المرحلة الثانية. احفظ إرسال XML وملف مشاركة PDF/A-3 كمخرجين منفصلين تحت معرف السيناريو نفسه.
يُفحص سلوك رمز QR وختم التشفير وفق المرحلة ونوع المستند المنطبقين. لا تطبق افتراضاً مرئياً من عينة مبسطة على مستند قياسي، ولا تعتبر وجود الرمز دليلاً على اكتمال مسار التكامل كله. يذكر صف القبول العلامة أو السلوك المتوقع والمرجع الرسمي المستخدم والملاحظة الفعلية.
إذا اختير ملف PDF/A-3 لتسليم العميل، افتحه بالعارض المقصود وافحص العرض العربي وبنية الصفحات ووجود الملف المدمج باستخدام الفحص التقني المتفق عليه. وتأكد من أن أي تصحيح لاحق ينشئ نسخة جديدة منضبطة بدلاً من استبدال غامض داخل حزمة الدليل.
نفذ سيناريوهات مقاصة الفواتير القياسية
في المسار المعتاد للمرحلة الثانية، تخضع الفواتير الضريبية القياسية، وهي عادة B2B أو B2G، للمقاصة. يضبط نوع المستند والسيناريو الاستثناءات، لذلك لا تعامل المصفوفة B2B كمرادف مطلق. استخدم مراجع زاتكا المنطبقة والمراجعة المؤهلة لتحديد المسار المتوقع.
احفظ الفاتورة المصدر قبل الإرسال ونتائج التحقق ومرجع الإرسال والاستجابة وحالة المقاصة النهائية والفاتورة العربية المقروءة ومخرج المشاركة المختار. وقارن القيم المالية عبر التمثيلات الثلاثة. إذا أظهر التكامل تحذيرات أو معلومات حالة إضافية، احتفظ بها مع تفسير المراجع.
كرر ذلك لكل كيان ودفتر وسيناريو مختلف جوهرياً. اختبر تصحيحاً بعد الرفض وتعديلاً بعد قبول المستند الأصلي ومسار استجابة غير متاحة أو غير معروفة حيثما يكون آمناً. ويوقع المراجع النتيجة المرصودة الفعلية لا التصميم المقصود وحده.
نفذ سيناريوهات الإبلاغ عن الفواتير المبسطة
تُبلَّغ الفواتير الضريبية المبسطة، وهي عادة B2C، خلال 24 ساعة في المسار المعتاد للمرحلة الثانية. سجل وقت الإصدار وعملية الإبلاغ والاستجابة ودليل الحالة النهائية للسيناريو المنطبق. وأدرج مصدر نقطة البيع أو البيع المباشر عند الحاجة.
تحقق من المخرج العربي للمستند المبسط وبيانات الطرف والمعاملة المطلوبة وسلوك QR أو ختم التشفير وقيم البنود والضريبة وتسليم العميل. وعندما يكون العمل دون اتصال أو التشغيل المؤجل جزءاً من التصميم، اختبر قائمة الانتظار والتعافي والمراقبة وفق المتطلبات الحالية، دون افتراض أن مستنداً لم يُبلَّغ عنه قد أكمل مساره.
اختبر الإشعارات الدائنة والمدينة المبسطة على حدة بما فيها مرجع الفاتورة الأصلية والسبب والقيم الجزئية وحالة الإبلاغ النهائية. تعرض حزمة الدليل تعديل العميل المرئي ونتيجة التكامل معاً، لا مجرد إجمالي متغير في أودو.
اختبر الإشعارات الدائنة والمدينة كمستندات مرتبطة
يدعم أودو 19 إشعارات دائنة ومدينة مع سبب متوافق مع متطلبات زاتكا ومرجع للفاتورة الأصلية. ابدأ كل اختبار من سيناريو أصلي محدد وسجل معرف مستنده وبيئته وحالته النهائية. وتجنب اختبار تعديل مرتبط بفاتورة مصدر غامضة أو غير ذات صلة.
افحص السبب في المخرج العربي والبيانات المنظمة ومرجع الفاتورة الأصلية والتواريخ والكميات أو المبالغ والضريبة والإجماليات والعملة. وأدرج التعديلات الكاملة والجزئية وحالات البنود المتعددة. وعندما يسمح إجراء العمل بتسلسل تعديلات، تحقق من النتيجة التراكمية وقدرة المستخدم على تتبع كل خطوة.
اختبر أيضاً صلاحيات المستخدمين والمراجعة المحاسبية. قد لا يكون من ينشئ تعديلاً تشغيلياً هو المخول باعتماد إرساله المالي أو النظامي. وتسمي القائمة كلا الإجراءين وتحتفظ بالحالة النهائية للمستندين الأصلي والمعدل.
أثبت معالجة الرفض والمهلة ومنع التكرار
أدرج بيانات أطراف غير صالحة أو ناقصة ومحتوى منظماً مرفوضاً وخدمة غير متاحة ومهلة وحالة غير معروفة وإجراء مستخدم مكرر حيثما يمكن اختبارها بأمان. الهدف هو اختبار الضبط التشغيلي، لا توليد طلبات إنتاج غير منضبطة.
لكل فشل، احفظ الاستجابة والرسالة الظاهرة للمستخدم وحالة المستند ومرجع السجل وما إذا كانت إعادة المحاولة مسموحة. حدد من يحقق ومن يصحح البيانات الرئيسية أو التهيئة ومن يخول إعادة الإرسال وكيف تثبت المالية الحالة النهائية المعتمدة.
بعد التصحيح، اربط المحاولة الجديدة بالسيناريو الأصلي وقارن المعرفات لإثبات عدم إنشاء مستندات أو إرسالات مكررة دون قصد. احجب الأسرار من السجلات واللقطات، لكن احتفظ بسياق تقني كافٍ لتمكين دعم زاتكا أو أودو أو المزود من التحقيق عند الحاجة.
تحقق من المشاركة والاحتفاظ وتوقيع المراجعين
اختبر مسار التسليم المقصود للعميل أو المراجع الداخلي. تأكد من قدرة المتلقي على فتح الصيغة المقروءة المختارة وقراءة المحتوى العربي وربطه بالفاتورة أو الإشعار الصحيح. وعند مشاركة XML وPDF/A-3 معاً، تحقق من تمثيلهما لنسخة المستند نفسها.
يذكر فهرس الدليل موقع التخزين المنضبط ومالك الاحتفاظ ومجموعة الوصول والرابط إلى المعاملة المصدر. وتُفصل أدلة الإنتاج عن مخرجات التدريب وSimulation حتى لا تُخلط الفواتير الاختبارية غير النظامية بالمستندات الحية.
يشمل التوقيع المختبر التقني ومراجع المالية والمراجع العربي للأعمال ومالك العملية. ويسجل كل منهم النطاق المقبول والاستثناءات والمتابعة المطلوبة. ويراجع مسؤول الإصدار العيوب عالية الأثر العالقة قبل اعتماد الإنتاج؛ ولا يُنسخ قبول سيناريو إلى دفتر أو كيان آخر دون دليل.
انقل القبول إلى الرعاية المكثفة وإدارة التغيير
أثناء الرعاية المكثفة، عاين سيناريوهات تشغيلية حقيقية باستخدام القائمة نفسها. راقب الحالات المرفوضة أو غير المعروفة وتصحيحات البيانات الرئيسية المتكررة وشكاوى العرض العربي ومراجع التعديلات والفروق بين XML والمخرج المرئي للعميل. واربط قضايا الدعم بمعرفات السيناريو الحالية لإظهار الاتجاهات.
تستدعي تغييرات قوالب الفواتير والخطوط ووحدات التوطين والضرائب والدفاتر وبيانات الاعتماد وإصدار أودو أو تهيئة المزود تقييم أثر وإعادة تشغيل مستهدفة. ولا يغلق عرض منتج لاحق سيناريو في خط أودو 19 المعتمد.
تعد جلستا OXP2026 العامتان عن تهيئة الفوترة الإلكترونية وقبولها والأدلة وحدود الإصدارات مادتين تعليميتين للتنفيذ فقط، وليستا قواعد تقنية سعودية أو مراجع لأوكلاند أو تأييداً من عملاء. تظل مصادر زاتكا الرسمية والتوطين السعودي في أودو 19 أساس المنتج والتنظيم؛ أما حزمة أدلتك فهي التي تحدد قرار الإصدار.