تُقرأ الحقول الإجبارية والاختيارية في نظام الفوترة الوطني من التظليل الملوّن في الدليل التقني الصادر عن دائرة ضريبة الدخل والمبيعات. فكل قالب XML في الإصدار 1.5 من الدليل يظلّل بالأصفر المتغيرات التي يجب أن يملأها نظام البائع، ويظلّل بالأخضر المتغيرات الاختيارية، ويترك باقي النص بلا تظليل لأنه وصف ثابت يُنسخ كما هو.
يجمع هذا المقال ما يقوله ذلك التظليل في جدول مرجعي مقسّم بحسب كتل الفاتورة، وهي الترويسة والبائع والمشتري وتسلسل مصدر الدخل والمجاميع والبنود. ثم يعرض الشروط التي تجعل حقلًا يبدو اختياريًا في القالب واجبًا في فاتورة بعينها، وينبّه إلى ما لا يوثقه الدليل أصلًا حتى لا يُقرأ سكوته على أنه إذن.
المقال موجّه لمن يبني ملف الفاتورة أو يراجعه، سواء كان مبرمجًا يربط نظامًا محاسبيًا بنظام الفوترة الوطني أو محاسبًا يريد أن يفهم سبب رفض فاتورة. أما البيانات التي يشترطها التشريع في الفاتورة من حيث المبدأ، بعيدًا عن بنية الملف، فمكانها مقال متطلبات الفاتورة الإلكترونية في الأردن.
تظليل الدليل التقني: الحقول الإجبارية والاختيارية في نظام الفوترة الوطني
يفتتح الدليل التقني قوالبه بمفتاح ألوان يتكرر فوق كل قالب منها، ونصه في الصفحة 12 من الإصدار 1.5 كما يلي.
«العناصر المظللة باللون الأصفر … تدل على متغيرات مطلوب تعبئتها (إجبارية) من خلال نظام البائع. أما العناصر المظللة باللون الأخضر تدل على متغيرات مطلوب تعبئتها (اختيارية) … وباقي العناصر وصف ثابت بدون تغيير».
ويخرج من هذا النص ثلاث فئات لكل ما تراه في أي قالب.
- أصفر متغير إجباري. قيمة تتغير من فاتورة إلى أخرى، ويجب أن يضعها نظام البائع، مثل رقم الفاتورة وتاريخها ومعرّفها الفريد.
- أخضر متغير اختياري. قيمة تتغير من فاتورة إلى أخرى، وتعبئتها متروكة للبائع ما لم يجعلها شرط آخر واجبة في فاتورة بعينها.
- ثابت وصف ثابت. أسماء العناصر نفسها وقيم حرفية مثل
ICVوJOوVAT، تُنسخ دون تغيير.
والتظليل هو الإشارة الوحيدة في الإصدار 1.5 إلى ما هو إجباري وما هو اختياري. لذلك إن احتجت إلى الاستشهاد بحكم حقل في مراسلة أو مواصفة فنية، فاكتب «حسب تظليل الحقول في الدليل التقني 1.5»، ولا تنسب الحكم إلى مصدر آخر.
وفي النص ملاحظة تستحق الانتباه. فالدليل يجمع في وصف المتغيرات الخضراء بين عبارة «مطلوب تعبئتها» ووصفها بأنها اختيارية، ولا يشرح كيف يُعامل العنصر الأخضر حين لا تملك قيمته، أيُحذف من الملف أم يُرسل فارغًا. فإن واجهت هذه الحالة فاحسمها مع مزوّد برنامجك أو مع الدعم الفني للدائرة، لا بالاستنتاج.
العناصر الخمسة المظللة بالأخضر
يظلّل الدليل بالأخضر خمسة عناصر في قوالبه كلها. واحد منها في الترويسة، وأربعة في كتلة المشتري.
مرِّر الجدول أفقيًا لعرض بقية الأعمدة
أربعة من الخمسة في كتلة المشتري، وهي الكتلة التي يتغير فيها حكم الحقل بحسب نوع الفاتورة وقيمتها، كما يأتي في قسم الشروط.
واختيارية هذه العناصر لا تعني أن قيمها بلا قيود. فإن أرسلت الرمز البريدي وجب ألا يتجاوز 5 خانات، وإلا عاد الرد برسالة Postal code length is incorrect. وإن أرسلت رقم الهاتف فبالأرقام وحدها، بين 9 أرقام و14 رقمًا.
جدول مرجعي للحقول حسب كتل الفاتورة
تجمع الجداول التالية أبرز عناصر كل كتلة وحكمها، لا جميعها. والحكم في كل جدول منقول من تظليل قوالب الدليل نفسها، وهي قالب فاتورة الدخل (ص12 إلى ص20) وقالب فاتورة ضريبة المبيعات العامة (ص33 إلى ص42). ففي كتل البائع والمجاميع والبنود يظلل الدليل كل متغير بالأصفر، ومنها عناصر لا تظهر في الجداول، مثل فئة الضريبة ونسبتها في بنود فاتورة ضريبة المبيعات العامة.
ولا تنسخ أمثلة XML من الدليل حرفيًا على أنها ملفات صالحة، ففي بعضها عيوب مثبتة، منها معرّفات فريدة بصيغة غير صحيحة، وعلامات تنصيص مكررة في أمثلة الضريبة الخاصة. استعمل القوالب لفهم البنية، وابنِ القيم من بياناتك.
الترويسة (معلومات الفاتورة الأساسية)
يسبق عناصر الترويسة سطر التعريف بالملف، ثم العنصر cbc:ProfileID بالقيمة reporting:1.0 في كل فاتورة. ويجب أن يأتي وسم Invoice الافتتاحي بكامله في سطر واحد، وإلا عاد الخطأ Invalid Invoice Minification.
مرِّر الجدول أفقيًا لعرض بقية الأعمدة
البائع
مرِّر الجدول أفقيًا لعرض بقية الأعمدة
المشتري
مرِّر الجدول أفقيًا لعرض بقية الأعمدة
وتفصيل حقول المشتري بحسب نوع الفاتورة وطريقة الدفع في مقال الفاتورة النقدية وفاتورة الذمم في نظام الفوترة الوطني.
تسلسل مصدر الدخل للبائع
مرِّر الجدول أفقيًا لعرض بقية الأعمدة
يختار المكلف تسلسل مصدر الدخل بنفسه عند إنشاء بيانات الربط من خيار «ربط الأجهزة»، ويرتبط كل زوج من رقم المستخدم والمفتاح السري بتسلسل واحد. والخطأ في هذه القيمة في مقدمة ما يذكره الدليل من أسباب الرمز 500، وطريقة فحصه في مقال خطأ 500 في نظام الفوترة الوطني.
المجاميع
أما معادلات المجاميع، والرسالة التي تعود حين لا تتطابق، فيشرحها مقال مستقل عن رسالة Total General Amount is Not Correct. والمهم هنا أن الخصم على مستوى الفاتورة ليس حقلًا حرًا، فإن خصمت من الفاتورة كلها وجب أن يوزّع برنامجك الخصم على البنود قبل الإرسال.
البنود
مرِّر الجدول أفقيًا لعرض بقية الأعمدة
الشروط التي تغيّر حكم الحقل
التظليل يصف القالب، لكن بعض القواعد في الدليل تجعل قيمة حقل واجبة في فاتورة دون أخرى، أو تحذف كتلة كاملة من نوع معيّن. هذه هي القواعد الموثقة.
اسم المشتري
عنصر اسم المشتري cbc:RegistrationName مظلل بالأصفر في القوالب كلها، أما وجوب قيمته فمشروط. يوجبها الدليل التقني في حالتين، أن تكون الفاتورة ذممًا، أو أن تكون نقدية وتزيد قيمتها على 10,000 دينار أو ما يعادلها بالعملات الأجنبية. وغيابها في هاتين الحالتين يعيد الرسالة Bayer name is missing بهذا الرسم كما وردت في الدليل.
ويشترط نظام تنظيم شؤون الفوترة والرقابة عليها في المادة (5/ب) ذكر اسم المشتري بوضوح في البيع الآجل والبيع بالتقسيط والبيع على دفعات.
الرقم الضريبي للمشتري
قيمة معرّف المشتري مظللة بالأخضر في القالب، لكن الدليل يجعل الرقم الضريبي للمشتري إجباريًا حين تكون الفاتورة من نوع المناطق التنموية، ويُرسل بنوع المعرّف TN. فالحقل الاختياري في القالب يصبح هنا شرطًا لقبول هذا النوع من الفواتير.
فاتورة الدخل
لا تحمل فاتورة الدخل كتلة TaxTotal على مستوى البند ولا على مستوى الفاتورة. فبنودها كمية وسعر وخصم واسم فقط، ومن يقرأ قالب فاتورة ضريبة المبيعات العامة ثم يطبقه على فاتورة دخل سيضيف كتلة لا مكان لها.
فاتورة الإرجاع
تضيف فاتورة الإرجاع مرجعًا إلى الفاتورة الأصلية يحمل رقمها ومعرّفها الفريد وإجماليها، وسبب إرجاع إجباريًا يُكتب نصًا حرًا. ويجب أن تتوافق بيانات المشتري فيها مع بياناته في الفاتورة الأصلية. ولا تحمل ترويسة الإرجاع العنصر cbc:Note في فاتورتي ضريبة المبيعات العامة والضريبة الخاصة، بينما تبقيه فاتورة إرجاع الدخل اختياريًا.
سعر المستهلك
العنصر cac:ItemPriceExtension لا يرد إلا عند من مُنح صلاحية سعر المستهلك بطلب إلى الدائرة، وهي متاحة للمسجلين في الضريبة العامة على المبيعات أو الضريبة الخاصة فقط. وإذا استُعمل فإنه يُطبق على بنود الفاتورة كلها، ويجب ألا يقل عن سعر الوحدة.
ما لا يوثقه الدليل، فلا تعدّه اختياريًا
الحقل الاختياري هو ما ظلله الدليل بالأخضر. أما ما لم يرد في القوالب أصلًا فحكمه غير موثق، والفرق بين الحالتين يغيّر طريقة بناء الملف. ومن الحالات التي يسكت عنها الدليل هذه الخمس.
- عناصر عنوان المشتري الأخرى. يعرّف معيار UBL 2.1 عناصر للشارع والمدينة ورقم المبنى، لكن قالب المشتري في الدليل لا يورد للعنوان إلا الرمز البريدي ورمز المحافظة. فهذه العناصر غير موثقة في الدليل، ولا يصح وصفها بأنها اختيارية ولا بأنها إجبارية.
- معاملة العنصر الأخضر الفارغ. لا يحدد الدليل هل يُحذف العنصر الأخضر حين لا قيمة له أم يُرسل فارغًا.
- رموز الوحدات. تظهر الوحدة
PCEوحدها في بنود الفواتير الجديدة، ولا يورد الدليل قائمة بغيرها ولا قاعدة لقبولها أو رفضها. - قيمة سمة العملة على المبالغ. تستخدم أمثلة الدليل القيمة
JOفي السمةcurrencyIDعلى كل مبلغ، ولا يوضح الدليل هل تُقبل قيمة غيرها. - سعر الصرف. لا يحتوي الدليل عنصرًا لسعر الصرف ولا قاعدة لتحويل فاتورة بعملة أجنبية إلى الدينار.
والقاعدة في كل ما سبق واحدة. سكوت الدليل عن عنصر ليس إذنًا بإرساله ولا بحذفه، فارجع فيه إلى الدعم الفني للدائرة أو إلى مزوّد برنامجك قبل أن تبني عليه.
أربعة أخطاء في قراءة التظليل
- حذف عنصر اسم المشتري لأن قيمته قد لا تجب. العنصر أصفر في القوالب كلها، والذي يتغير من فاتورة إلى أخرى هو وجوب قيمته بحسب طريقة الدفع والمبلغ.
- ترك معرّف المشتري فارغًا في فاتورة مناطق تنموية. اللون الأخضر في القالب لا يلغي شرط الرقم الضريبي للمشتري في هذا النوع.
- تعديل وصف ثابت. القيم غير المظللة، مثل
ICVوVATوreporting:1.0، تُنسخ كما هي، وتقسيم وسمInvoiceالافتتاحي على أكثر من سطر يعيد خطأ. - قراءة سكوت الدليل على أنه اختيار. العنصر الذي لا يظهر في القالب غير موثق، وليس أخضر.
وإن رُفضت فاتورة بسبب حقل ناقص أو قيمة خارج القيود، فرسائل الرمز 400 وطريقة قراءتها في مقال أخطاء نظام الفوترة الوطني.
كيف يتعامل قيود مع حقول الفاتورة
حين تُصدر الفاتورة من برنامج محاسبي مربوط بالنظام، لا تكتب ملف XML بيدك ولا تراجع تظليل حقوله. يبني قيود ملف الفاتورة بصيغة UBL 2.1 مع معرّفها الفريد، ويرسله إلى نظام الفوترة الوطني دون أي تدخل يدوي، عبر تكامل قيود مع نظام الفوترة الوطني.
- فحص قبل الإرسال. يفحص قيود كل فاتورة على مستوى الحقول لحظة إنشائها، وهي الرقم الضريبي، ونوع المستند وطريقة الدفع، ونسبة ضريبة المبيعات العامة، واكتمال البنود، وينبهك بأي خطأ قبل إرسالها لتقليل حالات الرفض.
- حالة كل فاتورة أمامك. تعيد الدائرة حالة الفاتورة ورسالة الخطأ، ويعرضها قيود في لوحة الحالة.
- إعادة إرسال بالمعرّف نفسه. تعرض لوحة الحالة الفواتير التي لم تُرسل وتحتاج إلى إعادة إرسال، وتُعاد بمعرّف UUID نفسه فلا تتكرر.
والفحص المسبق تنبيه لا ضمان. فهو يغطي الحقول الأربعة المذكورة، ويبقى قبول الفاتورة قرارًا لنظام الفوترة الوطني وحده. وللصورة الكاملة عن النظام وطريقة ربط منشأتك به، اقرأ مقال نظام الفوترة الوطني الإلكتروني في الأردن، أو تصفح مركز نظام الفوترة الوطني في الأردن، أو تعرّف على قيود ونظام الفوترة الوطني.
فوترة إلكترونية ومحاسبة متكاملة في نظام واحد
قيود متكامل مع نظام الفوترة الوطني (JoFotara). تُصدر فاتورتك بالدينار الأردني من قيود فتُقيَّد في دفاترك تلقائيًا وتُرسل إلى النظام، وبعد قبولها يعود عليها رمز QR من دائرة ضريبة الدخل والمبيعات.
الأسئلة الشائعة
ما الحقول الإجبارية والاختيارية في نظام الفوترة الوطني؟
يحددها تظليل الدليل التقني 1.5. فالأصفر متغير إجباري، والأخضر متغير اختياري، وغير المظلل وصف ثابت. والعناصر الخضراء خمسة، هي الملاحظة في الترويسة، وقيمة معرّف المشتري، والرمز البريدي، ورمز المحافظة، ورقم الهاتف.
هل اسم المشتري حقل اختياري؟
يظلّل الدليل عنصر اسم المشتري بالأصفر في القوالب كلها. وتجب قيمته في فاتورة الذمم، وفي الفاتورة النقدية التي تزيد قيمتها على 10,000 دينار أو ما يعادلها بالعملات الأجنبية.
متى يصبح الرقم الضريبي للمشتري إجباريًا؟
يصبح إجباريًا حين تكون الفاتورة من نوع المناطق التنموية، مع أن قيمة معرّف المشتري مظللة بالأخضر في القالب.
هل عناصر عنوان المشتري الأخرى اختيارية؟
يوثق الدليل عنصرين لعنوان المشتري، هما الرمز البريدي ورمز المحافظة، وكلاهما اختياري. أما الشارع والمدينة ورقم المبنى فلا تظهر في القالب، فحكمها غير موثق وليست اختيارية.
هل تحمل فاتورة الدخل حقول الضريبة؟
تخلو فاتورة الدخل من كتلة TaxTotal على مستوى البند وعلى مستوى الفاتورة. فبنودها كمية وسعر وخصم واسم فقط.
هل أنسخ أمثلة XML من الدليل كما هي؟
تحتوي بعض أمثلة الدليل على عيوب، منها معرّفات فريدة بصيغة غير صحيحة وعلامات تنصيص مكررة، فلا تُعامل على أنها ملفات صالحة. استعملها لفهم البنية، وابنِ القيم من بيانات فاتورتك.
المراجع
- دائرة ضريبة الدخل والمبيعات، الدليل التقني للربط مع نظام الفوترة الوطني من خلال واجهة برمجة التطبيقات (API)، الإصدار 1.5، 2026.
- نظام تنظيم شؤون الفوترة والرقابة عليها رقم (34) لسنة 2019 وتعديلاته، النسخة الموحدة 2023.
