Bienvenue dans FE Factory by Kaora

« Je veux valider un XML existant »

1. Ouvrez l'onglet Validation XML (ou Accueil → « Charger un XML existant »).
2. Glissez votre XML sur la zone ou cliquez pour parcourir.
3. Lisez le Verdict de conformité en haut : Conforme (✓ vert, aucun bloquant) / Valide avec réserves (⚠ orange, recommandations à examiner) / Non conforme bloquant (✗ rouge, à corriger avant émission). La facture est lisible à droite en mode Lisible.
4. Sous le verdict, le bloc Triage 5 cellules (OK / Non déclenchées / Bloquant / Recommandé / Bonne pratique) compte les règles uniques distinctes, dédoublonnées cross-couche.
5. À gauche, parcourez le détail par couche : XSD → CEN → BR-FR → EXTENDED → Socle CGI.
6. Corrigez les bloquants en priorité, puis idéalement les recommandations — ou utilisez le module Auto-fix décrit ci-dessous.

« Je veux corriger automatiquement les erreurs de mon XML »

1. Après validation, si des erreurs corrigeables sont détectées, le module Auto-fix apparaît sous le résumé.
2. La liste des correctifs applicables s'affiche avec le nombre d'occurrences détectées par fixer (jusqu'à 23 disponibles : namespaces UBL, ordre des éléments, formats décimaux/dates, attributs obligatoires, mentions légales socle CGI…).
3. Décochez les corrections que vous ne souhaitez pas appliquer ; cochez « Inclure les commentaires explicatifs » pour tracer chaque modification dans le XML.
4. Cliquez sur Appliquer & télécharger : le XML corrigé est téléchargé avec le suffixe _KaoraFix.xml.
5. Re-validez le fichier corrigé pour vérifier le delta. La couverture XSD atteint 94 % (28 règles sur 30) — les cas non auto-corrigeables sont signalés explicitement.

« Je veux tester un cas d'usage AFNOR »

1. Ouvrez l'onglet Générateur, mode « Preset ».
2. Dépliez l'une des 5 catégories (Commerciales, Cycle, Corrections, TVA, Tiers).
3. Cliquez sur le preset souhaité — son détail s'affiche dans le panneau droit.
4. Surchargez éventuellement le vendeur / acheteur dans le panneau de détail.
5. Cliquez sur « Générer & Valider » : le XML est généré, validé, et l'onglet Validation s'ouvre automatiquement.

« Je veux créer une facture maison sur mesure » (Composeur libre)

1. Dans le Générateur, sélectionnez « Composeur libre ».
2. Cochez vos options dans les 8 axes, dans l'ordre logique : A Type, B Régime TVA, D Tiers, E Modalités, C Parties (vendeur / acheteur), H Référence BdC, F Lignes, G Remise / frais.
3. Les cartes incompatibles sont automatiquement grisées et des bannières contextuelles expliquent les effets (profil EXTENDED forcé, BT-3 swappé…).
4. Pour certains types (ACOMPTE, SOLDE, AVOIR, RECTIFICATIVE), des cartes complémentaires apparaissent (ratio acompte, mode solde, référence BG-3).
5. Axe H — Référence Bon de commande : 4 modes au choix dans la liste déroulante :
   • Aucune : pas de BT-13 dans le XML.
   • Générer automatiquement : numéro plausible BC-{vendeur}-{YYYY}-Q{trimestre}-{rand}.
   • Saisir manuellement : champ libre pour taper votre propre référence.
   • Choisir dans Mes commandes : sélecteur des commandes enregistrées dans Référentiels → Mes commandes. Si la commande est rattachée à une entité, le vendeur (Axe C) est automatiquement verrouillé sur cette entité (fond jaune, bandeau d'info — désélectionnez la commande pour reprendre la main). Si la commande a un montant HT renseigné, un rappel vert s'affiche pour vous aider à composer des lignes en cohérence.
6. Cliquez sur « Générer & Valider ».

« Je veux gérer mes entités et mes commandes » (Référentiels)

1. Ouvrez l'onglet Référentiels (anciennement « Mes entités »).
2. Sous-onglet « Mes entités » :
   • Saisie manuelle : seuls la dénomination et le SIREN sont obligatoires. Le reste (SIRET, TVA, IBAN, mention légale, adresse, contact) est généré automatiquement par défaut, avec possibilité de basculer chaque champ en mode manuel (icône crayon).
   • Import CSV : téléchargez le template (17 colonnes, 2 exemples — minimal et complet), complétez vos entités en n'ayant à remplir que SIREN et dénomination si besoin, puis importez. Les colonnes vides sont auto-générées par le validateur.
   • Export CSV : sauvegarde de toutes vos entités au format point-virgule UTF-8 (compatible Excel FR).
   • Recherche en haut de la liste : filtre temps réel par SIREN, dénomination ou trigramme.
   • Sélecteur d'entité filtrable : dans tous les modules de génération (preset, composer libre, batch, commandes, anomalies), le sélecteur d'entité supporte la recherche live (tape un trigramme ou une dénomination pour filtrer la liste, navigation clavier ↑↓ Enter Esc).
3. Sous-onglet « Mes commandes » :
   • Saisie manuelle : seul le numéro de commande est obligatoire. Description, montant HT et entité vendeur rattachée sont optionnels.
   • Le rattachement à une entité (sélecteur peuplé depuis Mes entités) permet l'auto-sélection du vendeur dans le composeur libre (et son verrouillage tant que la commande est sélectionnée).
   • Le montant HT optionnel s'affiche dans la liste et sert d'aide à la cohérence dans le composeur libre (rappel visuel vert quand la commande est sélectionnée).
   • Import CSV : template avec 4 colonnes — Numero;Description;MontantHT;SirenEntiteLiee. Le rattachement à une entité se fait via le SIREN (pas le trigramme), pour cohérence avec le template entités.
   • Recherche : par numéro de commande, description ou trigramme d'entité rattachée.
4. Toute modification de référentiel est immédiatement répercutée dans le composeur libre (sélecteurs vendeur / acheteur / commande mis à jour à chaque ouverture du composer).

💡 Cas d'usage typique : import en masse de votre référentiel d'entités fournisseurs (depuis votre SI achats) via CSV, puis import des bons de commande ouverts. Lors de la génération d'une facture de test pour un fournisseur donné, sélectionnez son BdC dans le composer libre → vendeur et montant HT sont auto-rappelés, vous gagnez sur la saisie et limitez les incohérences.

« Admin uniquement » — Auditer le Générateur (Admin → Audit preset)

1. Ouvrez l'onglet Admin (en haut à droite), sous-onglet Audit preset.
2. Choisissez le nombre de variantes par preset (1-50, défaut 10). L'audit lance ce nombre de générations randomisées pour chacun des 33 presets, soit 330 validations par défaut.
3. Cliquez sur « Lancer l'audit ». La progression est affichée en temps réel (preset courant, % avancement, compteurs Conforme / Réserves / Non conforme / Erreur).
4. À la fin (~30 s à 2 min selon le N choisi), un tableau par preset apparaît : Total, ✓ Conformes, ⚠ Réserves, ✗ Non conformes, Erreurs, et un libellé Statut (« Robuste », « Avertissements », « Régression bloquante »).
5. Cliquez sur une ligne de preset en problème pour déplier le détail : variante en échec, règles déclenchées, et bouton Télécharger XML pour reproduire le cas à part.
6. Cliquez sur « Rapport CSV » en haut à droite pour exporter le bilan complet (compatible Excel FR).

Cas d'usage : qualifier le Générateur après modification d'un preset, d'un fixer ou du randomizer. Pour la mise en service de nouvelles entités. Pour détecter qu'une combinaison aléatoire spécifique produit une erreur (ex. multi-TVA + escompte + sous-traitance qui casse une mention légale).

« Admin uniquement » — Auditer le Composeur libre (Admin → Audit composeur libre)

1. Ouvrez l'onglet Admin (en haut à droite), sous-onglet Audit composeur libre.
2. Choisissez le mode d'audit :
   • Matrice (par défaut) — teste systématiquement toutes les paires d'options des 4 axes (Type × Régime × Tiers × Modalités) + exclusions mutuelles intra-axes (~258 paires).
   • Combinatoire — tire N (10-500) combinaisons aléatoires valides (3-4 axes activés simultanément) pour débusquer les bugs d'interaction multi-axes.
3. Cliquez sur « Lancer l'audit composer ». Suivez la progression avec les 5 compteurs : Conforme / Réserves / Non conf. / Skip (paires marquées incompatibles par la matrice) / Erreur.
4. À la fin (~30 s à 1 min), le tableau des combinaisons problématiques uniquement s'affiche (les conformes ne polluent pas la vue). Pour chaque : la combinaison testée + les règles déclenchées + bouton XML pour télécharger le cas reproductible.
5. Cliquez sur « Rapport CSV » pour exporter le bilan complet (avec colonne Compat_matrice indiquant si la paire était attendue compatible ou non).

Cas d'usage : qualifier la matrice de compatibilité du composer après modification d'un axe, détecter les combinaisons rares qui produisent un XML invalide en pratique (et que la matrice laisse passer à tort), ou inversement vérifier que la matrice n'est pas trop stricte (incompatible déclaré mais XML valide).

« Je veux fabriquer un jeu de données fournisseur de test » (Mode batch)

1. Ouvrez l'onglet Générateur, sous-onglet Batch (jeu de données).
2. Configurez la composition : nombre de factures (1-200), type de dataset (Mix simple, Mix varié recommandé, Cycle complet AP, Tous les cas AFNOR, ou Personnalisé en cochant manuellement).
3. Choisissez le mode Vendeur et Acheteur : rotation aléatoire sur les entités du référentiel partagé, ou fixe pour reproduire un flux fournisseur unique (cas typique : qualifier un connecteur EDI dédié).
4. Configurez si besoin les tiers (mandataire, affactureur, agent acheteur…) — par défaut tirés aléatoirement, ou fixés à une entité, ou avec un raccourci « Appliquer à tous » pour utiliser la même entité partout.
5. La convention de nommage est appliquée automatiquement : BT-1 au format {vendor}-{YYYY}-Q{trimestre}-{XXXX} et nom de fichier {preset}_{numero}.xml.
6. Cliquez sur « Générer le jeu & télécharger ZIP » — la barre de progression suit la génération. À la fin : un fichier dataset_FEFactory_{date}.zip est téléchargé.
7. Le ZIP contient : N fichiers XML UBL nommés selon votre convention + un manifest.csv récapitulatif (numéro, type, vendeur, acheteur, montants HT/TVA/TTC, dates, devise — directement exploitable Excel ou import SI Achats) + un README.txt.

💡 Cas d'usage : qualifier la Plateforme Agréée (PA) en réception, alimenter le SI Achats avec un échantillon réaliste, tester les cinématiques P2P / Comptabilité Fournisseur, ou créer un référentiel de non-régression. Variation aléatoire des dates / lignes / montants forcée pour la diversité du dataset.

« Je veux créer une facture liée à une facture antérieure » (Suite de facture)

1. Dans le Générateur, sélectionnez « Suite de facture ».
2. Collez ou chargez le XML de la facture antérieure (acompte ou facture commerciale).
3. FE Factory analyse le XML source et propose les suites logiques : solde après acompte, avoir total ou facture rectificative.
4. Choisissez la suite, ajustez si nécessaire et générez : numéro et date source sont référencés en BG-3 (BT-25 / BT-26). Les parties (vendeur / acheteur) sont reprises à l'identique.

« Je veux comprendre un champ »

1. Ouvrez l'onglet Dictionnaire des contrôles.
2. Tapez le code recherché (ex. BT-128, EXT-FR-FE-167) ou un mot-clé (ex. affacturage).
3. Filtrez par couche ou par sévérité si besoin.
4. Lisez la définition, l'XPath UBL où ce champ se trouve dans le document, et sa cardinalité selon le profil (CIUS-FR ou EXTENDED).

« Je veux tester / calibrer mon validateur avec des XML d'anomalie »

1. Ouvrez l'onglet Générateur d'anomalies (bandeau orange, zone de test).
2. Choisissez les entités vendeur / acheteur dans les dropdowns de configuration.
3. (Optionnel) Cochez « Variation aléatoire » pour produire une nouvelle variante de lignes/montants à chaque clic.
4. Dépliez les catégories (A — XSD, B — BT obligatoire, C — Format, D — Arithmétique, E — TVA, F — Socle CGI, H — Type document) et cochez une ou plusieurs anomalies à injecter.
5. Cliquez sur « Générer l'XML composé » — le XML produit (préfixé TEST-ANOM-…, marqué KaoraTest_*.xml) contient le mutateur ciblé.
6. Cliquez sur « Lancer la validation » — FE Factory passe l'XML dans son propre validateur, puis affiche un tableau comparatif Attendu vs Détecté avec un diagnostic par règle (Prévue et détectée / Prévue mais NON détectée / Détectée mais non prévue).
7. Lisez la conclusion automatique en bas : test conforme, régression potentielle, ou cascades convergentes attendues.

⚠ Important : les XML produits par cet onglet sont volontairement invalides. Le BT-1 est préfixé TEST-ANOM-, le nom de fichier commence par KaoraTest_, et un commentaire d'avertissement est ajouté en tête. Ne jamais transmettre à un destinataire en production.