UN GUIDE POUR CHAQUE ÉTAPE
Prenez le fil,
à votre rythme.
De la première ouverture à la clôture d’un exercice, les repères essentiels pour utiliser Fil de caisse sereinement.
01 · BIEN DÉMARRER
Votre première ouverture.
- Téléchargez la dernière version, puis décompressez entièrement l’archive.
- Placez le dossier sur un disque ou une clé USB, dans un emplacement accessible en écriture.
- Utilisez le lanceur adapté à votre système. L’interface s’ouvre dans le navigateur déjà présent sur le poste.
- Dans Établissement, renseignez le nom, la régie, l’exercice initial et le solde d’ouverture avant de commencer les saisies.
Le moteur SQLite est intégré : aucun Python, Go ou module supplémentaire n’est à installer sur le poste utilisateur. Le fonctionnement de l’application ne nécessite pas Internet.
Les données sont enregistrées dans caisse.sqlite, à côté de l’exécutable. Gardez toujours ce fichier avec l’application lorsque vous transportez le dossier.
02 · VOTRE SYSTÈME
Choisir le bon lanceur.
| Système | Lanceur |
|---|---|
| Windows x64 ou ARM64 | Lancer-Fil-de-caisse-Windows.bat |
| Linux x64 ou ARM64 | Lancer-Fil-de-caisse-Linux.sh |
| macOS Intel ou Apple Silicon | Lancer-Fil-de-caisse-macOS.command |
Les lanceurs choisissent automatiquement le fichier correspondant à l’architecture du poste.
Sous Linux
Ouvrez un terminal dans le dossier décompressé, puis lancez :
sh ./Lancer-Fil-de-caisse-Linux.shLe lanceur vérifie le droit d’exécution du programme. Une clé USB ou une politique informatique peut interdire les exécutables ; l’application ne contourne pas cette restriction.
Linux x64 a été testé. Les versions Windows, macOS et ARM sont compilées et leur exécution native reste à vérifier sur les systèmes correspondants. Les exécutables macOS ne sont pas signés ni notariés ; les autorisations du poste restent nécessaires.
03 · LES RECETTES
Du brouillon à la validation.
Dans le journal, cliquez sur Nouvel encaissement. Renseignez la date, le montant, le libellé et la référence de la pièce. Le tiers, l’observation et la référence OP@LE peuvent être complétés si nécessaire.
- Brouillon : la recette participe au solde ; vous pouvez la supprimer avant validation.
- Validée : le contenu financier est verrouillé. Une annulation avec motif conserve l’écriture et la retire des totaux.
- Annulée : la recette reste visible avec son motif et son historique.
La référence OP@LE se recopie depuis le module régie. Elle est distincte du numéro interne et peut être complétée avec le bouton Réf. OP@LE tant que l’exercice reste ouvert. Le logiciel ne prédit pas les numéros attribués par OP@LE et ne synchronise pas les deux applications.
Un arrêté conserve le résultat du comptage physique et l’explication de l’écart. Il s’agit d’un instantané : une saisie rétroactive ne recalcule pas les arrêtés déjà enregistrés.
04 · LES DÉPÔTS D’ESPÈCES
Chaque billet, chaque pièce.
- Sélectionnez l’exercice ouvert, puis la rubrique Dépôts d’espèces.
- Renseignez la date et le numéro de bordereau.
- Saisissez les quantités par billets et pièces, de 500 € à 0,01 €. Le total se calcule automatiquement.
- Enregistrez et confirmez le dépôt : son montant est déduit du solde de caisse.
Solde de caisse = ouverture + recettes non annulées − dépôts non annulés.
Les contrôles sont faits en fin de journée. À date égale, les recettes sont classées avant les dépôts.
Le dépôt est lié à son exercice : l’historique et les totaux suivent l’année sélectionnée. La référence 2026-0001 distingue le premier dépôt de 2026 de celui d’une autre année. Un même bordereau actif ne peut pas être réutilisé dans un exercice.
Un dépôt enregistré ne se modifie ni ne se supprime. En cas d’erreur, annulez-le avec un motif, puis saisissez le dépôt corrigé. Le logiciel constate le mouvement ; il n’envoie pas de bordereau à la banque et ne déclenche aucune transaction.
05 · LES EXERCICES
Une base, plusieurs années.
Tous les exercices restent dans la même base SQLite. Le sélecteur Exercice consulté permet de passer de l’année ouverte aux années closes, sans déplacer de fichiers.
Clôturer et ouvrir l’année suivante
- Vérifiez les recettes, dépôts et références. Validez ou supprimez tous les brouillons.
- Exportez une sauvegarde complète.
- Cliquez sur Clôturer et ouvrir l’exercice suivant.
- Lisez le solde de clôture et saisissez manuellement le solde d’ouverture de l’année suivante, zéro compris. Ce montant n’est pas reporté automatiquement.
- Saisissez la confirmation demandée, par exemple
CLOTURER 2026, puis confirmez.
La clôture est définitive dans l’application. Les écritures, dépôts, références, arrêtés et paramètres de l’ancien exercice deviennent non modifiables. Une restauration ne permet pas d’annuler cette clôture dans la base existante.
La clôture et l’ouverture sont enregistrées ensemble dans une transaction. Les années closes restent consultables et exportables en PDF ou CSV. Il n’est plus nécessaire de créer un dossier séparé pour chaque année.
06 · LES SAUVEGARDES
Gardez une copie indépendante.
SQLite enregistre automatiquement chaque action réussie. Conservez aussi une sauvegarde sur un autre support autorisé : le bouton Sauvegarder exporte un fichier JSON contenant tous les exercices, les historiques, les paramètres et les arrêtés.
Si le navigateur autorise son sélecteur de fichier, choisissez directement le dossier et le nom. Sinon, activez Toujours demander où enregistrer les fichiers dans ses paramètres de téléchargement, puis utilisez le bouton proposé. Sans ce réglage, le navigateur utilise son dossier habituel ; vérifiez la présence du fichier.
Restaurer une sauvegarde
Cliquez sur Restaurer une sauvegarde, choisissez le JSON puis confirmez. Sauvegardez d’abord les données actuelles à conserver. Les exercices déjà clos doivent rester strictement identiques : une sauvegarde antérieure à leur clôture est refusée dans cette base.
Pour copier directement caisse.sqlite, arrêtez d’abord le moteur. Les données ne sont pas chiffrées.
Mettre l’application à jour
Arrêtez le lanceur et conservez une copie de la base. Décompressez la nouvelle version, puis placez la base à côté de l’exécutable. La version 2.0 intègre automatiquement l’ancien exercice comme exercice ouvert et conserve le contenu précédent dans migration_backup. Aucun exercice n’est clôturé automatiquement. N’utilisez plus un ancien exécutable sur une base convertie.
07 · PDF ET CSV
Vos historiques, à emporter.
Dans le journal, cliquez sur Extraire les encaissements en PDF. Choisissez les dates de début et de fin incluses dans l’exercice consulté, puis Préparer le PDF. Dans le dialogue du navigateur, sélectionnez Enregistrer au format PDF.
L’état contient les références, les statuts et les totaux. Les brouillons sont inclus ; les annulations restent visibles et sont exclues du total. La recherche à l’écran ne limite pas cette extraction.
Le CSV du journal contient toutes les recettes de l’exercice sélectionné, même si l’affichage est filtré. L’historique des dépôts dispose de sa propre impression PDF et de son export CSV, également liés à l’exercice consulté.
08 · QUITTER ET TRANSPORTER
Votre caisse vous accompagne.
Transportez le dossier complet, avec l’exécutable et caisse.sqlite. Vous retrouvez vos exercices sur un autre poste compatible, sans restauration à chaque déplacement.
Fermer le dernier onglet arrête le processus après environ cinq secondes. Un rafraîchissement rapide ne le coupe pas. Si un autre onglet de l’application reste ouvert, le moteur continue. Le bouton Arrêter l’application reste disponible.
Attendez la fermeture du lanceur, puis éjectez le support depuis le système avant de retirer la clé USB. Les formulaires non enregistrés ne sont pas sauvegardés en fermant l’onglet.
09 · DÉPANNAGE
Retrouver le bon fil.
« Une autre instance utilise ce dossier »
Un processus précédent est probablement encore actif. Arrêtez son lanceur avec Ctrl+C ou son bouton Arrêter, puis relancez. Un ancien processus lancé avant l’arrêt automatique doit être fermé une fois manuellement. Ne supprimez pas la base pour résoudre ce message.
L’application ne s’ouvre pas sous Linux
Ouvrez un terminal dans le dossier et exécutez sh ./Lancer-Fil-de-caisse-Linux.sh. Consultez le message ou Fil-de-caisse-demarrage.log. Une architecture incorrecte, un support interdisant les exécutables ou des droits insuffisants peuvent bloquer le lancement. Le journal ne copie ni écritures comptables ni lien de session.
« Base non vérifiée · contrôle impossible » ou erreur 404
Dans le même navigateur, ouvrez l’adresse courante suivie de /api/health. Une réponse 404 signifie que le serveur ne propose pas ce contrôle, notamment avec un ancien lanceur ; elle ne prouve pas une corruption. Arrêtez l’ancien moteur, gardez une copie du dossier, puis utilisez l’exécutable actuel avec votre base. Le port change à chaque lancement : utilisez la nouvelle adresse.
Le navigateur ne s’ouvre pas automatiquement
Copiez le lien affiché dans la fenêtre du lanceur et ouvrez-le dans le navigateur. Gardez le lanceur actif pendant l’utilisation. Si le moteur est arrêté, relancez l’application pour obtenir un nouveau lien.
Un enregistrement est refusé après une saisie dans un autre onglet
Rechargez pour récupérer la dernière version des données avant de recommencer. Le serveur empêche qu’un onglet périmé écrase des écritures plus récentes. Utilisez un seul onglet de saisie à la fois.
10 · CADRE ET LICENCE
Un outil auxiliaire, libre.
Fil de caisse est un journal individuel. Il ne remplace ni OP@LE, ni les pièces justificatives originales, ni les contrôles réglementaires. Les données ne sont pas chiffrées. Le verrouillage des exercices est assuré dans l’application, mais ne protège pas d’une modification externe ou du remplacement physique de la base.
Le logiciel est partagé sous GNU GPL version 3 uniquement. Vous pouvez l’utiliser, l’étudier, le modifier et le redistribuer selon cette licence. Les données comptables restent indépendantes de la licence du logiciel.
Le site n’utilise ni cookies de suivi, ni statistiques externes, ni polices chargées depuis un tiers. L’hébergeur peut conserver les journaux techniques habituels du serveur.