Générer une facture
Utilisez cette procédure lorsque vous devez générer ou récupérer le document de conformité d’une facture qui existe déjà dans Sylius.
Préconditions
Avant toute génération :
- la facture Sylius doit déjà exister ;
- Invoice doit avoir capturé son instantané fiscal immuable ;
- la stack supportée et les migrations de base de données doivent être en place ;
- les diagnostics bloquants doivent être corrigés.
bin/console sylius-invoice:check-requirements
bin/console sylius-invoice:compliance:doctor
Voir Prérequis, Configuration et Données de facture pour les contrats sous-jacents.
Générer le document de conformité
Lancez la commande avec l’identifiant de la facture Sylius :
bin/console compliance:invoice:generate <invoice-id>
Pour copier également le PDF Factur-X résultant dans un fichier que vous contrôlez :
bin/console compliance:invoice:generate <invoice-id> --output=/tmp/facture-factur-x.pdf
--output est un chemin d’export. Le plugin conserve malgré tout les artefacts de conformité gouvernés dans son propre stockage.
Résultat attendu
Pour une facture valide, Invoice construit la facture électronique à partir des données fiscales figées, génère le PDF Factur-X et le XML structuré, valide le document électronique, stocke les empreintes d’intégrité et enregistre le document de conformité.
La commande de génération manuelle ne transmet pas le document à une plateforme/prestataire. La transmission reste une étape distincte ; conservez le mode MANUAL pendant l’onboarding tant que l’envoi automatique n’a pas été configuré volontairement.
Codes de sortie
| Code | Signification |
|---|---|
0 |
Génération réussie, ou document valide existant réutilisé sous forme de no-op idempotent. |
1 |
Échec de génération. Consultez l’erreur de commande et les diagnostics de conformité avant de réessayer. |
2 |
L’identifiant fourni ne correspond à aucune facture. |
Comportement important
La génération est volontairement idempotente. Relancer la commande ne crée ni une seconde facture fiscale ni un nouveau numéro de facture. Si un document de conformité complet et valide existe déjà, il est réutilisé.
Pour récupérer un artefact manquant, poursuivez avec Régénérer une facture. Pour récupérer les fichiers générés, voir Télécharger une facture.