Principes de développement Factur-X

Owned by Bertrand Littel
Last updated: 28/03/2023
3 min read

Principes généraux Factur-X

Pour la mise en oeuvre de la norme Factur-X, la plateforme Harmony intègre une bibliothèque intermédiaire (DLL) fournie par l'équipe de développement de la norme dans le runtime Harmony, afin d'être au plus proche de la norme, mais en rendant l’utilisation transparente pour le développeur.

 

Les éléments de développement qui entrent dans la mise en oeuvre sont les suivants :

  • Deux modules DIVA

    • YFACTUR.DHOP

      • Fait l’interface avec la DLL

      • Permet de rendre transparent l’usage de cette bibliothèque de lecture/écriture XML dédiée au format Factur-X (lecture xml, écriture xml, gestion d’erreur, lecture/écriture des propriétés)

    • YMETADATAOPEN.DHOP

      • Fait l’intermédiaire entre le fichier PDF et un fichier XML (temporaire) en procédant à l’extraction de la zone XML incluse dans le fichier PDF

  • Les traitement/objet DIVA

    • doit indiquer les meta-données qui vont entrer dans le fichier XML

    • doit indiquer des propriétés spécifiques à Factur-X

    • utilise les deux modules précédents

  • Le fichier d’impression harview (.DHVW)

    • C’est le fichier classique issu d’une impression graphique

    • Il doit être construit de manière classique, et deviendra la partie PDF de la factur-x

  • Le fichier XML (.XML)

    • C’est le fichier temporaire qui est généré par le traitement Diva

    • Il comporte les données au format de la norme Factur-X grâce à l’utilisation des 2 modules Diva

  • Le fichier PDF Factur-X final (.PDF)

    • C’est le fichier final, qui comporte donc

      • la partie visuelle du PDF dédiée à un utilisateur

      • la partie XML de métadonnées, sous forme de flux XML intégré à l’intérieur du fichier PDF

 

Exemple de contenu de fichier XML selon la norme Factur-X

Exemple de fichier PDF Factur-X

 

Principe pour générer un PDF Factur-X

Les éléments techniques suivent plusieurs étapes:

  1. Fabrication de la facture par impression/génération d’une impression (de manière classique, aucun changement dans le mode d'édition)

  2. Création d’un fichier XML contenant les données. Le format respecte la norme Factur-x par l’utilisation des modules dédiés. Le fichier est temporaire et sert d’entrée à l'étape suivante

  3. Assemblage de l’impression et du fichier XML pour intégrer le flux XML dans un fichier unique

  4. Conversion en PDF pour l’obtention du fichier final Factur-X

 

Principe pour lire un PDF Factur-X

Les éléments techniques suivent plusieurs étapes:

  1. Lecture du fichier PDF Factur-X

  2. Extraction de la zone du flux XML dans un fichier temporaire XML

  3. Lecture des propriétés Factur-X dans le fichier PDF et lecture des données XML dans le fichier XML temporaire