منهجية التوافق التقني: كيف تتحول بيانات فاتورتك إلى فاتورة متوافقة
الجواب المختصر
عند اعتماد أي فاتورة، يتحقق فاتورة Fattourh من الحقول الإلزامية، يحسب ضريبة 15% على مستوى البند، يرمّز وسوم TLV الخمسة على مستوى البايت في رمز QR بصيغة Base64، يولّد ملف UBL 2.1 XML بعدّاد ICV متسلسل وهاش الفاتورة السابقة، ثم يؤرشف النسخة النهائية بشكل غير قابل للتعديل.
وسوم TLV الخمسة داخل رمز QR
كل حقل يُخزَّن كثلاثية وسم-طول-قيمة: بايت يحدد الوسم (1 إلى 5)، بايت يحدد طول القيمة بالبايت (الحرف العربي = بايتان في UTF-8)، ثم القيمة نفسها. تُسلسل الحقول الخمسة بالترتيب وتُحوَّل Base64.
| الوسم | الحقل | مثال | ملاحظة |
|---|---|---|---|
| 1 | اسم البائع Seller name | مؤسسة المثال التجارية | كما هو مسجل لدى الهيئة، بترميز UTF-8. |
| 2 | الرقم الضريبي للبائع Seller VAT number | 310000000000003 | 15 خانة تبدأ وتنتهي بـ3 للمسجلين في ضريبة القيمة المضافة. |
| 3 | طابع التاريخ والوقت Invoice timestamp | 2026-06-15T10:30:00Z | لحظة إصدار الفاتورة بصيغة ISO 8601. |
| 4 | إجمالي الفاتورة شامل الضريبة Invoice total (with VAT) | 1150.00 | يطابق الإجمالي المطبوع على الفاتورة تماماً. |
| 5 | مبلغ ضريبة القيمة المضافة VAT amount | 150.00 | إجمالي الضريبة المحسوبة على بنود الفاتورة. |
في مسارات المرحلة الثانية تضاف وسوم لهاش XML والختم التشفيري والمفتاح العام وفق المواصفة الأمنية المنشورة من الهيئة.
الترقيم التسلسلي ICV: لماذا لا تُحذف فاتورة من السلسلة
ICV (Invoice Counter Value) عدّاد مركزي يزيد بمقدار واحد مع كل فاتورة تصدرها وحدة الفوترة: 1، 2، 3... دون إعادة استخدام ودون فجوات. ويُكمَّل بهاش الفاتورة السابقة (PIH) داخل XML: كل فاتورة تحمل بصمة الفاتورة التي قبلها، فيستحيل حذف فاتورة من المنتصف دون كسر السلسلة بشكل قابل للكشف عند أي فحص. فاتورة Fattourh يدير العدّاد والهاش تلقائياً ولا يتيح تجاوزهما يدوياً.
مسار توليد الفاتورة من البداية للنهاية
- التحقق من الحقول: اسم البائع، الرقم الضريبي للمسجلين، التاريخ والوقت، البنود، نسب الضريبة — لا تُعتمد فاتورة ناقصة.
- حساب الضريبة: 15% على مستوى كل بند خاضع مع تقريب صحيح، ثم تجميع الإجماليات.
- ترميز TLV: الوسوم 1-5 على مستوى البايت ثم Base64 ثم توليد رمز QR.
- توليد XML: مستند UBL 2.1 بترميز UTF-8 يحمل ICV وPIH وUUID والحقول السعودية المطلوبة.
- الأرشفة: النسخة المعتمدة تُحفظ غير قابلة للتعديل مع ملفات PDF وXML وQR للمدد النظامية.
How does the ZATCA QR code work? (English summary)
The ZATCA QR code encodes at least five mandatory fields — seller name (tag 1), VAT number (tag 2), ISO 8601 timestamp (tag 3), invoice total with VAT (tag 4), and VAT amount (tag 5) — using Tag-Length-Value encoding where lengths are counted in bytes (Arabic UTF-8 characters take two), then Base64-encodes the result. Phase 2 adds tags for the XML hash and cryptographic stamp. Fattourh performs this encoding, generates UBL 2.1 XML with sequential ICV numbering and a previous-invoice hash, and archives every approved invoice immutably.
Fattourh is an independent platform and is not affiliated with, certified by, or endorsed by ZATCA or any Saudi government body. This content is general guidance, not legal advice — always verify against official sources at zatca.gov.sa.
متبقي 18 يوماً على موعد الموجة 24
كل هذا يحدث تلقائياً في كل فاتورة تصدرها — ابدأ مجاناً.
ابدأ الامتثال مجاناً الآنراجع أيضاً دليل ترميز TLV ودليل UBL 2.1 XML والعد التنازلي للموعد.
فاتورة Fattourh منصة مستقلة وغير مرتبطة بهيئة الزكاة والضريبة والجمارك ولا تدّعي أي اعتماد أو شراكة رسمية. المعلومات هنا للتوعية العامة وليست استشارة قانونية — راجع دائماً المصادر الرسمية على zatca.gov.sa.