رقم المستخدم والمفتاح السري في نظام الفوترة الوطني قيمتان يولّدهما النظام لك من شاشة «ربط الأجهزة». بهما يرسل برنامجك المحاسبي فواتيرك إلى دائرة ضريبة الدخل والمبيعات باسمك. ويسميهما الدليل التقني للربط Client ID وSecret Key، أما الواجهة فتعرضهما بالاسمين العربيين.
باختصار، تدخل إلى نظام الفوترة الوطني بالمستخدم الرئيسي، وتختار «ربط الأجهزة»، ثم تنشئ ربطًا جديدًا تحدد فيه اسم مستخدم وتسلسل مصدر الدخل. بعدها يولّد النظام القيمتين تلقائيًا.
يقف هذا الدليل عند اللحظة التي تخرج فيها القيمتان من بوابة الدائرة. فيشرح مكان الشاشة، وخطوات الإنشاء، والأثر الذي يترتب على الربط، وأين تجد القيمتين لاحقًا، وكيف تحميهما. أما إدخالهما في برنامجك وتشغيل الإرسال فلهما دليل مستقل نشير إليه في آخر المقال.
ما رقم المستخدم والمفتاح السري في نظام الفوترة الوطني
يعتمد الدليل التقني للربط في إصداره 1.5 على هاتين القيمتين في المصادقة على الفواتير التي يرسلها نظام محاسبي مربوط. ولا يطلب من المكلف شهادة رقمية ولا توقيعًا إلكترونيًا من طرفه.
وثلاث حقائق عنهما تحسم أغلب الأسئلة:
- يولّدهما النظام ولا تختارهما أنت. دورك في الشاشة أن تكتب اسم مستخدم وتختار تسلسل مصدر الدخل، ثم ينشئ النظام القيمتين.
- يرتبط كل زوج منهما بتسلسل مصدر دخل واحد، وهو التسلسل الذي اخترته عند إنشاء الربط.
- ينشئهما المستخدم الرئيسي. فخيار «ربط الأجهزة» من أيقونات شاشته الرئيسية، ولا يظهر على شاشة المستخدم الفرعي التي تقتصر على «تنظيم فاتورة» و«عرض الفواتير».
ما تحتاجه قبل فتح شاشة ربط الأجهزة
شاشة ربط الأجهزة آخر محطة في مرحلة البوابة، لا أولها. وقبل أن تصل إليها تحتاج ثلاثة أمور:
- حساب على نظام الفوترة الوطني. يُنشأ من الخدمات الإلكترونية للدائرة، وتفاصيله في دليل التسجيل في النظام واستخراج وثيقة التسجيل.
- بيانات دخول المستخدم الرئيسي. تدخل بها عبر ثلاثة حقول: الرقم الضريبي، واسم المستخدم، وكلمة المرور.
- تسلسل مصدر دخل فعال. يذكر دليل الأسئلة والأجوبة الصادر عن الدائرة غيابه سببًا لتعثر الدخول إلى التسجيل أصلًا. والحل الرسمي طلب خدمة داخلية من نوع «فتح مصدر دخل ومجموعة جديدة».
وأمر رابع ليس شرطًا تقنيًا لكنه أهم من الثلاثة، وهو أن تكون قد قررت إصدار فواتيرك من برنامج محاسبي لا من البوابة. وسبب ذلك مشروح في القسم الخاص بأثر الربط أدناه.
أين توجد شاشة ربط الأجهزة
تصل إلى نظام الفوترة الوطني من موقع دائرة ضريبة الدخل والمبيعات، عبر «الدخول للخدمات الإلكترونية» ثم «الفوترة الوطني» من شريط الخدمات. وبعد الدخول بالمستخدم الرئيسي تظهر الشاشة الرئيسية بأربع أيقونات هي «إضافة مستخدم فرعي» و«ربط الأجهزة» و«عرض الفواتير» و«إعدادات».
ولا توجد على هذه الشاشة أيقونة «تنظيم فاتورة». فالمستخدم الرئيسي يدير الحساب، والإصدار من البوابة يجري من المستخدم الفرعي، والإصدار من برنامج محاسبي يمر عبر «ربط الأجهزة».
خطوات إنشاء رقم المستخدم والمفتاح السري
الخطوات كما يعرضها الدليل التقني للربط في صفحاته 6 إلى 8:
- ادخل إلى نظام الفوترة الوطني بالمستخدم الرئيسي من الخدمات الإلكترونية للدائرة.
- اختر «ربط الأجهزة» من الشاشة الرئيسية.
- اضغط «ربط جديد»، فتظهر نافذة «إضافة مستخدم».
- اكتب اسم مستخدم للربط، واختر تسلسل مصدر الدخل من القائمة المنسدلة، ثم اضغط «إضافة».
- يولّد النظام رقم المستخدم والمفتاح السري تلقائيًا، ويظهر الربط الجديد في قائمة ربط الأجهزة.
وهذه تسميات الواجهة كما تظهر في لقطات الدليل التقني، وقد تتغير مع تحديث البوابة. والثابت في الأدلة الرسمية كلها أن المسار يبدأ من «ربط الأجهزة» وينتهي بتوليد القيمتين، ثم تأتي المتطلبات الفنية للربط.
ويظهر اسم المستخدم الذي تكتبه في النافذة في عمود «المستخدم» بقائمة ربط الأجهزة. فاختر اسمًا يميّز الربط ويدل على البرنامج أو الفرع الذي سيستعمله.
تسلسل مصدر الدخل: تختاره أنت ولا يولّده النظام
أكثر خطأ يتكرر في شرح هذه الشاشة أن يُقال إن النظام يولّد ثلاث قيم. والصحيح أن النظام يولّد قيمتين فقط، أما تسلسل مصدر الدخل فتختاره أنت من قائمة التسلسلات المسجلة على رقمك الضريبي.
ويستحق هذا الاختيار انتباهًا لسببين:
- التسلسل عنصر إلزامي في كل فاتورة يرسلها برنامجك عبر الواجهة البرمجية، بحسب الدليل التقني للربط.
- الخطأ فيه أول ما يذكره الدليل التقني من أسباب الخطأ 500، إلى جانب الخطأ في الرقم الضريبي.
فإن كان لمنشأتك أكثر من تسلسل مصدر دخل، فتذكّر أن كل زوج من رقم المستخدم والمفتاح السري مقيد بالتسلسل الذي أنشأته عليه. ويجب أن يطابق التسلسل الذي يرسله برنامجك في الفاتورة تسلسل الربط الذي يرسل به.
قبل الضغط على «إضافة»: الربط يوقف تنظيم الفواتير من البوابة
هذا القسم هو سبب التنبيه الوارد أعلاه. فالربط ليس خطوة تفتحها لتنظر ثم تغلقها، لأن له أثرًا في طريقة إصدارك للفواتير.
ما تقوله الدائرة. يذكر دليل الأسئلة والأجوبة حالة لا يظهر فيها خيار «تنظيم فاتورة» لدى المستخدم الفرعي. وسببها الرسمي أن المكلف نقر على خيار «ربط الأجهزة». أي أن الربط يُسقط خيار تنظيم الفواتير من البوابة.
ما تقوله واجهة المنصة. يعرض دليل المستخدم الصادر عام 2024 للمنصة رسالة تأكيد قبل إتمام الربط. ونصها «لن يتمكن المكلف من تنظيم الفواتير باستخدام المنصة اذا قام بالربط مع الاجهزة». وهذا الدليل أعدّته جهة تقنية، وليس من أدلة الدائرة الرسمية، وقد تختلف الواجهة الحالية عنه. لكن الأثر الذي يصفه تؤكده الدائرة في دليل الأسئلة والأجوبة كما سبق.
فك الربط ليس إعدادًا ذاتيًا. لا يوجد زر تعيد به الوضع السابق. يجري فك الربط بطلب خدمة داخلية من نوع «طلب دعم فني لنظام الفوترة»، والقرار فيه للدائرة. وتقصره الدائرة على من ليس لديه نظام محاسبي وربط عن طريق الخطأ، ويتعهد مقدم الطلب كتابيًا بعدم وجود نظام محاسبي لديه.
وتضيف الدائرة في الدليل نفسه: «اما من يمتلك نظام محاسبي يلزمه ربط نظامه مع نظام الفوترة». وإن كنت تسأل هل يلزمك الربط أصلًا، فالجواب مفصّل في مقال هل ربط البرنامج المحاسبي إلزامي.
وفي الدليل نفسه ما يطمئن من أصدر فواتير من البوابة قبل الربط. فالمنصة تتيح إرجاع الفواتير المرسلة عبرها في جميع الحالات، سواء تم الربط أم لا.
ولا يحدد دليل الأسئلة والأجوبة نطاق هذا الأثر حين تتعدد تسلسلات مصدر الدخل في المنشأة الواحدة. فإن كان لديك أكثر من تسلسل وتريد ربط بعضها فقط، فاستوضح الأمر من الدائرة قبل الضغط على «إضافة».
أين تجد رقم المستخدم والمفتاح السري بعد إنشائهما
لا تختفي القيمتان بعد توليدهما. تعرض قائمة ربط الأجهزة كل ربط في صف مستقل، بأعمدة هي المستخدم، وحالة المستخدم، ورقم المستخدم، والمفتاح السري، وتسلسل مصدر الدخل. وبجانب كل من القيمتين زر نسخ، وفوق القائمة زر «ربط جديد» لإضافة ربط آخر.
وثلاث ملاحظات على هذه القائمة:
- انسخ القيمتين بزر النسخ لا يدويًا. فالكتابة اليدوية تفتح الباب لحرف ناقص أو مسافة زائدة، وهذا كافٍ لرفض المصادقة.
- عمود «حالة المستخدم» فيه مفتاح تشغيل وإيقاف، لكن الدليل التقني لا يشرح أثره. فلا تبنِ عليه افتراضًا، واسأل الدائرة قبل تغييره على ربط يعمل.
- لا يصف الدليل التقني في إصداره 1.5 إجراءً لإعادة توليد القيمتين. فإن احتجت ذلك، فالمرجع لجنة الدعم الفني لشؤون الفوترة في الدائرة.
كيف تحفظ القيمتين وتحميهما
تضع الأدلة الرسمية مسؤولية القيمتين على المكلف وحده. يقول دليل إجراءات الانضمام: «تأكد من حفظ بيانات الربط في مكان آمن وعدم مشاركتها مع أحد». ويضيف الدليل التقني للربط أن المكلف «يتحمّل كامل المسؤولية عن أي استخدام غير مصرح به».
ومن الإرشادات العشر في الدليل التقني إرشاد بعنوان «الأمان»، مضمونه حماية رقم المستخدم والمفتاح السري وعدم تخزينهما مكشوفين داخل الشيفرة البرمجية. ومن هذا المبدأ تتفرع ممارسات عملية:
- شاركهما مع من سيدخلهما في البرنامج فقط، كالمحاسب أو المزود التقني الذي تتعامل معه.
- لا ترسلهما في صورة شاشة أو رسالة دردشة تبقى محفوظة على أجهزة متعددة.
- اطمس القيمتين في أي لقطة شاشة تشاركها لطلب مساعدة، كما في الصورة أعلاه.
- احصر الدخول بالمستخدم الرئيسي في أضيق نطاق، لأن قائمة ربط الأجهزة تعرض القيمتين لكل من يدخل به.
ماذا يحدث إذا أُدخلت القيمتان خطأ
يربط الدليل التقني للربط الخطأ 403 (Forbidden) بخطأ في رقم المستخدم أو المفتاح السري. أي أن البرنامج وصل إلى النظام لكن النظام رفض المصادقة عليه. وتجد هذا الخطأ وغيره من رموز أخطاء الإرسال وأسبابها في دليل مستقل.
ويذكر الدليل التقني القيمتين كذلك ضمن أسباب الخطأ 500، لكن بدرجة أقل من الرقم الضريبي وتسلسل مصدر الدخل. فإذا ظهر لك أحد الخطأين بعد الربط مباشرة، فابدأ المراجعة من ثلاثة أمور:
- نسخ القيمتين من القائمة بزر النسخ لا بالكتابة اليدوية.
- أخذ القيمتين من الصف الصحيح إن كان لديك أكثر من ربط.
- تطابق تسلسل مصدر الدخل في الفاتورة مع تسلسل الربط.
بعد توليد القيمتين: أين يبدأ العمل الفني
بتوليد رقم المستخدم والمفتاح السري ينتهي ما تفعله على بوابة الدائرة في هذه المرحلة. وتقول الدائرة إنه «يتوجب على المكلف التنسيق مع مبرمج النظام أو مزود الحلول التقنية المعتمد لديه لاستكمال المتطلبات الفنية». والمقصود هنا المزود الذي يتعامل معه المكلف نفسه، لا قائمة مزودين تعتمدها الدائرة.
ما يلي ذلك من إدخال القيمتين في البرنامج وإرسال أول فاتورة مشروح في خطوات الربط التقني خطوة بخطوة. ولفهم موقع هذه المرحلة من النظام كله، راجع شرح نظام الفوترة الوطني الإلكتروني في الأردن وطريقة عمله.
وإن كان برنامجك هو برنامج قيود المحاسبي المتكامل مع نظام الفوترة الوطني، فالقيمتان هما ما يحتاجه منك من هذه الشاشة. بعدها يبني قيود ملف الفاتورة بمعيار UBL 2.1 مع معرّفها الفريد، ويرسله دون تدخل يدوي. ثم يطبع على الفاتورة رمز الاستجابة السريعة الذي تعيده الدائرة.
فوترة إلكترونية ومحاسبة متكاملة في نظام واحد
قيود متكامل مع نظام الفوترة الوطني (JoFotara). تُصدر فاتورتك بالدينار الأردني من قيود فتُقيَّد في دفاترك تلقائيًا وتُرسل إلى النظام، وبعد قبولها يعود عليها رمز QR من دائرة ضريبة الدخل والمبيعات.
الأسئلة الشائعة
ما رقم المستخدم والمفتاح السري في نظام الفوترة الوطني؟
هما قيمتان يولّدهما النظام من شاشة «ربط الأجهزة»، ويسميهما الدليل التقني Client ID وSecret Key. يستعملهما البرنامج المحاسبي المربوط للمصادقة عند إرسال الفواتير إلى دائرة ضريبة الدخل والمبيعات.
من يستطيع إنشاء رقم المستخدم والمفتاح السري؟
ينشئهما المستخدم الرئيسي، لأن خيار «ربط الأجهزة» من أيقونات شاشته الرئيسية. أما شاشة المستخدم الفرعي فتقتصر على «تنظيم فاتورة» و«عرض الفواتير».
هل يولّد النظام تسلسل مصدر الدخل مع القيمتين؟
لا. تختار أنت تسلسل مصدر الدخل من قائمة في نافذة الربط، ويولّد النظام رقم المستخدم والمفتاح السري فقط. ويرتبط كل زوج من القيمتين بالتسلسل الذي اخترته.
هل أستطيع العودة إلى تنظيم الفواتير من البوابة بعد الربط؟
لا يكون ذلك بإعداد ذاتي، ففك الربط طلب دعم فني يقدَّم إلى الدائرة عبر الخدمات الداخلية. وتقصره الدائرة على من ليس لديه نظام محاسبي وربط عن طريق الخطأ.
أين أجد القيمتين إذا لم أحفظهما؟
تجدهما في قائمة ربط الأجهزة لدى المستخدم الرئيسي، إذ يظهر كل ربط في صف يتضمن رقم المستخدم والمفتاح السري، وبجانب كل منهما زر نسخ.
ما الخطأ الذي يظهر إذا كان المفتاح السري خطأ؟
يربط الدليل التقني للربط الخطأ 403 بخطأ في رقم المستخدم أو المفتاح السري. ويذكرهما كذلك ضمن أسباب الخطأ 500، لكن بدرجة أقل من الرقم الضريبي وتسلسل مصدر الدخل.
