Documentation fonctionnelle KWISATZ
Personnaliser les modèles de devis, BL, factures et avoirs
Le générateur d’états permet d’adapter la présentation des documents commerciaux sans modifier les données. La méthode sûre consiste à repartir d’un modèle standard récent, travailler sur une copie et tester chaque cas métier avant déploiement.
Réponse directe
Ouvrez Outils > Générateur d’états, puis choisissez la famille correspondant au document commercial. Ne modifiez pas directement le seul modèle fonctionnel : dupliquez un modèle standard récent, renommez la copie, puis adaptez les bandes, champs, textes, images et totaux. Testez au minimum un DEV, un BLV, une FAV positive et une FAV négative avant de sélectionner le nouveau fichier dans la fenêtre d’impression ou comme modèle par défaut.
Conseil technicien général
1. Licence et disponibilité
La dépendance de licence mentionnée dans ce document provient des sources. Sa disponibilité peut varier selon la version, la sérialisation, le partenaire ou l’installation ; faites-la valider techniquement avant de modifier l’environnement.
2. Protection des données
3. Documents concernés
| Code | Document | Points spécifiques du modèle |
|---|---|---|
| DEV | Devis client | Durée de validité, conditions commerciales, signature ou bon pour accord. |
| BLV | Bon de livraison | Adresse de livraison, quantités, lots, séries, réserves et signature de réception. |
| FAV | Facture client | Totaux, TVA, échéances, règlement, acomptes, net à payer et mentions de facturation. |
| FAV négative | Avoir client | Titre Avoir, référence de la facture d’origine, motif et montants négatifs. |
La personnalisation visuelle ne doit pas transformer un document en un autre ni masquer des lignes réelles pour altérer le sens commercial ou fiscal de l’opération.
4. Les deux générations de modèles
| Moteur | Repère | Particularités |
|---|---|---|
| FastReport | Documents de nouvelle génération | Champs récents généralement visibles, scripts et conditions plus lisibles, exports modernes. |
| QuickReport / QRDesign | Documents historiques | Modèles plus anciens, gestion des Dataset et champs parfois manuelle, diagnostic de bandes moins explicite. |
La présence des deux moteurs dépend des modèles installés, de la version et des personnalisations conservées chez le client.
5. Identifier le moteur avant modification
- Ouvrez le modèle depuis le générateur d’états.
- Observez l’éditeur et le type du fichier proposé.
- Repérez les menus disponibles, notamment État > Ensemble de données dans les anciens modèles.
- Ne mélangez pas les composants et procédures propres aux deux moteurs.
- Notez le nom exact du fichier avant modification.
Ne renommez pas seulement l’extension d’un modèle pour le convertir. Une reconstruction depuis un modèle FastReport récent est préférable à une conversion improvisée.
6. Sauvegarder avant toute modification
- Fermez les impressions utilisant le modèle.
- Localisez le modèle dans le dossier documentaire utilisé par KWISATZ.
- Copiez le fichier dans un dossier de sauvegarde externe.
- Ajoutez la date et la version dans le nom de la copie.
- Dupliquez le modèle dans le générateur ou sous un nouveau nom.
- Travaillez uniquement sur la copie.
Une mise à jour de KWISATZ peut conserver un ancien modèle personnalisé alors qu’un modèle standard plus récent contient de nouveaux champs ou correctifs. Comparez toujours les deux versions.
7. Convention de nommage recommandée
| Élément | Exemple |
|---|---|
| Type de document | FAV, DEV, BLV. |
| Client ou société | SOCIETE. |
| Usage | A4, EMAIL, AVOIR. |
| Version | V03_20260719. |
Exemple :
FAV_SOCIETE_A4_V03_20260719. La forme exacte du nom et de l’extension dépend du moteur.8. Ouvrir le générateur d’états
Outils > Générateur d’états
- Ouvrez la famille des documents clients.
- Sélectionnez DEV, BLV ou FAV selon le besoin.
- Choisissez le modèle standard récent servant de base.
- Dupliquez ou enregistrez sous un nouveau nom.
- Ouvrez l’éditeur.
- Contrôlez le format de page et les marges avant d’ajouter des objets.
Le classement exact dans l’arborescence du générateur peut varier avec la version et les modules installés.
9. Choisir le modèle lors de l’impression
Depuis le document commercial, le bouton Imprimer ouvre une fenêtre contenant les modèles disponibles pour ce type de document.
- Le modèle sélectionné détermine la présentation.
- L’aperçu permet de vérifier le résultat avant impression.
- Les boutons d’impression restent inactifs tant qu’aucun modèle n’est choisi.
- Selon la fenêtre, l’envoi par email peut également être proposé.
10. Structure d’un modèle commercial
| Bande ou zone | Contenu habituel |
|---|---|
| Entête de page | Logo, société, titre, numéro, date. |
| Entête document | Client, adresses, références, vendeur, affaire. |
| Entête des colonnes | Code, désignation, quantité, prix, remise, TVA, total. |
| Bande détail | Une ligne imprimée par ligne commerciale. |
| Sous-détail | Lots, séries, commentaires, libellés étendus ou composants. |
| Pied de groupe | Sous-totaux éventuels. |
| Résumé | HT, TVA, TTC, acomptes, net à payer, échéancier. |
| Pied de page | Coordonnées, mentions, numérotation des pages. |
11. Ajouter le logo et les coordonnées
- Utilisez un composant image compatible avec le moteur.
- Conservez les proportions du logo.
- Évitez une image trop lourde qui ralentit l’aperçu et l’email.
- Utilisez les champs du dossier pour les coordonnées variables.
- Vérifiez le rendu en couleur et en noir et blanc.
- Contrôlez l’impression PDF et l’imprimante physique.
Une image liée à un chemin local peut manquer sur un autre poste. Préférez le mécanisme d’intégration prévu par le modèle ou un chemin partagé maîtrisé.
12. Champs du dossier et de l’entreprise
Les champs récents de la table DOSSIER, comme certaines coordonnées ou informations administratives, sont généralement visibles directement dans les modèles FastReport récents.
Dans un ancien modèle QRDesign, utilisez si nécessaire :
État > Ensemble de données > DOSSIER > Champs > Ajouter
N’ajoutez pas un champ à un Dataset au hasard. Vérifiez la table, le nom du champ et la compatibilité de la version.
13. Champs d’entête et de détail
| Niveau | Exemples fonctionnels |
|---|---|
| Entête | Numéro, date, client, adresses, vendeur, références, magasin, affaire. |
| Détail | Article, libellé, quantité, unité, prix, remise, TVA, total de ligne. |
| Compléments | Lot, série, péremption, commentaire, libellé étendu, poids. |
| Totaux | HT, TVA par taux, TTC, acomptes, reste à payer, frais et port. |
Les noms techniques exacts dépendent du Dataset exposé par le modèle. Utilisez la liste des champs de l’éditeur plutôt qu’un nom supposé.
14. Règle DataField / Dataset
Dans un modèle lié aux données, chaque composant de champ doit pointer vers une source valide.
- DataField : champ à imprimer.
- Dataset : table ou requête qui fournit le champ.
- Le champ doit exister dans la version installée.
- La bande doit être alimentée par la bonne source.
L’erreur « un champ de données n’a pas de source de données » signale souvent un
DataField renseigné avec un Dataset absent ou incorrect.15. Modifier les colonnes du détail
- Redimensionnez d’abord la largeur utile de page.
- Placez les titres des colonnes.
- Alignez chaque champ détail sous son titre.
- Définissez le format numérique des quantités et prix.
- Autorisez l’agrandissement du libellé lorsqu’il doit passer sur plusieurs lignes.
- Évitez le chevauchement avec les remises et totaux.
- Testez une ligne courte et une ligne très longue.
16. Commentaires et libellés étendus
- Les lignes commentaire doivent rester distinguées des articles.
- Un libellé étendu peut nécessiter un composant multi-ligne.
- Un champ RTF doit être imprimé avec un composant compatible RTF.
- Le texte intégré au RTF conserve généralement sa propre mise en forme.
- Contrôlez la hauteur variable et les sauts de page.
Ne remplacez pas les lignes commerciales réelles par un texte synthétique uniquement pour obtenir une présentation différente. Utilisez le modèle pour présenter autrement sans casser la traçabilité.
17. Personnaliser le devis
Un modèle de DEV peut notamment afficher :
- le titre Devis ou Proposition commerciale ;
- la date et le numéro ;
- le contact et l’adresse du client ;
- les références du besoin ;
- les conditions de validité ;
- les conditions de paiement et l’acompte demandé ;
- une zone « Bon pour accord » et signature ;
- les réserves commerciales validées par l’entreprise.
La date de validité n’est pas confirmée comme champ universel dans tous les documents. Utilisez un champ disponible ou une mention calculée et testée.
18. Personnaliser le bon de livraison
- Adresse de livraison réellement sélectionnée.
- Référence de la commande client.
- Date et numéro du BLV.
- Quantités livrées, sans valeur commerciale si le modèle le prévoit.
- Lots, séries et péremptions si nécessaires.
- Nom du transporteur ou du livreur si disponible.
- Zone de réserves, nom, date et signature du destinataire.
Masquer les prix dans un BLV ne modifie pas les données. Vérifiez toutefois que le modèle utilisé correspond bien à l’usage attendu et qu’un modèle valorisé reste disponible.
19. Personnaliser la facture
- Titre Facture.
- Numéro et date.
- Références des commandes et livraisons.
- Client facturé et adresse.
- Détail des articles et prestations.
- Total HT et ventilation de TVA.
- Total TTC.
- Acomptes et net à payer.
- Date ou tableau d’échéances.
- Mode et délai de règlement.
- Coordonnées bancaires lorsque l’entreprise les utilise.
- Mentions validées par le responsable comptable.
20. Personnaliser l’avoir
Dans KWISATZ, l’avoir de gestion est une FAV négative. Deux stratégies sont possibles.
| Stratégie | Avantage | Vigilance |
|---|---|---|
| Un modèle FAV commun | Maintenance unique. | Le titre et les mentions doivent changer de manière fiable lorsque le total est négatif. |
| Un modèle dédié Avoir | Présentation explicite et contrôlable. | L’utilisateur doit sélectionner le bon modèle. |
Une condition telle que
TOTAL_TTC < 0 peut servir à piloter un titre ou une zone dans un modèle compatible. Le champ exact et la syntaxe dépendent de l’éditeur.Le modèle d’avoir doit afficher la référence de la facture d’origine. La présentation ne crée pas ce lien : la référence doit exister dans les données ou commentaires du document.
21. Totaux et formules
- Utilisez les champs de total fournis par KWISATZ lorsque disponibles.
- Évitez de recalculer la TVA à partir de valeurs arrondies imprimées.
- Vérifiez les avoirs, remises, frais, port et acomptes.
- Testez plusieurs taux de TVA dans la même facture.
- Contrôlez les totaux sur une facture multi-pages.
Une formule d’impression erronée peut afficher un total faux alors que les données KWISATZ sont correctes. Comparez toujours au document à l’écran et aux bases TVA.
22. Groupes, bandes et sauts de page
| Besoin | Solution de modèle |
|---|---|
| Répéter les titres de colonnes | Entête de page ou de groupe répétable. |
| Afficher un total une seule fois | Bande résumé ou pied de document. |
| Conserver article et commentaire ensemble | Réglage de conservation ou bande enfant selon moteur. |
| Éviter un pied isolé | Contrôle de l’espace disponible et du saut de page. |
| Afficher « Page x / y » | Variables système du moteur. |
Des bandes résumé dupliquées ou masquées peuvent provoquer l’absence d’un total ou son impression en double. Ne supprimez pas une bande au hasard.
23. Conditions d’impression
Les conditions permettent d’afficher ou masquer un objet ou une bande selon les données.
- Masquer une adresse de livraison vide.
- Afficher le titre Avoir pour une FAV négative.
- Afficher une zone d’échéancier seulement lorsqu’il existe plusieurs échéances.
- Afficher les lots seulement lorsque le champ est renseigné.
- Masquer les prix dans un BLV non valorisé.
Testez les valeurs nulles, vides et zéro. Une condition vraie dans l’éditeur peut se comporter différemment avec une donnée absente lors de l’impression réelle.
24. Modèle d’impression et données électroniques
Le modèle agit sur l’aperçu, le papier, le PDF ou la pièce jointe générée.
Il ne modifie pas les lignes commerciales, les bases TVA, les mouvements de stock ni les données structurées d’une facture électronique. Une Factur-X ou un flux de plateforme doit rester cohérent avec les données enregistrées, même si le PDF est présenté différemment.
25. Modèle par défaut et envoi par email
Selon la version, les préférences d’email peuvent proposer un modèle FAV par défaut ainsi que des adresses de copie.
- Sélectionnez uniquement un modèle testé.
- Contrôlez la pièce jointe PDF.
- Vérifiez l’objet et le corps du message.
- Testez une facture et un avoir.
- Contrôlez l’archivage de la version envoyée.
Un modèle sélectionné par défaut pour l’email peut différer du modèle choisi manuellement à l’impression. Documentez les deux réglages.
26. Formats de page et imprimantes
| Réglage | Contrôle |
|---|---|
| Format | A4 ou format réellement chargé dans l’imprimante. |
| Orientation | Portrait ou paysage. |
| Marges | Compatibles avec la zone imprimable du pilote. |
| Bac papier | Entête, papier blanc ou bac spécifique selon besoin. |
| Recto verso | Testé avec le pilote réel. |
| Pages, polices et images correctes. |
Un modèle correct à l’écran peut être décalé par un pilote d’imprimante différent. Testez avec l’imprimante de production.
27. Problème de mise à l’échelle Windows
Les anciens éditeurs QRDesign peuvent être déformés lorsque Windows utilise une mise à l’échelle à 125 % ou davantage.
Pour un diagnostic, testez les propriétés de compatibilité du raccourci KWISATZ et le remplacement du comportement de mise à l’échelle PPP élevée par Application.
Ce réglage concerne l’affichage de l’application. Documentez-le et testez les autres écrans avant déploiement général.
28. Méthode de test minimale
| Document test | Pourquoi |
|---|---|
| DEV simple | Entête, conditions et signature. |
| BLV sans prix | Adresse et quantité. |
| BLV avec lots ou séries | Sous-détail et hauteur variable. |
| FAV positive | Totaux et TVA. |
| FAV négative | Titre Avoir et signes. |
| FAV avec plusieurs taux | Ventilation fiscale. |
| FAV avec acompte | Net à payer. |
| FAV multi-échéances | Tableau des échéances. |
| Document multi-pages | Entêtes répétés et pied final. |
| Libellé très long | Agrandissement et saut de page. |
29. Comparer au modèle standard récent
- Prévisualisez le modèle personnalisé actuel.
- Prévisualisez le modèle standard récent sur le même document.
- Comparez champs, totaux, bandes et mentions.
- Listez uniquement les personnalisations réellement nécessaires.
- Repartez du modèle récent si l’ancien contient de nombreuses anomalies.
- Réintégrez les adaptations une par une.
Cette méthode limite les erreurs héritées et permet de profiter des nouveaux champs et corrections du modèle standard.
30. Déploiement multi-postes ou multi-sites
- Identifiez le dossier réellement utilisé par chaque poste.
- Copiez le modèle dans l’emplacement partagé prévu.
- Vérifiez les droits de lecture et d’écriture.
- Contrôlez que tous les postes sélectionnent le même fichier.
- Testez l’impression et l’email depuis un poste distant.
- Archivez la version déployée.
Deux fichiers portant le même nom dans des dossiers différents peuvent produire des résultats différents selon le poste.
31. Journal de version recommandé
| Information | Exemple |
|---|---|
| Modèle | FAV_SOCIETE_A4_V03. |
| Moteur | FastReport. |
| Date | 19/07/2026. |
| Modification | Ajout IBAN, échéancier et titre Avoir. |
| Document test | FAV 2026-001245. |
| Validateur | Responsable ADV / comptabilité. |
| Emplacement | Dossier documentaire partagé. |
32. Actions à éviter
- Modifier le seul modèle fonctionnel sans copie.
- Partir d’un modèle ancien très modifié sans comparaison récente.
- Supprimer des bandes au hasard.
- Ajouter un DataField sans Dataset.
- Recalculer la TVA uniquement dans le modèle.
- Masquer des lignes réelles pour modifier le sens de la facture.
- Tester uniquement une facture positive d’une page.
- Déployer sur tous les postes sans test de l’imprimante réelle.
- Considérer le PDF imprimé comme la seule donnée d’une facture électronique.
33. Compatibilité documentée
| Fonction | Repère | Condition connue |
|---|---|---|
| Gestion des modèles | Outils > Générateur d’états | Famille dédiée à chaque édition |
| Sélection à l’impression | Zone Fichier modèle | Impression inactive sans sélection |
| FastReport | Documents de nouvelle génération | Selon licence et modèle installé |
| QuickReport / QRDesign | Documents historiques | Dataset et champs parfois à ajouter manuellement |
| Ajout d’un champ DOSSIER en QRD | État > Ensemble de données > Champs > Ajouter | Modèle ancien existant |
| Modèle FAV par défaut email | Préférences Email | Selon version et configuration |
| Export PDF | Prévisualisation / export | Contrôle du moteur et des polices |
34. Diagnostic rapide
Le nouveau champ n’apparaît pas dans QRDesign
Ouvrez État, Ensemble de données, sélectionnez la table concernée, puis Champs et Ajouter.
Un champ affiche vide
Contrôlez le Dataset, le DataField, le document test et la présence réelle de la valeur dans la base.
Erreur « champ sans source de données »
Un composant possède probablement un DataField sans Dataset valide. Recherchez le composant dans la bande signalée.
Le total n’apparaît pas
Contrôlez la bande Résumé, sa visibilité, sa position et l’existence d’une bande en doublon.
Le total s’imprime deux fois
Recherchez deux bandes résumé ou deux formules de somme actives.
Le modèle est lent à ouvrir
Testez avec un document et une période réduits. Un ancien QRD complexe peut être plus difficile à diagnostiquer qu’un modèle récent.
Le titre Facture apparaît sur un avoir
Ajoutez une condition fiable sur une FAV négative ou utilisez un modèle Avoir dédié.
Les échéances ne s’impriment pas
Le modèle ne contient peut-être pas la bande ou le sous-ensemble de données des échéances multiples.
Le logo disparaît sur un autre poste
Contrôlez le chemin de l’image ou son intégration dans le fichier modèle.
L’impression est décalée mais l’aperçu correct
Contrôlez le pilote, les marges, le format papier, le bac et l’échelle de l’imprimante.
QRDesign est déformé à l’écran
Testez la compatibilité PPP élevée de Windows avec le comportement remplacé par Application.
Le modèle personnalisé ne contient pas un correctif récent
Comparez avec le modèle standard livré et reconstruisez depuis celui-ci si nécessaire.
35. Résultat attendu
Chaque type de document utilise un modèle identifié, sauvegardé et versionné. Les données d’entête, de détail, de TVA et de règlement restent exactes, les factures positives et négatives sont clairement distinguées, les impressions multi-pages sont stables et le modèle fonctionne sur les postes, imprimantes et envois email prévus.
36. Sources documentaires
- Manuel KWISATZ — fenêtre d’impression des documents et sélection du fichier modèle.
- Manuel KWISATZ — gestion des fichiers modèles depuis Outils > Générateur d’états.
- Suivi de développement — différence entre FastReport et QuickReport, champs de la table DOSSIER et ajout manuel dans les modèles QRD existants.
- Suivi de développement — modèle FAV par défaut pour l’envoi par email.
- Base support — sauvegarde, comparaison avec un modèle standard récent et diagnostic DataField/Dataset.
- Base support — utilisation d’un modèle d’impression spécifique sans supprimer les lignes issues d’un BLV.