Cette page vous amène en quelques minutes à votre première facture électronique valide. Tous les paramètres se trouvent dans l'administration sous Stores → Configuration → Sales → E-Invoicing. Les détails de chaque paramètre sont décrits dans la section Configuration.
L'interface d'administration du module est disponible en anglais (et en allemand) ; les libellés de champs sont donc indiqués en anglais, tels qu'ils apparaissent dans l'administration.
1. Vérifier les informations du magasin
Une grande partie des données du vendeur est reprise des informations générales du magasin. Renseignez d'abord intégralement, sous Stores → Configuration → General → Store Information :
- Nom de la société, rue, code postal, ville, pays
- Numéro de TVA (BT-31)
Sans adresse complète ni numéro de TVA, aucune facture conforme à l'EN 16931 ne peut être générée.
2. Choisir un profil
Choisissez sous E-Invoicing → General → Profile le profil adapté. La valeur par défaut est EN 16931 (COMFORT) – le bon choix pour la plupart des factures B2B. Pour les factures destinées au secteur public allemand, choisissez un profil XRechnung. Plus de contexte sous Formats et profils.
3. Compléter les données du vendeur
Complétez sous E-Invoicing → Seller les champs propres à la facturation électronique qui ne proviennent pas des informations du magasin – au minimum le champ « Seller Name » (BT-27). Pour les virements, renseignez « IBAN » (BT-84) et « BIC » (BT-85). Détails sous Vendeur.
4. Définir les conditions de paiement
Renseignez sous E-Invoicing → Payment Information les conditions de paiement par défaut (BT-20) et un code de moyen de paiement par défaut (BT-81). En option, vous pouvez attribuer des valeurs propres à certaines méthodes de paiement Magento. Détails sous Paiement.
5. Générer la première facture
Générez une facture pour une commande comme d'habitude dans Magento. Ensuite, selon la configuration, le téléchargement XML, le PDF ZUGFeRD hybride et l'envoi par e-mail sont à votre disposition – voir Utilisation.
Vous pouvez également générer le XML en ligne de commande :
bin/magento geissweb:einvoice:generate-xml --invoice-id=123
Le fichier est par défaut enregistré sous var/export/e-invoices/invoice_000000123.xml.
6. Vérifier le résultat
Validez le résultat par rapport au schéma XSD et contrôlez les montants :
bin/magento geissweb:einvoice:validate-xml var/export/e-invoices/invoice_000000123.xml
bin/magento geissweb:einvoice:verify-amounts --invoice-id=000000123
Le contrôle XSD garantit la validité structurelle ; vous vérifiez les règles de gestion complètes de l'EN 16931 en complément avec un service de validation externe – voir Validation.
Après chaque modification de configuration, vous devriez régénérer les factures concernées avec --force, car les fichiers XML déjà générés ne sont pas mis à jour automatiquement. Voir Aide.