عداد الفاتورة ICV في نظام الفوترة الوطني: ما هو وأين يقع

يحمل ملف الفاتورة الذي ترسله إلى نظام الفوترة الوطني ثلاث قيم تتشابه أسماؤها، وهي رقم الفاتورة، والمعرّف الفريد، وعداد الفاتورة. هذا المقال عن الثالثة. عداد الفاتورة ICV في نظام الفوترة الوطني قيمة رقمية يضعها نظام البائع في رأس الفاتورة داخل الكتلة cac:AdditionalDocumentReference، إلى جانب عنصر يحمل القيمة الثابتة ICV.

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

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

ما هو عداد الفاتورة ICV في نظام الفوترة الوطني

يرد وصف العداد في جدول معلومات الفاتورة الأساسية في الدليل التقني للربط مع نظام الفوترة الوطني، الإصدار 1.5 (ص13). يسميه الدليل في عمود الوصف المختصر «عداد للفاتورة يتم إنشاؤه من قبل المكلف»، ثم يفصّل ذلك بالنص الآتي.

«عداد يتم إنشاؤه من قبل المكلف للفواتير الإلكترونية يبدأ بشكل تسلسلي من 1 إلى ما لانهاية حسب التعريف العالمي».

في هذا النص أربع معلومات، ولكل منها حدود يحسن أن تعرفها قبل أن تكتب سطرًا من الكود.

1. من ينشئ العداد. المكلف، أي النظام الذي يبني ملف الفاتورة ويرسله. لا يصف الدليل في أي موضع أن نظام الفوترة الوطني يولّد العداد نيابة عن المكلف.
2. لأي فواتير. «للفواتير الإلكترونية» بهذا اللفظ العام. لا يفرّق الوصف بين فاتورة دخل وفاتورة ضريبة مبيعات عامة أو خاصة، ولا يذكر فاتورة الإرجاع بالاسم.
3. من أين يبدأ. من الرقم 1، وهذا منصوص صراحة.
4. كيف يتقدم. «بشكل تسلسلي» و«إلى ما لانهاية»، أي أن الدليل لا يضع للعداد حدًا أعلى.

أما عبارة «حسب التعريف العالمي» فلا يشرحها الدليل، ولا يحيل فيها إلى مرجع بعينه. لذلك لا تحمّلها معنى تقنيًا محددًا لم يرد في النص، ولا تبنِ عليها قاعدة إضافية في نظامك على أنها من متطلبات الدائرة.

أين يقع العداد في ملف الفاتورة

يعرض الدليل (ص12) قالب «معلومات الفاتورة الأساسية»، وفيه تأتي كتلة العداد في رأس الفاتورة بعد عنصري العملة مباشرة. وشكلها في القالب كما يلي.

<cac:AdditionalDocumentReference>
  <cbc:ID>ICV</cbc:ID>
  <cbc:UUID>عداد الفاتورة</cbc:UUID>
</cac:AdditionalDocumentReference>

ولقراءة هذه الكتلة تحتاج إلى مفتاح الألوان الذي يضعه الدليل أعلى القالب. نصه أن «العناصر المظللة باللون الأصفر في الأمثلة أدناه تدل على متغيرات مطلوب تعبئتها (إجبارية) من خلال نظام البائع»، وأن العناصر غير المظللة «وصف ثابت بدون تغيير». وبتطبيق هذا المفتاح على الكتلة تتضح وظيفة كل عنصر فيها.

النتيجة أن ما يتغير بين فاتورة وأخرى في هذه الكتلة قيمة واحدة فقط، وهي الرقم داخل العنصر cbc:UUID. أما اسم الكتلة والقيمة ICV فتنسخهما كما هما في كل فاتورة. وقراءة التظليل في بقية عناصر الملف مشروحة في مقال الحقول الإجبارية والاختيارية في نظام الفوترة الوطني.

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

ويعرض الدليل في مثال فاتورة المبيعات العامة (ص34) الكتلة معبأة، فيضع في العنصر cbc:UUID القيمة 1. هذه القيمة تتسق مع الوصف الذي يجعل بداية العداد من 1، لكنها تبقى قيمة مثال. فلا تنسخها ثابتة في كل فاتورة، لأن الوصف نفسه يقول إن العداد يتقدم تسلسليًا.

عنصر اسمه UUID لا يحمل المعرّف الفريد

أول التباس في هذه الكتلة سببه اسم العنصر. فالعداد يُكتب داخل عنصر اسمه cbc:UUID، وهو الاسم نفسه الذي يحمله المعرّف الفريد للفاتورة. والفرق في الموضع وفي القيمة. المعرّف الفريد عنصر مباشر في رأس الفاتورة، أما العداد فعنصر داخل الكتلة cac:AdditionalDocumentReference. والجدول الآتي يضع القيم المتشابهة في مكان واحد.

ومن هذا الجدول ثلاث ملاحظات.

• العداد خارج المفتاح الأساسي. يجعل الدليل (ص12 وص104) رقم الفاتورة والمعرّف الفريد معًا مفتاحًا أساسيًا يمنع تكرار الفاتورة المرسلة على النظام، ولا يذكر العداد في هذا المفتاح. وتفصيل المفتاح وقاعدة إعادة الإرسال في مقال المعرّف الفريد UUID في نظام الفوترة الوطني.
• لا تضع المعرّف الفريد مكان العداد. يصف الدليل المعرّف الفريد بأنه «رقم مميز UUID (Universal Unique Identifier)» ينشئه نظام المكلف لكل فاتورة، ويصف العداد بأنه رقم يبدأ من 1 ويتقدم تسلسليًا. نقل القيمة من موضع إلى آخر يخالف وصف الدليل في الموضعين.
• رقم البند تسلسلي كذلك، لكن نطاقه مختلف. رقم البند ترتيب لسطور الفاتورة الواحدة ويجب أن يكون فريدًا داخلها، أما العداد فعداد للفواتير. وأثر تكرار رقم البند مشروح في مقال رسالة The ID number must be unique في نظام الفوترة الوطني.

ما يقوله الدليل عن تسلسل العداد وما لا يقوله

كلمة «تسلسلي» تطرح على المطور أسئلة عملية مباشرة. ماذا لو قفز الرقم؟ وماذا لو تكرر؟ وهل يعود إلى 1؟ والجدول الآتي يضع كل سؤال أمام ما يجده في الدليل التقني بإصداره 1.5.

ويؤكد هذا الصمت ما تجده في الإرشادات العشر التي يختم بها الدليل (ص104). فالإرشاد الخامس، وعنوانه «تخزين البيانات الأساسية»، يطلب حفظ رقم الفاتورة والمعرّف الفريد ورمز الاستجابة السريع وحالة الفاتورة، ولا يذكر العداد. ولا يتناول أي إرشاد من الإرشادات العشر العداد بالاسم.

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

فما الذي تفعله أمام هذا الصمت؟ إليك ثلاثة أمور.

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

العداد عند إعادة إرسال الفاتورة

يطلب الدليل في الإرشاد الثالث، «إدارة إعادة الإرسال»، أن تُعاد الفاتورة عند فشل الإرسال برقم الفاتورة والمعرّف الفريد ذاتهما. ويطلب في الإرشاد الثامن، «معالجة الانقطاع»، أن تُعاد المحاولة عند انقطاع الاتصال «دون توليد UUID جديد». ولا يذكر الدليل في الموضعين قيمة العداد.

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

وإذا كانت المحاولة الأولى قد قُبلت وضاع الرد، فإعادة الإرسال برقم الفاتورة ومعرّفها الفريد نفسيهما تعيد الحالة ALREADY_SUBMITTED ومعها رمز الاستجابة السريع الأصلي، بحسب الدليل (ص99). ويربط الدليل هذه الحالة بإرسال رقم الفاتورة ومعرّفها الفريد معًا مرة أخرى، ولا يذكر العداد فيها.

قائمة فحص لعداد الفاتورة قبل الإرسال

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

• الكتلة موجودة في رأس الفاتورة. cac:AdditionalDocumentReference في موضعها من قالب معلومات الفاتورة الأساسية (ص12).
• القيمة ICV ثابتة. العنصر cbc:ID داخل الكتلة يحمل ICV كما هي، لأنه غير مظلل في القالب (ص12).
• العداد في موضعه. العنصر cbc:UUID داخل الكتلة يحمل رقم العداد، لا المعرّف الفريد للفاتورة (ص12 وص13).
• البداية والتقدم. العداد يبدأ من 1 ويتقدم تسلسليًا، وفق وصف الدليل (ص13).
• قيمة المثال ليست ثابتة. القيمة 1 في مثال الدليل (ص34) لا تُنسخ في كل فاتورة.
• العداد محفوظ مع الفاتورة. قيمة العداد محفوظة في سجل الفاتورة مع رقمها ومعرّفها الفريد، وهذا استنتاج عملي لا نص.
• القواعد الإضافية موثقة على أنها تصميم. أي قاعدة تطبقها على الفجوات أو نطاق العداد موثقة داخليًا على أنها قرار في نظامك.

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

كيف يتعامل قيود مع ملف الفاتورة

كل ما سبق عمل يقع على نظام المكلف، أي على البرنامج الذي يبني ملف الفاتورة ويرسله. ويعمل تكامل قيود مع نظام الفوترة الوطني على هذه الطبقة كما يلي.

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

ولصورة أوسع عن النظام وطريقة ربط منشأتك به، اقرأ مقال نظام الفوترة الوطني الالكتروني، أو تعرّف على ما يقدمه قيود في نظام الفوترة الوطني.

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

ما هو عداد الفاتورة ICV في نظام الفوترة الوطني؟

يعرّفه الدليل التقني لدائرة ضريبة الدخل والمبيعات بأنه عداد ينشئه المكلف للفواتير الإلكترونية ويبدأ بشكل تسلسلي من 1. ويُكتب في رأس الفاتورة داخل الكتلة AdditionalDocumentReference، في العنصر UUID بعد العنصر ID الذي يحمل القيمة الثابتة ICV.

هل عداد الفاتورة هو المعرّف الفريد UUID نفسه؟

يختلف العداد عن المعرّف الفريد رغم تشابه اسم العنصر. فالمعرّف الفريد عنصر مباشر في رأس الفاتورة، ويشكّل مع رقم الفاتورة المفتاح الأساسي، أما العداد فيُكتب داخل الكتلة AdditionalDocumentReference وهو رقم تسلسلي يبدأ من 1.

هل حقل عداد الفاتورة إجباري؟

يظلل الدليل التقني قيمة العداد باللون الأصفر في قالب معلومات الفاتورة الأساسية (ص12). واللون الأصفر في مفتاح ألوان الدليل يدل على متغيرات مطلوب تعبئتها (إجبارية) من خلال نظام البائع.

هل تُرفض الفاتورة إذا كان في تسلسل العداد فجوة؟

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

هل يعود عداد الفاتورة إلى 1 مع بداية كل سنة؟

لا يذكر الدليل إعادة بدء العداد، لا مع بداية السنة ولا لكل تسلسل مصدر دخل ولا لكل مستخدم. ونصه أن العداد يبدأ من 1 ويستمر تسلسليًا إلى ما لا نهاية.

هل يعيد نظام الفوترة الوطني قيمة العداد في رده؟

لا يرد العداد بين عناصر الرد التي يشرحها الدليل التقني، ومنها حالة الفاتورة ورمز الاستجابة السريع والمعرّف الفريد. والعداد بحسب الدليل قيمة ينشئها المكلف ويرسلها في ملف الفاتورة.

المراجع

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