teif-invoice-automation

• Fichiers Racine Importants
• Fichiers de Configuration

Convertisseur automatique de factures PDF vers le format TEIF (Tunisian Electronic Invoice Format) conforme aux standards TTN (Tunisie TradeNet) version 1.8.8.

Description

Ce projet Python extrait automatiquement les données de factures depuis des fichiers PDF et les convertit en format XML TEIF conforme au standard tunisien d'échange électronique de factures (version 1.8.8).

Fonctionnalités principales

• Extraction intelligente : Analyse avancée du contenu des PDFs pour extraire les données de facture
• Conformité TEIF 1.8.8 : Génère du XML strictement conforme au standard TTN
• Préservation des données : Utilise les montants et taxes exactement comme trouvés dans le PDF, sans recalcul
• Support multi-format : Fonctionne avec différents formats de factures PDF
• Architecture modulaire : Code organisé en modules clairs et maintenables
• Validation intégrée : Vérification de la conformité du XML généré
• Génération de signatures : Support pour les signatures XAdES (optionnel)

Structure TEIF XML

Le format TEIF (Tunisian Electronic Invoice Format) suit une structure XML spécifique. Voici un aperçu des éléments principaux :

Structure de Base

<TEIF>
  <Header>
    <DocumentType>INVOICE</DocumentType>
    <DocumentNumber>FACT-2023-001</DocumentNumber>
    <DocumentDate>2023-01-01</DocumentDate>
    <Currency>DINAR TUNISIEN</Currency>
    <CurrencyCode>TND</CurrencyCode>
  </Header>
  
  <Seller>
    <Name>NOM DU VENDEUR</Name>
    <TaxIdentifier>
      <ID>IDENTIFIANT FISCAL</ID>
      <Type>FISCAL_NUMBER</Type>
    </TaxIdentifier>
  </Seller>
  
  <Buyer>
    <Name>NOM DE L'ACHETEUR</Name>
    <TaxIdentifier>...</TaxIdentifier>
  </Buyer>
  
  <Invoice>
    <InvoiceHeader>...</InvoiceHeader>
    <InvoiceLines>
      <Line>
        <LineNumber>1</LineNumber>
        <Item>
          <Description>DESCRIPTION DE L'ARTICLE</Description>
          <Quantity>1.000</Quantity>
          <UnitPrice>100.000</UnitPrice>
        </Item>
        <Moa amountTypeCode="I-181" currencyCodeList="ISO_4217">
          <Amount currencyIdentifier="TND">100.000</Amount>
          <AmountDescription lang="FR">Montant hors taxes</AmountDescription>
        </Moa>
      </Line>
    </InvoiceLines>
    
    <InvoiceTotals>
      <Moa amountTypeCode="I-181" currencyCodeList="ISO_4217">
        <Amount currencyIdentifier="TND">100.000</Amount>
        <AmountDescription lang="FR">Total hors taxes</AmountDescription>
      </Moa>
      <Moa amountTypeCode="I-182" currencyCodeList="ISO_4217">
        <Amount currencyIdentifier="TND">19.000</Amount>
        <AmountDescription lang="FR">Total TVA</AmountDescription>
      </Moa>
      <Moa amountTypeCode="I-183" currencyCodeList="ISO_4217">
        <Amount currencyIdentifier="TND">119.000</Amount>
        <AmountDescription lang="FR">Total TTC</AmountDescription>
      </Moa>
    </InvoiceTotals>
  </Invoice>
  
  <Signature>...</Signature>
</TEIF>

Points Importants

1. En-tête (Header)

   • Contient les informations de base du document
   • Inclut le type de document, numéro, date et devise

2. Vendeur et Acheteur

   • Sections dédiées pour les informations des parties
   • Inclut les identifiants fiscaux

3. Lignes de Facture

   • Chaque ligne contient un article ou service
   • Inclut la description, quantité, prix unitaire et montant HT

4. Totaux

   • Montant HT
   • Montant TVA
   • Montant TTC
   • Autres totaux spécifiques

5. Signature

   • Signature électronique XAdES
   • Optionnelle selon le cas d'utilisation

Attributs Spéciaux

• currencyCodeList="ISO_4217" : Obligatoire pour tous les éléments MOA
• amountTypeCode : Code indiquant le type de montant (ex: I-181 pour HT, I-182 pour TVA, etc.)
• currencyIdentifier : Code devise (TND pour Dinar Tunisien)

Pour plus de détails, consultez le fichier docs/TEIF_XML_Structure_Analysis.md.

Architecture du Projet

Vue d'ensemble

L'architecture du projet est conçue pour assurer une séparation claire des responsabilités et une facilité de maintenance. Le système intègre un flux de travail complet pour la conversion et la signature électronique de documents TEIF conformes aux standards Tunisie TradeNet.

Workflow Principal

Architecture Détaillée des Composants

Processus de Génération XML TEIF

Structure XML et Séquence des Étapes

Processus de Génération de Signature

Flux de Données et Validation

Légende des Diagrammes

• En rose : Point d'entrée principal (CLI)
• En bleu clair : Fichiers d'entrée/sortie
• En vert clair : Fichiers de configuration
• Boîtes blanches : Composants principaux

Fonctionnalités Clés

Signature Électronique XAdES-B

• SignedInfo : Contient la méthode de canonicalisation, la méthode de signature et les références du document
• SignatureValue : Signature RSA-SHA256 de l'élément SignedInfo
• KeyInfo : Informations du certificat X.509 pour la vérification de signature
• QualifyingProperties : Propriétés spécifiques XAdES incluant l'heure de signature et les détails du certificat

Conformité TEIF

• TTN Version 1.8.8 : Conformité complète avec les spécifications Tunisie TradeNet
• Structure XML : Structure de document TEIF correcte avec tous les éléments requis
• Validation : Validation multi-niveaux pour l'intégrité des données et la conformité du format
• Sécurité : Signatures XAdES-B pour l'authenticité et la non-répudiation des documents

Architecture Modulaire

• Extracteurs : Extraction et normalisation des données PDF
• Générateurs : Génération des sections XML TEIF
• Validateurs : Validation des données et de la structure XML
• Interface CLI : Outil en ligne de commande pour le traitement par lots

Implémentation Technique

Composants de la Section de Signature

• Gestion des namespaces : Gestion appropriée des namespaces XML pour les préfixes ds: et xades:
• Gestion des certificats : Chargement et validation des certificats X.509
• Calcul d'empreinte : Calcul de hash SHA-256 pour l'intégrité du document
• Canonicalisation : XML-EXC-C14N pour une représentation XML cohérente
• Transformations XPath : Filtrage et traitement des références de document

Architecture du Flux de Données

• Couche d'entrée : Fichiers PDF, configuration et certificats
• Couche de traitement : Extraction, normalisation et validation
• Couche de génération : Création de la structure XML TEIF
• Couche de sécurité : Application de la signature XAdES-B
• Couche de sortie : XML TEIF signé conforme aux standards TTN

Structure du Projet

TTN/
├── .github/
│   └── workflows/
│       └── main.yml
├── certs/
│   ├── ca.crt
│   ├── ca.key
│   ├── server.crt
│   └── server.key
├── docs/
│   ├── TEIF_XML_Structure_Analysis.md
│   ├── teif_xml_structure_example.xml
│   └── XADES_SIGNATURE.md
├── examples/
│   └── sign_teif_invoice.py
├── extracted_data/
├── legacy/
│   ├── README.md
│   ├── transform_invoice.py
│   └── transform_invoice_simple.py
├── output/
│   └── complete_invoice.xml
├── public/
│   └── teif-invoices/
├── scripts/
│   └── generate_test_cert.py
├── src/
│   ├── cli/
│   │   ├── __init__.py
│   │   └── main.py
│   ├── extractors/
│   │   ├── __init__.py
│   │   └── ...
│   └── teif/
│       ├── sections/
│       │   ├── __init__.py
│       │   ├── amounts.py
│       │   ├── common.py
│       │   ├── header.py
│       │   ├── lines.py
│       │   ├── partner.py
│       │   ├── payment.py
│       │   ├── references.py
│       │   ├── signature.py
│       │   └── taxes.py
│       ├── utils/
│       │   └── __init__.py
│       ├── __init__.py
│       └── generator.py
├── tests/
│   ├── test_data/
│   ├── test_output/
│   ├── conftest.py
│   ├── test_signature.py
│   └── test_*.py
├── .gitignore
├── .pytest_cache/
├── .vscode/
├── .venv/
├── .idea/
├── main.py
├── requirements.txt
├── setup.py
├── openssl.cnf
└── debug_extraction.py

Fichiers Racine Importants

• main.py : Point d'entrée principal de l'application
• requirements.txt : Dépendances du projet
• setup.py : Configuration du package Python
• openssl.cnf : Configura

INM5151

Dépôt contenant notre travail de session codé en Python, avec le framework Flask et la base de données SQLAlchemy, lors du cours INM5151 passé à la session d'été de l'année 2021 à l'UQAM. Ce projet a été fait avec Willy Tim et Thuc-Ann Truong.