ما الذي يذكره مطابق
مدخل لكل حالة تُذكر فيها هذه القاعدة في التقرير.
- صورة القيمة في التقرير
- صورة القيمة التي وُجدت — empty وnot_15_digits وما شابههما — لا القيمة نفسها.
أحد ملفات أرشيف ZIP هو نفسه أرشيف ZIP
صورة القيمة في التقريرentry.nested_zipأرشيف ZIP داخل أرشيف ZIP
ما الخلل
أحد الملفات داخل الأرشيف المرفوع هو أرشيف ZIP آخر لا فاتورة. ولا يفتح مطابق أرشيفاً داخل أرشيف، لذلك لم يُقرأ هذا الملف ولم يُنفَّذ عليه أي فحص. وهذه ملاحظة على ذلك الملف داخل الأرشيف، لا على أي فاتورة بداخله؛ فلم يُفحص منه شيء.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
اجعل ما ترفعه أرشيف ZIP واحداً مسطَّحاً يضم ملفات XML نفسها، دون أرشيف داخلي ودون بنية مجلدات تحمل واحداً. والسبب الشائع تصدير يضغط أرشيفاً لكل يوم أو لكل فرع ثم يضغط هذه الأرشيفات معاً للإرسال؛ أخرج ملفات XML من الأرشيفات الداخلية وضعها في أرشيف ZIP واحد.
أحد ملفات أرشيف ZIP يحمل مساراً غير آمن
صورة القيمة في التقريرentry.unsafe_pathمسار ملف غير آمن
ما الخلل
أحد الملفات داخل الأرشيف المرفوع يحمل اسماً هو مسار مطلق، أو مسار يخرج من الأرشيف عبر ".."، أو ليس اسماً بسيطاً داخل الأرشيف على أي نحو آخر. ويرفض مطابق مثل هذا الملف دون قراءته، لأن اسماً بهذه الصورة هو الطريقة التي يحاول بها أرشيف الكتابة خارج الموضع الذي يُفك فيه. فلم يُقرأ الملف ولم يُنفَّذ عليه أي فحص.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
راجع كيفية تكوين الأرشيف. ينبغي أن تُسمّى الملفات بأسماء الفواتير، أي اسم ملف عادي داخل مجلد بسيط عند الحاجة، لا أكثر. ووجود شرطة مائلة في البداية أو حرف محرك أقراص يعني غالباً أن الأرشيف بُني من قائمة مسارات كاملة على القرص لا من أسماء اختيرت للأرشيف؛ ووجود ".." يعني غالباً أنه بُني بالصعود من مجلد فرعي.
حجم أحد ملفات أرشيف ZIP أكبر من أن يُفحص
صورة القيمة في التقريرentry.entry_too_largeأكبر من أن يُفحص
ما الخلل
يعلن أحد الملفات داخل الأرشيف المرفوع حجماً يتجاوز الحد الأعلى الذي يقبله مطابق للملف الواحد وهو 5 ميغابايت، لذلك لم يُستخرج ولم يُنفَّذ عليه أي فحص. وهذا حدٌّ من حدود أداة الفحص مطبَّق على ذلك الملف، لا ملاحظة على الفاتورة التي بداخله.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
الحد يُطبَّق على كل ملف على حدة، فالأرشيف ككل ليس هو المشكلة. وفاتورة UBL وحدها لا تتجاوز عادة بضع مئات من الكيلوبايتات؛ والملف الذي يتجاوز ذلك بكثير يضم غالباً عدة فواتير في ملف واحد، أو مرفقاً أو شعاراً أو نسخة PDF مضمَّنة داخل XML. صدِّر فاتورة واحدة في كل ملف مع إيقاف تضمين المرفقات.
حجم أحد ملفات أرشيف ZIP أكبر مما يعلنه الأرشيف
صورة القيمة في التقريرentry.declared_size_exceededأكبر مما يعلنه الأرشيف
ما الخلل
يتمدّد أحد الملفات داخل الأرشيف المرفوع إلى عدد من البايتات أكبر مما يعلنه فهرس الأرشيف نفسه له. ويتوقف مطابق عند الحجم المعلن ولا يتابع البيانات، لأن ملفاً يتمدّد بما يتجاوز ما أعلنه هو الطريقة التي يحاول بها أرشيف استنفاد ذاكرة ما يفتحه. فتوقّف الاستخراج ولم يُنفَّذ على ذلك الملف أي فحص.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
الأرشيف متناقض داخلياً، وهذا خلل في الأداة التي كتبت الأرشيف لا في الفاتورة التي بداخله. أعد بناء ملف ZIP بأداة الأرشفة التي يستخدمها نظامك عادة أو بأداة نظام التشغيل نفسه، ثم ارفعه مرة أخرى. وإذا ظلت الأداة نفسها تنتج هذه الحالة فالأرجح أن الملف عُدِّل أو بُتر بعد كتابته، كأن يكون قد نُقل عبر قناة غيّرته أو أعادت بوابة بريد تغليفه.
تعذّر فك ضغط أحد ملفات أرشيف ZIP
صورة القيمة في التقريرentry.inflate_failedتعذّر فك الضغط
ما الخلل
تعذّر فك ضغط البيانات المضغوطة لأحد الملفات داخل الأرشيف المرفوع. فالبايتات ليست تدفّقاً يستطيع فاكّ الضغط قراءته إلى نهايته، لذلك لم يُستخرج الملف ولم يُنفَّذ عليه أي فحص. ولا يُعرف شيء عن الفاتورة التي بداخله.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
هذا تلف في الأرشيف لا في شيء داخل الفاتورة. أعد بناء ملف ZIP من ملفات XML المصدَّرة وارفعه مرة أخرى. وإذا أخفق الأرشيف المُعاد بناؤه بالطريقة نفسها فراجع الخطوة التي تنقل الملف: فالرفع الذي انقطع في منتصفه، أو النقل الذي عامل الأرشيف نصاً، أو برنامج الحماية الذي أعاد كتابته أثناء مروره، كلٌّ منها يترك تدفّقاً ينتهي حيث لا ينبغي.
أحد ملفات أرشيف ZIP مضغوط بطريقة لا يقرؤها مطابق
صورة القيمة في التقريرentry.unsupported_compressionطريقة ضغط لا يقرؤها مطابق
ما الخلل
أحد الملفات داخل الأرشيف المرفوع مضغوط بطريقة غير الطريقتين اللتين يقرؤهما مطابق، وهما التخزين دون ضغط وطريقة deflate التي يستخدمها أرشيف ZIP المعتاد. فلم يُستخرج الملف ولم يُنفَّذ عليه أي فحص.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
أعد بناء الأرشيف بالإعدادات الافتراضية لأداة الأرشفة لديك، فهي تنتج طريقة deflate. وتظهر طرائق مثل bzip2 أو LZMA أو XZ أو zstd حين تُضبط الأداة على أقصى ضغط، أو حين يكتب الأرشيف برنامج نسخ احتياطي عام لا أداة ZIP بسيطة. والوفر لا يتعدى بضعة كيلوبايتات على ملف بهذا الحجم، وثمنه أن يتعذّر فحص الملف.
أحد ملفات أرشيف ZIP ناقص
صورة القيمة في التقريرentry.truncated_entryالملف ناقص
ما الخلل
يذكر فهرس الأرشيف ملفاً، لكن البيانات التي يشير إليها ذلك الملف ليست موجودة: إمّا أنها تبدأ بعد نهاية الملف، أو تنتهي بعد نهايته، أو لا تبدأ بالترويسة التي يجب أن يبدأ بها. فلم يُقرأ الملف ولم يُنفَّذ عليه أي فحص.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
الأرشيف مبتور أو فهرسه يخالف محتواه، وهذا خلل في الملف لا في الفاتورة التي بداخله. أعد بناء ملف ZIP وارفعه مرة أخرى. وتكرار هذه الحالة على ملف بعينه يعني غالباً أن الأرشيف كُوِّن بينما كان أحد ملفاته لا يزال قيد الكتابة، فتحقّق من انتهاء التصدير قبل بدء خطوة الأرشفة.
أحد ملفات أرشيف ZIP ليس نصاً بترميز UTF-8
صورة القيمة في التقريرentry.not_utf8ليس نصاً بترميز UTF-8
ما الخلل
يحمل أحد الملفات داخل الأرشيف المرفوع بايتات ليست UTF-8 صحيحاً. ويفكّ مطابق ترميز كل ملف مرفوع على أنه UTF-8 حصراً ولا يخمّن أي ترميز آخر، لذلك تعذّر تحويل الملف إلى نص ولم يُنفَّذ عليه أي فحص.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
الفواتير الإلكترونية المعدّة وفق متطلبات هيئة الزكاة والضريبة والجمارك تُكتب بترميز UTF-8، والنص العربي هو موضع ظهور هذه المشكلة: فاسم بائع أو عميل مكتوب بترميز Windows-1256 أو ISO-8859-6 هو بايتات لا يقرؤها UTF-8. راجع ترميز المحارف الذي تكتب به خطوة التصدير، وينبغي أن يكون UTF-8، لا البيانات نفسها فهي سليمة عادة. والملف الذي يُفتح سليماً في محرِّر ويظهر نصه العربي تالفاً في آخر هو العَرَض نفسه.
أحد ملفات أرشيف ZIP يعلن ترميزاً غير UTF-8
صورة القيمة في التقريرentry.declared_encoding_not_utf8يعلن ترميزاً غير UTF-8
ما الخلل
يحمل أحد الملفات داخل الأرشيف المرفوع إعلان XML يسمّي ترميز محارف غير UTF-8. ولا يقبل مطابق سوى UTF-8 ولا يقدّم ترميزاً معلناً على البايتات نفسها، لذلك رُفض الملف دون قراءته ولم يُنفَّذ عليه أي فحص. وقد تكون البايتات نفسها UTF-8 فعلاً؛ فالمرفوض هو الإعلان.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
انظر إلى السطر الأول من ملف XML المصدَّر: ينبغي أن تحمل السمة encoding القيمة UTF-8، أو ألّا يحمل السطر سمة ترميز إطلاقاً وهو ما يعني UTF-8. وإعلان windows-1256 أو ISO-8859-6 أو UTF-16 يأتي غالباً من قالب أو أداة كتابة XML ضُبطت مرة ولم تُراجع بعدها، بينما البيانات المكتوبة UTF-8 أصلاً. صحّح الإعلان في قالب التصدير داخل وحدة الفوترة الإلكترونية لا في الملف المصدَّر.
حجم أحد ملفات PDF في أرشيف ZIP أكبر من أن يُفحص
صورة القيمة في التقريرentry.pdf_too_largeملف PDF أكبر من أن يُفحص
ما الخلل
أحد الملفات داخل الأرشيف المرفوع ملف PDF يعلن حجماً يتجاوز الحد الأعلى الذي يقبله مطابق لملف PDF وهو 10 ميغابايت، لذلك لم يُستخرج ولم يُنفَّذ عليه أي فحص، ولم يُحتسب ضمن فحوصك. وهذا حدٌّ من حدود أداة الفحص مطبَّق على ذلك الملف، لا ملاحظة على الفاتورة التي بداخله.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
لا يبلغ ملف PDF/A-3 للفاتورة عادة ميغابايتاً واحداً؛ والملف الذي يتجاوز 10 ميغابايت يضم غالباً صفحات ممسوحة ضوئياً أو صوراً كبيرة. ضع في أرشيف ZIP ملف الفاتورة بامتداد .xml بدلاً منه، أو صدِّر ملف PDF مرة أخرى مع ضغط صوره.
تعذّرت قراءة أحد ملفات PDF في أرشيف ZIP
صورة القيمة في التقريرentry.pdf_malformedتعذّرت قراءة ملف PDF
ما الخلل
يبدأ أحد الملفات داخل الأرشيف المرفوع كما يبدأ ملف PDF، لكن بنيته ليست كما تعلن: فجدول الإحالات يشير إلى مواضع خاطئة، أو أحد الكائنات مبتور، أو تجاوزت البنية أحد حدود القراءة. ولا يُصلح مطابق ملف PDF تالفاً، لذلك لم يُعثر فيه على فاتورة مضمَّنة ولم يُنفَّذ عليه أي فحص، ولم يُحتسب ضمن فحوصك.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
إن كنت أصدرت الفاتورة فصدِّر ملف PDF من نظامك مرة أخرى ثم أعد بناء أرشيف ZIP، وإن كانت قد وصلتك من مورّد فاطلب منه نسخة جديدة أو ملف الفاتورة بامتداد .xml، وهو الملف الذي تتسلّمه هيئة الزكاة والضريبة والجمارك نفسها. والملف الذي يبدأ فقط كما يبدأ ملف PDF، كملف نصي أُعيدت تسميته أو تنزيل انقطع قبل اكتماله، يُرفض بالطريقة نفسها.
أحد ملفات PDF في أرشيف ZIP محمي بكلمة مرور
صورة القيمة في التقريرentry.pdf_encryptedملف PDF محمي بكلمة مرور
ما الخلل
أحد الملفات داخل الأرشيف المرفوع ملف PDF محمي بكلمة مرور أو بتشفير المستند، فلا يمكن قراءة شيء منه. لذلك لم يُعثر فيه على فاتورة مضمَّنة ولم يُنفَّذ عليه أي فحص، ولم يُحتسب ضمن فحوصك.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
إن كنت أصدرته فصدِّره دون كلمة مرور ودون حماية للمستند ثم أعد بناء أرشيف ZIP، وإن كان قد وصلك من مورّد فاطلب منه نسخة دون حماية أو ملف الفاتورة بامتداد .xml. والحماية التي تقيّد الطباعة أو النسخ وحدهما تشفّر الملف هي أيضاً، فيُرفض كذلك.
أحد ملفات PDF في أرشيف ZIP يحفظ محتواه بصورة لا يقرؤها مطابق
صورة القيمة في التقريرentry.pdf_unsupported_filterمحتوى ملف PDF محفوظ بصورة لا يقرؤها مطابق
ما الخلل
أحد الملفات داخل الأرشيف المرفوع ملف PDF يضغط الأجزاء التي يجب أن يقرأها مطابق بطريقة غير ضغط Flate المعتاد أو ترك الضغط، وهما الطريقتان الوحيدتان اللتان يقرؤهما مطابق. لذلك لم يُعثر فيه على فاتورة مضمَّنة ولم يُنفَّذ عليه أي فحص، ولم يُحتسب ضمن فحوصك.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
تستخدم أدوات كتابة PDF/A-3 ضغط Flate افتراضياً، وظهور طريقة أخرى يعني غالباً أن الملف عولج بأداة تحسين أو ببرنامج تشغيل طابعة بعد إنتاجه. ضع في أرشيف ZIP ملف الفاتورة بامتداد .xml بدلاً منه، أو صدِّر ملف PDF مرة أخرى مباشرة من وحدة الفوترة الإلكترونية.
أحد ملفات PDF في أرشيف ZIP لا يتضمن فاتورة بصيغة XML
صورة القيمة في التقريرentry.pdf_no_embedded_xmlملف PDF لا يتضمن فاتورة بصيغة XML
ما الخلل
أحد الملفات داخل الأرشيف المرفوع ملف PDF لا تُرفق به فاتورة بصيغة XML: فإمّا أنه لا يتضمن أي مرفق، وإمّا أن ملفات XML التي يحملها ليست فاتورة UBL. وملف PDF/A-3 للفاتورة يحمل ملف XML مرفقاً به، وهذا الملف لا يحمله، فلم يكن فيه ما يُفحص، ولم يُحتسب ضمن فحوصك. ويجوز نظاماً أن تصل الفاتورة المبسطة إلى المشتري نسخةً مطبوعة أو ملف PDF، وعليها رمز الاستجابة السريعة دون ملف XML؛ أما الفاتورة الضريبية فهي وحدها التي تُشارك مع ملف XML مضمَّناً فيها.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
ملف PDF المصدَّر نسخةً قابلة للطباعة من الفاتورة ليس هو الفاتورة الإلكترونية، فهيئة الزكاة والضريبة والجمارك تتسلّم ملف XML. ضع في أرشيف ZIP ملف الفاتورة بامتداد .xml، أو صدِّر ملف PDF/A-3 يتضمنه إن كان نظامك يتيح ذلك. وإن كان ملف PDF موجوداً بجانب ملف XML نسخةً للقراءة فحسب، فيمكن إخراجه مما ترفعه. وتبيّن أدلة مطابق لأنظمة المحاسبة، لكل نظام، ما تقوله وثائق مزوِّده نفسه عن مكان تنزيل ملف XML.
أحد ملفات PDF في أرشيف ZIP يضم أكثر من فاتورة محتملة
صورة القيمة في التقريرentry.pdf_multiple_embedded_xmlملف PDF يضم أكثر من فاتورة محتملة
ما الخلل
أحد الملفات داخل الأرشيف المرفوع ملف PDF يحمل عدة مرفقات بصيغة XML، ولا يتضح أيها الفاتورة: فأكثر من مرفق منها فاتورة UBL، أو أن أحدها تتعذّر قراءته فلا يُعرف أهو الفاتورة أم لا. ولا يخمّن مطابق، لذلك لم يُنفَّذ على الملف أي فحص، ولم يُحتسب ضمن فحوصك.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
ضع في أرشيف ZIP ملف الفاتورة بامتداد .xml بدلاً من ملف PDF. وإرفاق إشعار تسليم أو طلب شراء بجانب الفاتورة لا يسبّب هذا الرفض وحده؛ فالمرفوض بهذه الطريقة هو ملف PDF يحمل فاتورتين، أو مرفقاً ليس ملف XML مقروءاً بترميز UTF-8.
حجم ملف XML داخل أحد ملفات PDF في أرشيف ZIP أكبر من أن يُفحص
صورة القيمة في التقريرentry.pdf_embedded_too_largeملف XML المضمَّن أكبر من أن يُفحص
ما الخلل
أحد الملفات داخل الأرشيف المرفوع ملف PDF يتضمن ملف XML يتجاوز حجمه 5 ميغابايت، وهو الحد الأعلى الذي يقبله مطابق للمستند الواحد، أو تتجاوز مرفقات XML فيه مجتمعةً ضعف ذلك. فلم يُستخرج ملف XML ولم يُنفَّذ عليه أي فحص، ولم يُحتسب ضمن فحوصك.
ما الذي تتحقق منه في وحدة الفوترة الإلكترونية
فاتورة UBL وحدها لا تتجاوز عادة بضع مئات من الكيلوبايتات؛ والملف الذي يتجاوز ذلك بكثير يضم غالباً عدة فواتير، أو مرفقاً مضمَّناً داخل XML نفسه. صدِّر فاتورة واحدة في كل مستند مع إيقاف تضمين المرفقات.