تخطَّ إلى المحتوى
برمج تك
English

أدلة · الفوترة الوطنية

كيف يرسل نظامك الفاتورة إلى منظومة JoFotara

دليل مطوّر JoFotara وواجهة الإرسال. كيف يرسل نظامك الفاتورة إلى منظومة JoFotara: هذا الدليل يشرح المسار الهندسي كما نبنيه في برمج تك، ويميّز ما نشرته دائرة ضريبة الدخل والمبيعات عما لم تؤكده صفحتها حتى ٢٦ آب ٢٠٢٦.

ناقش ربط JoFotaraاقرأ خدمة الربط

JoFotara هي منظومة الفوترة الوطنية التي تديرها دائرة ضريبة الدخل والمبيعات. النظام يبني مستند الفاتورة وفق الدليل الفني، ويرسله عبر الواجهة المنشورة، ثم ينتظر حالة القبول أو الرفض ومعرّفاً ورمزاً للتحقق قبل أن تُعدّ الفاتورة جاهزة للعميل. المنشأة تسجّل نفسها في البوابة الرسمية وتحصل على بيانات الدخول. برمج تك لا تعتمد أحداً؛ الدائرة لا تدير برنامج اعتماد لمزوّدي البرمجيات. في ١ نيسان ٢٠٢٥ أعلنت الدائرة قاعدة للاعتراف بالمصاريف المحلية تتطلب فاتورة من المنظومة أو من نظام مربوط بها. موجات الإلزام بين ٢٠١٩ و٢٠٢٤ وموعد رمز إلزامي في ٢٠٢٦ لم تظهر كتاريخ حاسم على صفحات الدائرة التي راجعناها.

مراجعة النص في 2026-08-26.

في التشغيل

أربع قواعد تظهر في اليوم الأول

  • المكلف يملك المفاتيح

    رقم العميل والمفتاح السري يُنشآن من بوابة JoFotara بعد ربط الجهاز. لا نطلب نشرهما في مستودع عام ولا في صفحة تسويق.

  • القبول قبل تسليم العميل

    فاتورة تُطبع قبل رد المنظومة ليست فاتورة معتمدة في هذا النموذج. صمّم نقطة البيع لانتظار الحالة أو لمسار انقطاع صريح.

  • الرفض مسار لا استثناء

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

  • لا اعتماد مزوّد

    أي بائع يدّعي شهادة رسمية من الدائرة لبرمجته يبيع صفة غير موجودة. الالتزام القانوني على المكلف.

ما الذي ننقله عن القانون وما الذي نتوقف عنده

تستشهد دائرة ضريبة الدخل والمبيعات في أسئلة فواتيري بنظام تنظيم شؤون الفوترة والرقابة عليها رقم ٣٤ لسنة ٢٠١٩، بما في ذلك شكل الفاتورة المقبول ومدة الاحتفاظ. وتذكر بوابة الدائرة أيضاً نظام تنظيم شؤون الفوترة لسنة ٢٠٢٣. نحن ننقل هذه الإحالات كما تظهر على صفحات الدائرة، لا من جريدة رسمية بين أيدينا. في ١ نيسان ٢٠٢٥ نشرت الدائرة خبراً عن تعديل نظام المصاريف رقم ٢ لسنة ٢٠٢٥: مشتريات السلع والخدمات المحلية ينبغي أن تُدعم بفاتورة صادرة من منظومة الفوترة الوطنية أو من نظام مربوط بها، وإلا قد لا يُقبل المصروف. لا نختصر ذلك إلى شعار «مرحلة ثانية على كل بائع». غرامات بالدينار لم نجدها مجدولة على الصفحات التي راجعناها؛ نقول إن المخالفة تخضع لقانون الضريبة ومتابعة الدائرة.

ثلاث أسر للمستندات لا تخلط بينها

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

عقد الإرسال كما ننفّذه

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

من أين تأتي الحقول حتى لا يفشل التحقق

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

ماذا تبني برمج تك وماذا يبقى عليك

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

كيف تقرأ هذا الدليل مع مقالات المدونة

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

حدود صريحة حتى لا يُنسخ الدليل كحقيقة قانونية

لا ننشر عنوان بيئة اختبار عام، ولا مبلغ غرامة، ولا جدولاً زمنياً لموجات إلزام لم تثبته صفحة الدائرة، ولا ادعاء شراكة. الحزمة البرمجية تنفيذ للدليل الفني بنسخته المعتمدة لدينا؛ تغيير الدليل يلزم مراجعة التنفيذ. إن طُلب منك «شهادة JoFotara» من مورّد، اطلب النص القانوني الذي يُنشئ برنامج الشهادات. لن تجد برنامجاً كهذا في عملنا ولا على الصفحات الرسمية التي راجعناها.

خطوات تسجيل الجهاز في البوابة، خدمة ربط JoFotara لنظامك الحالي، فوترة العيادة حتى اعتماد JoFotara، دليل صاحب العمل للفوترة الوطنية، تصحيح وإلغاء الفاتورة الإلكترونية، سوق الأردن ومقر عمّان.

أسئلة شائعة

أدلة برمج تك
لا ننشر جدولاً شاملاً من عندنا. ننقل قاعدة ١ نيسان ٢٠٢٥ عن الاعتراف بالمصاريف كما صاغتها الدائرة، ونحيل إلى البوابة الحالية لأي إلزام أوسع.

حوّل الدليل إلى نطاق مكتوب

نبدأ من نظام الفوترة الحالي وحالات الرفض، لا من وعد اعتماد. أرسل موجزاً بعد قراءة خطوات التسجيل.

ناقش ربط JoFotaraاقرأ خدمة الربط