قررت منشأتك الانتقال من برنامج محاسبي مربوط إلى برنامج آخر؟ تغيير البرنامج المحاسبي المربوط بنظام الفوترة الوطني لا ينتهي بتشغيل البرنامج الجديد. فالفواتير التي أرسلها البرنامج القديم تبقى في النظام برقمها ومعرّفها الفريد، وأي فاتورة إرجاع تصدرها عليها لاحقًا يجب أن تشير إليها بهذه البيانات نفسها، ومن البرنامج الجديد هذه المرة.
يعرض هذا المقال ما يحتاجه البرنامج الجديد ليعمل من أول فاتورة، وهو بيانات ربط لكل تسلسل مصدر دخل يرسل منه، والبيانات التي ينبغي نقلها من البرنامج القديم حتى تبقى فواتير الإرجاع على الفواتير السابقة ممكنة، ثم ما لا يحسمه الدليل التقني للربط الصادر عن دائرة ضريبة الدخل والمبيعات. والمرجع في كل ذلك الدليل التقني للربط مع نظام الفوترة الوطني (الإصدار 1.5) ودليل الأسئلة والأجوبة لعام 2026.
ولا يتناول المقال اختيار البرنامج نفسه، ولا نقل الأرصدة والمخزون، ولا المفاضلة بين الإصدار من المنصة والربط، فلهذه المفاضلة مقال الجمع بين المنصة والربط في نظام الفوترة الوطني.
تغيير البرنامج المحاسبي المربوط بنظام الفوترة الوطني: ما يتغير وما يبقى
يساعدك الفصل بين ما يتغير وما يبقى على معرفة ما يجب تجهيزه قبل الانتقال.
- يتغير البرنامج المرسِل. البرنامج الجديد هو الذي يبني ملف الفاتورة بمعيار UBL 2.1 ويرسله، ويحتاج لذلك بيانات ربط يستخدمها في كل إرسال.
- يبقى حسابك على النظام. الرقم الضريبي للمنشأة وتسلسلات مصدر الدخل مرتبطة بحسابك على نظام الفوترة الوطني، لا بالبرنامج الذي يرسل منه.
- تبقى الفواتير المقبولة سابقًا. كل فاتورة أرسلها البرنامج القديم وقُبلت تبقى معرّفة في النظام برقمها ومعرّفها الفريد معًا.
- يبقى التزام الربط. تقول الدائرة في دليل الأسئلة والأجوبة إن «من يمتلك نظام محاسبي يلزمه ربط نظامه مع نظام الفوترة»، فالانتقال بين برنامجين يجري داخل مسار الربط ولا يخرج منه.
فالعمل الفعلي في الانتقال يقع في نقطتين، تجهيز بيانات الربط للبرنامج الجديد، ونقل بيانات الفواتير السابقة إليه. والأقسام التالية تفصّل كلًّا منهما.
بيانات الربط: رقم مستخدم ومفتاح سري لكل تسلسل مصدر دخل
يرسل البرنامج المربوط فواتيره بزوج من بيانات الربط هما رقم المستخدم (Client ID) والمفتاح السري (Secret Key). ويصف الدليل التقني طريقة الحصول عليهما من حساب المستخدم الرئيسي على نظام الفوترة الوطني، إذ تدخل خيار «ربط الأجهزة» وتنشئ ربطًا جديدًا تدخل فيه اسم مستخدم وتختار تسلسل مصدر الدخل، فيولّد النظام رقم المستخدم والمفتاح السري. والخطوات بالتفصيل في مقال رقم المستخدم والمفتاح السري في نظام الفوترة الوطني.
وفي هذه القائمة ما يهمك عند تغيير البرنامج.
- كل زوج مرتبط بتسلسل واحد. يظهر في كل صف تسلسل مصدر الدخل الذي أُنشئ له الربط. فإذا كان البرنامج الجديد سيرسل فواتير أكثر من تسلسل، فهو يحتاج زوجًا لكل تسلسل منها.
- التسلسل يُرسل داخل كل فاتورة أيضًا. يحمل ملف الفاتورة تسلسل مصدر الدخل في العنصر
cac:SellerSupplierParty/cbc:ID، فيجب أن يضبطه البرنامج الجديد على التسلسل الصحيح. وتجد تعريف هذا التسلسل ومكانه في مقال تسلسل مصدر الدخل في نظام الفوترة الوطني. - الخطأ في التسلسل يظهر رفضًا. يذكر الدليل أن خطأ 500 يرجع إلى «خطأ في الرقم الضريبي أو تسلسل مصدر الدخل وبدرجة أقل يكون الخطأ في ال Client_ID أو ال Secret_Key». ويذكر رسالة الرفض «This user is not authorized to submit this type of invoice» حين يرسل المكلف نوع فاتورة لا يتناسب مع رقمه الضريبي أو تسلسل مصدر الدخل الخاص به.
ولا يتناول الدليل التقني صراحة ما إذا كان على المكلف أن ينشئ زوجًا جديدًا عند تغيير البرنامج أو أن يسلّم الزوج القائم إلى البرنامج الجديد. لكنه يضع سرية بيانات الربط على المكلف وحده، إذ «يتحمّل كامل المسؤولية عن أي استخدام غير مصرح به»، ويطلب في إرشاداته حماية رقم المستخدم والمفتاح السري وعدم تخزينهما بشكل مكشوف داخل الكود البرمجي. ومن هنا نرى، رأيًا عمليًا لا نصًّا في الدليل، أن إنشاء زوج خاص بالبرنامج الجديد يجعل كل زوج مرتبطًا ببرنامج واحد تعرف من يديره.
وتُظهر القائمة كذلك عمودًا باسم «حالة المستخدم»، ولا يشرح الدليل التقني أي أثر لتغييره. فاستوضح من الدائرة كيف تتعامل مع بيانات الربط التي كان يستخدمها البرنامج القديم، ولا تبنِ على افتراض في ذلك.
ويوجّه دليل إجراءات الانضمام إلى نظام الفوترة الوطني المكلفَ إلى التنسيق مع «مبرمج النظام أو مزود الحلول التقنية المعتمد لديه» لاستكمال المتطلبات الفنية. والمقصود هنا المزوّد الذي يتعامل معه المكلف نفسه، فالعبارة لا تشير إلى قائمة مزوّدين تعتمدها الدائرة.
لماذا تحتاج فواتير الإرجاع القديمة إلى بيانات البرنامج السابق
التصحيح بعد إرسال الفاتورة يجري في نظام الفوترة الوطني بفاتورة إرجاع، وهي في الدليل التقني الفاتورة ذات الرمز 381، وتقابل الإشعار الدائن، ويكون الإرجاع على الكميات فقط. وفاتورة الإرجاع لا تقف وحدها، بل تشير إلى الفاتورة الأصلية بثلاثة عناصر.
- رقم الفاتورة الأصلية في
cbc:ID. - المعرّف الفريد للفاتورة الأصلية في
cbc:UUID. - القيمة الإجمالية للفاتورة الأصلية في
cbc:DocumentDescription.
فإذا أرسل البرنامج القديم فاتورة في الشهر الماضي وأرجع العميل جزءًا من بضاعتها بعد الانتقال، فالبرنامج الجديد هو الذي سيصدر فاتورة الإرجاع، ويحتاج لذلك هذه العناصر الثلاثة كما أُرسلت أول مرة. ويشرح مقال المعرّف الفريد UUID في نظام الفوترة الوطني لماذا يُعامل الرقم والمعرّف معًا.
ولا تقف الشروط عند رأس الفاتورة. فالدليل يطلب أن تأتي بنود فاتورة الإرجاع برقم البند واسم السلعة وسعر الوحدة «كما هو في الفاتورة الاصلية»، ويشترط تطابق المشتري بقوله «يجب أن تتوافق بيانات المشتري في فاتورة الإرجاع مع بياناته في فاتورة البيع الأصلية المرتبطة بها».
وتنص الملاحظات التشغيلية في الدليل على أن رقم الفاتورة «لا يقتصر على رقم الـ ID فقط، وإنما يتكوّن من الـ ID والـ UUID معاً كمفتاح رئيسي»، وعلى وجوب الاحتفاظ برقم البند الخاص بالسلعة عند إصدار فاتورة البيع لاستخدامه لاحقًا في الإرجاع، «حيث يتم الاعتماد عليه في مطابقة السلعة المرتجعة مع بيانات الفاتورة الأصلية».
ويضيف الدليل قاعدتين تمسّان الانتقال مباشرة.
- الإرجاع على الكميات ولا يتجاوز الأصل. يجوز إرجاع الكمية كاملة أو جزء منها على أكثر من فاتورة إرجاع، حتى تنفد كميات الفاتورة الأصلية. ويترتب على ذلك عمليًا أن البرنامج الجديد يحتاج معرفة ما أُرجع سابقًا من كل بند، ولو كان الإرجاع السابق قد صدر من البرنامج القديم. وتفصيل هذا الرفض في مقال إرجاع يتجاوز الكمية الأصلية في نظام الفوترة الوطني.
- الخصم يتبع الكمية المرجعة. ينص الدليل على أنه «اذا كان الارجاع لجزء من الكمية فيجب ان يكون الخصم (إن وجد) جزء من الخصم الكلي للسلعة او الخدمة حسب الكمية المرجعة». فخصم كل بند في الفاتورة الأصلية بيان يحتاجه البرنامج الجديد أيضًا.
البيانات التي تنقلها من البرنامج القديم إلى البرنامج الجديد
يجمع الجدول التالي ما ينبغي أن يصل إلى البرنامج الجديد عن كل فاتورة سابقة قد تُرجع منها كميات، مع سند كل بيان في الدليل التقني.
مرِّر الجدول أفقيًا لعرض بقية الأعمدة
والبندان الأخيران يطابقان الإرشاد الخامس من إرشادات الدائرة العشر، وعنوانه «تخزين البيانات الأساسية».
وليس في الدليل التقني صيغة محددة لنقل هذه البيانات بين برنامجين، فطريقة النقل مسألة تتفق عليها مع مزوّد البرنامج الجديد. والمهم أن تصل البيانات كما أُرسلت إلى النظام، لا كما تظهر في نسخة الطباعة.
الفواتير المعلقة لحظة الانتقال
قد يحين موعد الانتقال وفي البرنامج القديم فواتير لم تُحسم حالتها، كفاتورة انقطع الاتصال أثناء إرسالها، أو فاتورة رُفضت ولم يُعد إرسالها بعد. ويحسم الدليل التقني طريقة التعامل معها بثلاث قواعد.
- الحالة تُقرأ من EINV_STATUS. يقرر الدليل أن الحكم على الفاتورة يكون من حالة الفاتورة العائدة في الاستجابة، لا من رمز نجاح الاتصال وحده.
- إعادة الإرسال بالرقم والمعرّف نفسيهما. عند فشل الإرسال أو انقطاع الاتصال يعيد المكلف الإرسال بالرقم والمعرّف الفريد نفسيهما دون توليد معرّف جديد، وينبه الدليل إلى أن عدم تخزين المعرّف «قد يؤدي ذلك إلى تكرار الفواتير عند إعادة الإرسال».
- الفاتورة المقبولة سابقًا تعيد رمزها. إذا أُعيد إرسال فاتورة سبق قبولها بالرقم والمعرّف نفسيهما، فالحالة العائدة ALREADY_SUBMITTED ومعها رمز QR الأصلي. وهذا هو الطريق الموثق لاستعادة رمز لم يُحفظ، كما في مقال حالة ALREADY_SUBMITTED في نظام الفوترة الوطني.
فأفضل وقت لحسم هذه الفواتير قبل إيقاف البرنامج القديم. وإن انتقلت قبل حسمها، فانقل رقمها ومعرّفها الفريد إلى البرنامج الجديد قبل أي إعادة إرسال، حتى لا يولّد لها معرّفًا جديدًا فتتكرر.
عداد الفاتورة ICV بعد تغيير البرنامج: ما لا يحسمه الدليل
يحمل كل ملف فاتورة عدادًا في العنصر cac:AdditionalDocumentReference بقيمة ICV، ويعرّفه الدليل بأنه «عداد يتم إنشاؤه من قبل المكلف للفواتير الإلكترونية يبدأ بشكل تسلسلي من 1 الى ما لانهاية حسب التعريف العالمي». وتفصيله في مقال عداد الفاتورة ICV في نظام الفوترة الوطني.
أما استمرار هذا العداد عند تغيير البرنامج فلا يتناوله الدليل التقني 1.5. فهو لا يقول هل يكمل البرنامج الجديد من آخر قيمة أرسلها البرنامج القديم أم يبدأ من 1، ولا يقول هل العداد واحد للمنشأة أم مستقل لكل تسلسل مصدر دخل. وكذلك لا يتناول الدليل ترقيم الفواتير نفسه عند الانتقال بين برنامجين، ويكتفي بتقرير أن الفاتورة تُعرف بالرقم والمعرّف الفريد معًا.
لذلك لا نقدم هنا قاعدة لم ترد في النص. والخطوة الآمنة أن تتفق مع مزوّد البرنامج الجديد على طريقة العداد والترقيم قبل أول إرسال، وأن تستوضح من لجنة الدعم الفني لشؤون الفوترة في الدائرة، التي يحيل إليها الدليل عبر موقع دائرة ضريبة الدخل والمبيعات.
فك ربط الأجهزة ليس خطوة في تغيير البرنامج
قد يبدو أن الانتقال يبدأ بفك الربط ثم الربط من جديد، لكن الدائرة لا تعرض فك الربط بهذه الصورة. فهو طلب خدمة داخلية من نوع «طلب دعم فني لنظام الفوترة»، تبت فيه الدائرة، وتقصره على حالة واحدة نصها في دليل الأسئلة والأجوبة «طلب فك ربط الأجهزة يكون فقط لمن ليس لديه نظام محاسبي ويكون قام بالربط عن طريق الخطأ اما من يمتلك نظام محاسبي يلزمه ربط نظامه مع نظام الفوترة».
ويتضمن الطلب تعهدًا بعدم وجود نظام محاسبي لدى المكلف، وهذا لا يصدق على منشأة تنتقل من برنامج إلى آخر. فتغيير البرنامج المحاسبي المربوط بنظام الفوترة الوطني يبقى داخل مسار الربط، وتجهيزه يمر ببيانات الربط ونقل البيانات كما سبق، لا بطلب فك الربط.
وإن كانت لديك فواتير أصدرتها من المنصة قبل أن تربط أول برنامج، فجواب الدائرة في السؤال الرابع عشر أن المنصة تتيح إرجاع الفواتير المرسلة عبرها «في جميع الحالات سواء تم الربط مع نظام الفوترة أو لم يتم». ونتناول هذه الحالة في مقال مستقل عن إرجاع فواتير البوابة قبل الربط وبعده.
قائمة تحقق قبل أول فاتورة من البرنامج الجديد
- حصر التسلسلات. حدد كل تسلسل مصدر دخل سيرسل منه البرنامج الجديد، وجهّز لكل تسلسل زوج بيانات ربط.
- تسليم بيانات الربط بأمان. أدخل رقم المستخدم والمفتاح السري في البرنامج الجديد دون تداولهما مكشوفين، فمسؤولية سريتهما عليك.
- حسم الفواتير المعلقة. راجع حالة كل فاتورة في البرنامج القديم من EINV_STATUS، وأعد إرسال ما يلزم بالرقم والمعرّف نفسيهما.
- نقل بيانات الفواتير السابقة. تأكد أن الرقم والمعرّف الفريد والإجمالي وأرقام البنود وأسماءها وأسعارها وكمياتها وخصوماتها وبيانات المشتري وصلت إلى البرنامج الجديد.
- نقل ما أُرجع سابقًا. تأكد أن الكميات المرجعة قبل الانتقال معروفة للبرنامج الجديد، حتى لا تتجاوز فاتورة إرجاع لاحقة الكمية الأصلية.
- الاتفاق على العداد والترقيم. اتفق مع المزوّد الجديد على طريقة عداد ICV وترقيم الفواتير، واستوضح من الدائرة ما لم يحسمه الدليل.
- الاحتفاظ بالفواتير. توجب المادة (8/أ/1) من نظام تنظيم شؤون الفوترة الاحتفاظ بالفواتير أربع سنوات، فاحتفظ بنسخ فواتير البرنامج القديم ولو توقفت عن استخدامه. والتفاصيل في مقال الاحتفاظ بفواتير نظام الفوترة الوطني في الأردن.
- أول إرسال تحت المراقبة. تابع حالة أول فواتير البرنامج الجديد ورمز QR العائد عليها قبل أن تعتمد عليه في كل مبيعاتك.
وللصورة الكاملة عن طريقة عمل النظام ومسارات الانضمام إليه، يمكنك الرجوع إلى مقال نظام الفوترة الوطني الإلكتروني في الأردن.
كيف يساعدك قيود إذا كان هو البرنامج الجديد
إن كان قيود هو البرنامج الذي تنتقل إليه، فهو برنامج محاسبي متكامل مع نظام الفوترة الوطني يجمع الفوترة الإلكترونية والمحاسبة في نظام واحد. وهذا ما يفعله حين ترسل فواتيرك منه.
- يبني ملف الفاتورة بمعيار UBL 2.1 مع معرّفها الفريد (UUID)، ويرسله دون تدخل يدوي، ولا تحتاج شهادة رقمية ولا توقيعًا من طرفك.
- يفحص كل فاتورة على مستوى الحقول لحظة إنشائها، وينبهك بأي خطأ قبل إرسالها لتقليل حالات الرفض.
- يعرض حالة كل فاتورة ورسالة الخطأ في لوحة الحالة، ويُدرج ما لم يُرسل منها لإعادة إرساله بمعرّف UUID نفسه.
- يطبع على الفاتورة رمز QR الذي تعيده دائرة ضريبة الدخل والمبيعات بعد قبولها.
وللدقة، قيود لا ينشئ حسابك على نظام الفوترة الوطني ولا يولّد رقم المستخدم والمفتاح السري، فهاتان خطوتان تجريهما على منصة الدائرة باسمك. ونقل بيانات فواتير برنامجك السابق مسألة تستوضحها من فريق قيود قبل الانتقال، فلا يعرضها هذا المقال على أنها ميزة جاهزة.
فوترة إلكترونية ومحاسبة متكاملة في نظام واحد
قيود متكامل مع نظام الفوترة الوطني (JoFotara). تُصدر فاتورتك بالدينار الأردني من قيود فتُقيَّد في دفاترك تلقائيًا وتُرسل إلى النظام، وبعد قبولها يعود عليها رمز QR من دائرة ضريبة الدخل والمبيعات.
الأسئلة الشائعة
هل أحتاج رقم مستخدم ومفتاحًا سريًا جديدين عند تغيير البرنامج المحاسبي المربوط؟
يربط الدليل التقني كل زوج من بيانات الربط بتسلسل مصدر دخل واحد، فيحتاج البرنامج الجديد زوجًا لكل تسلسل يرسل منه. ولا يذكر الدليل صراحة هل تنشئ زوجًا جديدًا أو تستخدم الزوج القائم، لكنه يحمّلك كامل المسؤولية عن أي استخدام غير مصرح به، ولذلك نرى إنشاء زوج خاص بالبرنامج الجديد.
هل أستطيع إرجاع فاتورة أرسلها البرنامج القديم من البرنامج الجديد؟
يربط الدليل التقني فاتورة الإرجاع بالفاتورة الأصلية عبر رقمها ومعرّفها الفريد وقيمتها الإجمالية، ويطلب أن تأتي البنود برقمها واسمها وسعرها كما في الأصلية، وأن تتوافق بيانات المشتري. فإذا وصلت هذه البيانات إلى البرنامج الجديد أمكنه أن يبني فاتورة الإرجاع وفق هذه الشروط.
هل يكمل عداد الفاتورة ICV من آخر رقم في البرنامج القديم؟
لا يتناول الدليل التقني 1.5 هذه المسألة، فهو يعرّف العداد بأنه يبدأ تسلسليًا من 1، ولا يذكر حكمه عند الانتقال بين برنامجين. اتفق مع مزوّد البرنامج الجديد على طريقة العداد، واستوضح من لجنة الدعم الفني لشؤون الفوترة في الدائرة قبل أول إرسال.
هل أطلب فك ربط الأجهزة قبل الانتقال إلى البرنامج الجديد؟
تقصر الدائرة طلب فك الربط على من ليس لديه نظام محاسبي وربط بالخطأ، ويتضمن الطلب تعهدًا بعدم وجود نظام محاسبي. فالمنشأة التي تنتقل من برنامج إلى آخر تبقى في مسار الربط، ولا يدخل فك الربط في خطوات انتقالها.
ماذا أفعل بفاتورة لم أعرف هل قُبلت قبل الانتقال؟
أعد إرسالها بالرقم والمعرّف الفريد نفسيهما، كما يوجب الدليل عند فشل الإرسال. فإن كانت مقبولة من قبل عادت الحالة ALREADY_SUBMITTED ومعها رمز QR الأصلي، وإن لم تكن، فالاستجابة تبيّن قبولها أو سبب رفضها.
لماذا رُفضت أول فاتورة من البرنامج الجديد برسالة «not authorized»؟
يربط الدليل التقني هذه الرسالة بإرسال نوع فاتورة لا يتناسب مع الرقم الضريبي للمكلف أو تسلسل مصدر الدخل الخاص به. راجع نوع الفاتورة الذي ضبطه البرنامج الجديد، وتسلسل مصدر الدخل في ملف الفاتورة، وتأكد أن بيانات الربط المستخدمة أُنشئت لهذا التسلسل نفسه.
المصادر
- دائرة ضريبة الدخل والمبيعات، الدليل التقني للربط مع نظام الفوترة الوطني من خلال واجهة برمجة التطبيقات (API)، الإصدار 1.5، ص7 وص8 وص13 وص23 وص24 وص26 وص30 وص99 وص101 وص104.
- دائرة ضريبة الدخل والمبيعات، دليل إجراءات الانضمام إلى نظام الفوترة الوطني الإلكتروني، مسار ربط الأجهزة.
- دائرة ضريبة الدخل والمبيعات، دليل الأسئلة والأجوبة لنظام الفوترة الوطني 2026، السؤال 9 والسؤال 14.
- نظام تنظيم شؤون الفوترة والرقابة عليها رقم (34) لسنة 2019 وتعديلاته، المادة (8).
- الأدلة الإرشادية لنظام الفوترة الوطني على موقع دائرة ضريبة الدخل والمبيعات.
