رموز المحافظات في فاتورة نظام الفوترة الوطني: القائمة كاملة

رموز المحافظات في فاتورة نظام الفوترة الوطني اثنا عشر رمزًا يحددها الدليل التقني الذي نشرته دائرة ضريبة الدخل والمبيعات، رمز لكل محافظة من المحافظات التي يسردها الدليل، تبدأ كلها بالحرفين JO ثم شرطة ثم حرفين، مثل JO-AM لعمان وJO-IR لإربد. ويُكتب الرمز في العنصر cbc:CountrySubentityCode داخل بيانات المشتري في ملف XML، وهو عنصر اختياري بحسب تظليل الدليل.

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

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

رموز المحافظات في فاتورة نظام الفوترة الوطني: الجدول الكامل

يشرح الدليل التقني العنصر cbc:CountrySubentityCode بعبارة «رمز المحافظة الخاصة بالمشتري ويتم استبدالها حسب الجدول التالي»، ثم يسرد اثنتي عشرة محافظة مع رمز كل منها. والجدول التالي يعيد ترتيب القائمة نفسها.

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

ويتكون كل رمز من جزأين. الجزء الأول JO ثابت في الرموز الاثني عشر، والجزء الثاني حرفان لاتينيان كبيران يميزان المحافظة، وبينهما شرطة. وتُكتب القيمة كما يطبعها الجدول تمامًا، بلا مسافات ولا اسم عربي بجانبها.

لماذا لا تُستنتج الرموز من أسماء المحافظات

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

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

موضع العنصر CountrySubentityCode في ملف XML

يقع العنصر في كتلة المشتري cac:AccountingCustomerParty، داخل عنوان المشتري cac:PostalAddress. ويأتي في القالب بعد الرمز البريدي cbc:PostalZone وقبل كتلة الدولة التي تحمل القيمة الثابتة JO. وهذا مقتطف من بنية القالب مع رمز محافظة إربد مثالًا.

<cac:AccountingCustomerParty>
  <cac:Party>
    ...
    <cac:PostalAddress>
      <cbc:PostalZone>...</cbc:PostalZone>
      <cbc:CountrySubentityCode>JO-IR</cbc:CountrySubentityCode>
      <cac:Country>
        <cbc:IdentificationCode>JO</cbc:IdentificationCode>
      </cac:Country>
    </cac:PostalAddress>
    ...
  </cac:Party>
</cac:AccountingCustomerParty>

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

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

• نوع معرّف المشتري. السمة schemeID إجبارية، وقيمها NIN للرقم الوطني وPN للرقم الشخصي لغير الأردني وTN للرقم الضريبي، أما قيمة المعرّف نفسها فمظللة بالأخضر.
• الرمز البريدي. عنصر اختياري حده الأعلى 5 خانات، وله مقال مستقل عن رموز الهاتف والرمز البريدي ضمن هذه السلسلة.
• اسم المشتري. العنصر مظلل بالأصفر، وتجب قيمته في فاتورة الذمم وفي الفاتورة النقدية التي تزيد قيمتها على 10,000 دينار، كما في مقال رسالة Bayer name is missing.
• رقم الهاتف. عنصر اختياري يقبل الأرقام فقط، من 9 أرقام إلى 14 رقمًا.
• الرقم الضريبي للمشتري في المناطق التنموية. يصبح إجباريًا حين تكون الفاتورة من هذا النوع، والتفصيل في مقال خطأ BuyerTaxNumber في فواتير المناطق التنموية.

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

معنى أن رمز المحافظة حقل اختياري

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

ويترتب على ذلك ثلاثة أمور يحسن أن يعرفها من يبني الملف.

1. غياب المحافظة لا يجعل الفاتورة ناقصة بحكم الدليل. إذا لم تكن محافظة المشتري مسجلة لديك، فترك القيمة متسق مع التظليل.
2. إذا عبّأت العنصر، فالقيمة من الجدول. الدليل يقول إن القيمة «يتم استبدالها حسب الجدول»، فلا تُكتب فيه قيمة من خارج الرموز الاثني عشر.
3. بعض التفاصيل لا يوثقها الدليل. لا يحدد الدليل هل يُحذف العنصر الأخضر حين لا قيمة له أم يُرسل فارغًا، ولا يذكر كيف يتعامل النظام مع رمز من خارج الجدول. فلا تبنِ على افتراض في أي من الحالتين، واجعل نظامك يرسل رمزًا من الجدول أو يترك المحافظة بحسب ما يتحقق منه مبرمجك.

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

خطأ الطباعة O-BA في جدول فاتورة الضريبة الخاصة

يرد جدول المحافظات في أكثر من موضع في الدليل، منها الصفحة 17 والصفحة 63. ويلاحظ في جدول الصفحة 63، ضمن قالب فاتورة الضريبة الخاصة، أن رمز البلقاء مطبوع بالصيغة O-BA، بحذف الحرف J من أوله. والرمز الصحيح للبلقاء هو JO-BA، كما في جدول الصفحة 17 وكما يقتضيه نمط الرموز الأحد عشر الأخرى.

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

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

حقل «المدينة» في نموذج الفاتورة على البوابة

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

يحمل حقل البوابة اسم «المدينة»، وهو النص نفسه الذي يضعه الدليل التقني مكان قيمة رمز المحافظة في قالب XML. لكن أيًا من الدليلين لا ينص على أن حقل البوابة هو الذي يملأ العنصر cbc:CountrySubentityCode، ولا يسرد القيم التي يعرضها حقل البوابة. لذلك نعرضهما هنا معلومتين منفصلتين، الأولى عن نموذج البوابة والثانية عن ملف الربط، ولا نربط بينهما.

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

قائمة تحقق قبل إرسال رمز المحافظة

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

1. مصدر الجدول. هل نُسخت الرموز من جدول الصفحة 17، أو صُحح سطر البلقاء إلى JO-BA إن نُسخت من الصفحة 63؟
2. عدد القيم. هل يحتوي جدول نظامك على الرموز الاثني عشر فقط، دون رموز مضافة لمدن أو ألوية؟
3. صيغة القيمة. هل تُكتب القيمة رمزًا لاتينيًا كما في الجدول، لا اسم المحافظة ولا اسم المدينة بالعربية؟
4. الأزواج المتشابهة. هل تحقق المراجع من رموز المفرق ومعان ومادبا، ومن عجلون وجرش؟
5. الموضع. هل يقع العنصر داخل cac:PostalAddress في كتلة المشتري، بعد الرمز البريدي وقبل كتلة الدولة؟
6. غياب البيانات. هل قرر فريقك ما يفعله النظام حين لا تكون محافظة المشتري معروفة، بعد التحقق من سلوك النظام لا بالافتراض؟
7. سلامة الملف. هل يمر الملف كاملًا بفحص بنية XML قبل ترميزه وإرساله، خصوصًا إن بُني على أمثلة الدليل؟

كيف يتعامل قيود مع ملف الفاتورة

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

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

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

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

ما رموز المحافظات في فاتورة نظام الفوترة الوطني؟

يحدد الدليل التقني اثني عشر رمزًا، هي JO-AM عمان، وJO-IR إربد، وJO-AZ الزرقاء، وJO-BA البلقاء، وJO-MD مادبا، وJO-MA المفرق، وJO-KA الكرك، وJO-JA جرش، وJO-AJ عجلون، وJO-AT الطفيلة، وJO-AQ العقبة، وJO-MN معان.

هل رمز المحافظة إجباري في الفاتورة؟

يظلّل الدليل التقني 1.5 العنصر cbc:CountrySubentityCode بالأخضر في قوالبه، والأخضر عنده متغير اختياري. فإذا عبّأته، فالقيمة أحد الرموز الاثني عشر في جدوله.

في أي جزء من ملف XML يُكتب رمز المحافظة؟

يُكتب في كتلة المشتري cac:AccountingCustomerParty داخل عنوانه cac:PostalAddress، بعد الرمز البريدي وقبل كتلة الدولة التي تحمل القيمة JO.

ما الرمز الصحيح لمحافظة البلقاء؟

الرمز الصحيح هو JO-BA. ويُطبع في جدول قالب فاتورة الضريبة الخاصة في الصفحة 63 بالصيغة O-BA، وهو خطأ طباعة لا يُنسخ.

هل توجد رموز للمدن أو الألوية؟

لا يورد الدليل التقني إلا رموز المحافظات الاثنتي عشرة. فالعميل في مدينة داخل محافظة يأخذ رمز محافظته، ولا يوثق الدليل رمزًا أدق من ذلك.

هل حقل «المدينة» في البوابة هو رمز المحافظة نفسه؟

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

المراجع

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