نسبة ضريبة غير مقبولة في نظام الفوترة الوطني: القيم التي تقبلها الواجهة وعلاقتها بخطأ 500

نسبة ضريبة غير مقبولة في نظام الفوترة الوطني هي قيمة يرسلها برنامجك المحاسبي في حقل النسبة cbc:Percent لأحد بنود الفاتورة، ولا ترد ضمن القيم التي تقبلها الواجهة البرمجية لهذا الحقل. ويذكر الدليل التقني الصادر عن دائرة ضريبة الدخل والمبيعات هذه الحالة بين أسباب رمز الحالة 500، بعد أسباب أخرى تخص هوية المكلف وبيانات الربط.

يبدأ الإصلاح من بنود الفاتورة. قارن النسبة المكتوبة في كل بند بالقيم التي يوردها الدليل لفواتير البيع الجديدة، وهي 0 و1 و2 و3 و4 و5 و7 و8 و10 و16، ثم صحّح القيمة من مصدرها في برنامجك، وأعد الإرسال برقم الفاتورة ومعرّفها الفريد نفسيهما.

يشرح هذا المقال نص الدليل التقني (الإصدار 1.5) حول هذا السبب، والقيم التي يقبلها حقل النسبة وصيغتها، والفرق بين هذه القائمة والنسب التي يفرضها القانون. ثم يعرض خطوات فحص فاتورة رُفضت، وما لا يذكره الدليل في هذه الحالة.

ما معنى نسبة ضريبة غير مقبولة في نظام الفوترة الوطني

كل بند في فاتورة ضريبة المبيعات العامة يحمل كتلة ضريبة خاصة به. وفي هذه الكتلة عنصران متجاوران، هما فئة الضريبة ونسبتها. والفئة حرف من ثلاثة أحرف هي S وZ وO، والنسبة رقم يُكتب في العنصر cbc:Percent. وهذا هو الشكل الذي يورده الدليل لبند خاضع بنسبة 16.

<cac:TaxSubtotal>
  <cbc:TaxAmount currencyID="JO">...</cbc:TaxAmount>
  ...
    <cbc:ID schemeAgencyID="6" schemeID="UN/ECE 5305">S</cbc:ID>
    <cbc:Percent>16</cbc:Percent>
    <cac:TaxScheme>
      <cbc:ID schemeAgencyID="6" schemeID="UN/ECE 5153">VAT</cbc:ID>
    </cac:TaxScheme>
  ...
</cac:TaxSubtotal>

والمقصود بعبارة «غير مقبولة» في هذا المقال أن القيمة لا تطابق أيًّا من القيم التي يحددها الدليل للحقل. فهو وصف تقني لقيمة في ملف، وليس حكمًا على صحة المعاملة الضريبية للسلعة. فقد تكون المعاملة الضريبية صحيحة في دفاترك، ويُكتب رقمها في الملف بصيغة لا يقبلها الحقل.

ويظهر أثر هذا الحقل في حساب ضريبة البند. فالدليل يحسب قيمة الضريبة في السطر بالمعادلة (الكمية × سعر الوحدة − الخصم) × نسبة الضريبة. وفي مثال فاتورة ضريبة المبيعات العامة الذي يورده الدليل (ص40 وص43 وص44) بند قيمته 33 × 2 − 2 = 64، ونسبته 7، فتكون ضريبته 4.48 ويصبح إجمالي السطر 68.48. ويتضح من المثال أن الحقل يحمل النسبة رقمًا صحيحًا أو عشريًّا بوحدة المئة، أي 7 لا 0.07.

ماذا يقول الدليل التقني عن علاقة النسبة بخطأ 500

يعدد الدليل في صفحة الأخطاء أسباب رمز الحالة 500 (Internal Server Error) بهذا النص.

«وهذا يدل على وجود خطأ في الرقم الضريبي أو تسلسل مصدر الدخل وبدرجة أقل يكون الخطأ في ال Client_ID أو ال Secret_Key ويمكن أن تكون نسبة الضريبة الموجودة في ملف ال XML ليست ضمن نسب الضريبة المعتمدة لدى الدائرة».

يقسم النص الأسباب إلى ثلاث مجموعات. الأولى الرقم الضريبي أو تسلسل مصدر الدخل. والثانية رقم المستخدم والمفتاح السري، ويصفها الدليل بعبارة «بدرجة أقل». والثالثة نسبة الضريبة، ويقدمها بعبارة «ويمكن أن تكون». ولا يضع الدليل ترتيبًا آخر بين هذه الأسباب غير عبارة «بدرجة أقل»، ولا يقول إن النسبة تؤدي إلى رمز 500 في كل مرة.

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

ويلاحظ أن الدليل يذكر هذا السبب تحت رمز 500، لا بين رسائل رمز 400 التي يرد تفصيلها في الحقل EINV_MESSAGE. فالرسائل التي يوردها لرمز 400 لا تتضمن رسالة خاصة بنسبة خارج القائمة.

القيم التي يقبلها الحقل cbc:Percent

يصف الدليل حقل النسبة في جدول بنود فاتورة ضريبة المبيعات العامة الجديدة (ص42) بأنه «نسبة الضريبة العامة على السلعة أو الخدمة وحسب النسب التالية»، ثم يسرد القيم 0% و1% و2% و3% و4% و5% و7% و8% و10% و16%. ويضيف «والصيغة تكون حسب الأمثلة التالية»، ويعرض أمثلة يُكتب فيها الرقم وحده داخل العنصر، مثل 1 و4 و8 و16.

ومن هذا الجدول يمكن استخلاص ثلاث ملاحظات عملية.

• الرقم وحده دون رمز النسبة المئوية. تكتب أمثلة الدليل القيمة 16 لا 16%، وتظهر في نماذج الفواتير الكاملة أيضًا بالصيغتين 7.00 و16.000.
• النسبة بوحدة المئة لا بالكسر العشري. القيمة 0.16 ليست من القيم الواردة في القائمة، والقيمة التي تقابلها في الأمثلة هي 16.
• الصفر يصحب فئتين. القيمة 0 تُرسل مع الفئة Z للبند المعفى أو O للبند الخاضع لنسبة الصفر، وباقي القيم تُرسل مع الفئة S. وتفصيل الفئات في مقال فئات الضريبة S وZ وO في نظام الفوترة الوطني.

وتورد صفحات فواتير الإرجاع في الدليل القائمة دون الصفر (1 و2 و3 و4 و5 و7 و8 و10 و16). ولا يشرح الدليل سبب هذا الفرق، فننقله هنا كما ورد دون تفسير.

قائمة تحقق تقنية لا قائمة بما يفرضه القانون

القائمة السابقة قائمة تحقق تقنية، أي القيم التي يقبلها الحقل عند الإرسال. وليست جدولًا بالنسب التي يفرضها القانون على السلع والخدمات. فهما يجيبان عن سؤالين مختلفين.

• ما النسبة التي تنطبق على هذه السلعة؟ يجيب عنه قانون الضريبة العامة على المبيعات وجداوله، وتجد شرحه في مقال ضريبة المبيعات في الأردن. وهذا سؤال تراجعه مع محاسبك.
• ما القيمة التي يقبلها حقل النسبة في ملف الفاتورة؟ يجيب عنه الدليل التقني في الصفحة 42، وهو السؤال الذي يتعلق به رمز 500 في هذه الحالة.

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

كيف يُكتب حقل النسبة حسب نوع البند والفاتورة

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

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

وأما الصفر مع الفئة S فحالة مختلفة. فالقيمة 0 مقبولة في القائمة، والخطأ في الفئة المرافقة لها، ويرد عليه الدليل برمز 400 ونص رسالة General tax percentage must be zero. وفي فواتير التصدير والأنواع غير المحلية الأربعة الأخرى ينص الدليل على نسبة 0% والفئة O لجميع السلع، وتفصيلها في مقال فواتير التصدير في نظام الفوترة الوطني.

خطوات فحص فاتورة رُفضت بسبب النسبة

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

1. تحقق من نوع الفاتورة. إن كانت فاتورة دخل فلا حقل نسبة فيها، وانتقل مباشرة إلى فحوص الرقم الضريبي وتسلسل مصدر الدخل وبيانات الربط.
2. افحص ملف XML الذي أُرسل فعلًا. القيمة التي تهم الواجهة هي المكتوبة في الملف قبل ترميزه بصيغة Base64، لا ما يظهر على شاشة البرنامج أو في النسخة المعدة للطباعة.
3. استخرج قيمة cbc:Percent من كل بند. افحص البنود كلها، لا البند الأول وحده، فالفاتورة الواحدة قد تجمع بنودًا بنسب وفئات مختلفة.
4. قارن كل قيمة بالقائمة. القيم الواردة في الصفحة 42 هي 0 و1 و2 و3 و4 و5 و7 و8 و10 و16. وأي قيمة غيرها خارج القائمة، ومنها الكسور العشرية مثل 0.16، والقيم الكسرية الناتجة عن حساب أو تقريب.
5. تحقق من الصيغة. اكتب الرقم وحده كما في أمثلة الدليل، دون رمز النسبة المئوية ودون مسافات أو نص إضافي داخل العنصر.
6. طابق الفئة مع النسبة. الصفر مع Z أو O في الفاتورة المحلية، والصفر مع O في فواتير التصدير والأنواع غير المحلية الأخرى، وباقي القيم مع S.
7. أعد حساب البند والمجاميع. تغيير النسبة يغير قيمة ضريبة السطر وإجماليه، ثم مجموع الضريبة وإجمالي الفاتورة. وإن لم تتطابق المجاميع بعد التصحيح فقد تعود الفاتورة برسالة أخرى، وتفصيلها في مقال رسالة Total General Amount is Not Correct.
8. صحّح المصدر لا الملف وحده. إن جاءت القيمة من إعداد الصنف أو من قاعدة حساب في برنامجك، فصحّح ذلك الإعداد حتى لا تتكرر القيمة نفسها في الفواتير التالية.

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

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

بعد التصحيح: إعادة الإرسال وقراءة النتيجة

الفاتورة التي عاد طلبها برمز 500 دون رمز QR لا تُعد مقبولة، فأعد إرسالها بعد التصحيح. وتنص إرشادات الدليل على إعادة الإرسال برقم الفاتورة ومعرّفها الفريد نفسيهما، وعلى عدم توليد معرّف جديد عند فشل الإرسال أو انقطاع الاتصال.

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

ما لا يذكره الدليل في هذه الحالة

يفيدك أن تعرف حدود النص قبل أن تبني عليه قاعدة في برنامجك. فالدليل التقني (الإصدار 1.5) لا يجيب عن الأسئلة التالية.

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

وإن واجهت حالة لا يحسمها الدليل، فيمكنك التواصل مع لجنة الدعم الفني لشؤون الفوترة في دائرة ضريبة الدخل والمبيعات عبر موقع الدائرة، كما يرد في الصفحة 104.

كيف يساعدك قيود

قيود متكامل مع نظام الفوترة الوطني، ويبني ملف الفاتورة بصيغة UBL 2.1 مع معرّفها الفريد ويرسله دون أي تدخل يدوي. ويفحص قيود كل فاتورة على مستوى الحقول لحظة إنشائها، ويشمل الفحص الرقم الضريبي ونوع المستند وطريقة الدفع ونسبة ضريبة المبيعات العامة واكتمال البنود، وينبهك بأي خطأ قبل إرسالها إلى نظام الفوترة الوطني لتقليل حالات الرفض.

وبعد الإرسال تعيد الدائرة حالة الفاتورة ورسالة الخطأ، ويعرضها قيود في لوحة الحالة. وتظهر في اللوحة الفواتير التي لم تُرسل وتحتاج إلى إعادة إرسال، ويُعاد الإرسال بمعرّف UUID نفسه. ويبقى التحقق من المعاملة الضريبية لكل صنف مسؤوليتك مع محاسبك.

أين تذهب بعد هذا المقال

• بقية أسباب رمز 500: الرقم الضريبي وتسلسل مصدر الدخل وبيانات الربط، في مقال خطأ 500 في نظام الفوترة الوطني.
• خريطة رموز الرفض كلها: في مقال أخطاء نظام الفوترة الوطني.
• الفئات الثلاث بالتفصيل: في مقال فئات الضريبة S وZ وO في نظام الفوترة الوطني.
• الصورة الكاملة للنظام: كيف يعمل وكيف تربط منشأتك به، في مقال نظام الفوترة الوطني الإلكتروني.

الأسئلة الشائعة

ما معنى نسبة ضريبة غير مقبولة في نظام الفوترة الوطني؟

تعني أن قيمة حقل النسبة cbc:Percent في أحد بنود الفاتورة لا ترد ضمن القيم التي يحددها الدليل التقني لهذا الحقل. ويذكر الدليل هذه الحالة سببًا محتملًا لرمز الحالة 500.

ما القيم التي يقبلها حقل النسبة في فاتورة ضريبة المبيعات العامة؟

يوردها الدليل التقني في الصفحة 42 لفواتير البيع الجديدة، وهي 0 و1 و2 و3 و4 و5 و7 و8 و10 و16. وتُكتب رقمًا وحده كما في أمثلة الدليل، مثل 16، دون رمز النسبة المئوية.

هل القيم المقبولة في حقل النسبة هي النسب التي يفرضها القانون؟

ليست كذلك، فهي قائمة تحقق تقنية تحدد ما يقبله الحقل عند الإرسال. أما النسبة التي تنطبق على سلعة أو خدمة بعينها فيحددها قانون الضريبة العامة على المبيعات، ثم يكتبها نظام البائع في الحقل.

هل تؤدي النسبة غير المقبولة دائمًا إلى رمز 500؟

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

ما الفرق بين هذه الحالة ورسالة General tax percentage must be zero؟

تأتي رسالة General tax percentage must be zero مع رمز 400، والنسبة فيها صفر مقبول والخطأ في الفئة S المرافقة له. أما النسبة غير المقبولة فقيمة لا ترد في القائمة أصلًا، ويذكرها الدليل بين أسباب رمز 500.

هل أولّد معرّفًا فريدًا جديدًا عند إعادة الإرسال بعد التصحيح؟

توصي إرشادات الدليل بإعادة الإرسال برقم الفاتورة ومعرّفها الفريد نفسيهما. فالفاتورة المرفوضة لم تُقبل، وتوليد معرّف جديد قد يؤدي إلى تكرارها.

المراجع

• دائرة ضريبة الدخل والمبيعات، الدليل التقني للربط مع نظام الفوترة الوطني من خلال واجهة برمجة التطبيقات (API)، الإصدار 1.5، 2026.