- ما هو JoFotara؟
- نظام الفوترة الوطني الأردني — منظومة تابعة لدائرة ضريبة الدخل والمبيعات تستقبل الفواتير إلكترونياً لحظة إصدارها وتعتمدها.
- صيغة الفاتورة
- ملف XML وفق معيار UBL 2.1، مُصغَّر (Minified) ومُرمَّز Base64 قبل الإرسال.
- ما تحتاجه للبدء
- رقم ضريبي مسجّل، وتسلسل مصدر الدخل، ومفتاحا الربط Client-Id و Secret-Key من بوابة JoFotara.
- رموز نوع الفاتورة
- 388 فاتورة ضريبية · 381 إشعار دائن أو مرتجع. وطرق الدفع: 011/021 للبيع، 013/023 للمرتجع.
- ما يعود من النظام
- رقم مرجعي، ومعرّف فريد (UUID)، ورمز QR يثبت اعتماد الفاتورة ويتيح التحقّق منها.
- أكثر أسباب الرفض
- عدم توافق رمز نوع الفاتورة مع طريقة الدفع، غياب تسلسل مصدر الدخل، المبالغ بخانتين عشريتين بدل ثلاث، و XML غير مُصغَّر.
1. ما هو نظام الفوترة الوطني؟
نظام الفوترة الوطني (المعروف باسم JoFotara) منظومة حكومية أردنية تستقبل فواتير المنشآت لحظة إصدارها وتعتمدها إلكترونياً. بدل أن تصدر فاتورة ورقية وتُدقَّق لاحقاً، تُرسل الفاتورة إلى الدائرة فور إنشائها فتعود باعتماد رسمي.
الفاتورة المعتمدة تحمل ثلاثة عناصر لا توجد في الفاتورة التقليدية:
- معرّف فريد (UUID) يميّز الفاتورة على مستوى المملكة.
- رقم مرجعي يصدره النظام بعد القبول.
- رمز QR يتيح لأي شخص التحقّق من صحة الفاتورة.
الفاتورة ليست ملف PDF ولا صورة — بل ملف XML منظَّم وفق معيار دولي اسمه UBL 2.1، تقرأه الأنظمة آلياً. ما تطبعه للعميل مجرد تمثيل بصري لذلك الملف.
خلاصة مفيدة: شكل الفاتورة لا يهم الدائرة — بنيتها هي ما يهم. فاتورة بسيطة الشكل بحقول صحيحة تُقبل، وفاتورة أنيقة بحقل ناقص تُرفض.
2. من المُلزَم بالفوترة الإلكترونية؟
التوجّه العام في الأردن هو توسيع الإلزام تدريجياً ليشمل المنشآت على شرائح، بدءاً بالأكبر حجماً ثم الأصغر. الشريحة التي تقع فيها منشأتك تحدّدها الدائرة بناءً على عوامل مثل حجم المبيعات السنوي وطبيعة النشاط والتسجيل في ضريبة المبيعات.
عملياً، إن كانت منشأتك تنطبق عليها الحالات التالية فمن الأرجح أنك مشمول أو ستُشمل قريباً:
- مسجّلة في ضريبة المبيعات وتصدر فواتير ضريبية لعملائها.
- تتعامل مع جهات حكومية أو شركات كبرى تطلب فاتورة معتمدة.
- تصدر عدداً معتبراً من الفواتير شهرياً عبر نظام محاسبي أو نقطة بيع.
3. التسجيل خطوة بخطوة
الطريق من «لا أعرف من أين أبدأ» إلى «أول فاتورة معتمدة» يمر بخمس محطات:
- سجّل المنشأة على بوابة النظام باستخدام الرقم الضريبي وبيانات التسجيل الرسمية. تأكد أن اسم المنشأة مطابق تماماً لما في سجلاتك الضريبية.
- فعّل خدمة الربط البرمجي من داخل حسابك لتصبح قادراً على الإرسال الآلي بدل الإدخال اليدوي.
- احصل على مفاتيح الربط — Client-Id وSecret-Key (التفاصيل في القسم التالي).
- جهّز بيانات البائع الثابتة: الرقم الضريبي، تسلسل مصدر الدخل، العنوان، والهاتف. هذه تتكرر في كل فاتورة.
- اختبر ثم انتقل للبيئة الحية. أصدر فواتير اختبارية أولاً حتى تستقر كل الحقول، ثم أرسل أول فاتورة حقيقية.
4. الحصول على مفاتيح الربط
الربط البرمجي مع النظام يتم بمفتاحين تصدرهما الدائرة لمنشأتك، ويُرسلان في ترويسات كل طلب:
| المفتاح | الترويسة | الدور |
|---|---|---|
| Client Id | Client-Id | يعرّف منشأتك لدى النظام. |
| Secret Key | Secret-Key | يثبت أن الطلب صادر عنك فعلاً. سرّي تماماً. |
في فواترا تُدخل المفتاحين مرة واحدة داخل حسابك، فيُخزَّنان مشفّرين ولا يظهران مرة أخرى بعد الحفظ. نستخدمهما وقت الإرسال فقط. اقرأ التفاصيل في صفحة الأمان والامتثال.
5. الحقول الإلزامية في الفاتورة
هذه الحقول إن نقص أحدها تُرفض الفاتورة — بغضّ النظر عن صحة المبالغ:
| الحقل | أين يقع في UBL | ملاحظة عملية |
|---|---|---|
| رقم الفاتورة | cbc:ID | يجب أن يكون فريداً لدى منشأتك. |
| المعرّف الفريد | cbc:UUID | يُولَّد لكل فاتورة (UUID v4). |
| تاريخ الإصدار | cbc:IssueDate | بصيغة YYYY-MM-DD حصراً. |
| نوع الفاتورة وطريقة الدفع | cbc:InvoiceTypeCode | يجب أن يتوافقا معاً — القسم التالي. |
| الرقم الضريبي للبائع | cac:PartyTaxScheme | مطابق للمسجّل لدى الدائرة. |
| تسلسل مصدر الدخل | cac:SellerSupplierParty | أكثر حقل يُنسى، وسبب رفض متكرر. |
| بيانات المشتري | cac:AccountingCustomerParty | الاسم مطلوب دائماً؛ الرقم الضريبي حسب نوع العملية. |
| بنود الفاتورة | cac:InvoiceLine | بند واحد على الأقل بكميّة أكبر من صفر. |
| المجاميع | cac:LegalMonetaryTotal | بثلاث خانات عشرية — لا خانتين. |
6. رموز نوع الفاتورة وطريقة الدفع
هنا يقع أكثر خطأ شيوعاً على الإطلاق. الرمزان ليسا مستقلّين: طريقة الدفع المسموحة تتبع نوع المستند.
| نوع المستند | الرمز | طرق الدفع المسموحة |
|---|---|---|
| فاتورة ضريبية | 388 | 011 نقدي · 021 ذمم (آجل) |
| إشعار دائن / مرتجع | 381 | 013 مرتجع نقدي · 023 مرتجع ذمم |
القاعدة باختصار: 388 لا تأتي أبداً مع 013 أو 023، و381 لا تأتي أبداً مع 011 أو 021. في فواترا يُمنع هذا الخطأ آلياً — القائمة تتبدّل تلقائياً عند تغيير نوع الفاتورة، والـ API يرفض التركيبة الخاطئة قبل إرسالها إلى الدائرة.
7. معيار UBL 2.1 عملياً
UBL (Universal Business Language) معيار دولي لتمثيل مستندات الأعمال في XML، والإصدار 2.1 هو المعتمد لدى النظام الأردني. لن تحتاج لحفظه، لكن فهم بنيته يساعدك على قراءة رسائل الخطأ.
الفاتورة تتكوّن من أربع كتل رئيسية:
- رأس المستند — الرقم، المعرّف، التاريخ، النوع، العملة.
- الأطراف — البائع (AccountingSupplierParty) والمشتري (AccountingCustomerParty) ومصدر الدخل.
- البنود — سطر لكل صنف بكميته وسعره وخصمه وضريبته.
- المجاميع — الأساس الخاضع، إجمالي الضريبة، والمبلغ المستحق.
نقطتان تقنيّتان تُسقطان الكثير من التكاملات: الملف يجب أن يُرسل مُصغَّراً (Minified) بلا مسافات أو أسطر زائدة، ثم مُرمَّزاً بـ Base64 داخل جسم الطلب. الفاتورة الصحيحة منطقياً تُرفض إن أُرسلت منسّقة بمسافات.
<Invoice>
<cbc:ID>INV-2026-0418</cbc:ID>
<cbc:UUID>8f3c1e42-…</cbc:UUID>
<cbc:IssueDate>2026-04-18</cbc:IssueDate>
<cbc:InvoiceTypeCode name="011">388</cbc:InvoiceTypeCode>
<cac:AccountingSupplierParty> <!-- البائع -->
<cac:AccountingCustomerParty> <!-- المشتري -->
<cac:SellerSupplierParty> <!-- تسلسل مصدر الدخل -->
<cac:InvoiceLine> <!-- بند لكل صنف -->
<cac:LegalMonetaryTotal> <!-- المجاميع -->
</Invoice>
8. ضريبة المبيعات والإعفاءات
النسبة العامة لضريبة المبيعات في الأردن 16%، وتوجد نسب مخفّضة وأصناف معفاة أو خاضعة لنسبة صفرية بحسب طبيعة السلعة أو الخدمة.
الاحتساب يجري على مستوى البند لا الفاتورة:
الأساس الخاضع = (الكمية × سعر الوحدة) − الخصم
الضريبة = الأساس الخاضع × (النسبة ÷ 100)
الإجمالي = الأساس الخاضع + الضريبة
// مثال: 2 × 120 بخصم 20 وضريبة 16%
// الأساس = 220 ، الضريبة = 35.200 ، الإجمالي = 255.200
البنود صفرية النسبة أو المعفاة تُرسل بفئة ضريبية مختلفة (Z بدل S) مع سبب الإعفاء. يمكن أن تجتمع بنود خاضعة ومعفاة في الفاتورة نفسها، ويجب أن تعكس المجاميع ذلك بدقة.
9. رمز QR والتحقق
بعد قبول الفاتورة يعيد النظام رمز QR تضعه على النسخة المطبوعة أو الـ PDF. أي شخص — عميلك أو مدقّق من الدائرة — يستطيع مسحه للتحقّق من أن الفاتورة مُسجَّلة فعلاً لدى النظام وأن مبالغها لم تُعدَّل.
عملياً هذا يعني أمرين:
- لا تطبع الفاتورة قبل استلام رد القبول — الرمز لا يوجد قبله.
- احتفظ بالرمز مع سجل الفاتورة، فهو جزء من مستندك لا زينة عليه.
10. أكثر أسباب الرفض وعلاجها
| السبب | كيف يظهر | العلاج |
|---|---|---|
| تعارض نوع الفاتورة مع طريقة الدفع | رفض فوري عند الإرسال | التزم بجدول الرموز في القسم 6. |
| تسلسل مصدر الدخل ناقص | خطأ يشير إلى SellerSupplierParty | أضف التسلسل لبيانات البائع الثابتة. |
| تقريب لخانتين عشريتين | عدم تطابق المجاميع | احسب وأرسل بثلاث خانات. |
| XML غير مُصغَّر | خطأ في صيغة المستند | طبّق Minify قبل ترميز Base64. |
| رقم فاتورة مكرر | رفض للتكرار | استخدم تسلسلاً فريداً، ولا تُعد استخدام الأرقام. |
| رقم ضريبي غير مطابق | خطأ في بيانات البائع | طابق الرقم مع سجلك لدى الدائرة حرفياً. |
| إرسال مزدوج بعد انقطاع | فاتورتان بالرقم نفسه | استخدم Idempotency-Key عند الربط البرمجي. |
فواترا تمنع الستة الأولى قبل الإرسال عبر تحقّق محلي، وتعالج السابع بمفتاح منع التكرار — فلا تُستهلك محاولات حكومية في أخطاء يمكن اكتشافها عندك.
11. كيف تبدأ عملياً
أمامك ثلاثة مسارات، اختر الأنسب لحجمك:
إدخال يدوي
على بوابة النظام مباشرة. مناسب لعدد فواتير قليل جداً، ومرهق مع التكرار.
منصة جاهزة
كفواترا — تُدخل البيانات في واجهة عربية وتتولّى المنصة UBL والإرسال والتحقّق.
ربط نظامك بالـ API
تبقى على نظامك الحالي ويُرسل الفواتير تلقائياً عبر نداء واحد.
أسئلة شائعة
ما هو نظام الفوترة الوطني JoFotara؟
منظومة حكومية أردنية تتبع دائرة ضريبة الدخل والمبيعات، تستقبل الفواتير إلكترونياً وتعتمدها. ترسل المنشأة الفاتورة بصيغة XML وفق معيار UBL 2.1، ويعيد النظام رقماً مرجعياً ورمز QR يثبتان اعتمادها.
ما الفرق بين الفاتورة الإلكترونية والفاتورة المطبوعة أو PDF؟
الفاتورة الإلكترونية ملف XML منظَّم تقرأه الأنظمة ويُعتمد من الدائرة لحظة إصداره. ملف PDF أو الفاتورة المطبوعة تمثيل بصري فقط — لا يكفي وحده للامتثال حتى لو كان جميل الشكل.
من أين أحصل على Client-Id و Secret-Key؟
من حسابك على بوابة نظام الفوترة الوطني بعد تسجيل منشأتك وتفعيل خدمة الربط البرمجي. هما خاصان بمنشأتك، ولا يصدرهما أي مزوّد خدمة خارجي.
هل أحتاج مزوّد خدمة أصلاً، أم أربط مباشرة؟
تستطيع الربط مباشرة إن كان لديك فريق تقني يبني UBL 2.1 ويتعامل مع التصغير والترميز ورسائل الخطأ ويصونها مع كل تحديث للمواصفة. مزوّد الخدمة يختصر هذه الطبقة ويتحمّل صيانتها.
ما أكثر أسباب رفض الفاتورة؟
عدم تطابق رمز نوع الفاتورة مع رمز طريقة الدفع، وغياب تسلسل مصدر الدخل، وإرسال المبالغ بخانتين عشريتين بدل ثلاث، وإرسال XML غير مُصغَّر، وخطأ في الرقم الضريبي للبائع.
هل تُحسب ضريبة المبيعات تلقائياً؟
في فواترا نعم — تُحتسب على مستوى كل بند بنسبته الخاصة، مع دعم البنود المعفاة وصفرية النسبة داخل الفاتورة نفسها، وتقريب إلى ثلاث خانات عشرية.
هذا المحتوى لأغراض التوعية التقنية ولا يُعدّ استشارة ضريبية أو قانونية. للمتطلبات الرسمية والمواعيد والغرامات، ارجع إلى دائرة ضريبة الدخل والمبيعات أو إلى مستشارك الضريبي.