Qoyod
منتجات قيود
نظام نقاط البيع
كاشير ZATCA متكامل لمحلاتك مع دفع مرن
قيود فليفرز
كاشير سحابي مصمَّم خصيصًا للمطاعم والكافيهات
قيود HR
الموظفون والرواتب والإجازات وفق نظام العمل السعودي
قيود CRM
من العميل المحتمل إلى الفاتورة في قيود
مساكن
إدارة جمعيات اتحاد الملاك
قيود للمؤسسات
نظام ERP للشركات من 200 إلى 1,000 موظف
الأسعار
Qoyod
الأسعار

 دليل المعرفة

خطأ BuyerTaxNumber في فواتير المناطق التنموية: الرقم الضريبي للمشتري غير مرتبط بالمنطقة

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

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

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

ما معنى خطأ BuyerTaxNumber في فواتير المناطق التنموية

يصف الدليل التقني رمز 400 (Bad Request) بأنه خطأ في القيم المرسلة داخل ملف XML، ويأتي تفصيله في الحقل EINV_MESSAGE من ملف الاستجابة. ومن الرسائل التي يذكرها تحت هذا الرمز رسالة BuyerTaxNumber، ويشرحها بهذا النص:

«يحدث عندما يتم إرسال فاتورة من نوع مناطق تنموية حيث إن الرقم الضريبي للمشتري إجباري ويجب أن يكون الرقم الضريبي للمشتري مسجل في المناطق التنموية ومعه كتاب إعفاء ساري المفعول مدخل على النظام المالي في ضريبة الدخل والمبيعات».

شرح الدليل التقني لرسالة BuyerTaxNumber: The buyer's taxpayer number is not associated with the developmental arear: تظهر عند إرسال فاتورة مناطق تنموية، والرقم الضريبي للمشتري إجباري ويجب أن يكون مسجلًا في المناطق التنموية ومعه كتاب إعفاء ساري المفعول
المصدر: دائرة ضريبة الدخل والمبيعات، الدليل التقني للربط مع نظام الفوترة الوطني من خلال واجهة برمجة التطبيقات (API)، الإصدار 1.5، ص102

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

والفاتورة المرفوضة بهذه الرسالة لم تُقبل. فحالتها في الحقل EINV_STATUS هي NOT_SUBMITTED، ولا يعود عليها رمز QR ولا رقم الفاتورة ولا معرّفها الفريد. ولا تُشارك هذه الفاتورة مع المشتري، لأن النظام يتحقق من الفاتورة قبل وصولها إليه.

متى تكون الفاتورة من نوع المناطق التنموية

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

وفي ملف XML يُحدَّد النوع في الخاصية name من العنصر cbc:InvoiceTypeCode، وهي رمز من ثلاث خانات. الخانة الأولى لنوع التعامل، والخانة الثانية لطريقة الدفع (1 نقدي، 2 ذمم)، والخانة الثالثة لنوع الضريبة (1 دخل، 2 مبيعات عامة، 3 مبيعات خاصة). ورمز المناطق التنموية في الخانة الأولى هو 2، فتكون رموزها كما في الجدول:

نوع الضريبة نقدية ذمم المحددات
فاتورة دخل 211 221 الرقم الضريبي للمشتري إجباري
فاتورة مبيعات عامة 212 222 نسبة الضريبة 0% والرقم الضريبي للمشتري إجباري
فاتورة مبيعات خاصة 213 223 نسبة الضريبة 0% والرقم الضريبي للمشتري إجباري
جدول رموز فاتورة المبيعات العامة في الدليل التقني: فاتورة المناطق التنموية 212 و222 يجب أن تكون نسبتها 0% والرقم الضريبي للمشتري إجباري، مع ملاحظة كتاب الإعفاء وأمثلة InvoiceTypeCode
المصدر: دائرة ضريبة الدخل والمبيعات، الدليل التقني للربط مع نظام الفوترة الوطني من خلال واجهة برمجة التطبيقات (API)، الإصدار 1.5، ص33

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

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

الرقم الضريبي للمشتري إجباري في فواتير المناطق التنموية

تُكتب هوية المشتري في الملف داخل العنصر cbc:ID مع الخاصية schemeID، ويختار البائع لها واحدًا من ثلاثة أنواع، وتكون القيمة أرقامًا فقط:

  • NIN للرقم الوطني للمشتري.
  • PN للرقم الشخصي لغير الأردني.
  • TN للرقم الضريبي للمشتري.

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

جدول أنواع معرف المشتري في الدليل التقني: NIN الرقم الوطني وPN الرقم الشخصي لغير الأردني وTN الرقم الضريبي، وتحته أن الرقم الضريبي للمشتري يصبح إجباريًا إذا كان نوع الفاتورة مناطق تنموية
المصدر: دائرة ضريبة الدخل والمبيعات، الدليل التقني للربط مع نظام الفوترة الوطني من خلال واجهة برمجة التطبيقات (API)، الإصدار 1.5، ص16

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

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

ثلاثة شروط يجمعها شرح الرسالة

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

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

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

كتاب الإعفاء: ما يقوله الدليل وما لا يقوله

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

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

نسبة الضريبة في فاتورة المناطق التنموية

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

وعند نسبة 0% لا يُستخدم التصنيف S، ويُستخدم Z للمعفى وO للخاضع لنسبة الصفر. ولا يسمّي الدليل تصنيفًا بعينه لكل نوع تعامل، فهو ينص على أن النسبة 0% فقط. والرسالة التي تعود حين تخالف النسبة هذا الشرط هي General tax percentage must be zero، ويتناولها مقال مستقل في مركز الأخطاء هذا. والمهم هنا أن تصحيح النسبة لا يعالج رسالة BuyerTaxNumber، فلكل رسالة شرطها.

كيف تصلح خطأ BuyerTaxNumber خطوة بخطوة

  1. اقرأ الاستجابة كاملة. تأكد أن حالة الفاتورة NOT_SUBMITTED، واحفظ نص EINV_MESSAGE كما عاد. وإن عادت مع الرسالة رسائل أخرى في المصفوفة ERRORS فعالجها معًا قبل إعادة الإرسال.
  2. راجع رمز نوع الفاتورة. هل يبدأ رمز الخاصية name بالرقم 2 عن قصد؟ إن كان البيع لا يخص مشتريًا مسجلًا ضمن مكلفي المناطق التنموية، فالمشكلة في اختيار النوع لا في الرقم الضريبي.
  3. راجع هوية المشتري في الملف. تأكد أن schemeID هو TN، وأن القيمة أرقام فقط، وأنها تطابق الرقم الضريبي للمشتري في وثائقه خانة بخانة.
  4. تحقق مع المشتري من تسجيله. اسأله إن كان رقمه الضريبي مسجلًا في المناطق التنموية، وإن كان معه كتاب إعفاء ساري المفعول مُدخل على النظام المالي. هذان الشرطان لا تصلحهما من ملفك، ويتابعهما المشتري من جهته.
  5. لا تكرر إرسال الملف نفسه دون تغيير. إن لم تتحقق الشروط، فالفاتورة لا تستوفي محددات نوع المناطق التنموية كما يضعها الدليل. ويعود اختيار النوع الصحيح إلى واقع البيع وتسجيل المشتري، فراجعه مع محاسبك قبل الإرسال التالي.
  6. راجع نسبة الضريبة في السطور. في فاتورة المبيعات العامة أو الخاصة من هذا النوع تكون النسبة 0% والتصنيف غير S.
  7. أعد الإرسال بالرقم والمعرّف نفسيهما. يوصي الدليل عند فشل الإرسال بإعادته برقم الفاتورة (ID) ومعرّفها الفريد (UUID) نفسيهما، لا بقيم جديدة.
  8. احكم من الحالة لا من رمز HTTP. الفاتورة مقبولة حين تعود حالتها SUBMITTED ويعود معها رمز QR في الحقل EINV_QR، ويجب طباعة هذا الرمز على فاتورة البائع.

قائمة فحص قبل إرسال فاتورة مناطق تنموية

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

  • المشتري مسجل ضمن مكلفي المناطق التنموية، وقد أكد ذلك قبل إصدار الفاتورة.
  • المشتري يحمل كتاب إعفاء ساري المفعول مُدخلًا على النظام المالي.
  • الخانة الأولى من رمز name هي 2، والخانتان الثانية والثالثة تطابقان طريقة الدفع ونوع الضريبة.
  • هوية المشتري بالنوع TN، والقيمة أرقام فقط وتطابق رقمه الضريبي.
  • في فاتورة المبيعات العامة أو الخاصة كل السطور بنسبة 0% وتصنيف غير S.
  • اسم المشتري موجود إن كانت الفاتورة ذممًا، أو نقدية تزيد قيمتها على 10,000 دينار.

كيف يساعدك قيود

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

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

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

أين تذهب بعد هذا المقال

وفي مركز الأخطاء هذا مقالان قريبان من هذه الرسالة، أحدهما عن خطأ 400 في نظام الفوترة الوطني وطريقة قراءة الحقل EINV_MESSAGE، والآخر عن رسالة General tax percentage must be zero.

قيود · نظام الفوترة الوطني

فوترة إلكترونية ومحاسبة متكاملة في نظام واحد

قيود متكامل مع نظام الفوترة الوطني (JoFotara). تُصدر فاتورتك بالدينار الأردني من قيود فتُقيَّد في دفاترك تلقائيًا وتُرسل إلى النظام، وبعد قبولها يعود عليها رمز QR من دائرة ضريبة الدخل والمبيعات.

الأسئلة الشائعة

ما معنى خطأ BuyerTaxNumber في فواتير المناطق التنموية؟

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

هل أستطيع إرسال فاتورة مناطق تنموية برقم المشتري الوطني؟

يشترط الدليل التقني الرقم الضريبي للمشتري في هذا النوع من الفواتير، ويُرسل في هوية المشتري بالنوع TN. فالرقم الوطني (NIN) أو الرقم الشخصي لغير الأردني (PN) لا يحقق هذا الشرط.

من يُصدر كتاب الإعفاء المطلوب في فاتورة المناطق التنموية؟

لا يسمّي الدليل التقني (الإصدار 1.5) الجهة التي تُصدر الكتاب ولا مدة سريانه. ويكتفي بأن يكون الكتاب ساري المفعول ومُدخلًا على النظام المالي، فالمرجع في تفاصيله المشتري ودائرة ضريبة الدخل والمبيعات.

هل فاتورة المناطق التنموية معفاة من الإرسال إلى نظام الفوترة الوطني؟

تُرسل فاتورة المناطق التنموية إلى نظام الفوترة الوطني كبقية الأنواع، ولها رموزها في الدليل التقني. وكتاب الإعفاء شرط من شروط هذا النوع، لا إعفاء من إرسال الفاتورة.

ما نسبة الضريبة في فاتورة المناطق التنموية؟

يشترط الدليل أن تكون نسبة الضريبة 0% في فاتورة المناطق التنموية من نوع المبيعات العامة والمبيعات الخاصة، دون التصنيف S. أما فاتورة الدخل فلا تحمل سطور ضريبة.

هل أولّد معرّفًا فريدًا جديدًا عند إعادة الإرسال بعد الإصلاح؟

يوصي الدليل بإعادة الإرسال برقم الفاتورة ومعرّفها الفريد نفسيهما، لا بقيم جديدة. ثم تحكم على النتيجة من حالة الفاتورة، فهي مقبولة حين تعود SUBMITTED ومعها رمز QR.

المراجع

الأدلّة الإرشادية

تابع رحلة التعلّم

استكشف بقية أدلّة قيود الإرشادية، أو ابدأ بتطبيق ما تعلّمته.

ندوات مباشرة يقدمها فريق قيود لمساعدتك في استخدام البرنامج بسهولة والرد على أسئلتك.

تعرّف على أحدث تحديثات فيود والتحسينات المستمرة والخصائص الجديدة في مكان واحد.

فريقنا جاهز لمساعدتك وتقديم الدعم الفوري لأي مشكلة تواجهها على مدار الساعة