مدقق فواتير المرحلة الثانية (ZATCA)

الصق أو ارفع ملف XML لفاتورة سعودية وتعرّف على ما قد ترفضه الهيئة: قواعد BR-KSA والرقم الضريبي والإجماليات ورمز QR وتجزئة الفاتورة، مع مسار الحقل وطريقة الإصلاح لكل خطأ.

الأداة

المرحلة الثانية · UBL 2.1

الصق المستند

رفع ملف أو أسقط ملفًا هنا

يعمل في متصفحك. لا يتم رفع الملف إلى أي مكان.

الأخطاء الشائعة وطريقة إصلاحها

عشرة أسباب للرفض مأخوذة مباشرة من قواعد معيار تطبيق XML للفاتورة الإلكترونية الإصدار 1.2، مع طريقة إصلاح كل منها.

القاعدة	ما المشكلة	طريقة الإصلاح
BR-KSA-40	الرقم الضريبي للبائع ليس 15 رقمًا يبدأ وينتهي بالرقم 3.	انسخ الرقم الضريبي كما هو من شهادة التسجيل دون مسافات.
BR-KSA-27	تم تعديل XML أو إعادة تنسيقه أو حفظه بعد التوقيع، فلم تعد التجزئة تطابق الملخص الموقع ورمز QR.	وقّع ملف XML النهائي وأرسله كما هو. لا تغيّر شيئًا بعد التوقيع.
BR-KSA-26 / 61	تجزئة الفاتورة السابقة (PIH) غير موجودة أو ليست تجزئة الفاتورة السابقة من نفس وحدة الفوترة.	احفظ تجزئة كل فاتورة ترسلها واستخدمها PIH للفاتورة التالية.
BR-KSA-33 / 34	عداد الفاتورة (ICV) غير موجود أو ليس رقمًا أو أُعيد ضبطه.	احتفظ بعداد متسلسل واحد لكل وحدة فوترة ولا تكرر أي قيمة.
BR-KSA-37 / 66	رقم مبنى البائع ليس 4 أرقام أو الرمز البريدي ليس 5 أرقام.	املأ حقول العنوان الوطني السعودي في بيانات الشركة.
BR-KSA-63	فاتورة قياسية لمشترٍ سعودي دون عنوانه الكامل (الشارع والمبنى والرمز البريدي والمدينة والحي).	أكمل العنوان الوطني للعميل قبل إصدار الفاتورة.
BR-KSA-06	قيمة InvoiceTypeCode/@name ليست رمز معاملة من 7 أرقام مثل 0100000 أو 0200000.	اربط كل نوع مستند بالرمز الصحيح وفعّل العلامات المطلوبة فقط.
BR-KSA-68	رمز عملة الضريبة غير موجود، أو لا يوجد TaxTotal يحمل الضريبة بالريال.	أرسل دائمًا TaxCurrencyCode بقيمة SAR و TaxTotal يحتوي فقط على مبلغ الضريبة بالريال.
BR-KSA-23 / 24 / 69	بنود صفرية أو معفاة أو خارج النطاق دون رمز سبب إعفاء VATEX-SA.	أضف TaxExemptionReasonCode و TaxExemptionReason لكل تفصيل من الفئات Z أو E أو O.
BR-KSA-51 / BR-CO-15	مبلغ البند شامل الضريبة أو إجماليات المستند غير متطابقة بعد التقريب.	قرّب ضريبة كل بند إلى منزلتين ثم اجمع البنود في الإجماليات.

المواصفات التي تفحص الأداة وفقها

معيار تطبيق XML للفاتورة الإلكترونية من هيئة الزكاة الإصدار 1.2 (قواعد BR-KSA و BR-DEC و BR-CO وتجزئة BR-KSA-27)
https://zatca.gov.sa/ar/E-Invoicing/SystemsDevelopers/Documents/20230519_ZATCA_Electronic_Invoice_XML_Implementation_Standard_%20vF.pdf
مخطط فاتورة UBL 2.1 من OASIS (UBL-Invoice-2.1.xsd)
https://docs.oasis-open.org/ubl/os-UBL-2.1/xsd/maindoc/UBL-Invoice-2.1.xsd
معيار W3C للتوحيد القانوني لـ XML الإصدار 1.1 (C14N 1.1) المستخدم في التجزئة
https://www.w3.org/TR/xml-c14n11/

تُحفظ نسخ من هذه الملفات مع شيفرة الأداة مع بصمات SHA-256. تفحص الأداة وفق المواصفات المنشورة من الهيئة، وهي ليست معتمدة من الهيئة وليست مدققًا رسميًا.

طريقة العمل

ثلاث خطوات بدون تسجيل

الصق أو ارفع XML

استخدم ملف XML الموقّع لفاتورة قياسية أو مبسطة أو إشعار دائن أو مدين، أو حمّل مثالًا.

اقرأ التقرير

تُعرض الأخطاء والتحذيرات والمعلومات في مجموعات، مع رقم القاعدة الرسمي (BR-KSA-…) ومسار XML وطريقة الإصلاح.

أصلح قبل الهيئة

صحّح الحقل في SAP Business One أو نظامك، وأعد إنشاء XML وافحصه مجددًا. نزّل تقرير PDF لفريقك.

الأسئلة الشائعة

أسئلة حول هذه الأداة

ماذا يفحص هذا المدقق؟

بنية UBL 2.1 وقواعد الأعمال السعودية في معيار تطبيق XML للفاتورة الإلكترونية الإصدار 1.2: نوع الفاتورة ورمز المعاملة (KSA-2) والمعرّف UUID وتاريخ ووقت الإصدار وعداد الفاتورة ICV وتجزئة الفاتورة السابقة PIH والرقم الضريبي للبائع والمشتري وحقول العنوان الوطني وتاريخ التوريد ورموز أسباب الإعفاء وضريبة البنود والتقريب وتفاصيل الضريبة والإجماليات ورمز QR وتجزئة الفاتورة BR-KSA-27.

كيف تُحسب تجزئة الفاتورة؟

كما في القاعدة BR-KSA-27: احذف ext:UBLExtensions ومرجع المستند الإضافي ذي المعرّف QR و cac:Signature، ثم وحّد الباقي بمعيار C14N 1.1، واحسب SHA-256 ورمّز النتيجة بـ Base64. تقارن الأداة النتيجة مع الملخص في التوقيع ومع الوسم 6 في رمز QR.

هل تتحقق الأداة من التوقيع التشفيري؟

لا. تتحقق من وجود الختم وسلامة بنيته (SignedInfo و SignatureValue والشهادة والخصائص الموقعة) ومن تطابق الملخص الموقع مع الفاتورة. لا تتحقق من توقيع ECDSA أو سلسلة الشهادات، لذا فإن النتيجة هنا ليست نتيجة اعتماد أو إبلاغ من الهيئة.

ما الفرق بين الفاتورة الضريبية القياسية والمبسطة؟

يبدأ رمز المعاملة في InvoiceTypeCode/@name بـ 01 للفاتورة القياسية (بين المنشآت) التي تعتمدها الهيئة فورًا، وبـ 02 للفاتورة المبسطة (للمستهلك) التي يجب أن تحمل الختم التشفيري ورمز QR وتُبلّغ خلال 24 ساعة.

هل هذه أداة رسمية من هيئة الزكاة؟

لا. Kodenova غير مرتبطة بهيئة الزكاة والضريبة والجمارك. تفحص الأداة وفق المواصفات المنشورة من الهيئة، والإجابة الرسمية تأتي دائمًا من منصة فاتورة.

هل يتم رفع فاتورتي إلى أي مكان؟

لا. يقرأ متصفحك ملف XML ويفحصه، ويُنشأ تقرير PDF فيه أيضًا. لا يُرسل أي شيء إلى Kodenova أو إلى أي جهة أخرى.

أدوات مجانية أخرى

مصممة لفرق SAP Business One

SAP B1 dashboard builderDrag and drop sales dashboards with click-to-filter, like Power BI but simpler. Works offline, no developer needed.SQL to HANA query converterPaste a SQL Server query and get the SAP HANA version, with every change explained.SAP B1 query libraryReady-made reports for sales, finance, stock and approvals, in SQL and HANA.SAP B1 table finderSearch any table: what it stores, its line tables and its key fields.

المرحلة الثانية من SAP Business One؟

نربط SAP B1 بهيئة الزكاة: XML وسلسلة التجزئة والتوقيع ورمز QR والاعتماد والإبلاغ، مع السجلات وإعادة المحاولة. سعر ثابت، عادةً خلال 24 ساعة.

ابدأ مشروعك تواصل عبر واتساب