بيانات المشتري في ملف فاتورة نظام الفوترة الوطني: NIN وPN وTN

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

هذا المقال فهرس لكتلة المشتري. يمر على عناصرها الموثقة عنصرًا بعد آخر، فيذكر ما يحمله كل عنصر وقيده وتظليله، ويشير إلى المقال الذي يتعمق فيه حين يكون للعنصر تفصيل أطول. ويبدأ من أكثر ما يُسأل عنه في هذه الكتلة، وهو نوع المعرّف وقيمه الثلاث NIN وPN وTN.

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

بيانات المشتري في ملف فاتورة نظام الفوترة الوطني: أين تقع الكتلة وما عناصرها

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

«العناصر المظللة باللون الأصفر … تدل على متغيرات مطلوب تعبئتها (إجبارية) من خلال نظام البائع. أما العناصر المظللة باللون الأخضر تدل على متغيرات مطلوب تعبئتها (اختيارية) … وباقي العناصر وصف ثابت بدون تغيير».

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

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

نوع معرّف المشتري: NIN وPN وTN

يُكتب رقم المشتري في الملف داخل العنصر cbc:ID، وتُكتب معه الخاصية schemeID التي تحدد نوع هذا الرقم. ويقبل الدليل لهذه الخاصية ثلاث قيم، لكل منها معنى محدد.

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

النوع إجباري والقيمة اختيارية

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

متى يصبح الرقم الضريبي للمشتري إجباريًا

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

المعرّف في البوابة

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

عنوان المشتري: الرمز البريدي ورمز المحافظة

لا يوثق قالب المشتري من العنوان إلا عنصرين، كلاهما مظلل بالأخضر.

• الرمز البريدي cbc:PostalZone. قيده في الدليل أن يكون بحد أعلى 5 خانات. فإذا زاد عليها رُفضت الفاتورة برسالة Postal code length is incorrect، ولهذه الرسالة مقال مستقل ضمن سلسلة مركز الأخطاء. ولا تفترض للرمز البريدي صيغة أخرى غير هذا الحد.
• رمز المحافظة cbc:CountrySubentityCode. يحمل رمز محافظة المشتري من جدول يضم اثنتي عشرة محافظة، مثل JO-AM لعمّان وJO-IR لإربد وJO-AQ للعقبة. ويطبع القالب داخل هذا العنصر كلمة «المدينة» مكانًا للقيمة، لكن وصفه في الدليل أنه رمز المحافظة يُستبدل من الجدول. والجدول الكامل للرموز مع قراءته موضوع مقال رموز المحافظات في السلسلة نفسها.

وفي الدليل خطأ مطبعي في هذا الجدول يحسن الانتباه إليه. ففي جدول قالب الضريبة الخاصة (ص63) يرد رمز البلقاء «O-BA»، والصحيح JO-BA كما في بقية الجداول.

ويعرّف معيار UBL 2.1 عناصر أخرى للعنوان، كالشارع والمدينة ورقم المبنى، لكن قالب المشتري في الدليل لا يوردها. فحكمها غير موثق، ولا يصح وصفها بأنها اختيارية ولا بأنها إجبارية. وإن احتاج نظامك إليها فالمرجع فيها الدعم الفني للدائرة قبل أن تبني عليها.

اسم المشتري: عنصر أصفر ومحتوى مشروط

العنصر cbc:RegistrationName مظلل بالأصفر، فهو حاضر في بنية كل فاتورة. لكن وجوب محتواه مشروط بحالتين يحددهما الدليل التقني.

• فاتورة الذمم. اسم المشتري فيها إجباري أيًا كانت قيمتها.
• الفاتورة النقدية. اسم المشتري فيها إجباري إذا زادت قيمتها على 10,000 دينار أو ما يعادلها بالعملات الأجنبية.

ويعرف النظام طريقة الدفع من الخانة الثانية في الرمز الثلاثي للسمة name في العنصر cbc:InvoiceTypeCode، فالرقم 1 للنقدي والرقم 2 للذمم. وإذا غاب الاسم في حالة يشترطه فيها الدليل رُفضت الفاتورة برسالة Bayer name is missing، وشرحها في مقال رسالة Bayer name is missing. أما الفرق بين النوعين من حيث العمل والحقول فتجده في مقال الفاتورة النقدية وفاتورة الذمم.

رقم هاتف المشتري

العنصر cbc:Telephone مظلل بالأخضر، وقيده في الدليل منصوص عليه حرفيًا بهذه العبارة.

«يأخذ فقط أرقام وبحد أعلى 14 رقم و بحد أدنى 9 أرقام».

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

ما الذي يبقى اختياريًا في كتلة المشتري

بجمع ما سبق، تتوزع عناصر الكتلة على ثلاث حالات.

• إجباري دائمًا. نوع المعرّف في schemeID، ووجود العنصر cbc:RegistrationName في البنية.
• اختياري يصير واجبًا بشرط. رقم المشتري في cbc:ID حين تكون الفاتورة من نوع المناطق التنموية فيجب الرقم الضريبي، ومحتوى اسم المشتري في فاتورة الذمم وفي النقدية التي تزيد على 10,000 دينار.
• اختياري لا يغيّره شرط موثق. الرمز البريدي ورمز المحافظة ورقم الهاتف. لكن قيودها تبقى سارية متى ملأتها، فالرمز البريدي لا يتجاوز 5 خانات، والهاتف أرقام فقط بين 9 و14.

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

بيانات المشتري في نموذج الفاتورة على البوابة

من يصدر فواتيره من البوابة لا يكتب ملف XML، بل يملأ قسم «بيانات المشتري» في نموذج الفاتورة الجديدة. ويضم هذا القسم في دليل إجراءات تنظيم الفاتورة (إصدار 2026) ستة حقول، هي الاسم، ونوع المعرفات الإضافية للمشتري، ورقم المشتري، ورقم الهاتف، والمدينة، والرمز البريدي.

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

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

بيانات المشتري في فاتورة الإرجاع

فاتورة الإرجاع تحمل كتلة المشتري أيضًا، لكن الدليل يقيّدها بقاعدة صريحة تتكرر في قوالب الإرجاع الثلاثة (ص26 وص49 وص76).

«يجب أن تتوافق بيانات المشتري في فاتورة الإرجاع مع بياناته في فاتورة البيع الأصلية المرتبطة بها».

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

قائمة فحص لكتلة المشتري قبل الإرسال

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

1. هل يحمل schemeID إحدى القيم الثلاث NIN أو PN أو TN، ويطابق النوع الرقم المرسل فعلًا؟
2. هل رقم المشتري أرقام فقط، بلا حروف ولا رموز؟
3. إن كانت الفاتورة من نوع المناطق التنموية، هل الرقم المرسل هو الرقم الضريبي للمشتري؟
4. إن كانت فاتورة ذمم، أو فاتورة نقدية تزيد قيمتها على 10,000 دينار، هل يحمل cbc:RegistrationName اسم المشتري؟
5. إن ملأت الرمز البريدي، هل هو 5 خانات أو أقل؟
6. إن ملأت رمز المحافظة، هل هو أحد الرموز الاثني عشر بالبادئة JO-؟
7. إن ملأت رقم الهاتف، هل هو أرقام فقط وعددها بين 9 و14؟
8. إن كانت فاتورة إرجاع، هل بيانات المشتري فيها مطابقة لبياناته في الفاتورة الأصلية؟

فإذا رُفضت الفاتورة رغم ذلك، فاقرأ سبب الرفض في ملف الاستجابة واحكم على النتيجة من حالة الفاتورة EINV_STATUS لا من رمز الاستجابة وحده. ثم أعد الإرسال بعد الإصلاح برقم الفاتورة cbc:ID ومعرّفها الفريد cbc:UUID نفسيهما، كما يوصي الدليل عند إعادة الإرسال.

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

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

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

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

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

• تظليل الحقول في القوالب كلها. تجده في مقال الحقول الإجبارية والاختيارية في نظام الفوترة الوطني.
• الصورة الكاملة للنظام. كيف يعمل وكيف تربط منشأتك به، في مقال نظام الفوترة الوطني الالكتروني.
• عناصر السلسلة نفسها. انظر مقال رموز المحافظات، ومقال رسالة Postal code length is incorrect، ومقال بيانات البائع في فاتورة نظام الفوترة الوطني.

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

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

تقع في الكتلة cac:AccountingCustomerParty، وهي حاضرة في قوالب الدليل التقني كلها. وتضم نوع المعرّف ورقم المشتري والرمز البريدي ورمز المحافظة واسم المشتري ورقم هاتفه.

ما الفرق بين NIN وPN وTN في معرّف المشتري؟

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

هل رقم المشتري إجباري في كل فاتورة؟

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

كم خانة يقبل الرمز البريدي للمشتري؟

يقبل 5 خانات حدًا أعلى بحسب الدليل التقني، والعنصر مظلل بالأخضر. وإذا زاد الرمز على هذا الحد رُفضت الفاتورة برسالة Postal code length is incorrect.

ما شروط رقم هاتف المشتري في ملف الفاتورة؟

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

هل يجوز تغيير بيانات المشتري في فاتورة الإرجاع؟

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

المراجع

• دائرة ضريبة الدخل والمبيعات، الدليل التقني للربط مع نظام الفوترة الوطني من خلال واجهة برمجة التطبيقات (API)، الإصدار 1.5، 2026، ص12 وص16 وص17 وص26 وص49 وص63 وص76 وص104.
• دائرة ضريبة الدخل والمبيعات، دليل إجراءات تنظيم الفاتورة في نظام الفوترة الوطني الإلكتروني الأردني، إصدار 2026، ص6.