التكامل مع «فوترة» الأردنية (JoFotara)

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

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

ما الذي يختلف في الأردن

بالمقارنة مع جيرانه، التكامل الأردني هو الأقصر.

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

الاتصال بالمنصة

ابدأ بتفعيل صفحة الدولة. من الإعدادات العامة، الصفحة الثانية، اضبط عرض صفحة الفاتورة الإلكترونية الخاصة بـ على الفاتورة الألكترونية بالأردن (أو كل الصفحات إذا كنت تقدّم إقرارات في أكثر من دولة)، ثم نفّذ إعادة توليد الواجهة (Regen UI) حتى تظهر الصفحة.

بعد ذلك أنشئ إعدادات مصلحة الضرائب — الأساسيات ← إعدادات مصلحة الضرائب ← إعدادات مصلحة الضرائب — واضبط نوع الممول على الأردن - الفاتورة الألكترونية. اختيارُه يملأ لك API URL؛ اتركه كما هو ما لم تنشر الدائرة عنوانًا جديدًا.

يعرّفك على المنصة بيانان، وكلاهما يأتي من حسابك على بوابة JoFotara:

الحقل في صفحة الأردن	ما تضعه فيه
اسم المستخدم	معرّف العميل (Client Id) الصادر لمنشأتك من JoFotara
كلمة المرور	المفتاح السري (Secret Key) المرتبط بذلك المعرّف

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

لا توجد بيئة تجريبية للأردن

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

من تكون أنت في نظر المنصة

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

• حساب معرف الفرع من يحدد المحدِّد — شركة أو فرع أو قطاع وما إلى ذلك — الذي يُؤخذ سجلّه بوصفه مُصدِر الفاتورة. اسمه وبلده هما ما يسافر مع الفاتورة، فلا بد أن يكون سجلًا حقيقيًا مضبوط الدولة.
• رقم التسجيل الضريبى هو رقم ضريبة المبيعات لمنشأتك، ويُرسَل بوصفه المعرّف الضريبي للبائع.
• نوع النشاط للفرع هو رمز نشاط الممول الذي صدر به تسجيلك. يطلبه الأردن ويُرسَل في كتلة مستقلة خاصة بالبائع مع كل فاتورة، ولذلك فإن خلوّ نوع النشاط للفرع هو أول ما ينبغي فحصه حين تبدأ المنصة برفض المستندات.

من يكون العميل في نظر المنصة

تتحدد هوية المشتري من حقل الكيان القانونى للشركة في البيانات الضريبية للعميل، ويترجمها نظام نما إلى نظام الهوية الذي تتوقعه JoFotara:

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

والنتيجة العملية أن حقل الكيان القانوني ليس حقلًا تجميليًا في الأردن. فعميل مؤسسي تُرك كيانه فرد يُهمَل رقمه الضريبي ويُرسَل رقم بطاقته الشخصية بدلًا منه، وهو ما لن تستطيع المنصة مطابقته بأي ممول مسجَّل.

وفيما عدا الهوية، لا يُرسَل عن المشتري سوى الاسم والرمز البريدي والمحافظة والدولة.

ما الذي يقبله الأردن

المستند	مدعوم
الفاتورة	نعم
المرتجع (إشعار دائن)	نعم
الإشعار المدين	لا

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

الإشعارات المدينة لا تذهب إلى الأردن

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

القيم والعملة والضريبة

تُعبَّر كل قيمة في الفاتورة الأردنية بـالدينار الأردني أيًّا كانت عملة المستند المصدر. وحين تختلف العملتان يحوّل نظام نما أرقام المستند بالسعر المحفوظ على المستند نفسه، فتصل المنصةَ فاتورةٌ متسقة حسابيًا بالدينار لا مزيجًا من عملتين.

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

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

أكواد الأصناف ليست جزءًا من الفاتورة الأردنية

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

الإرسال، وما يعود منه

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

حين تقبل المنصة مستندًا تهبط ثلاثة أشياء على سطره:

العمود	ما يحمله
حالة المستند بمصلحة الضرائب	حالة المنصة نفسها للفاتورة المقبولة
Signed Invoice Base 64	النسخة الموقّعة من فاتورتك كما أعادتها JoFotara
Qr Code Base 64	رمز الاستجابة السريعة الذي يُطبع على نسخة العميل

وتصير حالة السطر تم ارساله.

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

كل فاتورة تحمل رقمًا تسلسليًا

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