Module Caisse — guide complet

Le module Caisse permet d'encaisser les factures clients, de gérer les sessions de caisse (ouverture/fermeture par caissier) et de garder une trace fidèle des mouvements de trésorerie en temps réel.

Architecture en 3 niveaux

Nukuntche distingue trois concepts pour la caisse, chacun avec son rôle :

Paiement : la trace côté client (reçu PDF, lien à la facture).
Encaissement : le mouvement sur le compte de trésorerie (crédite la caisse, banque ou Mobile Money).
SessionCaisse : le poste opérationnel (qui était caissier, fond initial, écart au comptage).

Quand vous encaissez une facture en espèces, Nukuntche crée automatiquement les 3 : le Paiement (reçu client), l'Encaissement (crédite votre caisse), et lie le tout à la session de caisse en cours pour traçabilité.

Configurer une caisse

Allez dans Trésorerie → Comptes et créez un compte de type Caisse.
Rattachez la caisse à une boutique (champ "Boutique rattachée"). Nukuntche utilisera automatiquement la caisse de la boutique active pour les encaissements espèces. Plus de hardcode, plus de confusion en multi-boutique.
Cochez "Compte principal" si vous avez plusieurs caisses pour la même boutique. Une seule peut être principale — c'est elle qui sert par défaut.

Ouvrir une session de caisse

Avant tout encaissement (politique par défaut), un caissier doit ouvrir sa session :

Comptez physiquement votre fond de caisse (espèces présentes ce matin).
Allez dans Trésorerie → Comptes ou directement sur le bandeau jaune du dashboard caisse.
Cliquez "Ouvrir une session", saisissez le montant du fond, validez.

Encaisser une facture

Sur le dashboard caisse, sélectionnez la facture en attente dans la liste de gauche.
Cliquez "Encaisser le paiement", choisissez le mode (espèces, mobile money, etc.) et le montant.
Validez. Le reçu PDF est généré, la caisse est créditée, le théorique de session est mis à jour.

Si vous voyez "Aucune session ouverte" L'encaissement est bloqué tant qu'une session n'est pas ouverte. C'est une mesure de sécurité (traçabilité, anti-fraude). Vous pouvez la désactiver dans Paramètres → Caisse si vous êtes seul commerçant.

Fermer la session

En fin de journée :

Cliquez "Fermer la session" sur le bandeau vert du dashboard.
Comptez physiquement votre caisse et saisissez le montant compté.
Nukuntche calcule le solde théorique (fond + encaissements - décaissements) et l'écart entre théorique et réel.
Si écart, justifiez-le dans le commentaire (manque-monnaie, erreur, etc.).

Annuler un paiement

Sur le dashboard caisse, dans le tableau "Paiements du jour", cliquez la croix rouge en bout de ligne. Réservé aux managers (ROLE_MANAGER). L'Encaissement correspondant est annulé en même temps, le solde de caisse est réajusté, le statut de la facture repasse en attente.

Solde réel vs encaissé du jour

Le "Solde de caisse" affiché reflète la trésorerie réelle (encaissements + sorties cash + tout l'historique). L'"Encaissé aujourd'hui" ne montre que les paiements clients du jour. Ces deux chiffres sont différents et c'est normal.

Configurer la politique de session

Dans Paramètres → Caisse, le toggle "Session obligatoire" :

Activé (défaut) : encaissement bloqué sans session ouverte. Recommandé pour la traçabilité.
Désactivé : encaissement libre. Pertinent uniquement pour un commerce mono-personne où le commerçant est lui-même le seul caissier.