مرجع فني

أخطاء الفاتورة الإلكترونية: رموز BR-KSA

ما تعنيه رموز BR-KSA في رد منصة فاتورة، وما تراجعونه لحل كل منها.

ما هي رموز BR-KSA؟

رموز BR-KSA هي القواعد التي تضيفها هيئة الزكاة والضريبة والجمارك للتحقق من ملف الفاتورة الإلكترونية في السعودية، إلى جانب قواعد المعيار الأوروبي مثل BR-CO. وعندما يخالف ملف الفاتورة قاعدة، يذكر رد منصة فاتورة رمزها ورسالتها. وتبدأ رموز الصيغ والحقول بـBR-KSA-F. وليست كل قاعدة تؤدي إلى الرفض، فقد تأتي مخالفة بعضها في صورة تحذير.

اقرؤوا الرد قبل أي تعديل

رد المنصةمعناهما تفعلونه
قُبلتالفاتورة ممتثلةلا شيء
قُبلت مع تحذيراتخطأ بسيط لا يمنع القبولافحصوه وعالجوه في الفاتورة التالية
رُفضتخطأ جوهري يجعل المستند غير صالحصححوا الخطأ وأرسلوه كمستند جديد له عداده وتجزئته
الرمز وحده لا يكفي. اعتمدوا على الرسالة ومستوى الخطأ كما وردا في ردكم أنتم، فقد يختلف تصنيف القاعدة بين رفض وتحذير. ولتفاصيل التصحيح، راجعوا إلغاء الفاتورة الإلكترونية أو تعديلها.

الدليل التفصيلي للفوترة الإلكترونية، القسم 10.

بيانات البائع

الرمزما تشترطه القاعدةما تراجعونه
BR-KSA-39يجب أن تتضمن الفاتورة الرقم الضريبي للبائع.أضيفوا الرقم الضريبي في إعدادات المنشأة أو وحدة الإصدار.
BR-KSA-40الرقم الضريبي للبائع 15 رقمًا، أولها وآخرها الرقم 3.راجعوا الرقم مقابل شهادة التسجيل، وتأكدوا من خلوه من المسافات.
BR-KSA-08يجب أن يرد معرّف البائع مرة واحدة بأحد الأنواع (CRN وMOM وMLS و700 وSAG وOTH)، بأحرف وأرقام فقط.أدخلوا معرّفًا واحدًا مثل السجل التجاري، واحذفوا الرموز والمكرر.
BR-KSA-09يجب أن يتضمن عنوان البائع الشارع ورقم المبنى والرمز البريدي والمدينة والحي والدولة.أكملوا العنوان الوطني للمنشأة أو الفرع.
BR-KSA-37رقم مبنى البائع 4 أرقام.استخدموا رقم المبنى من العنوان الوطني، لا رقمًا مختصرًا.
BR-KSA-66الرمز البريدي للبائع 5 أرقام.صححوا الرمز في بيانات المنشأة.

بيانات المشتري

الرمزما تشترطه القاعدةما تراجعونه
BR-KSA-44إذا ورد الرقم الضريبي للمشتري في فاتورة غير تصديرية، فهو 15 رقمًا، أولها وآخرها الرقم 3.صححوا الرقم في ملف العميل، أو احذفوه إن لم يكن العميل مسجلًا واستخدموا معرّفًا آخر.
BR-KSA-81إذا لم يرد الرقم الضريبي للمشتري في الفاتورة الضريبية وإشعاراتها، فيلزم معرّف آخر له.أضيفوا السجل التجاري أو الهوية الوطنية أو الإقامة في ملف العميل.
BR-KSA-14معرّف المشتري مطلوب إذا لم يكن مسجلًا في الضريبة، ويرد بأحد الأنواع المحددة.اختاروا نوع المعرّف الصحيح مع الرقم.
BR-KSA-42اسم المشتري إلزامي في الفاتورة الضريبية وإشعاراتها.أكملوا اسم العميل قبل الإصدار.
BR-KSA-10يجب أن يتضمن عنوان المشتري الشارع والمدينة والدولة، ولا تنطبق القاعدة على الفاتورة المبسطة.أكملوا عنوان العميل في ملفه.
BR-KSA-63إذا كانت دولة المشتري السعودية، فيلزم الشارع ورقم المبنى والرمز البريدي والمدينة والحي والدولة.أكملوا العنوان الوطني للعميل.
BR-KSA-67إذا كانت دولة المشتري السعودية، فرمزه البريدي 5 أرقام.صححوا الرمز في ملف العميل.

الإشعارات الدائنة والمدينة

الرمزما تشترطه القاعدةما تراجعونه
BR-KSA-17يجب أن يتضمن الإشعار الدائن أو المدين سبب إصداره.اجعلوا السبب حقلًا إلزاميًا في شاشة الإشعار.
BR-KSA-56مرجع الفاتورة الأصلية إلزامي في الإشعار الدائن والمدين.اربطوا الإشعار برقم الفاتورة الأصلية قبل الإصدار.

الضريبة والمبالغ

الرمزما تشترطه القاعدةما تراجعونه
BR-KSA-18رمز فئة الضريبة أحد القيم S أو Z أو E أو O.اربطوا كل صنف بإحدى الفئات الأربع.
BR-KSA-69البند الخاضع لنسبة صفر يحتاج رمز سبب.أضيفوا رمز السبب للأصناف ذات النسبة الصفرية.
BR-KSA-23البند المعفى يحتاج رمز سبب الإعفاء.أضيفوا رمز الإعفاء للصنف المعفى.
BR-KSA-24البند غير الخاضع للضريبة يحتاج رمز سبب.أضيفوا الرمز، وراجعوا هل يلزم إصدار فاتورة أصلًا.
BR-KSA-51مبلغ البند شامل الضريبة يساوي صافي البند مضافًا إليه ضريبته.راجعوا التقريب، واحسبوا على مستوى البند بطريقة واحدة.
BR-KSA-F-04مبالغ المستند وكمياته موجبة.لا تستخدموا قيمًا سالبة للتخفيض أو الإرجاع: استخدموا الخصم أو الإشعار الدائن.

التسلسل والأمان

الرمزما تشترطه القاعدةما تراجعونه
BR-KSA-03يجب أن تتضمن الفاتورة معرّفًا فريدًا (UUID) يولّده جهاز الإصدار.ولّدوا معرّفًا جديدًا لكل مستند، ولا تعيدوا استخدامه.
BR-KSA-33لكل فاتورة قيمة عدّاد.راجعوا إعداد العدّاد في وحدة الإصدار.
BR-KSA-34قيمة العدّاد أرقام فقط.احذفوا البادئات والرموز من العدّاد، فهو مستقل عن رقم الفاتورة.
BR-KSA-61قيمة تجزئة الفاتورة السابقة يجب أن ترد في الفاتورة.احفظوا تجزئة آخر مستند لكل وحدة إصدار، واستخدموها في التالي.
BR-KSA-26تجزئة الفاتورة السابقة بصيغة SHA256 مرمّزة بـbase64.طبّقوا طريقة الحساب الواردة في المواصفة، ولا تغيروا الملف بعد حساب التجزئة.
BR-KSA-27يجب أن يتضمن المستند رمز QR بصيغة base64.راجعوا توليد الرمز بمحتوى المرحلة الثانية.
BR-KSA-60الختم التشفيري إلزامي في الفواتير المبسطة وإشعاراتها.تأكدوا من توقيع المبسطة بشهادة الإنتاج قبل الإبلاغ.

الصيغ والتواريخ

الرمزما تشترطه القاعدةما تراجعونه
BR-KSA-04تاريخ الإصدار لا يتجاوز التاريخ الحالي.راجعوا ساعة الخادم والمنطقة الزمنية، ولا تصدروا بتاريخ لاحق.
BR-KSA-70يجب أن يتضمن المستند وقت الإصدار بصيغة hh:mm:ss.أرسلوا الوقت بهذه الصيغة، مع Z إن كان بتوقيت UTC.
BR-KSA-F-01صيغة التاريخ YYYY-MM-DD.وحّدوا صيغة التاريخ في ملف XML بصرف النظر عن عرضه في الشاشة.
BR-KSA-F-03يجب ألا يتضمن المستند عناصر فارغة.احذفوا العنصر الاختياري من الملف إذا لم تكن له قيمة، ولا ترسلوه فارغًا.
BR-KSA-F-06يجب التزام الحد الأدنى والأقصى لعدد الأحرف في كل حقل.راجعوا طول الحقل في قاموس البيانات لدى الهيئة.

رموز لم نجدها في المواصفة

يبحث الناس أيضًا عن BR-KSA-F-07 وBR-KSA-F-08 وBR-KSA-F-10 وBR-KSA-F-13 وBR-KSA-FC-01 وBR-KSA-98. ولم نجد هذه الرموز في الإصدار 1.2 من المواصفة الذي راجعناه، وقد تكون في إصدار أحدث أو في أدوات الهيئة. لذلك لا نذكر لها معنى هنا، فاعتمدوا على الرسالة الواردة في ردكم.

معاني القواعد ملخصة من مواصفة XML للفاتورة الإلكترونية، الإصدار 1.2 (مايو 2023م). أما عمود «ما تراجعونه» فقراءتنا العملية، وليس نصًا لدى الهيئة. ولم يراجع هذه الصفحة مهندس مختص بعد، فاختبروا أي تعديل في بيئة المحاكاة أولًا.

أين يقع نظام emerge من هذا

تتعامل منظومة emerge المحاسبية مع بعض هذه القواعد عند الإصدار، مثل سبب الإشعار ورمز سبب النسبة الصفرية ومعرّف المشتري غير المسجل في الضريبة. ولا يعني ذلك أن كل خطأ يختفي، فجودة بيانات العملاء والأصناف تبقى مسؤولية مشتركة.

استعرضوا المنظومة المحاسبية

أسئلة شائعة

ماذا يعني الخطأ BR-KSA-44؟

إذا ورد الرقم الضريبي للمشتري في فاتورة غير تصديرية، فيجب أن يكون 15 رقمًا أولها وآخرها الرقم 3. راجعوا الرقم في ملف العميل، واحذفوه إن لم يكن العميل مسجلًا واستخدموا معرّفًا آخر.

ماذا يعني الخطأ BR-KSA-81؟

لم يرد الرقم الضريبي للمشتري في الفاتورة الضريبية أو إشعارها، فيلزم معرّف آخر له، مثل السجل التجاري أو الهوية الوطنية أو الإقامة.

ما سبب الخطأ BR-KSA-17؟

الإشعار الدائن أو المدين لا يتضمن سبب إصداره. اجعلوا السبب حقلًا إلزاميًا عند إنشاء الإشعار.

هل كل رمز BR-KSA يعني رفض الفاتورة؟

لا. قد يأتي الرمز في صورة تحذير مع قبول الفاتورة، أو خطأ مع رفضها. اعتمدوا على مستوى الخطأ في رد منصة فاتورة.

ما معنى BR-KSA-98 أو BR-KSA-F-13؟

لم نجد هذين الرمزين في الإصدار 1.2 من مواصفة الهيئة الذي راجعناه. فاعتمدوا على الرسالة الواردة في الرد، وراجعوا أحدث إصدار من وثائق الهيئة.

تبون تطبّقون هذا في منشأتكم؟ جرّبوه بأنفسكم، أو اسألونا على واتساب.

تنبيه

هذا الدليل شرح عام لأغراض معلوماتية، وليس استشارة ضريبية أو قانونية. الأنظمة واللوائح والمواعيد تتغير، والمرجع النهائي هو ما تنشره هيئة الزكاة والضريبة والجمارك. راجعوا مستشاركم الضريبي قبل اتخاذ أي إجراء.