Skip to Content

Tunisia TEIF Inbound

by
Odoo

$ 58.23

v 18.0 Third Party
Live Preview
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Discuss (mail)
• Invoicing (account)
Lines of code 1493
Technical Name l10n_tn_teif_inbound
LicenseOPL-1
Websitehttps://gencbaris.com/odoo_plugins/
Versions 18.0 19.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Discuss (mail)
• Invoicing (account)
Lines of code 1493
Technical Name l10n_tn_teif_inbound
LicenseOPL-1
Websitehttps://gencbaris.com/odoo_plugins/
Versions 18.0 19.0

وارد 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

Import Teif Invoice

Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.