أدلة ومقارناتالتجارة في المغربالفوترة

طريقة تصدير الفواتير الإلكترونية بصيغتي XML وZIP

تصدير ملف واحد أو فترة كاملة مع بيان CSV وفحص SHA-256 وتسليم الملف للمحاسب وحفظ الأدلة.

بقلم BelloCommerce

·

التصدير الجيد لا يختزل في تحميل ملف مضغوط. بل يجب معرفة أي الوثائق تدخل في الفترة، والعثور على كل ملف XML، ومراقبة بصمته، والحصول على إثبات التسليم أو الإيداع. ويقترح BelloPOS مسارين: ملف XML لفاتورة أو إشعار دائن بعينه، وملفًّا مضغوطًا لمجال من التواريخ مع بيان بصيغة CSV. ولا يشكّل أيٌّ منهما بمفرده إشعارًا بالتوصل من المديرية العامة للضرائب.

تصدير فواتير UBL بصيغتي XML وZIP في المغرب
تصدير فواتير UBL بصيغتي XML وZIP في المغرب.

المسار الموصى به

  • استعمل ملف XML الفردي لمراقبة وثيقة بعينها أو لتسليمها.
  • استعمل الملف المضغوط للفترة من أجل مكتب المحاسبة والأرشيف وإيداع مجمَّع إن قبلته القناة.
  • قارِب عدد سطور البيان والملفات الموجودة وسلسلة الأرقام.
  • أعد حساب بعض بصمات SHA-256 قبل التسليم.
  • أرسل عبر قناة مصادق عليها واحتفظ بإثباتها على حدة.
  • لا تعدّل أبدًا ملف XML مختومًا داخل الملف المضغوط؛ بل صحّح المصدر بالوثيقة الملائمة.

1. اختر بين ملف XML الفردي والملف المضغوط للفترة

تتوقف الصيغة على المهمة، لا على حجم الشاشة. فقد يطلب زبونٌ أو محاسب أو مراقب وثيقةً واحدة؛ أما الإقفال الشهري فيستلزم مجموعةً قابلة للمقاربة. فابدأ بفهم بنية UBL 2.1، ثم اختر مستوى التصدير.

التصديرالاستعمال السليمالمراقبة الفورية
ملف XML واحدفاتورة أو إشعار دائن محدَّدالرقم والتاريخ والمجموع والبصمة
ملف مضغوط يوميتسليم قصير أو اختبار للمسطرةالسلسلة الكاملة لهذا اليوم
ملف مضغوط شهريمكتب المحاسبة أو فترة الضريبةالعدد والأنواع والحالات والفراغات
ملف PDF المرافقالقراءة والتبادل البشريالهوية والسطور والمجموع نفسها
إشعار خارجي بالتوصلإثبات التوصل أو الإيداعالمرجع والتاريخ والقناة والحالة

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


2. ماذا يجب أن يقوله البيان بصيغة CSV

البيان هو فهرس الملف المضغوط. وفي BelloPOS، يبيّن كل سطر الرقم والنوع وتاريخ الختم والحالة المحلية واسم الملف وبصمة SHA-256. وهو لا يعوّض مجاميع ملف XML ولا إشعارًا إداريًّا بالتوصل، لكنه يتيح رصد ملف ناقص قبل فتح مئات الوثائق.

  • الرقم: مفتاح المقاربة مع سلسلة الفوترة.
  • النوع: فاتورة أو إشعار دائن، حتى لا يُجمَع الاثنان على غير هدى.
  • التاريخ: يحدّد موضع الوثيقة داخل المجال المصدَّر.
  • الحالة: تصف الحالة المحلية المعروفة لحظة التصدير، لا مصادقةً من المديرية العامة للضرائب بلا جواب حقيقي.
  • الملف: يربط السطر بملف XML بعينه داخل الملف المضغوط.
  • بصمة SHA-256: تتيح إعادة حساب بصمة المحتوى وكشف أي اختلاف.

وافتح ملف CSV ببرنامج يحترم ترميز UTF-8. ويحمل بيان BelloPOS علامة ترتيب البايتات للحفاظ على علامات التشكيل في Excel. ولا تحفظ ملف CSV بعد ذلك بفاصل آخر قبل المراقبة: فقد تغيّر بذلك عرض نسختك أو ترميزها.

3. صدّر وراقب في تسع مراحل

أنجز أولًا اختبارًا على يوم صغير، ثم طبّق المسطرة نفسها على الشهر.

  1. تحقق من الهوية القانونية والترقيم والنسب في BelloPOS.
  2. اختر تاريخي البداية والنهاية المطابقين لتسليمك.
  3. اقرأ عدد الوثائق المعلن قبل إطلاق التصدير.
  4. أنشئ الملف المضغوط للفترة في الإعدادات، قسم المطابقة.
  5. انسخ الملف المضغوط إلى مجلد عمل مؤرَّخ دون تعديل الأصل.
  6. افتح البيان بصيغة CSV وأحصِ الفواتير والإشعارات الدائنة والسطور.
  7. قارن كل اسم ملف في البيان بالمحتوى الحقيقي للملف المضغوط.
  8. أعد حساب بصمات عينة وعالج أي اختلاف.
  9. سلّم الملف عبر القناة المتفق عليها واحتفظ بالإشعار أو الرسالة أو الوصل.
الفارقالسبب المحتملالإجراء
ملف XML غائبتصدير انقطع أو وثيقة خارج المجالالبحث عن الرقم قبل أي إيداع
سطر بلا ملفأرشيف ناقصإعادة التوليد من المصدر
بصمة مختلفةمحتوى عُدِّل أو ملف خاطئلا تُرسله؛ وانطلق من المختوم
فراغ في الترقيمسلسلة أخرى أو إلغاء أو وثيقة ناقصةالتوثيق ومقاربة التاريخ
مجموع ملف PDF مختلفنسخة خاطئة أو تعديلالمقارنة بالوثيقة الصادرة والتصحيح عبر المسار القانوني

وعلى macOS أو Linux، يستطيع الأمر shasum بخيار 256 إعادة حساب بصمة؛ وعلى Windows، يؤدي الأمر Get-FileHash بخيار SHA256 الدور نفسه. فاجعل شخصًا مأذونًا له ينفّذ الأمر وقارن السلسلة كاملة، لا الأحرف الأولى وحدها. ويشرح دليل بصمة SHA-256 حدود هذا الاختبار.

بيان CSV وبصمات الفواتير المصدرة
بيان CSV وبصمات الفواتير المصدرة.

الملف المضغوط ليس إثباتًا على الإيداع

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

4. سلّم الملف لمكتب المحاسبة دون فقدان المسار

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

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

واحتفظ بسجل أدنى: اسم الملف، وبصمة الملف المضغوط، والمجال، والمرسِل، والمرسَل إليه، والتاريخ، والقناة، والجواب. فهذا السجل يتيح إثبات أي نسخة سُلِّمت إذا تنقّل الملف أو إذا أُنشئت نسخة جديدة.

5. كيف يشتغل التصدير في BelloPOS

تختم خطتا Go وPro محليًّا كل فاتورة صادرة وكل إشعار دائن في خطة Pro داخل الطابور الإلكتروني. ويصدّر إجراءٌ على وثيقة ملفَّ UBL 2.1 الخاص بها. وتصدّر شاشة المطابقة مجالًا في شكل ملف مضغوط، يتضمن ملفات XML المختومة وبيانًا بصيغة CSV. ولا تُنتج فترةٌ فارغة أرشيفًا مضلِّلًا.

الوظيفةما يفعله BelloPOSالمسؤولية الباقية
ملف XML فردييكتب المضمون المختوم للوثيقةمراقبة الوثيقة الصحيحة وتسليمها
ملف مضغوط للفترةيجمّع المختومات الواقعة بين تاريخينالمصادقة على النطاق وعلى السلاسل
البيانيحصي الملفات والأنواع والتواريخ والحالات والبصماتالمقاربة وتوثيق الفوارق
العمل دون اتصاللا يستلزم إنترنت للإصدار ولا للتصديرالإرسال بعد ذلك عبر القناة المتاحة
الاتصال بالمديرية العامة للضرائبلا إرسال مباشر مفعَّلالإيداع وحفظ الإشعار الرسمي

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

أخطاء ينبغي تجنبها

  • تصدير فترة دون الإعلان عن حدودها.
  • الخلط بين الحالة المحلية والمصادقة الإدارية.
  • إعادة تسمية ملفات XML أو تعديلها داخل الملف المضغوط.
  • إرسال ملف CSV وحده دون ملفاته.
  • عدم إعادة حساب أي بصمة أبدًا.
  • تكثير النسخ «النهائية» و«النهائية2» و«المصحَّحة» بلا سجل.
  • استعمال قناة غير مصادق عليها مع معطيات الزبناء.
  • حذف النسخة المحلية بعد التسليم لمكتب المحاسبة.

أسئلة متكررة

هل أستطيع تصدير فاتورة واحدة؟

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

ماذا يتضمن الملف المضغوط للفترة؟

كل ملف XML مختوم يقع داخل التواريخ، زائد بيانًا بصيغة CSV يتضمن الرقم والنوع والتاريخ والحالة واسم الملف وبصمة SHA-256.

هل يعوّض البيان ملفات XML؟

لا. فهو يفيد فهرسًا وأداةَ مقاربة. وتبقى المعطيات المفصَّلة في كل ملف XML.

كيف أتحقق من البصمة؟

أعد حساب بصمة SHA-256 على الملف بعينه بأداة موثوقة وقارن السلسلة كاملةً بما في البيان. والاختلاف يفرض توقيف التسليم.

هل يُرسَل الملف المضغوط تلقائيًّا إلى المديرية العامة للضرائب؟

لا. فـBelloPOS يُنشئه محليًّا. ويستعمل التاجر أو مكتب محاسبته القناة الرسمية المتاحة ويحتفظ بالإشعار.

هل يجب الاحتفاظ بالصادرات بعد الإيداع؟

نعم. تنص المدونة العامة للضرائب لسنة 2026 على حفظ لمدة عشر سنوات للفواتير والتذاكر والوثائق المثبتة والوثائق المحاسبية المقصودة. فنظّم الأرشيف حسب وضعيتك رفقة مستشارك.

الخلاصة

التصدير الموثوق يشكّل سلسلة: نطاقٌ معلن، وملفات XML مختومة، وبيانٌ مقارَب، وبصماتٌ مراقَبة، وتسليمٌ متتبَّع، وإشعارٌ محفوظ. وزرّ الملف المضغوط لا يعوّض أي مسؤولية من هذه، لكنه يجعلها قابلةً للتنفيذ دون إعادة إدخال.

المصادر

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

حضّر أول ملف فترة لديك

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

لمزيد من التعمق

أدلة عملية أخرى في الموضوع نفسه: