UBL 2.1 ليس برنامجًا ولا ملف PDF بامتداد مختلف. إنه معجم XML عمومي يرتّب المعطيات التجارية في خانات مسمّاة وقابلة للتوقع. فيستطيع برنامجٌ العثور على الرقم والبائع والمشتري والضريبة والمجموع دون قراءة صفحة بصريًّا. ويستعمله BelloPOS صيغةً مهيكلة للتصدير. وفي 29 غشت 2026، لا نقدّمه بوصفه المخطط الوطني المفروض بمواصفة تقنية منشورة من المديرية العامة للضرائب.
UBL 2.1 في ستة أجوبة
- UBL اختصارٌ لعبارة «اللغة التجارية الكونية»، والنسخة 2.1 معيارٌ عمومي صادر عن منظمة OASIS.
- تبدأ الفاتورة بالعنصر Invoice؛ ويستعمل الإشعار الدائن العنصر CreditNote.
- تفصل البادئتان cbc وcac بين القيم البسيطة ومجموعات المعطيات.
- ملف XML ينقل المعطيات؛ ويبقى ملف PDF هو العرض المقروء الذي يُسلَّم إلى شخص.
- ملفٌ سليم البنية أو مصادَق عليه بمخطط XSD ليس بالضرورة صحيحًا جبائيًّا ولا مقبولًا لدى إدارة.
- تصدّر خطة Go ملف UBL 2.1، لكنها لا ترسله مباشرةً إلى المديرية العامة للضرائب.
1. اقرأ شجرة UBL كما تقرأ فاتورة
تخيّل ملفًّا رئيسيًّا اسمه Invoice. وبداخله، تحمل بعض البطاقات قيمةً واحدة: ID للرقم، وIssueDate للتاريخ، وDocumentCurrencyCode لعملة الدرهم. وتفتح بطاقات أخرى ملفًّا فرعيًّا: AccountingSupplierParty للبائع، وAccountingCustomerParty للزبون، وInvoiceLine لكل سطر. وهذا التنظيم هو ما يميّز الفاتورة المهيكلة عن ملف PDF بسيط.
| عنصر UBL | ما يمثّله | مثال مقروء |
|---|---|---|
| Invoice أو CreditNote | نوع الوثيقة وجذرها | فاتورة أو إشعار دائن |
| cbc:ID | رقم الوثيقة | FAC-2026-00418 |
| cbc:IssueDate | تاريخ الإصدار | 2026-08-29 |
| cbc:DocumentCurrencyCode | العملة | MAD |
| cac:AccountingSupplierParty | هوية البائع | التسمية الاجتماعية والعنوان والمعرّف الموحد |
| cac:AccountingCustomerParty | هوية المشتري | الشركة الزبونة ومعرّفها الموحد |
| cac:InvoiceLine | سطر مفوتَر واحد | الكمية والمادة والثمن والضريبة |
| cac:TaxTotal | الضريبة مجمَّعة | الأساس والنسبة والمبلغ |
| cac:LegalMonetaryTotal | المجاميع القانونية | خارج الضريبة والضريبة والمجموع شاملًا لها والواجب أداؤه |
والأسماء الكاملة طويلة لأنها تتفادى الالتباس بين برنامجين. والبادئات ليست زخرفة: فـcbc تجمع عمومًا المكونات الأساسية، كمعرّف أو تاريخ، وcac تجمع المكونات المركَّبة، كطرف أو سطر. وليس من الضروري حفظها للفوترة، لكن التعرف عليها يساعد على مراقبة تصدير.
2. اربط الصفحة المرئية بمعطيات XML
لنأخذ بيع كرسيين بـ500 درهم خارج الضريبة للوحدة، بنسبة ضريبة قدرها 20 %. فتعرض الصفحة بمقاس A4 الزبونَ ووحدتين و1 000 درهم خارج الضريبة و200 درهم ضريبةً و1 200 درهم شاملًا لها. وعلى ملف XML أن يروي العملية نفسها بالضبط: كمية 2، وثمن وحدوي 500، ومبلغ السطر 1 000، وصنف الضريبة، ونسبة 20، وضريبة 200، ومجموع واجب الأداء 1 200. وتبقى بيانات الفاتورة المغربية واجبةَ المراقبة في الوثيقة وفي التصدير معًا.
- البائع: الاسم القانوني والعنوان والمعرّفات مجمَّعة في كتلة المورّد.
- الزبون: تحمل كتلة المشتري الهوية المنطبقة، بدل ملاحظة حرة يصعب معالجتها.
- السطور: تحتفظ كل كمية ووحدة وبيان وثمن ومبلغ بعلاقتها بالمادة المبيعة.
- الضريبة: المجاميع الفرعية حسب الصنف أو النسبة تتيح إعادة تركيب المبلغ الجبائي.
- المجاميع: الأسس والضرائب والتقريبات والمبلغ الواجب أداؤه يجب أن تُقارَب مع السطور.
- الأداء: الوسيلة وأجل الاستحقاق والمرجع يمكن هيكلتها دون تغيير المبلغ المفوتَر.
وقد تكون الفاتورة مقروءةً لكنها سيئة الهيكلة، أو مهيكلةً لكنها خاطئة جبائيًّا. فمثلًا، يقبل ملف XML صالح اسمَ زبون مرمَّزًا بشكل سليم؛ لكنه لا يعرف إن كان هذا المعرّف الموحد يعود فعلًا إلى هذا الزبون. فالجودة تتوقف إذن على المعطيات المدخَلة وعلى قواعد البرنامج وعلى المراقبة البشرية.
3. أربعة مستويات من المراقبة لا ينبغي الخلط بينها
كثيرًا ما تُستعمل كلمة «صالح» بمفردها. فاسأل دائمًا: صالح في مقابل ماذا؟
- سليم البنية بلغة XML: الوسوم تُفتَح وتُغلَق والحروف الخاصة مهروبة بشكل صحيح.
- مصادَق عليه في مقابل مخطط XSD الخاص بـUBL 2.1: العناصر والأنواع تحترم المخطط العام المنشور من طرف OASIS.
- مطابق للقواعد المهنية: الترقيم والهوية والحسابات والمراجع والضرائب تستجيب للملف الشخصي المطلوب.
- مقبول لدى المرسَل إليه: بوابته أو نظامه يتوصل بالملف ويعيد إشعارًا بالتوصل أو حالة.
| المراقبة | ما تكشفه | ما لا تثبته |
|---|---|---|
| محلّل XML | وسم مكسور أو حرف غير صالح | صحة نسبة الضريبة |
| مخطط XSD | بنية أو نوع ممنوع | تطبيق ملف شخصي مغربي |
| القواعد المهنية | مجموع غير منسجم أو حقل مطلوب غائب | وقوع الإيداع فعلًا |
| الإشعار من البوابة | التوصل أو الرفض عبر هذه القناة | أصالة كل المعطيات المدخَلة |
وقد تقيّد مواصفةٌ مغربية مستقبلية استعمال UBL، أو تختار صيغةً أخرى، أو تضيف قواعد ورموزًا وتواقيع. ولهذا يفصل دليل إلزامية الفوترة الإلكترونية بين المدونة العامة للضرائب الجاري بها العمل وبين التفاصيل التقنية التي لم تُنشَر أو لم تُؤكَّد بعد.
المعيار الدولي ليس اعتمادًا وطنيًّا
تنشر منظمة OASIS معيار UBL 2.1 ومخططاته. ووجوده لا يكفي لتأكيد أن المديرية العامة للضرائب المغربية تفرض هذه الصيغة، أو تعتمد البرنامج الذي يُصدرها، أو تقبل اليوم أي ملف بصيغة UBL. فكل تأكيد من هذه التأكيدات يستلزم مصدرًا إداريًّا مستقلًّا.
4. ما الذي يضعه BelloPOS في ملف UBL 2.1
يسلسل BelloPOS الفاتورة تحت الجذر Invoice والإشعار الدائن تحت CreditNote. ويحمل التصدير الرقم الصادر والتاريخ وعملة الدرهم وكتلتي البائع والزبون بالمعرّفات الموحدة المتوفرة، والسطور والكميات والأثمنة والضريبة مجمَّعةً حسب النسبة والمجاميع ومعطيات الأداء. وتُهرَّب الحروف مثل & أو < بواسطة مكتبة XML بدل ربطها كنصّ.
وعند الإصدار، يحتفظ التطبيق بملف XML بعينه ويحسب بصمة SHA-256 الخاصة به. ثم يصدّر هذا المحتوى نفسه، بدل إعادة بناء الفاتورة بمعطيات قد تكون تغيّرت. وهذه الآلية مفصَّلة في دليل الختم ببصمة SHA-256.
والوظيفة مدرَجة في خطتي Go وPro. وهي تهيّئ الملفات وتصدّرها محليًّا. وهي لا توقّع بشهادة مؤهَّلة ولا تنجز إرسالًا مباشرًا إلى المديرية العامة للضرائب. وعلى التاجر أو مكتب محاسبته التحقق من القناة الرسمية ومن المتطلبات المنطبقة لحظة الإيداع.
5. لائحة تحقق لفتح ملف دون أن تكون مطوّرًا
اشتغل على نسخة واستعمل محررًا لا ينفّذ محتوًى خارجيًّا. والمراقبة الأولية تستغرق بضع دقائق.
- الملف ينتهي بامتداد .xml ويُفتَح دون خطأ في التركيب.
- الجذر يطابق الوثيقة: Invoice أو CreditNote.
- الرقم والتاريخ وعملة الدرهم تطابق الفاتورة المرئية.
- اسم البائع وعنوانه ومعرّفه الموحد دقيقة.
- الزبون المهني ومعرّفه الموحد يطابقان البطاقة المصادق عليها.
- كل سطر يستعيد الكمية والبيان والثمن والمبلغ.
- الأسس ومبالغ الضريبة تُعاد تركيبها حسب كل نسبة.
- المجموع الواجب أداؤه يساوي الوثيقة المسلَّمة للزبون.
- بصمة الملف تطابق البصمة الواردة في البيان حين يكون متوفرًا.
- القناة المرسَل إليها تؤكد الصيغة والملف الشخصي الذي تنتظره.
واحتفظ بملف PDF وXML والبيان والإشعار المحتمل معًا، وفق عرف تسمية ثابت. فهذا الزوج المقروء والمهيكل يبسّط الاسترجاع والمراقبة والترحيل المستقبلي.
أخطاء ينبغي تجنبها
- إعادة تسمية ملف PDF بامتداد .xml.
- الاعتقاد بأن كل الوسوم إلزامية في كل الملفات الشخصية.
- المصادقة على التركيب وحده دون مقاربة المبالغ.
- الخلط بين CreditNote وفاتورة سالبة مرتجَلة.
- تقديم UBL دليلًا على الإيداع لدى المديرية العامة للضرائب.
- تعديل ملف XML المختوم لتصحيح العرض.
- إرسال ملف زبون حقيقي إلى أداة مصادقة مجهولة على الإنترنت.
- إغفال الاحتفاظ بالنسخة المقروءة وبالإشعار بالتوصل.
أسئلة متكررة
هل UBL 2.1 صيغةٌ للفاتورة الإلكترونية؟
نعم. تنشر منظمة OASIS معيار UBL بوصفه مكتبةً من الوثائق التجارية المهيكلة، ومنها Invoice وCreditNote. غير أن الملف الشخصي للمرسَل إليه قد يضيف إكراهاته الخاصة.
هل تفرض المديرية العامة للضرائب المغربية UBL 2.1 رسميًّا؟
لم نجد، في المصادر الرسمية التي تحققنا منها في 29 غشت 2026، مواصفةً وطنية منشورة تتيح هذا التأكيد العام. ويستعمله BelloPOS صيغةً للتصدير.
هل يجب على الزبون قراءة ملف XML؟
ليس عادةً. فملف PDF أو الطباعة يفيدان الشخص؛ أما ملف XML فيخدم المعالجة بواسطة البرمجيات. وعلى الاثنين وصف الفاتورة نفسها.
ما الفرق بين Invoice وCreditNote؟
يمثّل Invoice الفاتورة. ويمثّل CreditNote الإشعار الدائن وقد يحيل على الفاتورة المصحَّحة. وهما جذران متمايزان في UBL.
هل ملفٌ مصادَق عليه بمخطط XSD صحيح جبائيًّا؟
ليس بالضرورة. فالمخطط يراقب البنية العامة. أما الهوية الحقيقية والضريبة والترقيم والقواعد المهنية وقبول القناة فتستلزم مراقبات أخرى.
هل يرسل BelloPOS ملف UBL إلى المديرية العامة للضرائب؟
لا. فـGo وPro تهيّئان الملف وتختمانه وتصدّرانه. ويبقى الإيداع من إنجاز التاجر أو مكتب محاسبته عبر القناة الرسمية المتاحة.
الخلاصة
يصير UBL 2.1 بسيطًا حين تقرؤه كمصنَّف: جذر الوثيقة، والأطراف، والسطور، والضرائب، والمجاميع. وقيمته في المعطى القابل للتوقع، لا في شارة مطابقة. فراقب الفاتورة المرئية وملف XML والملف الشخصي المطلوب والإشعار بالتوصل بوصفها أربعة إثباتات منفصلة.
المصادر
الأرقام والقواعد المذكورة أعلاه مأخوذة من هذه الصفحات، بتاريخ الاطلاع المذكور في المقال.
- المواصفة الرسمية Universal Business Language 2.1 من OASIS
- المدونة العامة للضرائب 2026، المديرية العامة للضرائب، شوهدت في 29 غشت 2026
- BelloPOS، الفوترة الإلكترونية وتصدير UBL، شوهد في 29 غشت 2026
اختبر تصديرًا حقيقيًّا بصيغة UBL، لا لقطة شاشة
أصدر فاتورة تجريبية في خطة Go، واعثر على كل قيمة داخل ملف XML، وتحقق من البصمة، وسلّم الملف إلى مكتب محاسبتك قبل التحويل.
لمزيد من التعمق
أدلة عملية أخرى في الموضوع نفسه: