إلزامية الفوترة الإلكترونية تتوسّع تدريجياً في الأردن — اعرف إن كان منشأتك مُلزَمة ومتى
فواترا
دخول المطوّرين ابدأ مجاناً
للمطوّرين وفرق تقنية المعلومات

اربط نظامك الحالي بنظام الفوترة الوطني

لا تستبدل نظامك المحاسبي ولا تُدخل الفواتير مرتين. فواترا طبقة امتثال تجلس بين نظامك وبين الدائرة، وتتولّى UBL 2.1 والتصغير والترميز ورسائل الخطأ.

توثيق API تحدّث مع مهندس تكامل
ما يتولّاه عنك
  • بناء UBL 2.1 مطابق للمواصفة المنشورة
  • التصغير (Minify) وترميز Base64
  • ترويسات Client-Id و Secret-Key وإدارة المهلات
  • ترجمة رموز الأخطاء الحكومية إلى العربية
  • صيانة الطبقة مع كل تحديث رسمي للمواصفة

أين تقع فواترا في بنيتك

طبقة واحدة، بلا تغيير في مصدر الحقيقة لديك.

نظامك

ERP أو محاسبي أو POS أو متجر. يبقى مصدر الحقيقة لبيانات المبيعات.

POST /api/v1/invoices

فواترا

تحقّق مسبق، بناء UBL 2.1، تصغير، ترميز Base64، إرسال موقّع، سجل تدقيق.

Client-Id + Secret-Key

نظام الفوترة الوطني

يعتمد الفاتورة ويعيد الرقم المرجعي ورمز QR وحالة القبول.

UUID + QR + status

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

الربط كما يصفه دليل منصة الـPortal

المقاطع التالية منقولة حرفياً من «دليل المستخدم الخاص بمنصة الـPortal» الصادر عن نظام الفوترة الوطني، واللقطات مأخوذة من الدليل نفسه. هي المرجع الذي نبني عليه تدفّق الربط في فواترا.

1. قبل أي شيء: رقم ضريبي فعّال وحساب على بوابة الضريبة

يجب على المكلف أن يحمل رقماً ضريبياً فعالاً وأن يكون مسجلاً على بوابة دائرة ضريبة المبيعات والدخل الإلكترونية والموجود على الرابط التالي etax.istd.gov.jo.

دليل المستخدم — منصة الـPortal، «النظرة العامة»

بعد الدخول إلى etax.istd.gov.jo تضغط رابط «الفوترة الوطني» في القائمة العلوية، فتُنقل إلى شاشة إنشاء حساب نظام الفوترة الإلكتروني.

2. نوعا الحساب — ومن يملك صلاحية الربط

حساب المستخدم الرئيسي (Admin): هو حساب لشخص مكلف ويحمل رقماً ضريبياً ويكون المسؤول عن الإعدادات الرئيسية للحساب.

حساب المستخدم الفرعي (Subuser): هو حساب فرعي يتم إنشاؤه من قبل المستخدم الرئيسي لغاية تنظيم الفواتير من خلال الموقع الإلكتروني.

دليل المستخدم — «أنواع الحسابات في النظام»

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

بوابة دائرة ضريبة الدخل والمبيعات الإلكترونية مع تمييز رابط «الفوترة الوطني» في القائمة العلوية
الخطوة 2 في الدليل: رابط «الفوترة الوطني» داخل etax.istd.gov.jo.
شاشة تسجيل الدخول إلى نظام الفوترة الوطني: الرقم الضريبي واسم المستخدم وكلمة المرور
تسجيل الدخول: الرقم الضريبي + اسم المستخدم + كلمة المرور على portal.jofotara.gov.jo.

3. شاشة «ربط الأجهزة» — من هنا يخرج Client-Id و Secret-Key

يمكن للمستخدم الرئيسي (Admin) من خلال شاشة ربط الأجهزة ربط برنامجه الخاص لإصدار الفواتير (Integration) ليتم ترحيل الفواتير من خلاله.

دليل المستخدم — «ربط الأجهزة»
نافذة «إضافة ربط» في منصة الفوترة الوطني تطلب اسم المستخدم وتسلسل مصدر الدخل
إضافة ربط جديد: اسم المستخدم للربط + تسلسل مصدر الدخل، ثم «إضافة».
جدول ربط الأجهزة يعرض المستخدم Integration ورقم المستخدم والمفتاح السري وتسلسل مصدر الدخل مع زر نسخ
النتيجة: رقم المستخدم = Client-Id والمفتاح السري = Secret-Key، مربوطان بتسلسل مصدر دخل واحد.

الرسالة التنبيهية التي يعرضها النظام قبل تأكيد الربط:

لن يتمكن المكلف من تنظيم الفواتير باستخدام المنصة إذا قام بالربط مع الأجهزة.

دليل المستخدم — «ربط الأجهزة»، الخطوة 5

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

  • أنهِ اختبارك في بيئة Sandbox قبل تفعيل الربط على الحساب الحي.
  • تأكّد أن نظامك يغطّي كل الحالات التي كنت تصدرها يدوياً: الذمم، الخصومات، الإعفاءات، والمرتجعات.
  • إن كان لديك أكثر من تسلسل مصدر دخل، اربط ما أنت جاهز له فقط — الربط يُضبط لكل تسلسل على حدة.
أين تضع هذه المفاتيح في فواترا من لوحة التحكم ← الإعدادات ← مفاتيح JoFotara. تُخزَّن مشفّرة بـ AES-256-GCM ولا تُعرض بعد الحفظ. راجع المصادقة في توثيق API.

4. بعد الربط: الفواتير كلها في مكان واحد

يمكن للمستخدم الرئيسي (Admin) من خلال شاشة عرض الفواتير عرض جميع الفواتير الخاصة بالرقم الضريبي لجميع تسلسلات مصادر الدخل سواء تم تنظيمها عن طريق المنصة Portal أو عن طريق تطبيق الهاتف Mobile app أو عن طريق ربط الأجهزة API.

دليل المستخدم — «عرض الفواتير»
شاشة عرض الفواتير في منصة الفوترة الوطني مع عدادات الفواتير الصادرة وجدول الفواتير وزر التصدير إلى اكسل
شاشة عرض الفواتير: كل فاتورة أرسلها نظامك عبر API تظهر هنا بنفس الجدول — مع تسلسل مصدر الدخل ورقم الفاتورة الإلكترونية وتاريخ الإصدار. التصدير إلى اكسل متاح، وحدّ التحميل المعروض في الشاشة 100,000 فاتورة.

عملياً هذه شاشة التسوية (reconciliation) التي ستستخدمها بعد الإطلاق: قارن عدد الفواتير فيها بسجلّ نظامك وبسجل التدقيق في فواترا. الثلاثة يجب أن تتطابق.

المصدر: «نظام الفوترة الوطني — دليل المستخدم الخاص بمنصة الـPortal». الاقتباسات منقولة للتوضيح التقني، واللقطات من الدليل ذاته وتعود ملكيتها لجهة إصداره. الدليل هو المرجع عند أي اختلاف، وقد تتغيّر الشاشات مع تحديثات المنصة.

الأنظمة التي نربطها

أنماط ربط مجرَّبة. وإن لم يكن نظامك في القائمة، فنقطة النهاية نفسها تكفي.

Odoo

وحدة ربط تلتقط الفاتورة عند تأكيدها في Odoo وترسلها، ثم تكتب الرقم المرجعي ورمز QR على السجل نفسه.

SAP / S4HANA

تكامل عبر طبقة وسيطة تستهلك IDoc أو OData وتحوّلها إلى نداء فواترا، مع مطابقة حقول البائع المركزية.

Microsoft Dynamics

ربط على مستوى حدث ترحيل الفاتورة، مع إعادة الحالة إلى حقول مخصّصة داخل Dynamics.

WooCommerce / Shopify

إصدار فاتورة إلكترونية تلقائياً عند اكتمال الطلب، وإرسال رابط الفاتورة للعميل.

أنظمة نقاط البيع (POS)

إرسال فوري لحظة إتمام البيع، مع طباعة رمز QR على الإيصال مباشرة.

أنظمة مخصّصة

أي نظام يستطيع إرسال طلب HTTPS يستطيع الربط. نقطتان فقط وأمثلة بأربع لغات.

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

خطة التنفيذ

من القرار إلى أول فاتورة حيّة

مشروع ربط نموذجي يستغرق من يوم إلى أسبوع حسب تعقيد نظامك.

1

مفتاح Sandbox

تحصل على مفتاح اختبار خلال دقائق وتبدأ التجربة دون أي التزام.

2

مطابقة الحقول

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

3

تكامل وتجربة

تبني النداء وتختبره على حالات حقيقية: فاتورة عادية، آجلة، بخصم، ببنود معفاة، وإشعار دائن.

4

التحويل للبيئة الحية

تُدخل مفاتيح JoFotara الخاصة بمنشأتك ويُفعَّل المفتاح الحي. أول فاتورة حقيقية تحت إشرافنا.

POST/api/v1/invoices 
// الحد الأدنى للنداء — هذا كل شيء
{
  "invoice_number": "SO-10432",
  "invoice_type":   "388",
  "payment_method": "021",
  "buyer": { "name": "شركة النور" },
  "items": [
    { "name": "صيانة سنوية",
      "qty": 1,
      "unit_price": 1200,
      "tax_rate": 16 }
  ]
}

ما نقدّمه خلال الربط

  • مفتاح Sandbox مجاني وغير محدود
  • قناة مباشرة مع مهندس تكامل (خطة الأعمال وما فوقها)
  • مراجعة حالات الحافة: المرتجعات، الإعفاءات، تعدد العملات
  • اختبار تحمّل قبل الإطلاق للأحجام الكبيرة
  • تنفيذ الربط نيابة عنك كخدمة إضافية إن لم يتوفر فريق تقني
اطلب جلسة تكامل
الأمان أثناء الربط

مفاتيحك لا تمرّ في مكان لا ينبغي

مفاتيح JoFotara تعادل توقيع منشأتك الضريبي. نتعامل معها على هذا الأساس: تُخزَّن مشفّرة بـ AES-256-GCM، وتُفكّ وقت الإرسال فقط، ولا تظهر مرة أخرى بعد حفظها.

  • مفاتيح API منفصلة لكل نظام — إبطال أي منها لا يؤثر على البقية
  • مفتاح Sandbox لا يستطيع الإرسال الحكومي إطلاقاً
  • كل نداء مسجَّل: من، ومتى، وبأي ملف، وبأي رد
  • اتصال TLS مع تحقّق كامل من الشهادة في الاتجاهين
تفاصيل الأمان والامتثال

أسئلة يطرحها فريق تقنية المعلومات

هل تحتفظون بنسخة من فواتيرنا؟
نعم — ملف UBL المُرسل ورد الدائرة، لأن سجل التدقيق يتطلب ذلك. تستطيع تصديرها أو طلب حذفها وفق سياسة الخصوصية.
هل نستطيع الاستضافة على خادمنا؟
نعم ضمن خطة المؤسسات — نشر على بنيتك التحتية مع عقد صيانة وتحديثات للمواصفة.
ماذا لو توقّف النظام الحكومي؟
نُرجع خطأ واضحاً (government_rejected أو مهلة اتصال) ونحتفظ بالفاتورة لإعادة الإرسال. مع Idempotency-Key لا يتكرّر الإصدار.

ابدأ بمفتاح Sandbox مجاني

جرّب التكامل الكامل دون إرسال حكومي ودون استهلاك حصّة — ثم فعّل البيئة الحيّة عند جاهزيتك.

احصل على مفتاح اقرأ التوثيق

روابط مفيدة

إنشاء فاتورةمرجع الحقول الكامل مع أمثلة بأربع لغات. Webhooksإشعار موقّع بـ HMAC عند تغيّر حالة الفاتورة. آلية العملما يحدث داخل المنصة بين الطلب والاعتماد. الأمانكيف تُخزَّن المفاتيح وتُعزَل بيانات المنشآت.