Recalcul des sessions de caisse fermées
Le solde attendu en tiroir suit la formule : fond d’ouverture + ventes complétées en espèces + entrées caisse − sorties.
Ce montant est figé sur la session (expected_balance) et dans les rapports de caisse au moment de la fermeture ou lors d’un recalcul.
Quand recalculer ?
- Après une évolution de règle (ex. passage au calcul « espèces uniquement » pour l’attendu) : les anciennes clôtures gardent l’ancien
expected_balancetant qu’on ne les met pas à jour. - Après corrections de ventes ou de mouvements sur une période déjà fermée.
- Le rapport caisse web affiche un bandeau orange lorsque, pour la dernière session fermée de la période, la valeur en base diffère du recalcul actuel.
Commandes Artisan
À lancer à la racine du projet Laravel (même dossier que artisan).
Une session
php artisan cash:recalculate-closed-session 42
Remplace 42 par l’id de la ligne cash_sessions (statut closed).
Toutes les sessions fermées
Simulation (aucune écriture) :
php artisan cash:recalculate-closed-session --all --dry-run
Appliquer pour toutes les boutiques :
php artisan cash:recalculate-closed-session --all
Limiter à une boutique :
php artisan cash:recalculate-closed-session --all --shop=1
Effets en base
Pour chaque session traitée, le service met à jour :
cash_sessions.expected_balance,cash_sessions.difference(compté − attendu) ;- les enregistrements
cash_reportsliés (expected_balance,difference, totaux et JSON des ventes par méthode / catégorie).
Les totaux « toutes méthodes » dans les rapports (ex. total_sales) restent basés sur toutes les ventes complétées de la session ; seul l’attendu caisse repose sur les espèces + mouvements.
Précaution
Préférez --dry-run --all pour estimer l’ampleur des écarts avant d’écraser les valeurs historiques. En cas d’audit strict, documentez la date du recalcul et la raison.
Correction du comptage sans changer l’attendu
Si l’erreur est uniquement le montant compté saisi à la fermeture (et non la règle de calcul du solde attendu), utilisez l’action Corriger comptage / écart sur la liste des sessions de caisse (autorisation Fermer une session). Cela met à jour closing_balance, recalcule difference et ajoute une trace dans les notes, sans modifier expected_balance. Les PDF / CSV déjà générés ne sont pas régénérés automatiquement.