تظهر رسالة BuyerTaxNumber: The buyer’s taxpayer number is not associated with the developmental arear (بهذا الهجاء كما ترد حرفيًا في الدليل التقني) حين يرسل برنامجك فاتورة من نوع المناطق التنموية إلى نظام الفوترة الوطني فتعود مرفوضة. هذا هو خطأ BuyerTaxNumber في فواتير المناطق التنموية، ومعناه أن الرقم الضريبي للمشتري المذكور في الفاتورة غير مرتبط بالمناطق التنموية لدى دائرة ضريبة الدخل والمبيعات.
والإصلاح لا يبدأ من الملف وحده. فبعض شروط هذا النوع من الفواتير في ملفك، مثل الرقم الضريبي للمشتري ورمز نوع الفاتورة، وبعضها يخص المشتري نفسه، وهما تسجيله في المناطق التنموية ووجود كتاب إعفاء ساري المفعول مُدخل على النظام المالي.
يشرح هذا المقال ما تعنيه الرسالة كما شرحها الدليل التقني للربط مع النظام (الإصدار 1.5)، ومتى تكون الفاتورة من نوع المناطق التنموية، ولماذا يصبح الرقم الضريبي للمشتري إجباريًا فيها. ثم يعرض خطوات الإصلاح وقائمة فحص تستخدمها قبل الإرسال.
ما معنى خطأ BuyerTaxNumber في فواتير المناطق التنموية
يصف الدليل التقني رمز 400 (Bad Request) بأنه خطأ في القيم المرسلة داخل ملف XML، ويأتي تفصيله في الحقل EINV_MESSAGE من ملف الاستجابة. ومن الرسائل التي يذكرها تحت هذا الرمز رسالة BuyerTaxNumber، ويشرحها بهذا النص:
«يحدث عندما يتم إرسال فاتورة من نوع مناطق تنموية حيث إن الرقم الضريبي للمشتري إجباري ويجب أن يكون الرقم الضريبي للمشتري مسجل في المناطق التنموية ومعه كتاب إعفاء ساري المفعول مدخل على النظام المالي في ضريبة الدخل والمبيعات».

تحمل الرسالة اسم الحقل في أولها، فتعرف منها مباشرة أن موضع الفحص هو الرقم الضريبي للمشتري. وكلمة arear في آخرها خطأ إملائي في نص الدائرة نفسه، فإذا بحثت عن الرسالة في سجلات برنامجك فابحث بأولها BuyerTaxNumber لا بآخرها.
والفاتورة المرفوضة بهذه الرسالة لم تُقبل. فحالتها في الحقل EINV_STATUS هي NOT_SUBMITTED، ولا يعود عليها رمز QR ولا رقم الفاتورة ولا معرّفها الفريد. ولا تُشارك هذه الفاتورة مع المشتري، لأن النظام يتحقق من الفاتورة قبل وصولها إليه.
متى تكون الفاتورة من نوع المناطق التنموية
تقسّم دائرة ضريبة الدخل والمبيعات الفواتير بحسب نوع التعامل إلى ستة أنواع، هي المحلية والتصدير والمناطق التنموية والترانزيت والتجارة الخارجية والتنازل داخل المناطق الحرة. ويصف دليل إجراءات تنظيم الفاتورة فاتورة المناطق التنموية (وتُسمّى كذلك فاتورة تشجيع الاستثمار) بأنها الفاتورة التي يكون فيها المشتري مسجلًا ضمن مكلفي المناطق التنموية.
وفي ملف XML يُحدَّد النوع في الخاصية name من العنصر cbc:InvoiceTypeCode، وهي رمز من ثلاث خانات. الخانة الأولى لنوع التعامل، والخانة الثانية لطريقة الدفع (1 نقدي، 2 ذمم)، والخانة الثالثة لنوع الضريبة (1 دخل، 2 مبيعات عامة، 3 مبيعات خاصة). ورمز المناطق التنموية في الخانة الأولى هو 2، فتكون رموزها كما في الجدول:

يُلاحظ في الجدول أن شرط الرقم الضريبي للمشتري يرافق نوع المناطق التنموية في العائلات الثلاث، وأنه النوع الوحيد بين الأنواع الستة الذي يحمل هذا الشرط. أما ملاحظة التسجيل وكتاب الإعفاء فترد تحت صف المناطق التنموية في جداول العائلات الثلاث، ومنها جدول فاتورة المبيعات العامة في الصورة، وتتكرر في شرح الرسالة نفسها.
ويقرأ النظام نوع الفاتورة من الملف، لكن الملف لا يقرر وحده أن البيع بيع مناطق تنموية. فتسجيل المشتري وكتاب الإعفاء أمران خارج الملف كليًا، وهما ما يحدد إن كان يجوز للخاصية name أن تحمل رمزًا يبدأ بالرقم 2. ولتفصيل الفرق بين النقدي والذمم وحقول كل منهما راجع مقال الفاتورة النقدية وفاتورة الذمم في نظام الفوترة الوطني.
الرقم الضريبي للمشتري إجباري في فواتير المناطق التنموية
تُكتب هوية المشتري في الملف داخل العنصر cbc:ID مع الخاصية schemeID، ويختار البائع لها واحدًا من ثلاثة أنواع، وتكون القيمة أرقامًا فقط:
NINللرقم الوطني للمشتري.PNللرقم الشخصي لغير الأردني.TNللرقم الضريبي للمشتري.
وتحت جدول هذه الأنواع يضع الدليل شرطًا خاصًا بالنوع الذي يتناوله هذا المقال، وهو أن الرقم الضريبي للمشتري يصبح إجباريًا إذا كان نوع الفاتورة مناطق تنموية.

فإذا أرسل برنامجك فاتورة مناطق تنموية وهوية المشتري فيها رقمه الوطني أو رقمه الشخصي، فالرقم الضريبي الذي يشترطه الدليل غير موجود في الملف أصلًا. وإذا كان الرقم الضريبي موجودًا، فالشرط التالي أن يكون هذا الرقم نفسه مسجلًا في المناطق التنموية، وهنا تنتقل المسألة من ملفك إلى بيانات المشتري لدى الدائرة.
أما اسم المشتري فله قاعدة مستقلة عن نوع التعامل. فهو إجباري في فاتورة الذمم دائمًا، وفي الفاتورة النقدية إذا زادت قيمتها على 10,000 دينار. ولقراءة تظليل الحقول الإجبارية والاختيارية في نماذج الدليل راجع مقال الحقول الإجبارية والاختيارية في نظام الفوترة الوطني.
ثلاثة شروط يجمعها شرح الرسالة
يجمع نص الدائرة في شرح الرسالة ثلاثة شروط في جملة واحدة. وفصل بعضها عن بعض يحدد لك أين تبحث، لأن الشرط الأول في ملفك والشرطين الآخرين لدى المشتري:
- وجود الرقم الضريبي للمشتري في الفاتورة. هو إجباري في هذا النوع، ويُرسل في هوية المشتري بالنوع
TN. - تسجيل هذا الرقم في المناطق التنموية. لا يتحقق هذا الشرط من الملف، بل من تسجيل المشتري لدى الدائرة.
- كتاب إعفاء ساري المفعول مُدخل على النظام المالي. يصف الدليل الكتاب بوصفين، أن يكون ساري المفعول، وأن يكون مُدخلًا على النظام المالي في ضريبة الدخل والمبيعات.
ومن هذه الشروط تتفرع الحالات التي تفحصها حين تعود الرسالة. قد يكون في الرقم الضريبي خطأ في خانة، فيصبح رقمًا آخر غير مسجل في المناطق التنموية. وقد يكون الرقم صحيحًا والمشتري غير مسجل ضمن مكلفي المناطق التنموية. وقد يكون رمز نوع الفاتورة نفسه اختيارًا خاطئًا لبيع لا يستوفي شروط هذا النوع، كأن يبدأ الرمز بالرقم 2 في بيع محلي. وهذه الحالة الأخيرة استنتاج من تعريف النوع، لا نص في شرح الرسالة.
كتاب الإعفاء: ما يقوله الدليل وما لا يقوله
يكتفي الدليل التقني (الإصدار 1.5) بوصف الكتاب بأنه «كتاب إعفاء ساري المفعول مدخل على النظام المالي». ولا يذكر الجهة التي تُصدره، ولا مدة سريانه، ولا كيف يُدخل على النظام المالي. لذلك لا يحدد هذا المقال شيئًا من ذلك، ويبقى المرجع فيه المشتري الذي يحمل الكتاب، ودائرة ضريبة الدخل والمبيعات.
ولا يعني شرط كتاب الإعفاء أن الفاتورة معفاة من الإرسال. ففاتورة المناطق التنموية نوع من أنواع الفواتير التي تُرسل إلى نظام الفوترة الوطني، ولها رموزها في الدليل التقني مثل بقية الأنواع، ولا يعود عليها رمز QR إلا بعد قبولها.
نسبة الضريبة في فاتورة المناطق التنموية
يشترط الدليل في فاتورة المناطق التنموية من نوع المبيعات العامة والمبيعات الخاصة أن تكون نسبة الضريبة 0%. أما فاتورة الدخل فلا تحمل سطور ضريبة أصلًا، فلا ينطبق عليها شرط النسبة، ويبقى شرطها في الجدول أن الرقم الضريبي للمشتري إجباري، وتحته ملاحظة التسجيل وكتاب الإعفاء نفسها.
وعند نسبة 0% لا يُستخدم التصنيف S، ويُستخدم Z للمعفى وO للخاضع لنسبة الصفر. ولا يسمّي الدليل تصنيفًا بعينه لكل نوع تعامل، فهو ينص على أن النسبة 0% فقط. والرسالة التي تعود حين تخالف النسبة هذا الشرط هي General tax percentage must be zero، ويتناولها مقال مستقل في مركز الأخطاء هذا. والمهم هنا أن تصحيح النسبة لا يعالج رسالة BuyerTaxNumber، فلكل رسالة شرطها.
كيف تصلح خطأ BuyerTaxNumber خطوة بخطوة
- اقرأ الاستجابة كاملة. تأكد أن حالة الفاتورة
NOT_SUBMITTED، واحفظ نصEINV_MESSAGEكما عاد. وإن عادت مع الرسالة رسائل أخرى في المصفوفةERRORSفعالجها معًا قبل إعادة الإرسال. - راجع رمز نوع الفاتورة. هل يبدأ رمز الخاصية
nameبالرقم 2 عن قصد؟ إن كان البيع لا يخص مشتريًا مسجلًا ضمن مكلفي المناطق التنموية، فالمشكلة في اختيار النوع لا في الرقم الضريبي. - راجع هوية المشتري في الملف. تأكد أن
schemeIDهوTN، وأن القيمة أرقام فقط، وأنها تطابق الرقم الضريبي للمشتري في وثائقه خانة بخانة. - تحقق مع المشتري من تسجيله. اسأله إن كان رقمه الضريبي مسجلًا في المناطق التنموية، وإن كان معه كتاب إعفاء ساري المفعول مُدخل على النظام المالي. هذان الشرطان لا تصلحهما من ملفك، ويتابعهما المشتري من جهته.
- لا تكرر إرسال الملف نفسه دون تغيير. إن لم تتحقق الشروط، فالفاتورة لا تستوفي محددات نوع المناطق التنموية كما يضعها الدليل. ويعود اختيار النوع الصحيح إلى واقع البيع وتسجيل المشتري، فراجعه مع محاسبك قبل الإرسال التالي.
- راجع نسبة الضريبة في السطور. في فاتورة المبيعات العامة أو الخاصة من هذا النوع تكون النسبة 0% والتصنيف غير
S. - أعد الإرسال بالرقم والمعرّف نفسيهما. يوصي الدليل عند فشل الإرسال بإعادته برقم الفاتورة (
ID) ومعرّفها الفريد (UUID) نفسيهما، لا بقيم جديدة. - احكم من الحالة لا من رمز HTTP. الفاتورة مقبولة حين تعود حالتها
SUBMITTEDويعود معها رمز QR في الحقلEINV_QR، ويجب طباعة هذا الرمز على فاتورة البائع.
قائمة فحص قبل إرسال فاتورة مناطق تنموية
يوصي الدليل في إرشاداته بالتحقق من المجاميع والضرائب والرقم الضريبي ورقم المشتري والحقول الإلزامية قبل الإرسال، لتقليل أخطاء 400. وهذه القائمة تطبق التوصية على هذا النوع من الفواتير:
- المشتري مسجل ضمن مكلفي المناطق التنموية، وقد أكد ذلك قبل إصدار الفاتورة.
- المشتري يحمل كتاب إعفاء ساري المفعول مُدخلًا على النظام المالي.
- الخانة الأولى من رمز
nameهي 2، والخانتان الثانية والثالثة تطابقان طريقة الدفع ونوع الضريبة. - هوية المشتري بالنوع
TN، والقيمة أرقام فقط وتطابق رقمه الضريبي. - في فاتورة المبيعات العامة أو الخاصة كل السطور بنسبة 0% وتصنيف غير
S. - اسم المشتري موجود إن كانت الفاتورة ذممًا، أو نقدية تزيد قيمتها على 10,000 دينار.
كيف يساعدك قيود
حين تصدر فاتورتك من برنامج محاسبي، لا تكتب ملف XML بيدك. يبني تكامل قيود مع نظام الفوترة الوطني ملف الفاتورة بصيغة UBL 2.1 ومعرّفها الفريد، ويرسله دون أي تدخل يدوي. ويعمل كذلك على هذه الطبقة:
- فحص قبل الإرسال. يفحص قيود كل فاتورة على مستوى الحقول لحظة إنشائها، فيشمل الفحص الرقم الضريبي، ونوع المستند وطريقة الدفع، ونسبة ضريبة المبيعات العامة، واكتمال البنود، وينبهك بأي خطأ قبل إرسالها لتقليل حالات الرفض.
- حالة كل فاتورة أمامك. تعيد الدائرة حالة الفاتورة ورسالة الخطأ، ويعرضها قيود في لوحة الحالة.
- إعادة إرسال بالمعرّف نفسه. تعيد إرسال الفاتورة بمعرّف UUID نفسه بعد التصحيح.
والفحص المسبق تنبيه لا ضمان. فتسجيل المشتري في المناطق التنموية وكتاب الإعفاء بيانات لدى دائرة ضريبة الدخل والمبيعات، ويبقى قبول الفاتورة لنظام الفوترة الوطني وحده.
أين تذهب بعد هذا المقال
- بقية رموز الرفض ورسائله: في مقال أخطاء نظام الفوترة الوطني: لماذا تُرفض فاتورتك وكيف تصلحها.
- الصورة الكاملة للنظام: كيف يعمل وكيف تربط منشأتك به، في مقال نظام الفوترة الوطني الإلكتروني في الأردن.
- رسالة أخرى من رمز 400: مجاميع الفاتورة التي لا تطابق سطورها، في مقال رسالة Total General Amount is Not Correct.
- رمز 500: الرقم الضريبي وتسلسل مصدر الدخل ونسب الضريبة، في مقال خطأ 500 في نظام الفوترة الوطني.
- رمز 403: رقم المستخدم والمفتاح السري، في مقال خطأ 403 في نظام الفوترة الوطني.
وفي مركز الأخطاء هذا مقالان قريبان من هذه الرسالة، أحدهما عن خطأ 400 في نظام الفوترة الوطني وطريقة قراءة الحقل EINV_MESSAGE، والآخر عن رسالة General tax percentage must be zero.
فوترة إلكترونية ومحاسبة متكاملة في نظام واحد
قيود متكامل مع نظام الفوترة الوطني (JoFotara). تُصدر فاتورتك بالدينار الأردني من قيود فتُقيَّد في دفاترك تلقائيًا وتُرسل إلى النظام، وبعد قبولها يعود عليها رمز QR من دائرة ضريبة الدخل والمبيعات.
الأسئلة الشائعة
ما معنى خطأ BuyerTaxNumber في فواتير المناطق التنموية؟
تعني الرسالة أن الرقم الضريبي للمشتري في فاتورة من نوع المناطق التنموية غير مرتبط بالمناطق التنموية. ويشرحها الدليل التقني بأن الرقم الضريبي للمشتري إجباري في هذا النوع، ويجب أن يكون مسجلًا في المناطق التنموية ومعه كتاب إعفاء ساري المفعول مُدخل على النظام المالي.
هل أستطيع إرسال فاتورة مناطق تنموية برقم المشتري الوطني؟
يشترط الدليل التقني الرقم الضريبي للمشتري في هذا النوع من الفواتير، ويُرسل في هوية المشتري بالنوع TN. فالرقم الوطني (NIN) أو الرقم الشخصي لغير الأردني (PN) لا يحقق هذا الشرط.
من يُصدر كتاب الإعفاء المطلوب في فاتورة المناطق التنموية؟
لا يسمّي الدليل التقني (الإصدار 1.5) الجهة التي تُصدر الكتاب ولا مدة سريانه. ويكتفي بأن يكون الكتاب ساري المفعول ومُدخلًا على النظام المالي، فالمرجع في تفاصيله المشتري ودائرة ضريبة الدخل والمبيعات.
هل فاتورة المناطق التنموية معفاة من الإرسال إلى نظام الفوترة الوطني؟
تُرسل فاتورة المناطق التنموية إلى نظام الفوترة الوطني كبقية الأنواع، ولها رموزها في الدليل التقني. وكتاب الإعفاء شرط من شروط هذا النوع، لا إعفاء من إرسال الفاتورة.
ما نسبة الضريبة في فاتورة المناطق التنموية؟
يشترط الدليل أن تكون نسبة الضريبة 0% في فاتورة المناطق التنموية من نوع المبيعات العامة والمبيعات الخاصة، دون التصنيف S. أما فاتورة الدخل فلا تحمل سطور ضريبة.
هل أولّد معرّفًا فريدًا جديدًا عند إعادة الإرسال بعد الإصلاح؟
يوصي الدليل بإعادة الإرسال برقم الفاتورة ومعرّفها الفريد نفسيهما، لا بقيم جديدة. ثم تحكم على النتيجة من حالة الفاتورة، فهي مقبولة حين تعود SUBMITTED ومعها رمز QR.
المراجع
- دائرة ضريبة الدخل والمبيعات، الدليل التقني للربط مع نظام الفوترة الوطني من خلال واجهة برمجة التطبيقات (API)، الإصدار 1.5، 2026، ص12 وص16 وص33 وص58 وص102.
- دائرة ضريبة الدخل والمبيعات، دليل إجراءات تنظيم الفاتورة في نظام الفوترة الوطني، 2026، ضمن الأدلة الإرشادية لنظام الفوترة الوطني.
