وارد TEIF تونس
تحليل فواتير المورّدين الإلكترونية الموقَّعة بصيغة TEIF إلى فواتير مورّدين — التحقق من توقيع XAdES، فحص المعرّف الجبائي، إعادة احتساب ضريبة المدخلات
ماذا يفعل هذا الموديول
عندما يصدر لك مورّد تونسي فاتورةً على منصة الفاتورة الإلكترونية التي تشغّلها الشركة التونسية للتجارة الإلكترونية (TTN)، تتلقّى مستند XML موقَّعاً بالمخطّط الخاص الفاتورة الإلكترونية التونسية (TEIF). يقرأ هذا الموديول مستند TEIF XML المستلَم، ويتحقق من توقيعه الإلكتروني المضمَّن، ويعيد احتساب الضريبة بالمعدلات التونسية المنشورة، ويحوّله إلى فاتورة مورّد نظيفة في أودو — بحيث يستند خصم ضريبة المدخلات لديك (الأداء القابل للطرح) إلى مستند مُتحقَّق منه ومُطابَق.
الموديول محلّل ومتحقّق وارد فقط: يقرأ ويفحص مستندات تلقّيتها بالفعل ولا يرسل أي شيء. لا ينتحل صفة TTN أو المُصدِر أو أي جهاز معتمد — بل يتحقق ببساطة من المستند الذي أرسله المورّد.
محلّل TEIF XML
محلّل lxml حقيقي يقرأ مستند TTN TEIF
<TEIF>: نوع المستند Bgm، وتاريخي الإصدار
والاستحقاق Dtm، وبائع ومشتري PartnerSection (مع
معرّفهما الجبائي)، وكل بند Lin، وتفصيل الضريبة لكل معدل
InvoiceTax، والإجماليات النقدية InvoiceMoa، ومرجع
TTN RefTtnVal.
التحقق من توقيع XAdES / XMLDSig
تحمل كل فاتورة TEIF توقيعاً رقمياً XML من W3C (ds:Signature،
XAdES-B) منتَجاً بالخوارزمية المعتمدة RSA-SHA256. يتحقق الموديول من
اكتمال التوقيع بنيوياً (SignedInfo، SignatureMethod، المراجع الموقَّعة مع
البصمات، SignatureValue، شهادة X.509 المضمَّنة) — وعند توفّر مكتبة
cryptography — يتحقق تشفيرياً من SignatureValue مقابل تلك
الشهادة، مستخرجاً موضوعها ومُصدِرها ورقمها التسلسلي وصلاحيتها.
فحص المعرّف الجبائي
يُتحقَّق من المعرّف الجبائي التونسي بخوارزمية حرف التحقق المنشورة الفعلية (7 أرقام موزونة 7..1، مودولو 23 على الأبجدية ذات الـ23 حرفاً) إضافةً إلى رموز نظام الأداء والفئة والمؤسسة. يُقرأ معرّف المورّد من المستند ويُنشَر على سجل الشريك.
إعادة احتساب ومطابقة ضريبة المدخلات
تُعاد احتساب ضريبة كل بند بالمعدلات التونسية المنشورة وتُشتقّ ضريبة المدخلات
القابلة للاسترداد من الشرائح القابلة للطرح — لا تُؤخذ على الثقة من
المورّد. تُدقَّق إجماليات InvoiceMoa المصرَّح بها ومجاميع
InvoiceTax لكل معدل بشكل متقاطع مقابل الأرقام المُعاد احتسابها
بحيث يُلتقَط المستند غير المتطابق قبل قيده.
معدلات الضريبة التونسية المنشورة (TVA)
| الشريحة | المعدل | ضريبة المدخلات |
|---|---|---|
| قياسي | 19% | قابلة للطرح |
| متوسط | 13% | قابلة للطرح |
| مخفّض | 7% | قابلة للطرح |
| نسبة صفر / توقيف | 0% | لا ضريبة مدخلات قابلة للطرح |
أبرز الميزات
- معالج الرفع — أسقِط TEIF XML للمورّد، عاين الإجماليات المُعاد احتسابها وتقرير التوقيع ونتيجة التحقق، ثم أنشئ مسودة فاتورة مورّد بنقرة واحدة.
- تبويب TEIF على الفاتورة — أرفق XML الموقَّع بفاتورة مورّد وحلّل وتحقّق واستورد البنود مباشرةً من رأس النموذج.
- سجل التحقق — يُسجَّل كل خطأ حاجب وتحذير (مرجع TTN مفقود، توقيع مكسور، معرّف غير صحيح، معدل ضريبة غير قانوني، إجماليات لا تتسوّى) مع طابع زمني.
- حارس القيد — حجب قيد فاتورة مورّد فشل مستند TEIF المرفق بها في التحقق اختيارياً، واشتراط توقيع صحيح اختيارياً.
- مهمة التحقق المعلّقة — إجراء مجدول اختياري معطَّل افتراضياً يعيد التحقق من الفواتير المُعلَّمة "للتحليل".
- حالة قابلة للبحث — صفّ وجمّع فواتير المورّدين حسب حالة TEIF وعلامة التوقيع من شاشة بحث الفواتير.
النطاق والإفصاح
هذا محلّل TEIF وارد ومتحقّق توقيع خالص. لا يتصل بـ TTN، ولا يرسل أو يسجّل فواتير، ولا يعمل كمنصة فوترة إلكترونية معتمدة. يبقى تثبيت ثقة سلسلة الشهادات (تحديد السلطة المُصدِرة التي تثق بها) قرار سياسة البنية التحتية للمفاتيح العامة (PKI) لديك؛ يتحقق الموديول من أن المستند يحمل توقيعاً كاملاً صحيح الخوارزمية تتطابق قيمته مع الشهادة المرفقة به. مبني لأودو 18 و19، قاعدة مجتمعية فقط — بلا اعتماد على المؤسسي.
English
Tunisia TEIF Inbound
When a Tunisian supplier issues you an invoice on the El-Fatoora platform operated by Tunisie TradeNet (TTN), you receive a signed XML document in the TEIF schema. This module reads the received TEIF XML, validates its embedded electronic signature, recomputes VAT at the published Tunisian rates, and turns it into a clean Odoo vendor bill. It is an inbound parser and validator only and never transmits anything.
Parsing & XAdES validation
A real lxml parser reads the TEIF document (Bgm, Dtm, PartnerSection, Lin, InvoiceTax, InvoiceMoa, RefTtnVal). Checks the W3C XML signature (XAdES-B, RSA-SHA256) is structurally complete and, when the cryptography library is present, cryptographically verifies it against the embedded X.509 certificate.
Matricule check & input-VAT
Validates the matricule fiscal with its published control-letter algorithm. Recomputes every line's VAT at the published Tunisian rates (19/13/7/0%) and cross-checks the declared totals, catching mismatches before posting. Upload wizard, on-bill tab, validation log, posting guard. Odoo 18 and 19, Community only.
Screenshots
Import Teif Invoice
Update date: 2026-07-02