تعرف على كل ما يتعلق بمعيار UBL 2.1 (لغة الأعمال العالمية)، معيار XML المطلوب للامتثال للفوترة الإلكترونية في المغرب. نظرة تقنية وهيكل ودليل التنفيذ.

ما هو UBL 2.1؟ الدليل الشامل للشركات المغربية

إذا كنت تستعد لتفويض الفوترة الإلكترونية في المغرب لعام 2026، فقد سمعت على الأرجح عن UBL 2.1. لكن ما هو بالضبط، ولماذا يهم عملك؟ يشرح هذا الدليل الشامل كل ما تحتاج معرفته.

ما هو UBL (لغة الأعمال العالمية)؟

UBL 2.1 (Universal Business Language الإصدار 2.1) هو معيار دولي قائم على XML طورته منظمة OASIS للوثائق التجارية الإلكترونية. يوفر تنسيقًا موحدًا لـ:

الفواتير
إشعارات الائتمان
إشعارات الخصم
أوامر الشراء
إشعارات التسليم
والعديد من الوثائق التجارية الأخرى

لماذا UBL 2.1؟

اختارت المديرية العامة للضرائب (DGI) في المغرب UBL 2.1 كتنسيق قياسي للفواتير الإلكترونية لأنه:

الميزة	الوصف
معيار دولي	معترف به عالميًا، يسهل التجارة عبر الحدود
قائم على XML	قابل للقراءة الآلية والتحقق بسهولة
شامل	يغطي جميع متطلبات بيانات الفواتير
قابل للتوسيع	يمكن تكييفه للمتطلبات المحلية
مثبت	مستخدم في دول الاتحاد الأوروبي وعالميًا

هيكل فاتورة UBL 2.1

تحتوي فاتورة UBL 2.1 على عدة أقسام رئيسية:

1. رأس الفاتورة

<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2">
  <UBLVersionID>2.1UBLVersionID>
  <ID>INV-2024-001234ID>
  <IssueDate>2024-01-15IssueDate>
  <InvoiceTypeCode>380InvoiceTypeCode>
  <DocumentCurrencyCode>MADDocumentCurrencyCode>
Invoice>

2. معلومات المورد (AccountingSupplierParty)

تحتوي على تفاصيل شركتك:

الاسم القانوني والاسم التجاري
التعريف الضريبي (ICE، IF، RC)
العنوان
معلومات الاتصال

3. معلومات العميل (AccountingCustomerParty)

تحتوي على تفاصيل المشتري:

اسم الشركة أو الفرد
المعرفات الضريبية
عنوان التسليم
تفاصيل الاتصال

4. سطور الفاتورة (InvoiceLine)

يتضمن كل منتج أو خدمة:

الوصف
الكمية والوحدة
سعر الوحدة
فئة ومعدل الضريبة
إجمالي السطر

5. ملخص الضرائب (TaxTotal)

تفصيل جميع الضرائب المطبقة:

مبالغ ضريبة القيمة المضافة حسب المعدل
فئات الضرائب
المبالغ الخاضعة للضريبة

6. الإجماليات النقدية (LegalMonetaryTotal)

الملخص المالي:

مبلغ السطور (المجموع الفرعي)
المبلغ بدون ضريبة
المبلغ شامل الضريبة
المبلغ المستحق

عناصر UBL 2.1 الرئيسية للمغرب

للامتثال لـ DGI، هذه الحقول إلزامية:

العنصر	الوصف	مثال
`ICE`	المعرف المشترك للمقاولة	001234567000089
`IF`	المعرف الضريبي	12345678
`RC`	السجل التجاري	123456
`IssueDate`	تاريخ الفاتورة	2024-01-15
`DueDate`	تاريخ الاستحقاق	2024-02-15
`TaxTotal`	تفصيل الضريبة	معدل 20%

UBL 2.1 مقارنة بالتنسيقات الأخرى

الميزة	UBL 2.1	Factur-X	PEPPOL BIS
التنسيق الأساسي	XML خالص	PDF + XML	مجموعة فرعية من UBL
التعقيد	متوسط	منخفض	متوسط
دعم المغرب	✅ مطلوب	❌ غير مقبول	❌ غير مستخدم
قابل للقراءة البشرية	لا (XML)	نعم (PDF)	لا (XML)

كيف يتعامل حساب مع UBL 2.1

مع حساب، لا تحتاج للقلق بشأن تعقيد XML. منصتنا:

التوليد التلقائي - تنشئ XML UBL 2.1 صالح من بيانات فاتورتك
التحقق - تضمن الامتثال لمتطلبات DGI
التوقيعات الرقمية - تضيف التوقيعات المشفرة المطلوبة
تخزين الأرشيف - تحافظ على أرشيف متوافق لمدة 10 سنوات
الوصول عبر API - قم بتنزيل XML UBL لأي فاتورة عبر API الخاص بنا

نصائح التنفيذ التقني

للمطورين

إذا كنت تتكامل مباشرة مع نظام DGI، تذكر:

استخدم ترميز UTF-8 لجميع مستندات XML
أدرج إعلانات namespace XML بشكل صحيح
تحقق مقابل مخططات XSD الرسمية قبل الإرسال
تعامل مع النص العربي بدعم Unicode المناسب
اختبر مع بيئة sandbox DGI أولاً

أخطاء التحقق الشائعة

الخطأ	السبب	الحل
تنسيق ICE غير صالح	طول أو أحرف خاطئة	تأكد من 15 رقمًا
TaxTotal مفقود	لا يوجد تفصيل ضريبي	أضف حساب الضريبة
تنسيق تاريخ غير صالح	تنسيق خاطئ	استخدم YYYY-MM-DD
انتهاك المخطط	عنصر مطلوب مفقود	تحقق من جميع الحقول الإلزامية

الخلاصة

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

مستعد للبدء؟ أنشئ حسابك المجاني في حساب وأنشئ أول فاتورة متوافقة مع UBL 2.1 في دقائق.

ما هو UBL 2.1؟ الدليل الشامل لمعيار الفوترة الإلكترونية