فاتورة نقطة بيع DGI المغرب
إضفاء الطابع الجبائي على إيصالات تجزئة DGI المغرب — حمولات إجازة UBL 2.1 لنقطة البيع B2C وفواتير B2B
تطرح المديرية العامة للضرائب المغربية (DGI) الفوترة الإلكترونية الإلزامية على نموذج الإجازة المسبقة: تُرسَل كل فاتورة إلى منصة DGI وتُجاز قبل أن تصبح صحيحة قانوناً، بصيغة UBL 2.1 الموحّدة وحاملةً ICE البائع والمشتري (المعرّف الموحّد للمقاولة). يحوّل هذا الموديول فواتير أودو وإيصالات نقطة البيع لديك إلى حمولات إجازة UBL جاهزة لـ DGI، ويتحقق من المعرّفات المغربية، ويبني رمز QR للتحقق، ويحفظ سلسلة بصمة جبائية مقاومة للتلاعب، ويُرسل إلى نقطة نهاية DGI باستخدام بياناتك الخاصة.
ماذا يفعل
حمولة إجازة UBL 2.1
يولّد مستند Invoice / CreditNote بمعيار OASIS
UBL 2.1 مع تخصيص DGI المغرب وملف الإجازة، وتسلسل حتمي (مستقر بايتياً)،
وتخطيط معاملات المبيعات / تفصيل الضريبة الذي تتوقعه المنصة.
إضفاء الطابع الجبائي على نقطة البيع B2C
يصبح كل إيصال نقطة بيع مستند إجازة DGI. تُصدَر إيصالات المستهلك المجهولة
بمرجع المشتري B2C؛ وعندما يُربط عميل يحمل ICE تُرقَّى الفاتورة
إلى مستند B2B تلقائياً.
التحقق من ICE والمعرّف الجبائي
يُتحقَّق من ICE البائع والمشتري بالبنية الفعلية ذات الـ15 رقماً وخوارزمية مفتاح التحقق مودولو-97 المنشورة؛ ويُفحص المعرّف الجبائي (IF) والسجل التجاري (RC) على الشركة والشركاء ومعالج الإعداد.
سلسلة جبائية مقاومة للتلاعب
يحمل كل مستند مُجاز بصمة SHA-256 للمستند السابق وعدّاداً تصاعدياً لكل شركة، مكوّناً سلسلةً مقاومةً للتلاعب: أي تعديل رجعي يكسر السلسلة.
رمز QR للتحقق
تُبنى حمولة QR مدمجة وحتمية (ICE البائع، رقم المستند، التاريخ والوقت، الإجمالي، الضريبة، بصمة المستند ومرجع الإجازة) لكل إيصال جبائي وتُعرَض كصورة لطباعتها على التذكرة.
نقل بمفتاحك الخاص (BYOK)
أرسِل وراقِب نقطة نهاية إجازة DGI بمفتاح API أو رمز حامل خاص بك عبر TLS. تبقى البيانات في قاعدة بياناتك فقط؛ هذا الموديول مولّد صيغة ونقل BYOK، وليس مزوّد خدمة معتمداً.
التحقق من قواعد العمل قبل الإرسال
مجموعة قواعد محلية تحجب المستندات غير المطابقة قبل أن تصل إلى DGI، وتُعيد رسالة دقيقة وقابلة للتنفيذ لكل مشكلة:
| القاعدة | ما تتحقق منه |
|---|---|
| ICE البائع | إلزامي، 15 رقماً، مفتاح تحقق mod-97 صحيح |
| IF البائع | معرّف جبائي إلزامي، صحيح بنيوياً |
| ICE المشتري | مُتحقَّق عند وجوده؛ إيصالات B2C لا تحتاج ICE مشترٍ |
| فئة الضريبة | قياسية / صفر / معفاة / خارج النطاق فقط |
| معدل الضريبة | المعدلات المغربية السارية لـ2026 (20% قياسي، 10% مخفّض، 0%) |
| الإجماليات | مجموع البنود = قبل الضريبة؛ قبل الضريبة + الضريبة = شامل الضريبة |
| الإشعار الدائن / المدين | يجب أن يشير إلى الفاتورة الأصلية |
كيفية الاستخدام
1. الإعداد
افتح المحاسبة › التهيئة › DGI المغرب › الإعداد، وأدخل ICE والمعرّف الجبائي، و(عند نشرها) نقطة نهاية إجازة DGI ومفتاحك.
2. التوليد
على أي فاتورة عميل أو إشعار دائن أو طلب نقطة بيع، استخدم تحقّق DGI، ثم توليد UBL لبناء حمولة الإجازة وسلسلة البصمة ورمز QR.
3. الإجازة
استخدم إجازة عبر DGI للإرسال ببياناتك الخاصة، وتخزين مرجع الإجازة ورمز QR، وتقديم السلسلة الجبائية. يراقب إجراء مجدول الإرساليات المعلّقة.
أبرز النقاط
- فاتورة وإشعار دائن OASIS UBL 2.1، ملف إجازة DGI
- التحقق من ICE (mod-97) والمعرّف الجبائي وRC في كل مكان
- إضفاء الطابع الجبائي على إيصالات نقطة البيع B2C وفواتير B2B
- سلسلة جبائية SHA-256 مقاومة للتلاعب بعدّاد لكل شركة
- حمولة وصورة QR حتمية للتحقق
- توليد / إرسال جماعي من قائمة الفواتير
- نقل BYOK واستطلاع حالة غير متزامن
- نواة بايثون خالصة ومختبَرة بالكامل؛ وحدات مجتمعية فقط
المطابقة والإفصاح
يولّد هذا الموديول صيغة إجازة UBL الخاصة بـ DGI، وعند تهيئتك لنقطة نهاية، يُرسلها باستخدام بياناتك الخاصة (BYOK). وهو ليس مزوّد خدمة معتمداً (CSP) ولا يتضمّن أي اعتماد؛ ولا يزال برنامج CSP لـ DGI وواجهة الإجازة الإنتاجية قيد الإنهاء، لذا تُترك نقطة النهاية فارغة لتملأها عند نشرها. تُرسَل بياناتك فقط إلى نقطة النهاية التي تهيّئها، وبياناتك لا تغادر قاعدة بياناتك. معدلات الضريبة وقواعد المعرّفات تعكس المدونة العامة للضرائب المغربية كما عُدّلت لـ2026.
English
Morocco DGI POS Invoice (UBL 2.1 Clearance)
Morocco's DGI is rolling out mandatory e-invoicing on a pre-clearance model: every invoice is validated by the DGI platform before it is legally valid, in UBL 2.1 format carrying the seller and buyer ICE. This module turns Odoo invoices and POS receipts into DGI-ready UBL clearance payloads, validates the Moroccan identifiers, builds the verification QR, keeps a tamper-evident fiscal hash chain, and transmits with your own credentials.
UBL 2.1, POS fiscalisation & identifiers
Standards-correct OASIS UBL 2.1 Invoice/CreditNote with deterministic serialization. Every POS receipt becomes a DGI clearance document (B2C, auto-upgraded to B2B when a customer ICE is attached). ICE (mod-97), Identifiant Fiscal and RC validated everywhere.
Fiscal chain, QR & BYOK
Tamper-evident SHA-256 fiscal chain with per-company counter, a deterministic verification QR, pre-submission rule validation, batch generation, and BYOK transmission with async status polling. A format generator and BYOK transport, not a certified service provider. Rates reflect the Moroccan CGI for 2026. Odoo 18 and 19.
Screenshots
Dgi Connections
Onboarding
Update date: 2026-07-02