قواعد التحقق — الفوترة الإلكترونية في السعودية (فاتورة)
معيار XML لا يقول أي القواعد أخطاء وأيها تحذيرات؛ هذا التصنيف لم يُتحقق منه في وثيقة رسمية.
قواعد الهيئة (BR-KSA)
| المعرّف | ما تطلبه | في جوداكس |
|---|---|---|
| BR-KSA-03 | يجب أن يحمل المستند UUID يولّده الجهاز المُصدر، من حروف وأرقام وشَرطات فقط. | مبني |
| BR-KSA-04 | يجب ألا يكون تاريخ الإصدار بعد التاريخ الحالي. | مبني |
| BR-KSA-05 | يجب أن يكون رمز نوع الفاتورة من القائمة السعودية: 388 أو 386 أو 383 أو 381. | مبني |
| BR-KSA-06 | يجب أن توجد الخاصية name على نوع الفاتورة بالبنية NNPNESB. | مبني |
| BR-KSA-07 | لا يجوز الجمع بين علم الفوترة الذاتية وعلم التصدير. | غير مبني |
| BR-KSA-08 | يجب أن يحمل البائع معرّفاً واحداً بأحد الأنواع CRN أو MOM أو MLS أو 700 أو SAG أو OTH، حروفاً وأرقاماً فقط. | مبني جزئيًا |
| BR-KSA-09 | يجب أن يحمل عنوان البائع الشارع ورقم المبنى والرمز البريدي والمدينة والحي ورمز الدولة. | مبني جزئيًا |
| BR-KSA-10 | في الفاتورة الضريبية يجب أن يحمل عنوان المشتري الشارع والمدينة ورمز الدولة. | غير مبني |
| BR-KSA-11 | البند غير الخاضع للضريبة (O) تكون نسبته صفراً إن ذُكرت. | غير مبني |
| BR-KSA-14 | معرّف المشتري الإضافي، حين يلزم، يكون بأحد الأنواع المحددة وحروفاً وأرقاماً فقط. | غير مبني |
| BR-KSA-15 | الفاتورة الضريبية (388 بالخانتين 01) يجب أن تحمل تاريخ التوريد. | غير مبني |
| BR-KSA-16 | إذا ذُكر رمز طريقة الدفع فيجب أن يكون من قائمة UNTDID 4461. | مبني |
| BR-KSA-17 | الإشعار الدائن أو المدين يجب أن يحمل سبب إصداره. | مبني |
| BR-KSA-18 | رمز فئة الضريبة يجب أن يكون S أو Z أو E أو O. | مبني |
| BR-KSA-23 | التفصيل بفئة «معفى» (E) يجب أن يحمل رمز سبب الإعفاء. | مبني جزئيًا |
| BR-KSA-24 | التفصيل بفئة «غير خاضع» (O) يجب أن يحمل رمز السبب. | غير مبني |
| BR-KSA-25 | في المبسطة التي فيها VATEX-SA-EDU أو VATEX-SA-HEA يجب ذكر اسم المشتري. | مبني جزئيًا |
| BR-KSA-26 | hash الفاتورة السابقة يجب أن يكون SHA-256 بترميز base64 محسوباً بطريقة المعيار. | مبني |
| BR-KSA-27 | يجب أن يحمل المستند رمز استجابة سريعة بترميز base64. | مبني |
| BR-KSA-28 | معرّف معلومات التوقيع في ختم التشفير يجب أن يكون urn:oasis:names:specification:ubl:signature:1. | مبني |
| BR-KSA-29 | معرّف التوقيع المرجعي يجب أن يكون urn:oasis:names:specification:ubl:signature:Invoice. | مبني |
| BR-KSA-30 | طريقة التوقيع يجب أن تكون urn:oasis:names:specification:ubl:dsig:enveloped:xades. | مبني |
| BR-KSA-31 | في المبسطة لا يُقبل من الأعلام إلا الطرف الثالث والتوريد المفترض والملخص. | مبني |
| BR-KSA-33 | يجب أن يحمل كل مستند قيمة عداد الفاتورة. | مبني |
| BR-KSA-34 | قيمة العداد أرقام فقط. | مبني |
| BR-KSA-35 | إذا وُجد تاريخ نهاية التوريد فيجب أن يوجد تاريخ التوريد. | غير مبني |
| BR-KSA-36 | تاريخ نهاية التوريد لا يسبق تاريخ التوريد. | غير مبني |
| BR-KSA-37 | رقم مبنى البائع يجب أن يكون أربعة أرقام. | مبني جزئيًا |
| BR-KSA-39 | يجب أن يحمل المستند الرقم الضريبي للبائع أو رقم مجموعته الضريبية. | مبني |
| BR-KSA-40 | الرقم الضريبي للبائع 15 رقماً أولها وآخرها 3. | مبني جزئيًا |
| BR-KSA-42 | اسم المشتري إلزامي في الفاتورة الضريبية وإشعاراتها. | غير مبني |
| BR-KSA-44 | الرقم الضريبي للمشتري، إن ذُكر في غير التصدير، 15 رقماً أولها وآخرها 3. | غير مبني |
| BR-KSA-46 | فاتورة التصدير يجب ألا تحمل رقماً ضريبياً للمشتري. | غير مبني |
| BR-KSA-49 | إذا كان سبب الإعفاء VATEX-SA-EDU أو VATEX-SA-HEA فيجب ذكر الهوية الوطنية للمشتري بنوع NAT. | غير مبني |
| BR-KSA-51 | إجمالي البند مع الضريبة يساوي صافي البند زائد ضريبته. | مبني |
| BR-KSA-52 | ضريبة البند إلزامية في الفاتورة الضريبية وإشعاراتها. | مبني |
| BR-KSA-53 | إجمالي البند مع الضريبة إلزامي في الفاتورة الضريبية وإشعاراتها. | مبني |
| BR-KSA-56 | الإشعار الدائن (381) والمدين (383) يجب أن يحمل مرجع الفاتورة الأصلية. | مبني |
| BR-KSA-60 | ختم التشفير إلزامي في المبسطة وإشعاراتها. | مبني |
| BR-KSA-61 | يجب أن يحمل كل مستند hash الفاتورة السابقة. | مبني |
| BR-KSA-63 | إذا كان المشتري في السعودية فيجب ذكر عنوانه الوطني كاملاً. | غير مبني |
| BR-KSA-66 | الرمز البريدي للبائع خمسة أرقام. | مبني جزئيًا |
| BR-KSA-67 | إذا كان المشتري في السعودية فرمزه البريدي خمسة أرقام. | غير مبني |
| BR-KSA-68 | يجب أن يحمل المستند رمز عملة احتساب الضريبة. | مبني |
| BR-KSA-69 | التفصيل بفئة «صفري» (Z) يجب أن يحمل رمز السبب. | مبني جزئيًا |
| BR-KSA-70 | يجب أن يحمل المستند وقت الإصدار بصيغة hh:mm:ss أو hh:mm:ssZ. | مبني |
| BR-KSA-71 | المبسطة الملخص يجب أن تحمل اسم المشتري. | غير مبني |
| BR-KSA-72 | المبسطة الملخص يجب أن تحمل تاريخي بداية التوريد ونهايته. | غير مبني |
| BR-KSA-73 | إذا ذُكر المبلغ المدفوع مقدماً فيجب ذكر بيانات كل فاتورة دفعة مقدمة في بند إضافي. | غير مبني |
| BR-KSA-80 | المبلغ المدفوع مقدماً يساوي مجموع المبالغ الخاضعة في الدفعات المقدمة وضرائبها. | غير مبني |
| BR-KSA-81 | في الفاتورة الضريبية بلا رقم ضريبي للمشتري يجب ذكر معرّف آخر له. | غير مبني |
| BR-KSA-82 | في بند تسوية الدفعة المقدمة تكون مبالغ البند الأساسية صفراً. | غير مبني |
| BR-KSA-83 | التفصيل بفئة E أو Z أو O يجب أن يحمل نص سبب من قائمة الهيئة. | مبني جزئيًا |
| BR-KSA-DEC-02 | نسب الضريبة بين 0.00 و100.00 بمنزلتين على الأكثر ودون رمز %. | مبني |
| BR-KSA-CL-02 | كل خاصية currencyID تساوي عملة الفاتورة، عدا إجمالي الضريبة بعملة المحاسبة. | مبني |
| BR-KSA-CL-04 | إذا كانت الفئة Z أو E أو O فيجب وجود رمز سبب من القائمة السعودية. | مبني جزئيًا |
| BR-KSA-EN16931-01 | نوع العملية التجارية يجب أن يكون reporting:1.0. | مبني |
| BR-KSA-EN16931-02 | عملة احتساب الضريبة يجب أن تكون SAR. | مبني |
| BR-KSA-EN16931-07 | إذا ذُكر السعر الإجمالي فسعر الوحدة يساويه ناقص خصم السعر. | غير مبني |
| BR-KSA-EN16931-08 | مجموع ضريبي واحد فقط يحمل التفصيل. | مبني |
| BR-KSA-EN16931-09 | مجموع ضريبي واحد فقط بلا تفصيل عند وجود عملة الضريبة. | مبني |
| BR-KSA-EN16931-11 | صافي البند = الكمية × (السعر ÷ كمية الأساس) + الرسوم − الخصومات. | مبني |
| BR-KSA-F-01 | التواريخ بصيغة YYYY-MM-DD. | مبني |
| BR-KSA-F-03 | يجب ألا يحتوي المستند على عناصر فارغة. | مبني |
| BR-KSA-F-04 | كل المبالغ والكميات موجبة. | مبني |
| BR-KSA-F-06 | أطوال الحقول ضمن الحدين الأدنى والأعلى في قاموس البيانات. | مبني جزئيًا |
| BR-KSA-98 | يُنبَّه إلى أن المستند المبسط يجب أن يُبلَّغ خلال 24 ساعة. | مبني جزئيًا |
قواعد EN 16931 التي تطبقها الهيئة
| المعرّف | ما تطلبه | في جوداكس |
|---|---|---|
| BR-02 | يجب أن يحمل المستند رقم فاتورة. الرقم التسلسلي الذي تشترطه المادة 53؛ لا يغني عنه الـ UUID ولا العداد، فلكل منهما وظيفة أخرى. | مبني |
| BR-03 | يجب أن يحمل المستند تاريخ إصدار. التاريخ ميلادي بصيغة YYYY-MM-DD، ولا يجوز أن يكون في المستقبل (BR-KSA-04). | مبني |
| BR-06 | يجب أن يحمل المستند اسم البائع. الاسم المسجل في RegistrationName، وهو أيضاً الوسم 1 في رمز الاستجابة السريعة. | مبني |
| BR-08 | يجب أن يحمل المستند عنوان البائع البريدي. هذه القاعدة الأوروبية تطلب وجود العنوان، والقاعدة السعودية BR-KSA-09 تحدد أجزاءه الستة. | مبني جزئيًا |
| BR-09 | يجب أن يحمل عنوان البائع رمز دولة. رمز ISO 3166 من حرفين. وتطبيق القواعد السعودية مرتبط برمز دولة البائع. | مبني |
| BR-10 | يجب أن يحمل المستند عنوان المشتري، عدا المبسطة وإشعاراتها. الهيئة عدّلت القاعدة الأوروبية فاستثنت المبسطة (الخانتان 02 في KSA-2)، لأن المبسطة لا تحمل عادة بيانات المشتري. | غير مبني |
| BR-16 | يجب أن يحمل المستند بنداً واحداً على الأقل. حتى الإشعار الدائن يحتاج بنداً يصف ما يُرد. وفاتورة تسوية الدفعة المقدمة تضيف بنوداً إضافية بمبالغ صفرية. | مبني |
| BR-48 | كل تفصيل ضريبي يحمل نسبة، إلا في غير الخاضع. في الفئة O يجوز حذف النسبة؛ وفي غيرها يجب ذكرها ولو كانت صفراً. | مبني |
| BR-53 | إذا ذُكرت عملة احتساب الضريبة فيجب ذكر إجمالي الضريبة بها. لأن الهيئة تجعل عملة الضريبة إلزامية، يصبح هذا المجموع الثاني إلزامياً في كل مستند. | مبني |
| BR-55 | كل مرجع لفاتورة سابقة يجب أن يحمل رقمها. عنصر BillingReference الفارغ مرفوض؛ إن وُجد المرجع فيجب أن يحمل رقم الفاتورة الأصلية. | مبني |
| BR-CO-04 | كل بند يُصنَّف بفئة ضريبية. الفئة على البند هي ما يُبنى عليه التفصيل الضريبي، فالبند بلا فئة لا يمكن نسبته إلى أي تفصيل. | مبني |
| BR-CO-10 | مجموع صافي البنود يساوي جمع صافي كل بند. تطابق تام بالهللة. أي فرق تقريب بين البنود والمجموع يكفي للرفض. | مبني |
| BR-CO-13 | الإجمالي قبل الضريبة = صافي البنود − خصومات الفاتورة + رسومها. من دون خصومات أو رسوم على مستوى الفاتورة يتساوى الإجمالي قبل الضريبة مع مجموع صافي البنود. | مبني |
| BR-CO-14 | إجمالي ضريبة الفاتورة = جمع ضريبة الفئات. الإجمالي يُبنى من التفصيل، لا من جمع ضريبة البنود. والمعيار يطلب التقريب على مستوى المستند. | مبني جزئيًا |
| BR-CO-15 | الإجمالي مع الضريبة = الإجمالي قبلها + إجمالي الضريبة. هذا المبلغ هو الوسم 4 في رمز الاستجابة السريعة. | مبني |
| BR-CO-16 | المبلغ المستحق = الإجمالي مع الضريبة − المدفوع مقدماً + التقريب. في فاتورة بلا دفعة مقدمة ولا تقريب يساوي المستحقُ الإجماليَ مع الضريبة. | مبني |
| BR-CO-17 | ضريبة الفئة = المبلغ الخاضع × النسبة ÷ 100، مقربة إلى منزلتين. التقريب «نصف للأعلى» على النتيجة النهائية للفئة. ولهذا قد تختلف ضريبة الفئة بهللة عن جمع ضريبة بنودها المقربة. | مبني جزئيًا |
| BR-CO-18 | يجب أن يحمل المستند تفصيلاً ضريبياً واحداً على الأقل. حتى الفاتورة المعفاة بالكامل تحمل تفصيلاً بفئة E ومبلغ ضريبة صفر. | مبني |
| BR-S-08 | المبلغ الخاضع في تفصيل الفئة S يساوي صافي بنودها − خصوماتها + رسومها. تُجمع فقط البنود والخصومات والرسوم التي فئتها S ومعرّف نظامها VAT. | مبني |
| BR-S-09 | ضريبة تفصيل الفئة S = المبلغ الخاضع × النسبة ÷ 100، مقربة. هذه نسخة BR-CO-17 الخاصة بالنسبة الأساسية، وفيها يظهر أثر التقريب أكثر من غيرها. | مبني جزئيًا |
| BR-S-10 | تفصيل الفئة S لا يحمل سبب إعفاء، لا رمزاً ولا نصاً. سبب الإعفاء يشرح غياب الضريبة الأساسية، فلا معنى له في فئة تُفرض فيها. | مبني |
| BR-Z-01 | إذا وُجد بند صفري فيجب أن يوجد تفصيل بالفئة Z. كل فئة مستخدمة في البنود تحتاج تفصيلاً بها. | مبني |
| BR-Z-05 | نسبة البند الصفري صفر. الصفرية ليست «بلا نسبة»: النسبة موجودة وقيمتها 0. | مبني |
| BR-Z-08 | المبلغ الخاضع في تفصيل Z يساوي صافي بنوده الصفرية مع خصوماتها ورسومها. المبلغ يُذكر كاملاً رغم أن ضريبته صفر، لأنه يدخل في الإقرار الضريبي. | مبني |
| BR-Z-09 | ضريبة تفصيل Z صفر. أي مبلغ غير الصفر في تفصيل صفري يُرفض. | مبني |
| BR-E-01 | إذا وُجد بند معفى فيجب أن يوجد تفصيل بالفئة E. وتفصيل E يحتاج رمز السبب ونصه (BR-KSA-23 وBR-KSA-83). | مبني |
| BR-E-05 | نسبة البند المعفى صفر. كما في الصفرية، النسبة مذكورة وقيمتها 0. | مبني |
| BR-E-08 | المبلغ الخاضع في تفصيل E يساوي صافي بنوده المعفاة مع خصوماتها ورسومها. المبلغ يُذكر كاملاً حتى لو لم تُفرض عليه ضريبة. | مبني |
| BR-E-09 | ضريبة تفصيل E صفر. المعفاة لا ضريبة عليها، ورموز أسبابها ثلاثة: الخدمات المالية، وعقود التأمين على الحياة، والتوريدات العقارية المعفاة. | مبني |
| BR-O-01 | إذا وُجد بند غير خاضع فيجب أن يوجد تفصيل بالفئة O. وتفصيل O يحتاج الرمز VATEX-SA-OOS ونص سبب يكتبه المكلف. | غير مبني |
| BR-O-08 | المبلغ الخاضع في تفصيل O يساوي صافي بنوده غير الخاضعة مع خصوماتها ورسومها. رغم التسمية، يُذكر مبلغ البنود غير الخاضعة في هذا الحقل. | غير مبني |
| BR-O-09 | ضريبة تفصيل O صفر. التوريد خارج نطاق الضريبة لا يحمل ضريبة. | غير مبني |
| BR-CL-01 | رمز نوع المستند من قائمة UNTDID 1001. القاعدة الأوروبية تقبل أي رمز من القائمة، والسعودية BR-KSA-05 تحصرها في أربعة. | مبني |
| BR-CL-18 | فئات الضريبة من قائمة UNCL5305. القائمة الدولية أوسع، والقاعدة السعودية BR-KSA-18 تحصرها في S وZ وE وO. | مبني |
المصادر
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
- Electronic Invoice Data Dictionary to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- تحمّل الدولة ضريبة القيمة المضافة المستحقة على الخدمات التعليمية الأهلية المقدمة إلى المواطنين (vالإصدار الثاني) — ZATCA
- Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- اللائحة التنفيذية لنظام ضريبة القيمة المضافة (vالنسخة العاشرة (آخر تعديل بقرار 24-06-01 في 2024-11-19)) — ZATCA
- Integration Sandbox API pages (Swagger): reporting, clearance, compliance, production CSID, renewal (ve-Invoicing Sandbox Release 2.1.0 (page lists 2.1.1 as latest)) — ZATCA
تاريخ المراجعة: 4 نوفمبر 2026. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.