English

كيف تحصل على بيانات الربط مع نظام الفوترة الوطني (Client ID و Secret Key)

بقلم CS-Aspirations · آخر تحديث

شرح مركّز لشاشة ربط الأجهزة في نظام الفوترة الوطني: ما تحتاجه قبل البدء، كيف تولّد رقم المستخدم والمفتاح السري، أي تسلسل مصدر دخل تختار، وماذا تعني أخطاء الربط الشائعة.

حتى يرسل برنامجك الفواتير إلى نظام الفوترة الوطني (جو فوترة)، يجب أن يعرف النظام من المرسِل. وهذه الهوية قيمتان تولّدهما أنت من بوابة JoFotara: رقم المستخدم (Client ID) والمفتاح السري (Secret Key)، ومعهما تسلسل مصدر الدخل. هذه القيم الثلاث هي كل ما يحتاجه برنامج المحاسبة أو الكاشير ليبدأ الربط. هذا الدليل مخصّص لهذه الخطوة وحدها، وبتفصيل أكثر من دليل الفوترة الإلكترونية الكامل: ماذا تجهّز، أي شاشة تفتح، أي اختيار يفرق، وكيف تقرأ الأخطاء التي قد تظهر لك في أول يوم. وإذا أردت أن ترى أين توضع هذه القيم داخل نظام ERP، فصفحة ربط نظام الفوترة الوطني في Aspirations تعرض شاشة الإعدادات.

قبل أن تبدأ: ثلاثة متطلبات

  1. رقم ضريبي فعّال ومسجّل على الخدمات الإلكترونية للدائرة. يذكر دليل المستخدم المنشور على portal.jofotara.gov.jo أن على المكلف أن يحمل رقماً ضريبياً فعالاً وأن يكون مسجلاً على بوابة الخدمات الإلكترونية لدائرة ضريبة الدخل والمبيعات قبل الدخول إلى نظام الفوترة.
  2. حساب على نظام الفوترة. من الخدمات الإلكترونية للدائرة تضغط رابط "الفوترة الوطني"، وتنشئ المستخدم الرئيسي (Admin) لنظام الفوترة باسم مستخدم وكلمة مرور. بعدها تدخل على portal.jofotara.gov.jo بثلاث قيم: الرقم الضريبي واسم المستخدم وكلمة المرور.
  3. المستخدم الرئيسي. حسب دليل المستخدم، ربط الأجهزة يتم من حساب الـ Admin. أما المستخدمون الفرعيون الذين ينشئهم الـ Admin لكل تسلسل مصدر دخل أو فرع، فيصدرون الفواتير على البوابة ولا يربطون البرامج.

وإذا لم تكن منشأتك قد انضمّت للنظام بعد، فالدليل التقني للدائرة يحيلك أولاً إلى دليل إجراءات الانضمام المنشور على istd.gov.jo. لا يمكن توليد بيانات ربط لحساب غير موجود.

خطوة بخطوة: توليد رقم المستخدم والمفتاح السري

دليل إجراءات الربط والدليل التقني للربط مع نظام الفوترة الوطني (الإصدار 1.5 المنشور في 2026) يصفان المسار القصير نفسه:

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

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

اختيار تسلسل مصدر الدخل الصحيح

تسلسل مصدر الدخل يحدّد النشاط الذي تتبع له الفواتير، ويُرسل داخل كل فاتورة يرسلها برنامجك، وهو الاختيار الذي يسبّب أغلب مشاكل البداية. ثلاث قواعد تساعدك:

  • نشاط واحد، تسلسل واحد. إذا كان لرقمك الضريبي أكثر من تسلسل مصدر دخل، فولّد ربطاً مستقلاً لكل نشاط سيرسل فواتير، وتأكّد أن فواتير كل نشاط تخرج على تسلسله.
  • طابِق نوع الفاتورة. النشاط المسجّل في الضريبة العامة على المبيعات يرسل فواتير مبيعات، وغير المسجّل يرسل فواتير دخل بلا أسطر ضريبة. ويذكر الدليل التقني رسالة "This user is not authorized to submit this type of invoice" كخطأ يظهر عندما لا يتطابق الاثنان.
  • الرقم الضريبي المستقل له حساب مستقل. الفرع أو الشركة المسجّلة برقم ضريبي خاص تدخل برقمها وتولّد بيانات ربط خاصة بها، وبيانات رقم ضريبي لا ترسل فواتير لرقم آخر.

ماذا يفعل برنامجك ببيانات الربط؟

حسب الدليل التقني، كل إرسال يتكوّن من ثلاثة مكوّنات: رقم المستخدم والمفتاح السري والفاتورة نفسها بصيغة XML حسب معيار UBL 2.1. تُرمَّز الفاتورة وتُرسل إلى عنوان استقبال الفواتير في JoFotara، وتنتقل القيمتان في ترويسة الطلب باسمي Client-Id وSecret-Key. لا تحتاج أن تلصقهما في أي مكان آخر. وإذا طلب منك مزوّد برنامج أن ترسل له صورة الجدول على الإيميل، فهو يطلب أكثر من حاجته: يكفي أن تُدخل القيم مرة واحدة في الإعدادات، والأفضل أن تُدخلها أنت.

كيف تحمي بيانات الربط؟

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

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

اختبار الاتصال وقراءة الأخطاء

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

الاستجابةمعناها غالباً
403 Forbiddenرقم المستخدم أو المفتاح السري خطأ
500 Internal Server Errorغالباً خطأ في الرقم الضريبي أو تسلسل مصدر الدخل، وأقل من ذلك في بيانات الربط، أو نسبة ضريبة في الملف غير معتمدة لدى الدائرة
504 Gateway Timeoutتعذّر الوصول إلى نظام الفوترة: الجدار الناري عندك أو الموقع الرئيسي
400 Bad Requestبيانات الربط سليمة لكن بيانات الفاتورة خطأ، والسبب في رسالة الاستجابة

ورمز 200 ليس نهاية التحقق. يطلب الدليل قراءة حالة الفاتورة في الاستجابة (SUBMITTED أو ALREADY_SUBMITTED أو NOT_SUBMITTED) والتأكد من رجوع رمز QR. وعند انتهاء المهلة، أعد إرسال الفاتورة نفسها بالرقم والمعرّف الفريد نفسيهما، لا بمعرّف جديد.

قائمة تحقّق بيانات الربط

  • رقم ضريبي فعّال، وحساب على الخدمات الإلكترونية، ومستخدم رئيسي على نظام الفوترة.
  • ربط لكل نشاط يرسل فواتير، على تسلسل مصدر الدخل الصحيح.
  • رقم المستخدم والمفتاح السري منسوخان لا مكتوبان باليد.
  • نوع الفاتورة (مبيعات أو دخل) يطابق تسجيل النشاط الضريبي.
  • بيانات ربط مستقلة لكل فرع له رقم ضريبي خاص.
  • القيم محفوظة مشفّرة، وتعديل الإعدادات محصور بالمدراء.
  • أول فاتورة حقيقية مقبولة وظاهرة على البوابة ومتحقَّق منها على "سند".

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

أين توضع بيانات الربط في Aspirations؟

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

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

المصادر الرسمية

أسئلة شائعة

أين أجد رقم المستخدم والمفتاح السري لجو فوترة؟

ادخل إلى portal.jofotara.gov.jo بالرقم الضريبي واسم المستخدم وكلمة المرور، افتح ربط الأجهزة ثم ربط جديد، اكتب اسم مستخدم واختر تسلسل مصدر الدخل واضغط إضافة. يظهر رقم المستخدم والمفتاح السري في جدول وبجانب كل منهما زر نسخ.

هل يستطيع المستخدم الفرعي توليد بيانات الربط؟

حسب دليل المستخدم للبوابة، ربط الأجهزة يتم من حساب المستخدم الرئيسي (Admin). المستخدمون الفرعيون ينشئهم الـ Admin لتنظيم الفواتير على البوابة لتسلسل مصدر دخل أو فرع معيّن.

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

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

لماذا يظهر خطأ 403 عند إرسال الفاتورة؟

حسب الدليل التقني للدائرة، خطأ 403 Forbidden يدل على خطأ في رقم المستخدم أو المفتاح السري. انسخ القيمتين من جدول الربط على البوابة مرة أخرى بدل كتابتهما.

هل يحتاج كل فرع بيانات ربط خاصة؟

الفرع المسجّل برقم ضريبي مستقل يدخل برقمه ويولّد بيانات ربط خاصة به. وضمن الرقم الضريبي الواحد، ولّد ربطاً لكل تسلسل مصدر دخل سيرسل فواتير.