تخطَّ إلى المحتوى

قواعد التحقق — الفوترة الإلكترونية في السعودية (فاتورة)

معيار 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-26hash الفاتورة السابقة يجب أن يكون 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.مبني

المصادر

  1. Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
  3. Electronic Invoice Data Dictionary to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  4. تحمّل الدولة ضريبة القيمة المضافة المستحقة على الخدمات التعليمية الأهلية المقدمة إلى المواطنين (vالإصدار الثاني) — ZATCA
  5. Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  6. اللائحة التنفيذية لنظام ضريبة القيمة المضافة (vالنسخة العاشرة (آخر تعديل بقرار 24-06-01 في 2024-11-19)) — ZATCA
  7. 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. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.