Recalcul sessions caisse

Lien isolé Accueil docs Formation
Technique & dev

Recalcul des totaux et écarts de sessions de caisse.

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_balance tant 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_reports lié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.