باختصار: UBL 2.1 (Universal Business Language) معيار دولي لكتابة الفاتورة كملف XML منظّم، وعلى أساسه يستقبل نظام الفوترة الوطني كل فاتورة إلكترونية في الأردن.
الشرح الكامل: كاشير مرتبط بالفوترة الوطنية
استخدم الأداة: فحص جاهزية الفوترة الوطنية
UBL اختصار Universal Business Language، أي لغة الأعمال الموحّدة، وهو معيار دولي يحدد كيف تُكتب المستندات التجارية مثل الفاتورة والإشعار الدائن في ملف واحد منظّم. والرقم 2.1 هو إصدار المعيار. أما XML فهو شكل الملف نفسه: نص منظّم بعلامات، لكل معلومة في الفاتورة مكان واسم ثابت، فيقرؤه الحاسوب دون أن يخمّن.
نظام الفوترة الوطني JoFotara يستقبل كل فاتورة إلكترونية ملفاً بصيغة XML مبنياً على UBL 2.1. لهذا يرد الاسمان في الأدلة الفنية للدائرة وفي أسئلة المحاسبين. لكن صاحب المحل لا يرى هذا الملف عادة: برنامج الكاشير أو البوابة يبنيه من بيانات البيع، ويرسله، ويستلم الرد.
ماذا يحمل ملف XML للفاتورة؟
| الجزء | ماذا فيه |
|---|---|
| رأس الفاتورة | رقم الفاتورة، ومعرّفها الفريد UUID، وتاريخ إصدارها، والعملة |
| نوع الفاتورة | رمز 388 للفاتورة و381 للإشعار الدائن، مع رمز يبيّن هل هي نقدية أم ذمم، فاتورة دخل أم ضريبة مبيعات |
| البائع | الرقم الضريبي، والاسم المسجّل لدى الدائرة، وتسلسل مصدر الدخل |
| المشتري | اسمه، ورقمه الضريبي حين يُطلب، أو زبون نقدي في البيع العادي |
| الأسطر | كل صنف بكميته وسعره وخصمه ونسبة ضريبته |
| المجاميع | الضريبة، والإجمالي قبلها وبعدها، والمبلغ المستحق |
بعد استلام الملف يعيد النظام رقم الفاتورة لديه، ورمز QR الذي يُطبع على الإيصال.
من يكتب ملف UBL؟
إذا أصدرت الفاتورة يدوياً من بوابة الفوترة الوطنية، فالبوابة تبني الملف من النموذج الذي تعبّئه. وإذا كان عندك برنامج كاشير أو محاسبة مرتبط بالنظام، فالبرنامج يبني الملف عند كل بيع ويرسله وحده. في الحالتين لا تكتب XML بيدك.
في غلّة يُبنى ملف كل فاتورة من البيع نفسه: الأصناف والكميات والأسعار والضريبة، مع بيانات منشأتك التي كتبتها مرة واحدة عند الربط، ثم يُرسل إلى النظام، ويعود برمز QR يُطبع على الإيصال.
هل أحتاج API لأربط محلّي بالفوترة الوطنية؟
لا، ليس إذا كان برنامج الكاشير الذي تستخدمه مرتبطاً بالنظام. واجهة الربط البرمجية (API) يحتاجها من يبني البرنامج نفسه، لا صاحب المحل. ما تحتاجه أنت هو رقم المستخدم (Client ID) والمفتاح السري (Secret Key) من شاشة ربط الأجهزة في البوابة، تكتبهما في البرنامج مرة واحدة.
لماذا يرفض النظام فاتورة أحياناً؟
- رقم ضريبي أو اسم مسجّل لا يطابق ما في ملفك لدى الدائرة، ولو بحرف.
- تسلسل مصدر دخل خاطئ أو غير موجود في ملفك.
- نوع فاتورة لا يناسب ملفك، مثل فاتورة ضريبة مبيعات من محل غير مسجّل فيها.
- حسابات لا تتطابق بين الأسطر والمجاميع، فالنظام يعيد حساب الضريبة والإجمالي.
كل ما يخص الفوترة الوطنية في صفحة واحدة: دليل نظام الفوترة الوطني.
مثال من محل
سوبرماركت في الشميساني يبيع خمسة أصناف بقيمة 18.450 د.أ شاملة الضريبة. يبني برنامج الكاشير ملف XML فيه خمسة أسطر ونوع الفاتورة ورقم المحل الضريبي وتسلسل مصدر دخله، ويرسله إلى النظام. يعود الرد برقم الفاتورة ورمز QR، فيُطبع الرمز أسفل الإيصال، ولا يرى الكاشير الملف نفسه أبداً.
أسئلة شائعة
هل أحتاج أن أكتب ملف XML بنفسي؟
لا. البوابة تبنيه حين تصدر الفاتورة يدوياً، وبرنامج الكاشير المرتبط يبنيه عند كل بيع. أنت تتعامل مع الفاتورة، لا مع الملف.
هل أحتاج API لأربط محلّي بالفوترة الوطنية؟
لا، إذا كان برنامج الكاشير مرتبطاً بالنظام. الـ API لمن يبني البرنامج. أنت تحتاج رقم المستخدم والمفتاح السري من شاشة ربط الأجهزة في البوابة فقط.
ما الفرق بين ملف XML وفاتورة PDF؟
ملف XML بيانات منظّمة يقرؤها النظام ويتحقق منها، وهو ما يُرسل إلى الفوترة الوطنية. ملف PDF صورة للفاتورة يقرؤها الإنسان، ولا يُعتبر فاتورة إلكترونية وحده.