Factur-Xray
Prérequis
- Système : Microsoft Windows.
- Microsoft Excel, version de bureau : Factur-Xray pilote Excel pour ouvrir les exemples, suivre la cellule active et lire les valeurs. Excel en ligne ne convient pas.
- Aucune connexion Internet ni aucun compte n'est nécessaire.
Installation
- Téléchargez l'archive de la dernière version sur la page des versions GitHub.
- Décompressez-la dans le dossier de votre choix (par exemple
Documents\Factur-Xray). Le dossier contient l'exécutable, le répertoireexemples(index et classeurs), le répertoirefacturesoù seront écrites les factures générées, ainsi que les fichiers de licence. - Lancez l'exécutable. Aucune installation n'est requise ; Windows peut afficher un avertissement lors du premier lancement d'une application téléchargée.
L'interface
Factur-Xray se présente comme une petite fenêtre placée dans le coin inférieur droit de l'écran, qui reste à côté d'Excel :
| Commande | Rôle |
|---|---|
| Ouvrir | Ouvre le classeur d'index ou l'une des neuf familles d'exemples |
| Aide | Ouvre la documentation en ligne |
| Générer la facture | Produit le Factur-X et le XML de l'onglet actif |
| Rayons X (BT et XML) | Ouvre le panneau qui décrit la cellule sélectionnée |
Une zone de messages, sous les boutons, indique le résultat des opérations. À la fermeture, Factur-Xray demande confirmation car les classeurs d'exemples ouverts sont fermés sans enregistrement.
Utilisation pas à pas
- Ouvrir un classeur. Choisissez l'index pour une vue d'ensemble, ou directement une famille. Le classeur s'ouvre en lecture seule : vous pouvez modifier des valeurs pour expérimenter, les fichiers d'origine ne sont jamais écrasés.
- Choisir un cas. Chaque onglet Excel correspond à un cas ; son nom reprend le numéro et l'intitulé du cas.
- Passer aux rayons X. Ouvrez le panneau et cliquez dans la facture : le panneau suit la cellule active (voir ci-dessous).
- Générer la facture. Le bouton produit le Factur-X de l'onglet actif, puis l'ouvre dans votre lecteur PDF.
- Contrôler. Ouvrez la facture générée dans Fchecker pour la valider.
Lire un onglet d'exemple
Chaque onglet comporte deux zones.
La facture
La zone imprimable présente la facture telle qu'un client la recevrait : blocs d'en-tête (vendeur, acheteur, références, livraison, paiement), tableau des lignes, récapitulatif de TVA, totaux et notes. Les montants sont calculés par des formules Excel : modifier une quantité ou un prix met à jour toute la facture.
Les données hors impression
À droite de la facture, hors de la zone imprimée, figurent :
- les données présentes dans le XML mais pas sur le papier : l'identifiant de spécification (BT-24), les adresses électroniques du vendeur (BT-34) et de l'acheteur (BT-49) ;
- la fiche du cas : descriptif, type de document, cadre de facturation, référence du cas d'usage, profil et points d'attention avec les règles concernées (par exemple BR-FR-05 pour les notes obligatoires).
Les conventions
- Chaque cellule de donnée est une cellule nommée d'après son BT : la cellule du numéro
de facture s'appelle
BT_1, celle du nom du vendeurBT_27. Le nom apparaît dans la zone Nom d'Excel. - Chaque en-tête de colonne des tableaux se termine par l'identifiant de la donnée, par exemple « Quantité (BT-129) ».
- Le XML reprend les valeurs telles qu'elles sont affichées, sans aucun recalcul : une erreur saisie dans Excel se retrouve dans la facture électronique.
Le panneau Rayons X
Le panneau « Rayons X — le BT derrière la cellule » reste au premier plan et se met à jour lorsque vous changez de cellule. Pour la cellule active, il affiche :
- l'identifiant de la donnée (BT ou BG) et son libellé ;
- son bloc, le profil minimal qui la contient et le nom de la cellule ;
- un aperçu de la balise CII avec la valeur courante ;
- le chemin XML de la balise ;
- le commentaire propre au cas lorsque la donnée joue un rôle particulier dans l'exemple étudié.
Sur une cellule de la fiche du cas, le panneau affiche le titre, les codes et le profil du cas.
L'interrupteur « Colorer les données par bloc et ajouter une note au survol » attribue une couleur à chaque bloc de données (la légende apparaît dans le panneau) et pose sur chaque cellule une note visible au survol. Désactivez-le pour retrouver l'aspect d'origine.
Excel est occupé ?
Pendant une saisie dans une cellule, Excel n'accepte pas d'être piloté. Validez ou annulez la saisie en cours, puis réessayez.
Générer un Factur-X
Le bouton Générer la facture lit l'onglet actif et produit deux fichiers :
factures\<classeur>\<onglet>.pdf Factur-X : PDF/A-3 avec le XML CII intégré
factures\<classeur>\<onglet>.xml le XML CII seul
Le profil est déterminé automatiquement :
- EN 16931 lorsque seules des données de la norme européenne sont renseignées
(identifiant
urn:cen.eu:en16931:2017) ; - EXTENDED dès qu'une donnée étendue ou une extension française est renseignée
(identifiant
urn:cen.eu:en16931:2017#conformant#urn:factur-x.eu:1p0:extended).
Le PDF reçoit un profil colorimétrique sRGB et des métadonnées XMP cohérentes avec le XML, conformément aux exigences PDF/A-3 et Factur-X.
Aucune validation à la génération
Factur-Xray génère la facture correspondant à ce qui est saisi, même si ce contenu est incorrect. C'est voulu : on peut ainsi introduire une erreur et observer sa détection. Pour contrôler une facture, ouvrez-la dans Fchecker.
Catalogue des 50 cas
Le type de document correspond au code BT-3, le cadre de facturation à la nature de l'opération et au traitement du paiement (B pour les biens, S pour les services, M pour les opérations mixtes). Le cas 30 comporte deux documents (30a et 30b).
| N° | Cas | Type | Cadre | Profil |
|---|---|---|---|---|
| A. Factures de base | ||||
| 01 | Facture de vente de biens | 380 | B1 | EN 16931 |
| 02 | Facture de prestation de services, TVA à l'encaissement | 380 | S1 | EN 16931 |
| 03 | Facture de prestation de services, option TVA sur les débits | 380 | S1 | EN 16931 |
| 04 | Facture mixte biens et services | 380 | M1 | EN 16931 |
| 05 | Facture déjà payée à l'émission | 380 | B2 | EN 16931 |
| 06 | Facture multi-commandes, multi-livraisons | 380 | B1 | EXTENDED |
| 07 | Facture périodique ou d'abonnement | 380 | S1 | EN 16931 |
| B. Acomptes | ||||
| 08 | Facture d'acompte | 386 | S1 | EN 16931 |
| 09 | Facture d'acompte déjà encaissé | 386 | S2 | EN 16931 |
| 10 | Facture définitive après acompte | 380 | S4 | EN 16931 |
| 11 | Avoir sur facture d'acompte | 503 | S1 | EN 16931 |
| C. Corrections : rectificatives, avoirs, notes de débit | ||||
| 12 | Facture rectificative | 384 | B1 | EN 16931 |
| 13 | Avoir d'annulation totale | 381 | B1 | EN 16931 |
| 14 | Avoir partiel (rabais, retour) | 381 | B1 | EN 16931 |
| 15 | Avoir de remise globale (RFA) | 262 | B1 | EN 16931 |
| 16 | Avoir net de taxe | 381 | B1 | EN 16931 |
| 17 | Note de débit | 380 | S1 | EN 16931 |
| D. Affacturage | ||||
| 18 | Facture affacturée | 393 | B1 | EN 16931 |
| 19 | Avoir affacturé | 396 | B1 | EN 16931 |
| 20 | Facture rectificative affacturée | 472 | B1 | EN 16931 |
| 21 | Affacturage décidé après émission | 380 | B1 | EN 16931 |
| E. Mandat de facturation et autofacturation | ||||
| 22 | Facture émise sous mandat (pour ordre et pour compte) | 380 | B1 | EXTENDED |
| 23 | Autofacture | 389 | B1 | EN 16931 |
| 24 | Autofacture d'acompte | 500 | S1 | EN 16931 |
| 25 | Avoir autofacturé | 261 | B1 | EN 16931 |
| 26 | Autofacture rectificative | 471 | B1 | EN 16931 |
| 27 | Autofacture affacturée | 501 | B1 | EN 16931 |
| 28 | Autofacturation avec un particulier | 389 | B1 | EN 16931 |
| 29 | Autofacture bidirectionnelle | 389 | S9 | EXTENDED |
| 30 | Autofacture compensée avec une facture croisée | 389 | B1 | EN 16931 / EXTENDED |
| F. Tiers payeurs et intermédiaires | ||||
| 31 | Facture payée par un tiers payeur | 380 | S1 | EXTENDED |
| 32 | Facture prise en charge partiellement par un tiers | 380 | S1 | EXTENDED |
| 33 | Facture à payer à un tiers bénéficiaire | 380 | B1 | EN 16931 |
| 34 | Facture reçue par un tiers pour le compte de l'acheteur | 380 | B1 | EXTENDED |
| 35 | Facture avec débours | 380 | S1 | EN 16931 |
| 36 | Facture marketplace sous mandat | 380 | B1 | EXTENDED |
| G. BTP, sous-traitance, cotraitance | ||||
| 37 | Facture de sous-traitant en autoliquidation | 380 | S1 | EN 16931 |
| 38 | Facture de sous-traitant avec paiement direct | 380 | S5 | EXTENDED |
| 39 | Facture du titulaire après paiement direct | 380 | S1 | EN 16931 |
| 40 | Facture de cotraitant | 380 | S6 | EXTENDED |
| 41 | Demande de paiement de sous-traitance (B2G) | 380 | S3 | EXTENDED |
| H. TVA et régimes particuliers | ||||
| 42 | Facture avec escompte pour paiement anticipé | 380 | S1 | EN 16931 |
| 43 | Facture exonérée de TVA | 380 | S1 | EN 16931 |
| 44 | Facture en franchise en base de TVA | 380 | S1 | EN 16931 |
| 45 | Facture sous régime de TVA sur la marge | 380 | B1 | EN 16931 |
| 46 | Facture d'un membre d'assujetti unique | 380 | B1 | EN 16931 |
| 47 | Facture en devise étrangère | 380 | B1 | EN 16931 |
| 48 | Facture après ticket déjà déclaré en B2C | 380 | S7 | EN 16931 |
| I. Structure de facture avancée | ||||
| 49 | Facture avec sous-lignes | 380 | B1 | EXTENDED |
| 50 | Facture multi-vendeurs | 380 | S8 | EXTENDED |
Limites connues
- Factur-Xray ne valide pas les factures qu'il génère (voir Générer un Factur-X).
- Le codage du cas 28 (autofacturation avec un particulier, sans SIREN) reste à confirmer : la facture générée ne passe pas tous les contrôles.
- L'application nécessite Windows et Excel de bureau.
Travailler à partir des sources
Le code source est publié sur GitHub. Il nécessite Python 3.13 :
python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt
python main.py
Les tests, qui ne nécessitent pas Excel, vérifient le catalogue des données, le rendu et la validité XSD des factures à partir d'instantanés des exemples :
pytest generation/tests xray/tests
Les exemples sont décrits dans des fichiers YAML (un fichier par famille, limité à ce qui distingue chaque cas, plus un fichier commun pour les parties fictives) et les classeurs Excel en sont générés. Le README du dépôt détaille la procédure de régénération et de compilation de l'exécutable.
Licence
Factur-Xray est distribué sous licence Apache 2.0 par Siadeo. Il s'appuie sur des composants open source tiers, dont la liste et les licences sont fournies avec l'application. Toutes les données des exemples (entreprises, SIREN, numéros de TVA, IBAN) sont fictives ; les identifiants ont des clés de contrôle valides pour passer les vérifications de format.