- Créer un dossier : bouton + Nouveau client dans la barre latérale. Choisir le type avant de saisir.
-
Deux types de clients :
- Particulier : prénom + nom requis, téléphone et email facultatifs.
- Professionnel : recherchez l'entreprise par nom ou SIRET — les champs (raison sociale, SIRET, adresse, N° TVA) se pré-remplissent automatiquement depuis l'API officielle Recherche Entreprises (données INSEE). Ajoutez ensuite le contact au sein de l'entreprise.
- Champs professionnels : raison sociale, SIRET, N° TVA intracommunautaire (calculé automatiquement depuis le SIREN). Ces informations apparaissent dans la section "Facturé à" de la facture.
- Importer en masse : depuis un fichier CSV, via Clients → Importer. Les doublons (même nom + téléphone) sont fusionnés.
- Fiche client : 4 onglets — Fiche, Prestations, Fiche soin (Sérénité), Communication (Sérénité).
- Recherche : index alphabétique ou champ de recherche. Pour les professionnels, la recherche fonctionne aussi sur la raison sociale et le SIRET. Pagination automatique.
- Multi-praticiens : chaque praticien ne voit que ses propres clients.
- Créer un rendez-vous : depuis l'agenda (clic sur un créneau) ou depuis la fiche client → onglet Prestations → bouton +.
- Modale en deux onglets :
- Prestation : date, heure, prestation (durée et prix affichés en lecture seule à titre indicatif), statut, rappel SMS, bilan clinique et bilan énergétique (Sérénité).
- Facturation & Paiement : montant, statut de règlement, remise. Ces champs sont verrouillés dès qu'une facture a été émise.
- Prestations sans durée fixe : si une prestation est configurée sans durée (Réglages → Prestations → Sans durée fixe), le champ Durée est masqué et la colonne ne figure pas dans la facture.
- Statuts rapides après la prestation :
- Réalisée : verrouille la prestation et permet la facturation.
- Annulée : ne compte pas dans le CA.
- Reportée : invite à saisir la nouvelle date directement.
- Verrou temporel : une prestation passée ne peut plus être supprimée ni voir sa date / son type modifiés. Les notes restent éditables.
- Bilan clinique & énergétique (Sérénité) : intégré dans l'onglet Prestation — motif, observations, exercices, intention pour la prochaine prestation, bilan des méridiens, élément dominant, synthèse MTC.
- Une prestation marquée réalisée propose le bouton 🧾 Facturer. La prestation est marquée réglée et le numéro de facture est attribué automatiquement.
- La facture Factur-X (PDF/A-3 avec XML intégré, norme EN 16931) est générée et téléchargée immédiatement.
- Les remises (Réglages → Remises) s'appliquent au montant saisi dans l'onglet Facturation & Paiement de la prestation, avant émission.
- Cliquer 🧾 Facturer : la facture est émise et le PDF Factur-X est téléchargé, mais la prestation reste en attente de règlement.
- Une fois le virement ou le chèque reçu, ouvrir la facture dans l'onglet Facturation de la barre latérale et cliquer ✓ Marquer comme acquittée.
- La fiche affiche ensuite le statut Réglée avec la date d'acquittement.
- Dès qu'une facture est émise, le montant, la prestation et la remise de la prestation sont verrouillés et ne peuvent plus être modifiés.
- La colonne Durée n'apparaît dans la facture que si la prestation a une durée fixe.
- Le nommage des colonnes TVA s'adapte automatiquement selon le régime fiscal renseigné dans les paramètres (art. 293 B du CGI par défaut).
La facturation s'appuie sur deux compteurs distincts. Bien faire la différence évite les mauvaises surprises.
- Lancement : 5 factures / mois
- Essor : 25 factures / mois
- Sérénité : illimité
Rechargement automatique : le compteur se base sur le mois calendaire en cours. Le 1er du mois à 00:00, vous retrouvez l'intégralité de votre quota. Aucune action requise, aucun report.
- Achetés en packs (dès 6 €).
- Solde permanent, sans date d'expiration.
- Consommés uniquement au-delà du quota mensuel, 1 crédit par facture.
Pas de rechargement automatique : les crédits ne sont jamais ajoutés ni remis à zéro tout seuls. Ils ne bougent qu'à l'achat (+) ou à la consommation hors quota (−).
- Si vous êtes sous le quota du mois → facture émise, aucun crédit consommé.
- Si vous êtes au quota et que des crédits sont disponibles → facture émise, 1 crédit décompté.
- Si vous êtes au quota et sans crédit → émission bloquée. Choisir : acheter un pack ou monter d'offre.
- Vous achetez un pack de 10 crédits.
- Mois 1 : 27 factures émises → 25 dans le quota + 2 consomment des crédits. Reste : 8 crédits.
- Mois 2 : le quota repart à 25, et vous gardez vos 8 crédits en réserve.
- Clients suivis : total + nouveaux du mois ou clients actifs sur 90 jours.
- Prestations : volume du mois en cours, comparaison à N-1.
- Chiffre d'affaires (Sérénité) : encaissé vs facturation émise.
- Alertes : prestations en attente de validation, factures impayées, clients sans nouvelle depuis longtemps.
- Top clients : par fréquence ou par CA, sur la période choisie.
- Modèles (Réglages → Comms) : préparation de visite, relance, compte-rendu, demande d'avis Google. Variables :
{{first_name}},{{session_date_label}},{{google_review_url}}. - Envoi : depuis la fiche client → onglet Communication, choix du canal (SMS ou email) et du modèle.
- Historique : toutes les communications envoyées sont tracées par client (statut, date, contenu).
- Rappels J-1 automatiques : voir la section technique plus bas.
- Connexion en un clic depuis la barre d'état (bouton Drive off / Drive).
- Les fiches client et les bilans de prestation sont sauvegardés en PDF dans le dossier configuré (Réglages → Google).
- Le bouton ✓ vérifie la cohérence des fichiers Drive vs base locale.
- Déconnexion : même bouton, le token est purgé immédiatement.
android_queue
dans les réglages.
-
1Installer Termux et Termux:API depuis F-Droid (pas depuis le Play Store — version Play Store obsolète). Ouvrir Termux:API au moins une fois après installation.
-
2Dans Termux, lancer la commande d'installation en une seule fois :Pour multi-SIM, ajouter
curl -fsSL "https://demo.serengest.app/api/cabinet/termux/bootstrap" \ -H "X-Api-Key: DEMO_NO_API" | bash?sim=0ou?sim=1à l'URL. -
3Le script installe automatiquement :
python,cronie,termux-api, configure le cron toutes les 10 min et gère le redémarrage Android via Termux:Boot. Installer l'app Termux:Boot depuis F-Droid pour que crond redémarre automatiquement. -
4Tester manuellement l'envoi depuis Termux :Les logs sont dans
python3 ~/scripts/termux-sms-queue.py~/sms-queue.log.
status=prepared →
Termux envoie via antenne Android → status=sent ou error
android_queue que Termux.
-
1Installer MacroDroid depuis le Play Store. Créer un nouveau macro Cabinet SMS avec un déclencheur Minuterie périodique → 10 min.
-
2Action 1 — Requête HTTP GET pour récupérer la file :
GET https://demo.serengest.app/api/cabinet/sms/queue En-tête : X-Api-Key → DEMO_NO_API Réponse → variable : queue_response -
3Action 2 — Boucle Pour chaque : source = tableau JSON, variable JSON =
{queue_response}, JSONPath =$.items, variable de boucle =item. -
4Dans la boucle — extraire
$.id→sms_id,$.to→sms_to,$.message→sms_messagevia Variables → Définir (JSONPath). -
5Messages → Envoyer un SMS : numéro =
{sms_to}, message ={sms_message}. -
6Requête HTTP POST pour confirmer l'envoi (ACK) :
POST https://demo.serengest.app/api/cabinet/sms/queue/{sms_id}/ack En-tête : X-Api-Key → DEMO_NO_API Corps : {"status":"sent"} -
7Terminer par une Fin de boucle et optionnellement une notification SMS Cabinet envoyés ✓.
La clé API (X-Api-Key)
permet aux scripts externes (Termux, MacroDroid) d'accéder à l'API sans session Grav.
Si un Token push (sms_push_token) est configuré, les scripts Android l'utilisent à la place.
Elle doit être longue, aléatoire et gardée secrète.
DEMO_NO_API
-
1Pour changer la clé, aller dans Plugins → Cabinet → Clé API et saisir une nouvelle valeur. Exemple de génération :
openssl rand -hex 32dans un terminal. -
2Après changement, retélécharger les scripts Termux pour que la nouvelle clé soit injectée :
curl -fsSL "https://demo.serengest.app/api/cabinet/termux/bootstrap" \ -H "X-Api-Key: NOUVELLE_CLE" | bash -
3Mettre à jour la clé dans le macro MacroDroid si vous l'utilisez (en-têtes des deux requêtes HTTP).
-
1Activer SMS dans les réglages (sms_enabled → Oui) et choisir un provider.
-
2Ajouter le scheduler Grav au cron du serveur :Vérifier dans Outils → Scheduler que le job
* * * * * cd /chemin/vers/grav && php bin/grav scheduler 1>> /dev/null 2>&1cabinet-sms-rappelsapparaît. -
3Par prestation, cocher "Désactiver le rappel SMS J-1" pour exclure un rendez-vous spécifique.
-
En retard€€
Générez un lien sécurisé à envoyer par email ou SMS — votre cliente paie par carte en quelques clics.
Après combien de prestations payantes votre client reçoit-il une prestation gratuite ?
Fichier attendu :