صيغة TEIF: شرح الفاتورة الإلكترونية التونسية

ما هي صيغة TEIF؟

TEIF هي صيغة المعطيات التي حددتها شبكة تونس للتجارة لتبادل الفواتير الإلكترونية. ويقدمها دليل التطبيق الصادر عن TTN على أنها مبنية على معيار INVOIC من UN/EDIFACT، وهو مرجع تبادل المعطيات التابع للأمم المتحدة، مع نمذجة بلغة XML يصفها مخطط وفق W3C.

إلى غاية 13 أكتوبر 2026، يتضمن ملف المواصفات القابل للتحميل من موقع tradenet.com.tn دليل التطبيق في نسخته 2.0 بتاريخ 20 أكتوبر 2021، ومخطط XSD في نسخته 1.8.8 بصيغتين (بالإمضاء ودونه)، ومخططًا في النسخة 1.8.9، ومثالًا لفاتورة ممضاة، ومواصفات إمضاء المزوّد في نسختها 3.0 بتاريخ 29 ماي 2026.

يصف هذا المقال الملف. ولمعرفة من يجب عليه إصدار فواتير إلكترونية، ومنذ متى، وبأي كلفة، اطلع على دليل El Fatoora الشامل 2026.

ما هي بنية ملف TEIF؟

يحمل العنصر الجذر TEIF خاصيتين وجوبيتين: نسخة الصيغة وهيكل المراقبة («TTN»). ثم يتضمن الكتل التالية بهذا الترتيب. ويستعيد عمود «وجوبي» جدول البنية الوارد في دليل TTN.

وتوجد كتل اختيارية أخرى (نص حر، وأماكن، وشروط خاصة، ووثائق مرفقة)؛ والفاتورة العادية لا تحتاج إليها.

وكل معلومة مرمّزة تحيل إلى مرجع من الملحق أ بالدليل: I-0 لأنواع المعرّفات، وI-1 لأنواع الوثائق، وI-3 للتواريخ، وI-6 لدور الأطراف، وI-16 للأداءات، وI-17 للمبالغ. وتعرض الأقسام الموالية الرموز المفيدة.

كيف يتم تعريف البائع والمشتري؟

في الترويسة، يتضمن العنصر MessageSenderIdentifier المعرّف الجبائي للمصدر، بالنوع I-01. وهذه نقطة مراقبة أساسية: يجب أن يكون هذا المعرّف هو معرّف حساب TTN الذي يودع الفاتورة، وإلا ترفض TTN الإيداع.

يصف الدليل المعرّف الجبائي في خمسة أجزاء: المعرّف المتكون من 7 أرقام، وحرف مفتاح (جميع الحروف ما عدا I وO وU)، ورمز الأداء على القيمة المضافة (A أو P أو B أو F أو N)، ورمز الصنف (M أو P أو C أو N أو E)، ورقم المؤسسة الثانوية (000 للمؤسسة الرئيسية). ويُكتب في ملف XML دون خطوط مائلة، مثل 0736202XAM000، وهو معرّف TTN في مثالها الرسمي.

ويُعرَّف المرسل إليه بأحد الأنواع الأربعة الواردة في المرجع I-0:

وتستعيد الكتلة PartnerSection كل طرف مع دوره (I-62 للمزوّد، وI-64 للحريف)، ومعرّفه، واسمه، واختياريًا عنوانه. ويُعرَّف الحريف الخاص ببطاقة تعريفه الوطنية؛ ويرفض Clic2Up إرسال فاتورة ليس لحريفها معرّف جبائي ولا بطاقة تعريف وطنية.

الرقم ونوع الوثيقة والتواريخ

تتضمن الكتلة Bgm رقم الفاتورة (DocumentIdentifier)، أي رقمها في سلسلة ترقيمك، ونوع الوثيقة حسب المرجع I-1:

يودع Clic2Up الفواتير (I-11) والإشعارات الدائنة (I-12) ومذكرات الأتعاب (I-13)، ويصنّف فاتورة البيع بالأورو أو بالدولار ضمن فواتير التصدير (I-15). ويتضمن الدليل أيضًا رمز مرجع (I-89) للإشارة إلى الفاتورة التي تتعلق بها وثيقة ما.

وتحمل الكتلة Dtm التواريخ، لكل منها رمزه: I-31 لتاريخ الإصدار، وI-32 لآخر أجل للدفع، وI-36 لفترة الفوترة. وتُكتب التواريخ بصيغة اليوم والشهر والسنة، برقمين لكل منها: 070612 لـ 7 جوان 2012 في مثال TTN.

كيف توصف أسطر الفاتورة؟

يتضمن كل سطر (Lin، داخل LinSection):

• رقم السطر (ItemIdentifier)؛
• رمز منتج لا يتجاوز 35 حرفًا وتسمية (LinImd)؛
• كمية مع وحدة قيسها (LinQty)؛
• نسبة الأداء على القيمة المضافة الخاصة بالسطر (LinTax، الرمز I-1602)؛
• المبالغ (LinMoa): سعر الوحدة دون احتساب الأداء (I-183) ومبلغ السطر دون احتساب الأداء (I-171)؛
• واختياريًا، تخفيض أو عبء خاص بالسطر (LinAlc) ونص حر.

تحمل جميع المبالغ العملة وفق معيار ISO 4217. وبالدينار، تُكتب بثلاثة أرقام بعد الفاصل، أي بالمليم.

كيف يظهر الأداء على القيمة المضافة وFODEC ومعلوم الطابع الجبائي؟

تلخص الكتلة InvoiceTax أداءات الفاتورة، مع كتلة فرعية InvoiceTaxDetails لكل أداء ولكل نسبة. وتعطي كل كتلة فرعية نوع الأداء (رمز من المرجع I-16)، والنسبة، والقاعدة الخاضعة (I-177) عند الاقتضاء، ومبلغ الأداء (I-178). ورموز المرجع هي:

عمليًا، تتضمن الفاتورة بنسبتين للأداء على القيمة المضافة كتلتين I-1602، واحدة لكل نسبة. ولمعلوم الطابع الجبائي كتلته الخاصة، بنسبة 0 مع مبلغه فقط. ولـ FODEC كتلة لكل نسبة، قاعدتها المبلغ دون احتساب الأداء للأسطر الخاضعة له. وفي الملفات التي ينتجها Clic2Up، تشمل قاعدة كتل الأداء على القيمة المضافة مبلغ FODEC والأداءات الأخرى التي تدخل في أساس الأداء على القيمة المضافة.

ما القاعدة التي يجب أن تحترمها المجاميع؟

تحمل الكتلة InvoiceMoa مجاميع الفاتورة، لكل منها رمز من المرجع I-17: I-176 للمجموع دون احتساب الأداء، وI-181 لمجموع الأداءات، وI-180 للمجموع باحتساب الأداء. وتوجد رموز أخرى (مجموع القاعدة الخاضعة، والمبلغ المعفى، والمبلغ الموقوف عنه الأداء على القيمة المضافة…) للحالات الخاصة.

ويجب أن تكون الحسابات دقيقة: المبلغ دون احتساب الأداء، زائد FODEC، زائد الأداءات الأخرى المضمّنة، زائد الأداء على القيمة المضافة، زائد معلوم الطابع الجبائي، يساوي المبلغ باحتساب الأداء. ويتحقق Clic2Up من هذه المساواة، في حدود 5 مليمات، قبل الإمضاء. وإذا لم تتحقق، لا تُرسل الفاتورة وتفصّل الرسالة الحساب.

هذا النوع من الأخطاء، وبقية الأسباب التي تجعل TTN ترفض الفاتورة، مفصّلة في مقال لماذا ترفض El Fatoora فاتورتك؟ الأسباب والحلول.

كيف يحمي إمضاء XAdES الفاتورة؟

يُدرج إمضاء المزوّد داخل الملف نفسه (إمضاء مغلّف) ويتبع معيار XAdES-B الذي حدده المعهد الأوروبي لمعايير الاتصالات ETSI (EN 319 132-1). وتحدد مواصفات TTN التفاصيل:

• إمضاء مزوّد واحد لكل فاتورة، في كتلة ds:Signature معرّفها «SigFrs»؛
• التقنين الحصري لـ XML وبصمات SHA-256؛ وخوارزمية الإمضاء التي تنص عليها TTN هي RSA-SHA256؛
• خصائص ممضاة: وقت الإمضاء، وبصمة الشهادة والجهة المصدرة لها، ودور الممضي، وسياسة الإمضاء الخاصة بـ TTN (المعرّف OID، والبصمة، وعنوان الوثيقة)؛
• استثناءان: الإمضاء نفسه والكتلة RefTtnVal لا يدخلان في ما يتم إمضاؤه.

يفسر هذان الاستثناءان طريقة العمل كلها: يمكن لـ TTN أن تضيف لاحقًا مرجعها وQR code وإمضاءاتها الخاصة دون إبطال إمضاء المزوّد. وفي المقابل، فإن أي تعديل لبقية الملف بعد الإمضاء يفسده. لذلك تطلب TTN إمضاء ملف XML في شكله النهائي بالضبط، بترميز UTF-8، مع تجنب الحروف الخاصة.

يجب أن تصدر الشهادة عن الوكالة الوطنية للمصادقة الإلكترونية (TunTrust). وتذكر مواصفات TTN شهادات ID-Trust وختم المؤسسة (Cachet Entreprise) وDigigo وMobile ID (e-Houwiya). وتستعمل شهادات Mobile ID مفتاحًا بالمنحنيات الإهليلجية، ويمضيها Clic2Up بالخوارزمية الموافقة ECDSA-SHA256.

لاختيار شهادة، اطلع على مقارنتنا Digigo أم ID-Trust.

ماذا تتضمن الفاتورة بعد مصادقة TTN عليها؟

عندما تنجح المراقبة، ترجع TTN ملفًا مكتملًا. ويصف دليل TEIF ما تضيفه:

• الكتلة RefTtnVal، وفيها المرجع الوحيد للفاتورة (الرمز I-88)، وتاريخ إسناده (الرمز I-37، بصيغة اليوم والشهر والسنة والساعة والدقيقة)، والختم الإلكتروني المرئي (ReferenceCev)، أي QR code مرمّزًا بـ base64؛
• إمضاء من TTN على الختم الإلكتروني المرئي (المعرّف SigCEv)؛
• إمضاء من TTN على الرسالة المصادق عليها (المعرّف SigTTN).

هذا الملف النهائي هو المعتمد. وعندما يحصل Clic2Up على مصادقة TTN، يسترجع هذا الملف، ويستخرج QR code لطباعته على ملف PDF، ويتحقق من الإمضاءات التي يتضمنها: لكل منها، فترة صلاحية الشهادة، وسلسلة الثقة الخاصة بها، وعدم إلغائها (عبر OCSP، مع اللجوء إلى قائمة الشهادات الملغاة عند الحاجة)، والسلامة التشفيرية. ويُحفظ تقرير التحقق مع الفاتورة.

PDF أم XML: أيهما المعتمد؟

ملف XML. يعرّف الفصل 18 من مجلة الأداء على القيمة المضافة الفاتورة الإلكترونية بأنها وثيقة تتضمن التنصيصات الوجوبية، وتحمل الإمضاء الإلكتروني للمصدر، ومسجلة لدى TTN، وتحمل المرجع الوحيد الذي تسنده TTN. ولا يجمع هذه الشروط الأربعة سوى ملف TEIF المصادق عليه. أما ملف PDF، حتى وإن كان ممضى، فليس فاتورة إلكترونية.

ويبقى ملف PDF النسخة المقروءة التي تُرسل إلى الحريف أو تُطبع. وتسمح مجلة الأداء على القيمة المضافة بنسخة ورقية من الفاتورة الإلكترونية إذا حملت مرجع التسجيل لدى TTN؛ ويعرض مثال TTN عبارة «نسخة من الفاتورة الإلكترونية المسجلة لدى TTN تحت المرجع: …». ويطبع Clic2Up مرجع TTN وQR code على ملف PDF لكل فاتورة مصادق عليها.

أما التنصيصات الدقيقة للنسخة الورقية، كما حددتها المذكرة العامة عدد 2 لسنة 2026، فتجدها في دليل El Fatoora 2026.

كم من الوقت يُحفظ ملف XML، وأين؟

عشر سنوات، مثل كل فاتورة: يفرض الفصل 62 من مجلة الضريبة على دخل الأشخاص الطبيعيين والضريبة على الشركات حفظ الوثائق المحاسبية لمدة عشر سنوات. وتسجل TTN الفواتير الإلكترونية وتحفظها، ويمكنها أن تسلم نسخة منها حسب جدول تعريفاتها. ويبقى من الحكمة الاحتفاظ بنسختك الخاصة.

احتفظ بالملف النهائي الذي ترجعه TTN، أي الملف الذي يحمل RefTtnVal وإمضاءات TTN، لا بالملف الممضى الذي أودعته وحده ولا بملف PDF. وفي Clic2Up، يُحفظ ملف XML الممضى المودع وملف XML النهائي المصادق عليه مع كل فاتورة، ويوفر التحميل ملف XML النهائي بمجرد توفره.

هل يجب أن تكتب ملف XML بصيغة TEIF بنفسك؟

لا. يولّد برنامج الفوترة المرتبط بـ El Fatoora الملف انطلاقًا من الفاتورة التي تُدخلها بشكل عادي: تختار حريفًا وتضيف أسطرًا ونسبًا، فيبني البرنامج ملف XML ويمضيه ويودعه. أما المؤسسات التي تطوّر ربطها الخاص، فتجد في ملف TTN الدليل ومخططات XSD ومثالًا ممضى ووصف خدمات الواب الخاصة بالإيداع والاستفسار.

يولّد Clic2Up صيغة TEIF لكل فاتورة وإشعار دائن ومذكرة أتعاب، ويمضيها بـ Digigo أو ID-Trust أو Mobile ID، ثم يودعها لدى TTN. وهو مجاني إلى غاية 31 ديسمبر 2026، مع جميع الوظائف ودون بطاقة بنكية؛ وبعد ذلك بداية من 9 دنانير دون احتساب الأداء شهريًا (اطلع على الأسعار). وتجد خطوات البدء في صفحة الفاتورة الإلكترونية، ويمكنك إنشاء حساب الآن.

أسئلة شائعة حول صيغة TEIF

المصادر

• شبكة تونس للتجارة (Tunisie TradeNet): ملف المواصفات التقنية لـ El Fatoora (دليل تطبيق رسالة TEIF النسخة 2.0 بتاريخ 20 أكتوبر 2021، مخططات XSD 1.8.8 و1.8.9، مثال فاتورة ممضاة، مواصفات خدمات الواب) — ملف ZIP، بالفرنسية
• شبكة تونس للتجارة (Tunisie TradeNet): المواصفات التقنية للإمضاء الإلكتروني للمزوّد، النسخة 3.0 بتاريخ 29 ماي 2026 — بالفرنسية
• شبكة تونس للتجارة (Tunisie TradeNet): سياسة الإمضاء الإلكتروني — بالفرنسية
• شبكة تونس للتجارة (Tunisie TradeNet): صفحة El Fatoora
• مجلة الأداء على القيمة المضافة، طبعة محيّنة إلى غرة جانفي 2026 (الفصل 18، الفقرة II ثالثا: الفاتورة الإلكترونية والنسخة الورقية) — jibaya.tn، بوابة الإدارة الجبائية
• مجلة الضريبة على دخل الأشخاص الطبيعيين والضريبة على الشركات 2026 (الفصل 62، الفقرة IV: الحفظ لمدة عشر سنوات)
• المذكرة العامة عدد 2 لسنة 2026: توسيع الفاتورة الإلكترونية إلى عمليات إسداء الخدمات، وتنصيصات النسخة الورقية