LuaBill · Documentation LuaBill

Résoudre les problèmes de génération

Le message principal donne le contexte ; le journal permet d’identifier la première cause précise.

Commencez par le journal

Ouvrez l’onglet Journal de création et le dossier de travail indiqué après un échec. Pour LuaLaTeX, consultez pass1.txt et document.log ; cherchez la première erreur plutôt que les messages qui en découlent.

Reproduisez ensuite le problème avec un exemple fourni. Si l’exemple fonctionne, comparez les champs et le format du document concerné. Conservez une copie de votre projet avant de modifier ses données.

LuaLaTeX, paquets et polices

Utilisez Aide → Composants et installation pour vérifier les exécutables, puis l’assistant de préparation pour une compilation de contrôle. Après installation ou modification du PATH, fermez et relancez LuaBill.

TeX Live peut afficher « LuaHBTeX » pour la commande lualatex : il s’agit du moteur utilisé et ce nom n’est pas une erreur. La commande lualatex doit cependant exister et sélectionner le format LaTeX ; lancer directement luahbtex n’est pas équivalent.

  • Un paquet .sty manquant doit être préparé avec le gestionnaire de votre distribution TeX ou l’assistant.
  • MiKTeX peut installer des paquets à la demande si cette fonction est activée ; TeX Live utilise son propre mécanisme de paquets.
  • Les polices et les métriques mathématiques doivent aussi être disponibles : le test autonome LuaLaTeX aide à les vérifier.
lualatex --version
texlua --version
Télécharger le test LuaLaTeX et les outils →

Java, XML et PDF/A

Java 17 ou ultérieur est nécessaire aux formats électroniques, même si une version plus ancienne de Java est déjà installée. Le rapport de composants indique l’exécutable réellement choisi. Ghostscript est nécessaire à ZUGFeRD ; le PDF ordinaire peut être créé sans compression Ghostscript.

Un refus de validation peut provenir d’une adresse, d’une référence acheteur, d’un identifiant électronique, du traitement fiscal ou d’une incohérence de montants. Lisez l’identifiant de règle et son message dans les rapports avant de corriger le champ concerné.

Vérifier une XRechnung →Vérifier un document ZUGFeRD →

Projets, sorties et version installée

Un projet .luabill contient vos données de document ; les chemins de sortie appartiennent aux réglages utilisateur. La barre de résultat permet de retrouver le PDF, le XML et leur dossier. Un ancien résultat peut rester sur disque après un échec : vérifiez le message et les chemins du dernier traitement.

La version de l’application est visible dans À propos de LuaBill. L’inventaire des normes et du validateur figure dans Aide → Normes de facturation électronique et mises à jour. La vérification hebdomadaire est facultative et désactivée par défaut ; elle n’installe pas automatiquement les mises à jour.

Comparer avec les notes de version →
← Retour à la documentation

Avant de commencer

LuaBill est-il gratuit pour une activité professionnelle ?

Oui. Le code et la documentation propres à LuaBill sont disponibles sous Apache License 2.0, y compris pour un usage commercial selon ses conditions. Aucun abonnement LuaBill n'est requis. Les composants tiers conservent leurs licences d'origine.

Faut-il connaître Lua ou LaTeX ?

Non. Le formulaire graphique couvre la saisie courante. LuaLaTeX doit être disponible, mais l’assistant peut préparer les composants nécessaires sur les systèmes pris en charge. Les champs structurés se remplissent en texte normal ; les développeurs peuvent adapter le code et les modèles.

Faut-il télécharger une distribution LaTeX complète ?

Non. Le paquet LuaBill n’inclut pas une distribution TeX complète. Sous Windows, l’assistant peut préparer Basic MiKTeX puis les paquets du modèle. Les composants supplémentaires sont téléchargés séparément ; une connexion Internet est donc nécessaire pour leur préparation. Sous Linux, le volume dépend des paquets de la distribution ; certains ensembles de polices peuvent être importants.

Puis-je insérer des formules LaTeX dans un document professionnel ?

Oui. Remarks prend en charge un ensemble limité de commandes LaTeX pour la mise en valeur du texte et les formules, notamment les intégrales, sommes et fractions. Encadrez les expressions mathématiques par \( ... \) ou \[ ... \] ; le texte ordinaire ne demande aucun balisage. Le PDF compose les formules. Dans les notes exportées en XML, le code LaTeX reste du texte brut et n’est pas automatiquement rendu par le logiciel du destinataire. Le texte d’introduction est réservé au PDF. Les paquets et macros arbitraires ne sont pas pris en charge.

Mes informations clients et mes factures sont-elles téléversées ?

LuaBill génère les documents localement et ne téléverse pas les factures vers un service de génération. Le numéro TVA du client est envoyé à VIES uniquement lorsque vous cliquez sur Vérifier dans VIES. La préparation des composants et la recherche des mises à jour peuvent utiliser Internet ; cette dernière ne transmet aucune donnée de facture, de client ou XML. Vous choisissez comment envoyer la facture terminée.

Comment fonctionnent la vérification VIES et la coche verte ?

Saisissez le numéro TVA UE complet avec préfixe pays (XI pour l’Irlande du Nord, EL pour la Grèce), puis cliquez sur Vérifier dans VIES dans Client. Une réponse complète enregistre le résultat et la date ; sauvegardez le projet .luabill pour les conserver. Une réponse négative retire la coche verte. Une erreur de service ou de connexion conserve l’ancien enregistrement. La durée de validité choisie se compte en jours calendaires par rapport à aujourd’hui et, pour le PDF, au jour de génération ; la date de facture n’intervient pas. Cette vérification ne contrôle ni le nom ni l’adresse du client et ne détermine pas le traitement fiscal de l’opération.

Puis-je facturer des clients hors d'Allemagne ?

La version actuelle prend en charge les vendeurs établis en Allemagne et leurs clients en Allemagne, dans un autre pays de l'UE ou hors de l'UE. Choisissez la situation réelle et le pays de livraison ; un client étranger ne prouve pas, à lui seul, une exonération de TVA.

Puis-je utiliser une autre langue ou devise ?

L'interface et le document se règlent séparément en EN, DE, FR, IT ou RU. EUR, USD, RUB, CNY et d'autres codes de devises sont acceptés, sans conversion de change automatique. Vos descriptions et textes personnels ne sont pas traduits automatiquement.

Quel fichier faut-il envoyer au client ?

.luabill est le projet modifiable à conserver. XRechnung se transmet en XML ; ZUGFeRD se transmet généralement en PDF hybride contenant le XML. Envoyez un PDF ordinaire seulement lorsque ce format convient à l'opération et au destinataire.

Le PDF ou la signature suffisent-ils à prouver le format ?

Non. Le nom et l'apparence du fichier ne prouvent pas la présence d'un XML valide. Contrôlez le format choisi et le rapport. Les images de signature et de cachet sont des éléments graphiques, pas des signatures électroniques cryptographiques.

LuaBill remplace-t-il un logiciel de comptabilité ?

LuaBill prépare des documents. Il ne gère pas la numérotation unique de toute votre entreprise, les écritures comptables, les mouvements bancaires ni l'archivage des versions émises. Ces processus restent à organiser séparément.

Comment transférer mon travail sur un autre ordinateur ?

Copiez le projet .luabill et les images de signature et de cachet utilisées. Sélectionnez de nouveau les images si leurs chemins ont changé. Le dossier de sortie dépend des préférences du nouvel ordinateur et n'est pas enregistré dans le projet.

Où trouver le guide et les informations de licence ?

Le menu Aide propose le guide dans la langue de l’interface, le rapport des composants, l’assistant Préparer la création des documents, Normes de facturation électronique et mises à jour et les références des composants tiers. Les guides sont inclus dans l’application et dans les sources ; préparer des composants ou rechercher des mises à jour peut nécessiter Internet.

Faut-il désinstaller LuaBill avant une mise à jour ?

Non. Fermez LuaBill et utilisez le nouvel installateur dans le même dossier. Sous Linux/macOS, réutilisez votre --prefix personnalisé. Vos documents et réglages restent conservés. Sauvegardez séparément les modifications manuelles des fichiers du programme ; sous Unix, un conflit interrompt la mise à jour.

Pourquoi LuaLaTeX affiche-t-il LuaHBTeX ?

Le message « This is LuaHBTeX » est normal : LuaLaTeX utilise ce moteur dans TeX Live. La commande doit rester lualatex ; texlua conserve aussi son propre nom de lancement. LuaBill 0.1.14 et les versions suivantes préservent ces liens. Ne remplacez pas lualatex par une invocation directe de luahbtex.

Où voir les versions du validateur et des règles réellement utilisées ?

Ouvrez Aide → Normes de facturation électronique et mises à jour, ou Versions de validation dans le panneau de résultats. Les règles actives sont distinguées des anciennes ressources du JAR Mustang d’origine. Le fichier .validation-info.json conserve les versions, empreintes SHA-256, profil et étapes de validation de la facture ; gardez-le avec les deux rapports XML.

LuaBill peut-il signaler qu’une mise à jour des règles est disponible ?

Oui. Rechercher des mises à jour consulte les publications officielles publiques. Vous pouvez activer une recherche hebdomadaire au démarrage ; elle est désactivée par défaut. Aucun document n’est envoyé et rien n’est installé automatiquement. Une nouvelle version technique invite à examiner une mise à jour ; elle ne détermine pas, à elle seule, un changement de droit ou une échéance obligatoire.

Pourquoi reste-t-il des fichiers après la désinstallation ?

LuaBill conserve volontairement les documents, réglages et fichiers modifiés ou inconnus. Les dépendances système et le dossier de l’archive téléchargée sont également conservés. Le rapport indique les avertissements et les chemins restants. Le désinstalleur d’une nouvelle archive peut nettoyer une ancienne installation sans réinstallation. Le cache des composants, les polices privées et les journaux de préparation peuvent également rester dans les données utilisateur de LuaBill.