Annuler une facture
Invoice n’expose aucune opération destructive « annuler une facture émise ». Une fois les données fiscales figées, la facture historique reste immuable.
Si une facture commerciale doit être totalement ou partiellement contrepassée, représentez la correction par un avoir. Ne supprimez pas la facture source, ne réécrivez pas ses montants et ne la régénérez pas avec des données fiscales différentes.
Annulation totale
Pour une contrepassation complète :
- conservez la facture d’origine et son instantané immuable ;
- créez un avoir total avec son propre numéro et une date d’émission qui n’est pas antérieure à la facture d’origine ;
- conservez la référence vers la facture corrigée ;
- générez et validez le document de conformité de l’avoir ;
- transmettez l’avoir selon le mode de transmission configuré.
La facture d’origine reste dans l’historique. L’avoir total porte la correction commerciale sans modifier cet enregistrement source.
Annulation partielle
Lorsque seule une partie de la facture est corrigée, créez un avoir partiel pour les lignes et quantités sélectionnées. Invoice suit les quantités déjà créditées et rejette toute allocation qui dépasserait la quantité restant créditable.
Suivez Créer ou utiliser un avoir pour les API PHP concrètes.
À ne pas faire
N’implémentez pas une annulation en :
- supprimant la facture Sylius ;
- modifiant son numéro, sa date d’émission, ses totaux ou les données vendeur/acheteur figées ;
- écrasant ses artefacts Factur-X/XML persistés ;
- relançant la génération après modification de données de commande mutables en espérant un résultat fiscal différent.
Ces approches rompent le contrat d’immuabilité décrit dans Données de facture et Cycle de vie.
Limite d’intégration actuelle
Dans la version supportée, l’annulation est un workflow comptable exprimé par les services d’avoir, et non un bouton « Annuler » dédié dans l’Admin Invoice, un endpoint public ou une commande console. Votre application décide quel événement métier nécessite un avoir total ou partiel ; Invoice fournit les données source immuables, les règles de construction des avoirs et la chaîne d’enregistrement de conformité.