Régénérer une facture
Dans Invoice, « régénérer » signifie rejouer de manière idempotente ou récupérer l’artefact de conformité à partir des données fiscales figées. Cela ne signifie pas remplacer une facture émise.
Quand l’utiliser
Utilisez cette procédure lorsque :
- la génération a été interrompue et qu’un artefact manque ;
- vous voulez rejouer la génération après avoir corrigé une erreur technique ;
- vous voulez vérifier que le document de conformité existant peut toujours être réutilisé.
N’utilisez pas la régénération pour modifier les données client, montants, taxes, numéro de facture ou autres valeurs fiscales après émission. Ces valeurs proviennent de l’instantané immuable. Voir Données de facture.
Relancer la commande de génération
Utilisez la même commande que pour la génération initiale :
bin/console compliance:invoice:generate <invoice-id>
Vous pouvez demander simultanément un export du PDF :
bin/console compliance:invoice:generate <invoice-id> --output=/tmp/facture-factur-x.pdf
Ce que fait Invoice
Le générateur suit un chemin de récupération protégé :
| État existant | Résultat |
|---|---|
| Document complet et validé avec intégrité XML/PDF valide | Réutilisation du document existant ; aucun doublon fiscal n’est créé. |
| Document généré en attente de validation | Validation avant réutilisation. |
| Artefact généré légitimement absent/incomplet et reconstructible | Reconstruction depuis les données immuables de la facture. |
| Document existant marqué invalide | Arrêt avec remontée des erreurs de validation persistées. |
| XML ou PDF Factur-X stocké en échec d’intégrité | Arrêt ; l’artefact n’est pas écrasé silencieusement. |
| XML reconstruit différent du XML structuré figé | Arrêt ; Invoice refuse la divergence fiscale. |
La commande retourne 0 pour une récupération réussie ou un no-op idempotent, 2 si la facture est introuvable et 1 pour les autres erreurs.
Ce que la régénération ne fait jamais
Elle ne :
- réserve pas un nouveau numéro de facture ;
- modifie pas la facture Sylius d’origine ;
- recalcule pas l’historique fiscal depuis des données de commande encore mutables ;
- remplace pas silencieusement un artefact dont l’intégrité échoue ;
- transmet pas le document à une plateforme depuis la commande manuelle de génération.
Si la correction commerciale modifie ce qui a été facturé, utilisez un avoir plutôt qu’une régénération. Pour une « annulation » destructive, voir Annuler une facture.