ربط برنامج المحاسبة مع JoFotara: الخطوات

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

نشرح هنا الخطوات بالترتيب كما تُنفَّذ في موثوق، مع التجربة ببيئة الاختبار قبل الإنتاج، وما تعنيه حالات الفاتورة، وأشهر أسباب الرفض.

قبل أن تبدأ: متطلبات الربط

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

الخطوة 1: احصل على بيانات الربط من البوابة

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

• رمز العميل (Client ID)
• المفتاح السري (Secret Key)

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

الخطوة 2: أدخلها في موثوق

1. افتح الإعدادات ← ربط JoFotara.
2. اختر بيئة الاتصال: بيئة الاختبار (Testing / Sandbox) للتجربة، أو البيئة الحقيقية (Production).
3. أدخل رمز العميل (Client ID).
4. أدخل المفتاح السري (Secret Key). يُعرض مخفياً، ويمكنك إظهاره للتحقق من صحة الإدخال.
5. رقم تسلسل مصدر الدخل: حقل اختياري، يُدخل إذا كانت الدائرة زوّدتك به.
6. اضغط حفظ إعدادات الربط.

الخطوة 3: جرّب ببيئة الاختبار أولاً

ابدأ دائماً ببيئة الاختبار قبل أي فاتورة حقيقية:

1. اضبط بيئة الاتصال على Testing.
2. أصدر فاتورة تجريبية لعميل تجريبي (غير مسودة، فالمسودة لا تُرسل).
3. يرسلها موثوق تلقائياً إلى JoFotara ويعرض النتيجة: معتمدة مع رمز QR، أو مرفوضة مع سبب الرفض.
4. جرّب أنواعاً مختلفة: فاتورة نقدية وأخرى آجلة، وفاتورة بنسبة ضريبة 16% وأخرى بنسبة صفرية إن كان تسجيلك يقتضي ذلك، وإشعاراً دائناً.
5. إذا رُفضت فاتورة، اقرأ سبب الرفض وصحّح الإعداد، ثم أعد الإرسال من صفحة الفاتورة.

وعندما تنجح جميع السيناريوهات، حوّل بيئة الاتصال إلى البيئة الحقيقية. تأكد من إدخال البيانات الخاصة بكل بيئة كما أصدرتها لك البوابة.

الخطوة 4: أصدر فواتيرك الحقيقية

عند إصدار فاتورة غير مسودة في الشركات المرتبطة، يُرسلها النظام تلقائياً. وبعد الاعتماد:

• تُحفظ استجابة النظام الوطني، ويظهر رمز QR للفاتورة المعتمدة في الطباعة.
• تظهر حالة الفاتورة في قائمة الفواتير، ويوجد تقرير مبيعات يعرض حالة كل فاتورة في الفوترة الوطنية.
• لا تُلغى الفاتورة المعتمدة وطنياً بزر الإلغاء، بل بإصدار إشعار دائن مرتبط بها. اقرأ الإشعار الدائن وإلغاء الفاتورة.

ماذا لو لم تكن مرتبطاً بعد؟

لا يمنعك ذلك من العمل: تُصدر الفاتورة محلياً داخل النظام، ويمكنك لاحقاً، بعد إكمال الربط، إرسال الفواتير غير المرسلة من صفحة الفاتورة بزر "إرسال للفوترة الوطنية".

حالات الفاتورة مع JoFotara

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

أشهر أسباب الرفض وحلها

• "This user is not authorized to submit this type of invoice": نوع الفاتورة لا يطابق نوع تسجيلك (ضريبة دخل فقط مقابل ضريبة مبيعات). اضبط خيار "الشركة مسجلة بضريبة المبيعات" في إعدادات الشركة.
• بيانات ربط خاطئة أو من بيئة أخرى: تأكد أن الـClient ID والمفتاح السري يخصّان البيئة المختارة، وأنهما بلا مسافات زائدة.
• رقم ضريبي غير صحيح: صحّحه في بيانات الشركة.
• بيانات عميل غير صالحة: راجع رقم العميل الضريبي وبياناته، فالنظام الوطني يتحقق منها.
• فشل الاتصال المؤقت: تبقى الفاتورة بحالة غير مرسلة، فأعد الإرسال لاحقاً من صفحتها.

هل الربط مجاني؟

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

قائمة تحقق قبل الانتقال إلى البيئة الحقيقية

لا تحوّل البيئة قبل أن تنجح كل هذه الفحوصات في بيئة الاختبار:

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

حماية بيانات الربط

الـClient ID والمفتاح السري يخوّلان إصدار فواتير باسم منشأتك، فاحمهما:

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

ابدأ ببيئة الاختبار الآن

يمكنك تجربة الربط كاملاً قبل أن تصدر أي فاتورة حقيقية. أنشئ حسابك المجاني في موثوق، وأدخل بيانات الربط ببيئة الاختبار، وأصدر فاتورة تجريبية لترى الاعتماد ورمز QR بنفسك. الربط متاح حتى في الخطة المجانية.

أسئلة شائعة

كيف أحصل على Client ID وSecret Key؟

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

هل أجرّب الربط قبل إصدار فواتير حقيقية؟

نعم، وهذا ما ننصح به. يوفر موثوق بيئة اختبار (Testing) تجرّب بها الإرسال والاعتماد والرفض قبل التحويل إلى البيئة الحقيقية.

لماذا لا تُرسل فاتورتي إلى JoFotara؟

تأكد أن الربط مفعّل بإدخال Client ID والمفتاح السري، وأن الفاتورة غير مسودة، وأن شركتك مسجلة بدولة الأردن. إن لم تُرسل، فستظهر "غير مُرسلة" ويمكنك إرسالها يدوياً من صفحتها.

ماذا أفعل إذا رُفضت الفاتورة؟

اقرأ سبب الرفض المعروض، وصحّح الإعداد (أشيعه نوع التسجيل أو الرقم الضريبي)، ثم أعد الإرسال من صفحة الفاتورة.

هل أستطيع إلغاء فاتورة معتمدة؟

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

هل يعمل الربط للشركات خارج الأردن؟

لا. JoFotara نظام أردني، ويظهر الربط للشركات المسجلة بدولة الأردن فقط.

هل الربط مع JoFotara مجاني؟

نعم، متاح في الخطة المجانية وفي الخطط المدفوعة في موثوق دون رسوم إضافية للربط.

أين أجد رمز QR للفاتورة؟

يظهر رمز QR للفاتورة المعتمدة وطنياً في صفحتها وعند الطباعة والتنزيل.