أخطاء نظام الفوترة الوطني: لماذا تُرفض فاتورتك وكيف تصلحها

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

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

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

القاعدة الأولى: الفاتورة لا تُقرأ من رمز HTTP

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

الرد يحمل عدة حقول، أهمها ثلاثة. Response Status Code وهو النتيجة التقنية للاتصال، وEINV_STATUS وهو الحالة الفعلية للفاتورة، وEINV_MESSAGE الذي يحمل تفصيل الخطأ أو سبب الرفض. ويأتي معها EINV_QR الذي يحمل رمز الاستجابة السريعة، وEINV_SINGED_INVOICE وهي الفاتورة الموقّعة العائدة من النظام.

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

لحقل EINV_STATUS ثلاث قيم، ولكل واحدة معنى تشغيلي مختلف:

• SUBMITTED: الفاتورة مقبولة، ورمز الاستجابة السريعة عاد في EINV_QR. هذه هي الحالة الوحيدة التي تعني أن الفاتورة معتمدة.
• ALREADY_SUBMITTED: أرسلت الفاتورة نفسها مرة أخرى بالمعرّف والرقم الفريد ذاتهما، فأعاد النظام رمز الاستجابة الأصلي. هذه ليست مشكلة، بل هي الطريقة الموثّقة لاستعادة رمز فشلت في تخزينه.
• NOT_SUBMITTED: الفاتورة مرفوضة. رمز الاستجابة الفني لن يكون 200، وحقول الرمز والرقم الفريد ورقم الفاتورة والفاتورة الموقّعة تعود فارغة.

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

خريطة الأخطاء الأربعة: أيها يخصك

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

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

ويضع الدليل قاعدة وقائية قبل ذلك كله: تحقّق من المجاميع والضرائب ورقم المكلف ورقم المشتري والحقول الإلزامية قبل الإرسال، فهذا وحده يقلّل رسائل رمز 400. ويضيف أن الملف يجب أن يطابق معيار UBL 2.1، وأن أي خلل في بنيته يرفض الفاتورة بصرف النظر عن صحة أرقامها. ويوصي كذلك باستخدام تنسيق زمني موحّد بين الأنظمة. أما تاريخ الإصدار فيُرسل بصيغة سنة ثم شهر ثم يوم (yyyy-mm-dd) كما في جميع أمثلة XML في الدليل، فاثبت عليها ولا تتركها لإعدادات الخادم لديك.

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

خطأ 504: المشكلة في الطريق لا في الفاتورة

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

ورمز 504 لا يقول شيئًا عن محتوى الفاتورة، فلا تعاملها كفاتورة رُفض محتواها ولا تقيّدها مرفوضة في دفاترك، ولا تسلّمها للزبون قبل أن يعود رمز الاستجابة السريعة في EINV_QR.

الإرشاد الرسمي هنا دقيق ومهم: عند انقطاع الاتصال أو انتهاء المهلة، أعد الإرسال من دون توليد رقم فريد جديد. توليد رقم فريد جديد عند كل محاولة هو ما يُنتج فواتير مكرّرة، والدليل يحذّر منه صراحة.

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

إعادة الإرسال والرقم الفريد: لماذا تتكرر فواتيرك

مفتاح الفاتورة ليس رقمها وحده، بل رقمها مع الرقم الفريد معًا. الرقم الفريد يولّده نظامك أنت، وهنا مكمن الخطأ الأكثر كلفة.

ويرافق هذين المفتاحين عدّاد الفواتير، ويُرسل في مرجع مستند إضافي يحمل الرمز ICV. وهو رقم صحيح ينشئه نظامك تسلسليًا من 1 لفواتيرك الإلكترونية، ويتصاعد بلا سقف، وهو عنصر مستقل عن رقم الفاتورة نفسه.

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

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

خطأ 403: بيانات اعتماد لا فاتورة

رمز 403 له سبب واحد موثّق: رقم المستخدم أو المفتاح السري غير صحيح. هذان المفتاحان يصدران من خدمة ربط الأجهزة داخل النظام الوطني، وهما مسؤوليتك وحدك، والدليل يضع تبعة أي استخدام غير مصرّح به عليك بالكامل.

والدليل يوصي كذلك بحماية هذين المفتاحين وعدم تضمينهما بشكل مكشوف داخل الشيفرة، وهي توصية أمنية قبل أن تكون تقنية.

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

خطوات الحصول على هذين المفتاحين ليست موضوع هذا الدليل، وتجدها مشروحة بالتفصيل في مقالة خطوات الربط التقني خطوة بخطوة.

خطأ 500: ابدأ من هوية المكلف لا من الفاتورة

رمز 500 هو الأكثر إرباكًا، لأن اسمه يوحي بعطل في الخادم بينما أسبابه الموثّقة تعود إلى بياناتك أنت.

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

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

1. الرقم الضريبي خاطئ. الرقم المرسل في بيانات البائع يجب أن يطابق المسجّل لدى الدائرة، واسم البائع كذلك يُرسل كما هو مسجّل لديها لا كما تكتبه في مطبوعاتك.
2. تسلسل مصدر الدخل خاطئ. وهو والرقم الضريبي السببان الأبرز اللذان يذكرهما الدليل لهذا الرمز. تسلسل مصدر الدخل حقل إلزامي في كل فاتورة تُرسل عبر الواجهة البرمجية، ويُرسل ضمن بيانات النشاط. ومن يربط نظامه يختار التسلسل الذي يُرسل عليه.
3. نسبة ضريبة خارج القائمة. النسب التي يقبلها النظام في حقل نسبة الضريبة قائمة مغلقة: 0 و1 و2 و3 و4 و5 و7 و8 و10 و16، وهي قائمة تحقق لا جدول بالنسب القانونية. أي نسبة خارجها سبب لرمز 500.

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

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

خطأ 400: رسائل التحقق وما تعنيه بالضبط

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

قاعدة اسم المشتري: متى يصبح إلزاميًا

رسالة Bayer name is missing تربك كثيرين لأن الاسم ليس إلزاميًا في كل فاتورة. القاعدة التي يوثّقها الدليل التقني ذات شرطين: اسم المشتري إلزامي إذا كانت الفاتورة ذممًا، وإلزامي كذلك إذا كانت نقدية وتجاوزت قيمتها 10,000 دينار أو ما يعادلها بالعملات الأخرى. ويضيف نظام تنظيم شؤون الفوترة (المادة 5/ب) وجوب اسم المشتري في البيع بالتقسيط أو على دفعات. والفرق بين النوعين وما يترتب عليه مشروح في الفاتورة النقدية وفاتورة الذمم.

وإلى جانب الاسم، رقم هاتف المشتري أرقام فقط وبطول بين 9 و14 خانة، ورمز المحافظة يُرسل بصيغته المعتمدة مثل JO-AM لعمّان وJO-IR لإربد، والرقم المعرّف للمشتري له نوع محدّد: الرقم الوطني أو الرقم الشخصي لغير الأردني أو الرقم الضريبي.

فخ الصفر: الفرق بين S وZ وO

فئات الضريبة ثلاث ولكل منها معنى مختلف: S للخاضع بنسبة غير الصفر، وZ للمعفى، وO للخاضع بنسبة الصفر. الخطأ المتكرر هو إرسال نسبة صفر مع الفئة S، وهو ما يُنتج رسالة General tax percentage must be zero. الإصلاح أن تختار Z إن كان الصنف معفى، وO إن كان خاضعًا لنسبة الصفر.

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

المجاميع والخصم: أربعة أسباب رفض لا تخطر ببالك

بعض حالات الرفض تأتي من قرارات تبدو محاسبية بحتة، لكنها تصطدم بقواعد بنية الفاتورة.

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

ومتى تجاوز الفارق بين حساب برنامجك وهذا الترتيب حدّ التقريب المسموح، عادت رسالة Total General Amount is Not Correct. لذلك يستحق الأمر أن تفحص المعادلة نفسها لا أن تعيد إدخال الفاتورة. وتزداد الحاجة إلى ذلك مع الضريبة الخاصة، فهي تُرسل في كتلة ضريبية ثانية مستقلة، وتُحسب ضريبة المبيعات العامة بعدها على قيمة السطر مضافًا إليها الضريبة الخاصة لا على قيمة السطر وحدها. ومجموع السطر هو قيمته مضافًا إليها الضريبة العامة، والضريبة الخاصة أيضًا إن وُجدت. وهذه أسباب تتصل مباشرة بهذه القواعد:

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

ولاحظ فرقًا يغيب عن كثيرين: فاتورة الدخل لا تحمل كتلة ضريبة أصلًا، فسطورها كمية وسعر وخصم واسم صنف فقط. أما رسالة عدم التخويل بنوع الفاتورة فالدليل يربطها بعدم تناسب نوع الفاتورة مع رقمك الضريبي أو مع تسلسل مصدر الدخل، لا بمحتوى السطور.

قبل الإرسال أصلًا: عندما تكون المشكلة في الحساب لا في الربط

ليست كل الأخطاء تقنية. دليل الأسئلة والأجوبة الرسمي يوثّق مجموعة من الحالات التي تسبق الفاتورة أصلًا.

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

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

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

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

فاتورة صدرت ثم ظهر فيها خطأ: ما المسار

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

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

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

ولأن الإرجاع يطابق السطور بمعرّفاتها، فإن إهمال حفظ معرّف السطر من البيعة الأصلية يتحوّل إلى مشكلة يوم الإرجاع لا يوم البيع.

عشر دقائق لتشخيص أي رفض

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

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

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

ولمن يوازن بين الإصدار اليدوي من البوابة والإصدار من نظام محاسبي، تفصّل المفاضلة مقالة البوابة المجانية أم نظام محاسبي.

كيف يقلّل قيود هذه الأخطاء

قيود متكامل مع نظام الفوترة الوطني، والفكرة التي تعنيك هنا أن الفاتورة تُبنى مرة واحدة داخل نظامك المحاسبي ثم تُرسل، بلا إعادة إدخال في البوابة وبلا نسخة ثانية من البيانات.

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

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

• محرّك ضريبي أردني. ضريبة المبيعات العامة 16% مع النسب المخفّضة ومنطق المعفى والخاضع لنسبة الصفر، والتسمية داخل النظام «ضريبة المبيعات العامة 16%». وبذلك تكون النسب المضبوطة على أصنافك هي النسب الأردنية، فتراجعها مرة واحدة على الأصناف بدل كل فاتورة.
• قالب فاتورة ضريبية أردنية. بالعربية والإنجليزية، يحمل الرقم الضريبي ورمز الاستجابة السريعة العائد من النظام الوطني والحقول الإلزامية.
• أنواع المستندات الأربعة. ثلاث عائلات ضريبية (دخل، ومبيعات عامة، وخاصة) تصدر كل منها فاتورة جديدة، ومعها فاتورة الإرجاع وهي إشعار دائن، وهو ما يقابل تقسيم الدليل التقني.
• الدينار الأردني في الفوترة والتنسيق، مع دعم تعدد العملات في الحسابات.
• الاستيراد عبر إكسل مع تقرير أخطاء لكل سطر يصل بالبريد، وتسجيل كل محاولة في تقرير النشاط. مفيد تحديدًا عند إدخال أرصدة أو أصناف بالجملة، حيث يبدأ كثير من أخطاء البيانات لاحقًا.
• صلاحيات المستخدمين وإدارة الفروع لضبط من يصدر ومن يعتمد، وتقارير لمتابعة ما صدر فعلًا.
• تطبيق جوال وواجهة برمجية وZapier لمن يصل إلى النظام من متجر إلكتروني أو أداة أخرى، عبر المسار: المنصة ثم Zapier أو الواجهة البرمجية ثم قيود ثم النظام الوطني.
• خبرة تشغيل في بيئة إلزامية مماثلة. أكثر من 25,000 منشأة تعمل على قيود في السوق السعودي تحت إلزام فوترة إلكترونية مشابه، وهذه الخبرة منقولة الآن إلى المتطلبات الأردنية.

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

أسئلة شائعة

وصلني رمز 200 لكن الفاتورة بلا رمز استجابة سريعة، فهل هي معتمدة؟

لا. رمز الاستجابة الفني يعني أن الطلب عولج تقنيًا فقط. الحكم على الفاتورة يؤخذ من حقل EINV_STATUS، ولا تُعدّ الفاتورة مستلمة ومقبولة إلا إذا عاد رمز الاستجابة السريعة في حقل EINV_QR. وهذا الرمز يجب أن يظهر على الفاتورة.

ما أكثر سبب لرمز 500؟

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

أعدت إرسال الفاتورة فصارت مكرّرة، ما الخطأ؟

على الأرجح أن نظامك ولّد رقمًا فريدًا جديدًا عند إعادة المحاولة. مفتاح الفاتورة هو رقمها مع رقمها الفريد معًا، وإعادة الإرسال يجب أن تتم بالقيمتين ذاتهما. عندها تعود الحالة ALREADY_SUBMITTED ومعها رمز الاستجابة الأصلي بدل فاتورة ثانية.

كيف أعرف أن الخطأ في الاتصال لا في بيانات الفاتورة؟

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

متى يكون اسم المشتري إلزاميًا؟

اسم المشتري إلزامي في كل فاتورة ذمم، وإلزامي أيضًا في الفاتورة النقدية إذا تجاوزت قيمتها 10,000 دينار أو ما يعادلها، وفي البيع بالتقسيط أو على دفعات. غيابه في حالتي الذمم والنقدية فوق الحد يُنتج رسالة رفض صريحة ضمن رمز 400.

ضريبتي صفر لكن الفاتورة تُرفض، لماذا؟

لأن فئة الضريبة على الأرجح مضبوطة على S بينما النسبة صفر. النسبة الصفرية تستدعي الفئة O، والمعفاة تستدعي Z. وفي فواتير ضريبة المبيعات العامة والضريبة الخاصة من أنواع التصدير والمناطق التنموية والترانزيت والتجارة الخارجية والتنازل داخل المنطقة الحرة، يشترط الدليل نسبة 0% والفئة O لجميع السلع.

هل يمكنني تعديل فاتورة بعد أن سلّمتها للزبون؟

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

كيف أتأكد أن فاتورة استلمتها من مورّد صحيحة؟

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

الخلاصة

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

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

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

رسائل الأخطاء وحلولها

تفاصيل كل موضوع في هذا القسم في مقالة مستقلة:

• حالة SUBMITTED: ماذا تحفظ وتعرض بعد قبول الفاتورة
• رسالة Invalid Invoice Minification: السبب والإصلاح
• نسبة ضريبة غير مقبولة: القيم التي تقبلها الواجهة وعلاقتها بخطأ 500
• حالة NOT_SUBMITTED: ماذا تعني وكيف تعيد الإرسال
• حالة ALREADY_SUBMITTED: معناها وكيف تستعيد رمز QR
• إرجاع يتجاوز الكمية الأصلية: لماذا يُرفض وكيف تحسبه
• رفض الكمية أو السعر السالب: القاعدة والبديل
• رسالة Postal code length is incorrect وحلها
• خطأ 504: أسبابه وطريقة إصلاحه
• خطأ BuyerTaxNumber في فواتير المناطق التنموية: الرقم الضريبي للمشتري غير مرتبط بالمنطقة
• رسالة General tax percentage must be zero: أسبابها وحلها
• رسالة The ID number must be unique: تكرار رقم البند
• رسالة Bayer name is missing: متى يُشترط اسم المشتري
• رسالة This user is not authorized to submit this type of invoice
• خطأ 400: كيف تقرأ EINV_MESSAGE
• رسالة Total General Amount is Not Correct: أسبابها وطريقة إصلاحها
• خطأ 403: أسبابه وطريقة إصلاحه
• خطأ 500: أسبابه وطريقة إصلاحه