BR-KSA-F-06-C19 تحذير — الفاتورة تُقبل

اسم البند (BT-153) أقصر من ثلاثة محارف أو أطول من ألف

اسم البند في سطر الفاتورة له حدّان: أدنى ثلاثة محارف، وأعلى ألف. والأدنى هو المفاجأة — بند اسمه «A» أو «1» أو «م2» يعود بتحذير من الهيئة، والفاتورة تُقبل معه. وهذا الكود لا تجده في المستخرج المنشور مع حزمة تطوير الهيئة؛ أضفناه من ردّ الواجهة الحيّة على فاتورة حقيقية.

نص الرسالة كما ترسلها الهيئة بالإنجليزية، بلا تعديل

Field character limits for Item name field (BT-153) have not been met. The minimum limit is 3 character and the maximum limit is 1000 characters.

ماذا يعني هذا؟

كل سطر في الفاتورة يحمل اسم البند (BT-153) في cac:InvoiceLine/cac:Item/cbc:Name — وهو الاسم الذي يقرؤه المشتري على المستند ويقرؤه المتحقق في الملف. وهذه القاعدة تضع له حدّين في جملة واحدة: ألا يقلّ عن ثلاثة محارف، وألا يزيد على ألف.

والحدّ الأدنى هو ما يستحق صفحة. من بين القواعد الـ 136 التي نفهرسها، عشر قواعد فقط تذكر «حدًّا أدنى» في نصّها — وكلها تقول محرفًا واحدًا. هذه وحدها تقول ثلاثة. فالاسم الذي يستوفي كل شرط آخر في الملف — غير فارغ، غير مقتطع، بلا محارف ممنوعة — يظل تحت الحد لو كان حرفًا أو حرفين.

ودرجتها تحذير: الهيئة تُجيز الفاتورة ويعود الكود مع القبول في warningMessages لا في errorMessages. فلا شيء يُرفض هنا، والذي يبقى سطر على مستند ضريبي لا يقول ما بيع.

وموضعها من القائمة يستحق الذكر. عائلة BR-KSA-F-06 هي قواعد أطوال الحقول، وتمرّ في المستخرج المنشور من C3 إلى C39 وفيها فجوات: C8 و C10 و C17 إلى C20 و C27 و C30 و C31 غائبة. و C19 إحدى هذه الفجوات، ومع ذلك ترجعه الواجهة الحيّة. أضفناه إلى قائمتنا من ردّ التقطناه بتاريخ 2026-08-29، كما فعلنا من قبل مع BR-KSA-F-13.

لماذا يحدث؟

مرتّبة من الأشيع إلى الأقل شيوعًا — الأرجح أن سببك في الأول أو الثاني.

  • بند يحمل رمزه لا اسمه: S للمقاس الصغير، أو A4 لمقاس الورق، أو «م2» للمتر المربع — حرف أو حرفان في خانة الاسم.
  • ربط خاطئ عند الاستيراد: عمود رقم الصنف مربوط باسم البند، والوصف الحقيقي في عمود آخر لم يُقرأ.
  • سطر أُضيف لغرض حسابي — فرق تقريب، أو رسم، أو بند خصم — واسمه - أو + أو حرف واحد.
  • وحدة القياس مكتوبة في خانة الاسم بدل خانتها: «كج» أو «م» أو «لتر»، وبعضها محرف أو محرفان.
  • صفّ بلا اسم في ملف مستورد، فيضع النظام علامة نائبة من محرف واحد بدل أن يوقف الصف ويسأل.
  • والاتجاه الآخر: مواصفة كاملة أو نطاق عمل مكتوب في خانة الاسم، فيتجاوز الألف.

كيف تصلحه

3 خطوات، ثم أعد إرسال الفاتورة.

  1. 1
    اكتب اسم البند كما يقرؤه المشتري لا كما يرمّزه نظامك

    خانة الاسم لقارئ المستند: «تصميم هوية بصرية»، «صيانة مكيّف سبليت»، «ورق تصوير A4». والرمز الداخلي مكانه وصف السطر لا اسمه. وثلاثة محارف حدّ منخفض جدًّا — أي اسم حقيقي يتجاوزه دون أن تفكّر فيه.

  2. 2
    راجع ربط الأعمدة قبل أن يراجعه المتحقق

    إن كانت السطور تصل من متجر أو من جدول بيانات أو عبر واجهة البرمجة، فافحص أي عمود يملأ name: عمود الوصف أو العنوان، لا عمود رقم الصنف. والصفّ الذي لا اسم له أوقفه أو سمِّه، ولا تضع فيه علامة نائبة — العلامة النائبة تمرّ من نظامك وتقف عند الهيئة.

  3. 3
    الحد الأعلى ألف محرف — وهو مساحة لا دعوة

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

هذا الكود لا يمنع القبول، فالفاتورة الحالية نظامية. صحّح البيانات لتختفي التحذيرات من الفواتير القادمة.

هل يمنعه ZATCA Tools؟

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

أكواد لها علاقة

BR-KSA-F-13 تحذير
معرّف البائع أو المشتري الإضافي يحتوي قيمة غير صحيحة
BR-KSA-F-06-C12
نص الرسالة الرسمي فيالمرجع الكامل.
BR-KSA-F-06-C23 تحذير
شارع المشتري (BT-50) بلا قيمة، أو أطول من الحد
BR-KSA-11 يرفض الفاتورة
بند خارج نطاق الضريبة بنسبة غير صفرية

أسئلة شائعة

هل تُرفض الفاتورة بسبب اسم بند قصير؟ +
لا. درجة هذا الكود تحذير، ويعود في warningMessages مع قبول الفاتورة لا في errorMessages التي ترفض. فالمستند مُجاز ومسجَّل عند الهيئة، والذي يبقى سطر لا يقول ما بيع. وطريقة قراءة الرد في فاتورتي مرفوضة من الهيئة.
بحثت عن هذا الكود في قائمة الهيئة فلم أجده +
صحيح، ونقولها كما هي: المستخرج المنشور مع حزمة التطوير لا يحتوي BR-KSA-F-06-C19، والواجهة الحيّة ترجعه. أضفناه إلى صفحة الأكواد من ردّ التقطناه بأنفسنا، بنصّ الهيئة حرفًا بحرف — حتى «3 character» بالمفرد كما وصلتنا. وهذه ثاني مرة يحدث فيها هذا عندنا؛ الأولى كانت BR-KSA-F-13.
اسم بندي «A4» — محرفان. هل يكفي؟ +
لا، الحد الأدنى ثلاثة فالمحرفان تحته. وA4 مقاس لا اسم على أي حال: «ورق تصوير A4» يصف ما بيع ويتجاوز الحد في الوقت نفسه.
هل يُحسب الاسم بالمحارف أم بالبايتات؟ +
الرسالة تقول character، ولا نملك تجربة تفصل أين ترسم الهيئة الحد بين المحرف والبايت. والاتجاه العربي آمن في القراءتين: ثلاثة أحرف عربية ثلاثة محارف وستة بايتات، وكلاهما فوق الحد. الذي يستحق الحذر اسم لاتيني من حرفين.
فاتورتي عشرة بنود — أيّها القصير؟ +
الرد لا يقول. رسائل التحقق تصل بكود ونصّ فقط بلا رقم سطر، فالفحص عليك: اقرأ أسماء البنود وابحث عن الأقصر من ثلاثة. وفي فاتورة طويلة تصل من نظام آخر، الأسرع أن تفحص المصدر — العمود الذي يملأ الاسم — لا الفاتورة.
هل تشمل وصف السطر أو ملاحظات الفاتورة؟ +
لا. هذه القاعدة لاسم البند (BT-153) وحده. وأطوال الحقول الأخرى لها أكواد مستقلة في العائلة نفسها — اسم المشتري BR-KSA-F-06-C12، وشارع المشتري BR-KSA-F-06-C23، وسبب الإشعار BR-KSA-F-06-C13 — وحدّها الأدنى محرف واحد لا ثلاثة.
أصلحت هذه — ولا تريد التالية

ZATCA Tools يبني التوقيع والبصمة والعدّاد والترميز عنك، ويتحقق من البيانات قبل الإرسال. ابدأ مجانًا، وبدون بطاقة ائتمانية.

ابدأ مجانًا

← كل أكواد أخطاء ZATCA