الأسئلة الشائعة
34 سؤالاً نسمعها من أصحاب المنشآت والمحاسبين والمطوّرين — بإجابات مباشرة بلا لفّ، ومع اقتباسات من الدليل الرسمي حيث يلزم.
الأساسيات
ما هو نظام الفوترة الوطني (JoFotara)؟
منظومة حكومية أردنية تابعة لدائرة ضريبة الدخل والمبيعات تستقبل الفواتير إلكترونياً لحظة إصدارها وتعتمدها. تُرسل الفاتورة بصيغة XML وفق معيار UBL 2.1، ويعيد النظام معرّفاً فريداً ورقماً مرجعياً ورمز QR.
ما الفرق بين فواترا ونظام الفوترة الوطني؟
نظام الفوترة الوطني جهة حكومية تعتمد الفواتير. فواترا مزوّد خدمة تقنية مستقل يبني الفاتورة بالصيغة المطلوبة ويرسلها نيابة عنك بمفاتيحك أنت. نحن الطريق، والاعتماد يصدر عنهم.
هل أحتاج فواترا أصلاً، أم أستطيع الربط مباشرة؟
تستطيع الربط مباشرة إن كان لديك فريق تقني قادر على بناء UBL 2.1 والتعامل مع التصغير والترميز ورموز الأخطاء، وعلى صيانة ذلك مع كل تحديث للمواصفة. فواترا تختصر هذه الطبقة وتتحمّل صيانتها.
هل المنصة مناسبة لمنشأة صغيرة جداً؟
نعم. الخطة المجانية تغطي 50 فاتورة شهرياً بإرسال فعلي إلى النظام الوطني، وتكفي معظم المتاجر الصغيرة ومقدّمي الخدمات الأفراد.
البدء والتسجيل
كم يستغرق إصدار أول فاتورة؟
من واجهة الويب: دقائق بعد إدخال بيانات منشأتك ومفاتيح الربط. عبر API: من ساعتين إلى يوم عمل لربط نظامك واختباره في بيئة Sandbox.
من أين أحصل على Client-Id و Secret-Key؟
من حسابك على بوابة نظام الفوترة الوطني بعد تسجيل منشأتك وتفعيل خدمة الربط البرمجي. لا يصدرهما أي مزوّد خدمة — هما خاصان بمنشأتك.
هل أحتاج رقماً ضريبياً للبدء؟
نعم للإرسال الفعلي، لأن الرقم الضريبي وتسلسل مصدر الدخل حقلان إلزاميان في الفاتورة. لكن تستطيع إنشاء الحساب وتجربة المنصة في بيئة الاختبار قبل ذلك.
هل تساعدونني في الإعداد؟
نعم. نرافقك حتى أول فاتورة معتمدة في كل الخطط. وتتوفّر خدمة تنفيذ الربط كاملاً نيابة عنك كخدمة إضافية إن لم يكن لديك فريق تقني.
التقنية والربط
ما معيار UBL 2.1 ولماذا يهمّني؟
معيار دولي لتمثيل مستندات الأعمال في XML، وهو الصيغة التي يقبلها النظام الأردني. يهمّك لأن فاتورة صحيحة منطقياً قد تُرفض إن خالفت بنية المعيار — مثل إرسالها منسّقة بمسافات بدل مُصغَّرة.
هل يوجد بيئة تجريبية (Sandbox)؟
نعم، مجانية وغير محدودة في الخطط التي تتضمن API. مفاتيح Sandbox تبني الفاتورة وتتحقّق منها فعلياً لكنها لا ترسل شيئاً إلى النظام الحكومي ولا تُحتسب من حصّتك.
كيف أمنع إرسال الفاتورة مرتين عند انقطاع الشبكة؟
أرسل ترويسة Idempotency-Key مع كل طلب إنشاء (استخدم رقم فاتورتك). إن تكرّر النداء نعيد الاستجابة الأصلية حرفياً ولا تُرسل الفاتورة مرة ثانية إلى الدائرة.
هل أستطيع ربط Odoo أو SAP أو نظام نقاط البيع؟
نعم. أي نظام يستطيع إرسال طلب HTTPS يستطيع الربط. لدينا أنماط تكامل مجرَّبة لـ Odoo و SAP و Dynamics والمتاجر الإلكترونية وأنظمة نقاط البيع — راجع صفحة الربط الوطني.
ما حدود المعدّل على الـ API؟
60 طلباً في الدقيقة لخطة النمو، و300 لخطة الأعمال، وحسب الاتفاق لخطة المؤسسات. كل استجابة تحمل ترويستي X-RateLimit-Limit و X-RateLimit-Remaining.
الضريبة والفواتير
كيف تُحتسب ضريبة المبيعات؟
على مستوى كل بند: الأساس = (الكمية × السعر) − الخصم، والضريبة = الأساس × النسبة، بتقريب إلى ثلاث خانات عشرية. يمكن أن تختلف النسبة من بند لآخر داخل الفاتورة نفسها.
هل تدعمون البنود المعفاة وصفرية النسبة؟
نعم، بفئة ضريبية صحيحة (Z بدل S) وسبب إعفاء مُصرَّح، ويمكن أن تجتمع مع بنود خاضعة في الفاتورة ذاتها مع مجاميع تعكس ذلك بدقة.
كيف أصدر إشعاراً دائناً أو مرتجعاً؟
اختر نوع المستند 381، وستتبدّل طرق الدفع تلقائياً إلى 013 (مرتجع نقدي) أو 023 (مرتجع ذمم). إرسال 381 مع 011 أو 021 سبب رفض شائع نمنعه تلقائياً.
هل أستطيع إصدار فواتير بالدولار؟
نعم، ندعم JOD و USD و EUR مع تسجيل عملة الضريبة بشكل صحيح في الفاتورة.
ماذا أفعل إذا رُفضت فاتورتي؟
نعرض لك رد الدائرة كما ورد، مع شرح عربي للسبب وإشارة للحقل المسبّب. تُصحّح الحقل وتعيد الإرسال دون إعادة إدخال الفاتورة، وتبقى كل المحاولات في سجل التدقيق.
الربط من داخل منصة الفوترة الوطني
من أين أحصل على مفاتيح الربط من المنصة نفسها؟
من شاشة «ربط الأجهزة» داخل منصة الفوترة الوطني، وبحساب المستخدم الرئيسي (Admin) حصراً. تضغط «ربط جديد»، تُدخل اسم المستخدم للربط وتحدّد تسلسل مصدر الدخل، فيولّد النظام رقم المستخدم (Client-Id) والمفتاح السري (Secret-Key).
يمكن للمستخدم الرئيسي (Admin) من خلال شاشة ربط الأجهزة ربط برنامجه الخاص لإصدار الفواتير (Integration) ليتم ترحيل الفواتير من خلاله.
هل أفقد القدرة على إصدار الفواتير يدوياً بعد الربط؟
نعم، لتسلسل مصدر الدخل الذي ربطته. النظام يعرض رسالة تنبيهية صريحة قبل تأكيد الربط، ولهذا ننصح بإنهاء الاختبار في بيئة Sandbox والتأكد من تغطية كل حالاتك (ذمم، خصومات، إعفاءات، مرتجعات) قبل التفعيل على الحساب الحي.
لن يتمكن المكلف من تنظيم الفواتير باستخدام المنصة إذا قام بالربط مع الأجهزة.
ماذا أحتاج قبل أن أبدأ أصلاً؟
رقماً ضريبياً فعّالاً وحساباً على بوابة دائرة ضريبة الدخل والمبيعات الإلكترونية. منها تضغط رابط «الفوترة الوطني» لإنشاء حساب نظام الفوترة الإلكتروني، ثم تدخل إليه عبر portal.jofotara.gov.jo بالرقم الضريبي واسم المستخدم وكلمة المرور.
يجب على المكلف أن يحمل رقماً ضريبياً فعالاً وأن يكون مسجلاً على بوابة دائرة ضريبة المبيعات والدخل الإلكترونية والموجود على الرابط التالي etax.istd.gov.jo.
ما الفرق بين المستخدم الرئيسي والمستخدم الفرعي؟
المستخدم الرئيسي (Admin) هو صاحب الرقم الضريبي والمسؤول عن الإعدادات ومفاتيح الربط وعرض كل الفواتير. المستخدم الفرعي (Subuser) يُنشئه الرئيسي لتنظيم الفواتير فقط، ولا يرى إلا الفواتير التي أصدرها هو. وينصح الدليل بإضافة مستخدم فرعي لكل تسلسل مصدر دخل عند تعدّدها.
حساب المستخدم الرئيسي (Admin): هو حساب لشخص مكلف ويحمل رقماً ضريبياً ويكون المسؤول عن الإعدادات الرئيسية للحساب.
هل أرى فواتير الـAPI داخل منصة الفوترة الوطني؟
نعم، كلها في شاشة واحدة. استخدم هذه الشاشة للتسوية الشهرية: عدد الفواتير فيها يجب أن يطابق سجلّ نظامك وسجل التدقيق في فواترا. والتصدير إلى اكسل متاح منها مباشرة.
يمكن للمستخدم الرئيسي (Admin) من خلال شاشة عرض الفواتير عرض جميع الفواتير الخاصة بالرقم الضريبي لجميع تسلسلات مصادر الدخل سواء تم تنظيمها عن طريق المنصة Portal أو عن طريق تطبيق الهاتف Mobile app أو عن طريق ربط الأجهزة API.
كيف أُرجع فاتورة بعد أن ربطت نظامي؟
شاشة الإرجاع داخل المنصة تعمل على الفواتير المصدرة منها، وفيها تحدّد الكمية المراد إرجاعها لكل بند. أما عبر الـAPI فالمرتجع مستند مستقل: أرسل نوع 381 (إشعار دائن) بطريقة دفع 013 أو 023 وبنوده بالكميات المرتجعة.
لإتمام عملية إرجاع فاتورة، يمكن للمستخدمين إرجاع فاتورة مصدرة عن طريق منصة الـPortal فقط.
ما أشكال الفواتير التي أستطيع إصدارها؟
ثلاثة أشكال، ويحدّدها تصنيف منشأتك لدى الدائرة لا اختيارك في النداء: فاتورة الدخل بلا ضرائب، وفاتورة الضريبة العامة بضريبة المبيعات، وفاتورة الضريبة الخاصة التي تجمع العامة والخاصة. إرسال نسبة ضريبة على مفتاح مسجَّل كمكلف ضريبة دخل يُرفض من الدائرة.
فاتورة الدخل: الفواتير التي لا تحتوي على ضرائب. فاتورة الضريبة العامة: الفواتير التي تحتوي على ضرائب المبيعات. فاتورة الضريبة الخاصة: الفواتير التي تحتوي على الضريبة العامة للمبيعات والضريبة الخاصة.
متى يكون اسم المشتري إلزامياً؟
في فواتير الذمم وفي الفواتير بقيمة 10,000 وأكثر. وعلى فواتير المناطق التنموية وتشجيع الاستثمار يُضاف إليه الرقم الضريبي للمشتري. لدينا buyer.name مطلوب دائماً لأنه يمنع الرفض الأكثر شيوعاً.
الاسم: لإدخال اسم المشتري، ويكون إجبارياً لفواتير الذمم والفواتير بقيمة 10000 وأكثر.
الأسعار والاشتراك
هل الخطة المجانية مجانية فعلاً؟
نعم — 50 فاتورة شهرياً بإرسال فعلي إلى النظام الوطني، بلا بطاقة ائتمانية وبلا مدة تجريبية تنتهي. الخطط المدفوعة تضيف الـ API والتقارير والمستخدمين المتعددين.
ماذا يحدث إذا تجاوزت حصّة خطتي؟
نُشعرك عند 80% و100%، ثم تُحتسب الفواتير الإضافية بـ 0.015 دينار للفاتورة حتى نهاية الشهر، أو ترقّي خطتك فوراً بفرق تناسبي. لا نوقف الإرسال فجأة.
هل أستطيع الإلغاء في أي وقت؟
نعم ودون رسوم. يسري الإلغاء نهاية الدورة الجارية، وتبقى فواترك وسجلاتك متاحة للتصدير 12 شهراً.
هل الأسعار تشمل ضريبة المبيعات؟
لا، تُضاف 16% إلى الفاتورة الصادرة لك. ونصدر لك فاتورة ضريبية إلكترونية عن اشتراكك — مُصدَرة بفواترا نفسها.
الأمان والبيانات
كيف تحمون مفاتيح الربط الخاصة بي؟
تُخزَّن مشفّرة بـ AES-256-GCM بمفتاح خارج قاعدة البيانات، وتُفكّ وقت الإرسال فقط، ولا تُعرض مرة أخرى بعد حفظها. لا تُكتب في السجلات ولا تظهر في أي استجابة API.
هل تحتفظون بنسخة من فواتيري؟
نعم — ملف UBL المُرسل ورد الدائرة والطابع الزمني، لأن سجل التدقيق يتطلب ذلك وقد يُطلب منك لاحقاً. تستطيع تصديرها في أي وقت.
هل البيانات مخزّنة داخل الأردن؟
تُعالَج على بنية تحتية بضمانات تعاقدية مناسبة. خطة المؤسسات تتيح النشر على خادم داخل الأردن عند وجود متطلب تنظيمي لديك.
هل تستطيعون إصدار فواتير باسمي دون علمي؟
لا. الإرسال يتم بمفاتيحك أنت ولغرض الفواتير التي ترسلها فقط، وكل نداء مسجَّل في سجل تدقيق تطّلع عليه. يمكنك حذف المفاتيح في أي لحظة فيتوقف الإرسال فوراً.
الاقتباسات واللقطات في قسم «الربط من داخل منصة الفوترة الوطني» مأخوذة من «نظام الفوترة الوطني — دليل المستخدم الخاص بمنصة الـPortal»، وتعود ملكيتها لجهة إصداره. أُدرجت للتوضيح فقط، والدليل الرسمي هو المرجع عند أي اختلاف، وقد تتغيّر الشاشات مع تحديثات المنصة.
لم تجد سؤالك؟
اكتب لنا ونجيبك خلال يوم عمل واحد — حتى لو كان سؤالاً تقنياً دقيقاً عن حقل في UBL.