حالة استخدام · الفوترة الإلكترونية في الأردن
ربط جو فوترة مع الـ POS أو نظام المحاسبة أو الـ ERP
جو فوترة هو نظام الفوترة الوطني في الأردن، وتديره دائرة ضريبة الدخل والمبيعات. نربط النظام اللي تستخدمه اليوم، فتوصل كل عملية بيع مكتملة إلى جو فوترة بدون ما أحد يعيد كتابتها.
مين يقدر يربط نظامي مع جو فوترة، وماذا يحتاج الربط؟
أي نشاط يصدر فواتير يقدر ينضم إلى جو فوترة، مهما كان نظامه الحالي. وإذا كان نظام الـ POS أو المحاسبة أو الـ ERP عندك يقدر يرسل الفواتير المكتملة عبر API، نربطه نحن. تربط أنت الجهاز من بوابة جو فوترة وتحصل على معرّف العميل والمفتاح السري، ونرسل كل فاتورة بصيغة UBL 2.1.
لمن هذه الصفحة
للأنشطة اللي تبيع في الأردن وتصدر فواتيرها من واحد من هذه:
- Odoo، وتعريبه للأردن فيه وحدة لجو فوترة. ابدأ منها.
- نظام POS سحابي يقدر يرسل المبيعات المكتملة عبر API أو webhook.
- نظام محاسبة له API.
- ملفات Excel أو بدون نظام. بوابة جو فوترة تقبل فواتير تكتبها باليد، وإذا فواتيرك قليلة ممكن تكفيك. نقول لك إذا كانت تكفي.
إذا كان نظامك ما يقدر يرسل الفواتير المكتملة عبر API أو webhook، فالربط ما يناسبك بوضعه الحالي. نقول لك هذا من أول محادثة، ونوجهك إلى البوابة أو إلى نظام ثاني.
الشروط اللي يلتزم فيها الربط مع جو فوترة
هذه شروط الدائرة نفسها، كما نقرأها في أدلتها. كل صف مرتبط بالمستند اللي أخذناه منه.
| الموضوع | ماذا تقول الدائرة | ماذا يعني للربط |
|---|---|---|
| معرّف العميل والمفتاح السري | في طريقتان. بدون برنامج محاسبة تضيف مستخدماً فرعياً وتنظّم الفواتير من البوابة. مع برنامج محاسبة تربط الجهاز، فيعطيك معرّف العميل (Client ID) والمفتاح السري (Secret Key)، وتكمل المتطلبات الفنية، وبعدها البرنامج يرسل الفواتير مباشرة. | نحتاج المعرّف والمفتاح السري من حسابك على جو فوترة عشان نرسل الفواتير. ويظل المفتاح السري سري. |
| صيغة الفاتورة | الدليل التقني الإصدار 1.5 (اعتماد 14 أيار 2026): الفاتورة ملف XML بصيغة UBL 2.1، مشفّر Base64 داخل JSON، ويُرسل إلى الخادم مع ترويسة Client-Id وSecret-Key. | نبني ملف UBL 2.1 لكل عملية بيع، ونشفّره Base64 داخل JSON، ونرسله مع ترويسة Client-Id وSecret-Key. |
| نوع الفاتورة | ثلاث عائلات فواتير: فاتورة الدخل (لمن غير مسجل في ضريبة المبيعات)، وفاتورة المبيعات العامة، وفاتورة المبيعات الخاصة. ولكل منها فاتورة إرجاع. طريقة الدفع (نقد أو ذمم) ونوع الفاتورة (محلي، تصدير، منطقة تنموية، ترانزيت، تجارة خارجية، تحويل منطقة حرة) يُكتبان داخل الفاتورة. | نختار لكل عملية بيع نوع الفاتورة اللي يسمح به تسجيلك، والمرتجع نرسله فاتورة إرجاع. وجو فوترة يرفض النوع غير المطابق، مثل فاتورة دخل من بائع مسجل في ضريبة المبيعات. |
| الرد ورمز QR والـ UUID | الجواب من النظام يحمل حالة الفاتورة ورمز QR ومعرّفاً فريداً (UUID). رمز QR الراجع من النظام لازم يُطبع على فاتورة البائع. احتفظ بالرقم والـ UUID والرمز والحالة. وعند إعادة الإرسال استخدم نفس الرقم ونفس الـ UUID. | نحتفظ بالرقم والـ UUID والرمز والحالة مع كل عملية بيع، ونرجّع رمز QR إلى نظامك عشان يظهر على الفاتورة. وعند إعادة الإرسال نستخدم نفس الرقم ونفس الـ UUID. |
| اسم المشتري | اسم المشتري إلزامي في فواتير الذمم وفي الفواتير النقدية التي تزيد عن 10,000 دينار (أو ما يعادلها بعملة أخرى). | نرسل اسم المشتري إذا كان عند نظامك، وننبهك للفواتير اللي تشترطه الدائرة وهو ناقص فيها. |
راجعنا المعلومات مع مستندات الدائرة في 1 نوفمبر 2026. الدليل التقني الإصدار 1.5.
أربع طرق لإيصال الفواتير إلى جو فوترة
اختر أبسط طريقة تغطي فواتيرك. الربط اللي نبنيه لك يجي آخر القائمة، وما يجي أولها.
| الطريقة | لمن تناسب | ماذا تحتاج | أين تتوقف |
|---|---|---|---|
| وحدة جو فوترة داخل نظامك | نظام فيه هذه الوحدة. تعريب Odoo للأردن فيه وحدة لجو فوترة. | رقم النشاط والمفتاح السري ومعرّف العميل، وهذا اللي تطلبه وحدة Odoo. | حسب قراءتنا لتوثيق Odoo، الوحدة ترسل الفواتير اللي يصدرها Odoo نفسه. وPOS منفصل ما يسجل مبيعاته داخل Odoo يحتاج طريقته الخاصة. وتأكد أن نسختك فيها الوحدة. |
| الربط الجاهز من مزوّد الـ POS أو الـ ERP | نظام تقول شركته إنه يرسل الفواتير إلى جو فوترة. | معرّف العميل والمفتاح السري من حسابك على جو فوترة، وخطوات الإعداد من الشركة. | يغطي اللي بنته الشركة فقط. ما عندنا قائمة بالأنظمة اللي فيها هذا الربط، فاسأل شركتك عمّا يدعمه نظامك. |
| كتابة الفواتير باليد في بوابة جو فوترة | نشاط بدون برنامج محاسبة، أو فواتيره قليلة. | حساب على البوابة ومستخدم فرعي. | كل فاتورة تكتبها باليد. وتصير بطيئة عند حوالي 1,000 فاتورة في الشهر. هذه قاعدة تقريبية منا، وما هي قاعدة من الدائرة. |
| ربط نبنيه لك | نظام له API وما فيه وحدة لجو فوترة، أو فواتير تطلع من أكثر من نظام، أو قواعد خاصة بك. | معرّف العميل والمفتاح السري، وصلاحية API على نظامك، ووصف بسيط لطريقة إصدار فواتيرك. | لازم نظامك يرسل الفواتير المكتملة عبر API أو webhook. وهو أيضاً برنامج لازم أحد يتابعه، والدليل التقني للدائرة ممكن يتغير. |
رقم 1,000 فاتورة قاعدة تقريبية منا، وما هو من الدائرة.
إذا تستخدم Odoo
تعريب Odoo للأردن فيه وحدة للربط مع جو فوترة. تحتاج رقم النشاط والمفتاح السري ومعرّف العميل، وتنتج فاتورة بصيغة UBL 2.1. ابدأ بهذه الوحدة.
تأكد أن نسخة Odoo عندك فيها هذه الوحدة. التوثيق اللي قرأناه للإصدار 19.0.
نقدر ندخل لما ما تغطي الوحدة حالتك. حسب قراءتنا لتوثيق Odoo، الوحدة ترسل الفواتير اللي يصدرها Odoo نفسه. وPOS منفصل ما يسجل مبيعاته داخل Odoo يحتاج طريقته الخاصة، وهنا نقدر نربط ذلك النظام مع جو فوترة.
الإيصال والفاتورة
تعليمات الدائرة لسنة 2019 تقول إن كل من يبيع سلع أو خدمات يصدر فاتورة، إلا اللي تستثنيهم التعليمات بالاسم. وما قدرنا نتأكد أن هذه الاستثناءات ما زالت كما هي في 2026. أداة فحص الجاهزية تعطيك نتيجة «قد يكون نشاطك معفى» إذا كانت حالتك تنطبق عليها.
رمز QR الراجع من جو فوترة لازم يُطبع على فاتورة البائع. أما المستند اللي يستلمه العميل عند الدفع، هو إيصال أو فاتورة منفصلة، فهذا سؤال للدائرة أو لمحاسبك. ما نخمّن، ونبني على جوابهم.
المرتجع فاتورة إرجاع. لكل نوع فاتورة نوع إرجاع خاص به، ونرسله بنفس الطريقة.
كيف يشتغل الربط
هذه الخطوات بالترتيب اللي نقدر نمشي عليه إذا اشتغلنا معك. الصيغة وطريقة التعامل مع الرد تحددهما الدائرة، أما الخطوات فهي طريقتنا.
- أنت تربط نظامك من بوابة جو فوترة وتحصل على معرّف العميل والمفتاح السري. ونقدر نحفظ المفتاح السري في إعدادات محمية، وما نحطه في الكود.
- نقدر نقرأ كل عملية بيع مكتملة من نظامك، عبر API أو webhook، بعد ما تكتمل فقط.
- نقدر نحوّلها إلى فاتورة جو فوترة: نوع الفاتورة المناسب لتسجيلك الضريبي، وطريقة الدفع، ونوع البيع، واسم المشتري إذا كان مطلوب.
- نقدر نبني ملف UBL 2.1، ونشفّره Base64 داخل JSON، ونرسله مع ترويسة Client-Id وSecret-Key.
- نقدر نحفظ رد جو فوترة مع عملية البيع: الحالة ورمز QR والـ UUID، ونرجّع رمز QR إلى نظامك عشان يظهر على الفاتورة.
- إذا رفض جو فوترة فاتورة، نقدر نعرض لك الرسالة وسببها ونصلح السبب أول شي. وعند إعادة الإرسال نقدر نستخدم نفس الرقم ونفس الـ UUID. وإذا فشل الطلب قبل ما يصلنا رد، نقدر نعيد المحاولة وننبهك إذا استمر الفشل.
- نقدر نقارن اللي أصدره نظامك باللي رجع عليه رد من جو فوترة، وننبهك لأي عملية بيع ما رجع لها رد.
ماذا نحتاج منك
- حساب على جو فوترة مربوط بنظامك، مع معرّف العميل والمفتاح السري اللي تحصل عليهم منه.
- أي نظام يصدر فواتيرك اليوم، ومسؤول عنده يعطينا صلاحية API.
- تسجيلك الضريبي، عشان نختار نوع الفاتورة الصحيح: فاتورة دخل أو مبيعات عامة أو مبيعات خاصة.
- كيف تتعامل مع المرتجعات، وأي مبيعاتك نقدية وأي منها بالذمم.
- طريقة تعرض رمز QR على الفاتورة اللي يستلمها عميلك.
- جواب محاسبك عن المستند اللي يستلمه العميل عند الدفع: إيصال أو فاتورة منفصلة.
تأكد من جاهزيتك أول شي
12 سؤال على الأكثر، وما نطلب بريدك الإلكتروني، وكل خطوة مرتبطة بمستند الدائرة اللي أخذناه منه.
افتح أداة فحص جاهزية جو فوترةأسئلة شائعة
المصادر
كل ما كتبناه عن جو فوترة مأخوذ من مستندات الدائرة نفسها ومن توثيق Odoo، كما كانت منشورة وقت آخر مراجعة لنا. ممكن الدائرة تغيّر قواعدها، فتأكد منها قبل ما تعتمد على هذا. والخطوات ورقم 1,000 فاتورة منا، وما هي من الدائرة.
- دائرة ضريبة الدخل والمبيعات: نظام الفوترة الوطني
- دليل إجراءات الانضمام، طبعة 2026
- الدليل التقني للربط، الإصدار 1.5
- تعليمات تنظيم ومراقبة شؤون الفوترة رقم (1) لسنة 2019
- توثيق Odoo: الأردن
راجعنا المعلومات مع مستندات الدائرة في 1 نوفمبر 2026. الدليل التقني الإصدار 1.5.
قبل ما تعتمد على هذا
هذه الصفحة معلومات عامة من مستندات الدائرة المنشورة. ما هي استشارة ضريبية أو قانونية، وما هي خدمة من الدائرة. تأكد من الدائرة أو من محاسبك قبل ما تتصرف. بوتلتك غير تابعة لدائرة ضريبة الدخل والمبيعات.
تريد نظام النقاط أو المحاسبة عندك يرسل الفواتير إلى جو فوترة؟
قل لنا أي نظام تستخدم. نرسم لك الربط ونقول لك إذا كان مناسباً، سواء اشتغلت معنا أو لا.