فاحص XML لفواتير زاتكا: افحص بنية ملف XML لفاتورتك
الصق مستند XML لفاتورة، أو اختر ملفاً، أو استخدم المثال. يعرض الفاحص الحقول التي يجدها، والعناصر الناقصة أو المكتوبة بصيغة خاطئة أو التي لا تتطابق مبالغها. وهو يفحص البنية، وليس التحقق الذي تجريه هيئة الزكاة والضريبة والجمارك.
فاحص XML لفواتير زاتكا
الصق مستند XML لفاتورة، أو اختر ملفاً. يجري الفحص داخل متصفحك، ولا يُرفع أي شيء إلى أي مكان.
هذا فحص لبنية الفاتورة، وليس التحقق الذي تجريه هيئة الزكاة والضريبة والجمارك. فهو يبحث عن العناصر التي تحملها عادةً فاتورة UBL المعدّة وفق متطلبات الهيئة، ويتأكد من أن القيم مكتوبة بالصيغة الصحيحة وأن الإجماليات متطابقة. ولا يفحص التوقيع الرقمي، ولا سلسلة البصمات الرقمية، ولا قواعد التحقق لدى الهيئة: استخدم لذلك حزمة أدوات التطوير التي توفرها الهيئة أو بوابة فاتورة.
المثال فاتورة ضريبية مبسطة غير موقّعة، وأرقامها افتراضية.
النتيجة
الصق فاتورة لترى النتيجة.
خلوّ النتيجة هنا من المشكلات لا يعني أن هيئة الزكاة والضريبة والجمارك ستقبل الفاتورة. فتحقق منها بحزمة أدوات التطوير التي توفرها الهيئة أو عبر بوابة فاتورة قبل أن تعتمد عليها.
كيف يعمل فاحص XML
الصق مستند XML لفاتورة، أو اختر ملفاً، أو استخدم المثال. يقرأ الفاحص المستند داخل متصفحك، ويعرض ما يجده مرتّباً في أقسام: بيانات الفاتورة، والبائع والمشتري، والضريبة، والإجماليات، وبنود الفاتورة، والتوقيع ورمز QR.
يبحث الفاحص عن العناصر التي تحملها عادةً فاتورة UBL المعدّة وفق متطلبات هيئة الزكاة والضريبة والجمارك، ويتأكد من أن قيماً مثل التاريخ والوقت والمعرّف الفريد (UUID) والرقم الضريبي مكتوبة بالصيغة الصحيحة، ثم يعيد حساب الإجماليات من البنود ليتأكد من تطابقها. وتذكر كل رسالة اسم العنصر، ورقم السطر في مستند XML حين يمكن ذلك.
ولا يفحص التوقيع الرقمي، ولا سلسلة البصمات الرقمية للفواتير، ولا قوائم الرموز، ولا قواعد التحقق لدى هيئة الزكاة والضريبة والجمارك. فهذه الفحوص تجريها حزمة أدوات التطوير التي توفرها الهيئة وبوابة فاتورة، ولذلك فخلوّ النتيجة هنا من المشكلات ليس إلا نظرة أولى.
من المفيد أن تعرف
- تعني «مشكلة» أن في البنية شيئاً ناقصاً أو خاطئاً. وتعني «راجع» أن البند يستحق النظر: فالفاتورة غير الموقّعة مثلاً أمر طبيعي وأنت تُعدّها، لكن لا يمكن اعتمادها أو الإبلاغ عنها لدى هيئة الزكاة والضريبة والجمارك.
- تتبع العناصر التي يتوقعها الفاحص صيغة UBL الشائعة في الفواتير المعدّة وفق متطلبات هيئة الزكاة والضريبة والجمارك. وقد لا تشمل كل قاعدة في معيار XML الحالي لدى الهيئة، فارجع إلى وثائق الهيئة، فهي المرجع النهائي.
- يُقرأ مستند XML داخل متصفحك، ولا يُرفع إلى أي مكان ولا يُخزَّن. ولأن الفواتير تحمل بيانات ضريبية وبيانات عملاء، فجرّب المثال أولاً إن أردت أن ترى كيف تعمل الأداة.
- يقرأ الفاحص الملفات التي لا يتجاوز حجمها 2 ميجابايت.
أسئلة عن فاحص XML
ما الذي يفحصه فاحص XML لفواتير زاتكا؟
يتأكد من أن مستند XML قابل للقراءة، وأنه فاتورة بصيغة UBL، وأن العناصر التي تحملها عادةً الفاتورة المعدّة وفق متطلبات هيئة الزكاة والضريبة والجمارك موجودة، وأن التواريخ والأوقات والمعرّفات الفريدة (UUID) والأرقام الضريبية مكتوبة بالصيغة الصحيحة، وأن الإجماليات متطابقة.
هل هذا هو التحقق الذي تجريه زاتكا؟
لا. تتحقق هيئة الزكاة والضريبة والجمارك من الفواتير وفق قواعدها الخاصة، ومنها التوقيع وسلسلة البصمات الرقمية، وتُجرى هذه الفحوص بحزمة أدوات التطوير التي توفرها الهيئة وعبر بوابة فاتورة. أما هذه الأداة فتنظر في البنية فقط.
لماذا يقول الفاحص إن فاتورتي بلا توقيع؟
التوقيع، وهو الختم التشفيري، يُضاف عند توقيع الفاتورة. والفاتورة التي ما زالت قيد الإعداد لا تحمله، ولذلك يظهر غيابه بعلامة «راجع» فقط. أما فاتورة المرحلة الثانية الموقّعة فتحمله.
هل تُرفع فاتورتي إلى أي مكان؟
لا. يُقرأ مستند XML داخل متصفحك، ولا يُرسَل أو يُخزَّن.
هل يعمل الفاحص مع إشعارات الدائن والمدين؟
نعم. يقرؤها على أنها فواتير رمز نوعها 381 أو 383، ويطلب فيها إشارة إلى الفاتورة الأصلية. وتأكد من القواعد الكاملة في وثائق هيئة الزكاة والضريبة والجمارك.
أصدر فواتير سليمة دون تخمين
جرّب فاتوراز مجاناً لمدة 90 يوماً في بيئة المحاكاة لدى الهيئة، دون بطاقة ائتمان.