--- title: "FAQ" weight: 50 description: "Questions fréquentes sur le module SmartInterventions pour Dolibarr." --- # FAQ ## Installation et activation ### Le module ne s'active pas, que faire ? Vérifiez que tous les modules requis sont activés : Tiers, Interventions, Produits, Services, Tâches planifiées (Cron), Facturation, ECM et SmartAuth. SmartInterventions ne peut pas s'activer si l'une de ces dépendances manque. ### Comment savoir quelle version du module est installée ? Rendez-vous dans l'onglet **À propos** de la configuration du module (**Accueil > Configuration > Modules > SmartInterventions > À propos**). La version du module y est affichée. ## Application smartphone ### Comment connecter un smartphone ? Allez dans l'onglet **Smartphones** de la configuration du module. Un QR Code est affiché en bas de la page. Scannez-le avec l'appareil photo du smartphone ou saisissez l'adresse dans le navigateur du téléphone. L'authentification utilise le module SmartAuth. ### L'application ne se charge pas sur le smartphone - Vérifiez que l'adresse de l'hôte virtuel est correcte dans l'onglet **Généralités** - Assurez-vous que le serveur est accessible depuis l'extérieur (pare-feu, certificat SSL) - Si vous n'avez pas d'hôte virtuel dédié, utilisez le service [DoliProxy](https://doliproxy.fr) ### Les interventions n'apparaissent pas sur le smartphone du technicien L'application mobile interroge l'API `/interventions/mine` qui filtre les fiches d'intervention selon plusieurs critères croisés. Si une fiche que vous attendez n'apparaît pas, vérifiez les points suivants **dans l'ordre** : #### 1. Le contact INTERVENING interne est-il posé ? L'API ne renvoie que les fiches où le technicien est lié comme contact de **type INTERVENING**, **source `internal`**. Sur la fiche d'intervention dans le backoffice : - Onglet **Contacts** - Section **Intervenants** - Le technicien doit apparaître comme intervenant (et pas seulement comme contact client/externe) C'est le piège le plus fréquent : un admin qui ajoute le technicien dans la section "Contacts du tiers" (source `external`) au lieu des "Intervenants" (source `internal`) ne le voit pas apparaître côté mobile. #### 2. La fiche a-t-elle une ligne satellite SmartInterventions ? L'API "Mes interventions" fait une jointure INNER avec la table satellite `llx_smartinterventions_smartinterventions`. Si la fiche n'a JAMAIS eu de donnée SmartInterventions enregistrée, **la ligne satellite n'existe pas** et la requête l'exclut silencieusement. Cela arrive quand un admin crée une fiche d'intervention via le formulaire Dolibarr standard sans jamais ouvrir l'onglet SmartInterventions ni passer par le bouton "Démarrer" depuis l'application mobile. **Solution** : ouvrez la fiche, allez sur l'onglet SmartInterventions, posez au moins un champ (par exemple la date d'intervention prévue) puis enregistrez. La fiche sera désormais visible côté technicien. #### 3. La date d'intervention prévue tombe-t-elle dans la fenêtre d'affichage ? Le paramètre **Nombre de jours d'historique maximum** (`SMARTINTERVENTION_MAX_HISTORY_DAYS` dans la configuration) définit combien de jours en arrière l'API regarde. Toute fiche dont `smartinterventions_date_inter` est antérieure à `aujourd'hui - ` ou postérieure à `aujourd'hui 23:59:59` est exclue. Par défaut ce paramètre est désactivé (la limite est alors de 50 fiches retournées, sans contrainte de date). Si vous l'avez configuré à une valeur trop courte (ex. 1 jour), une intervention prévue après-demain n'apparaît pas. #### 4. Le tiers de la fiche est-il valide ? L'API exige `f.fk_soc > 0`. Une fiche sans tiers (cas rare, hérité d'imports anciens) est exclue. Vérifiez dans le backoffice qu'un tiers est bien assigné à la fiche. #### 5. Le statut SmartInterventions est-il dans une catégorie affichée ? L'application groupe les fiches par statut SmartInterventions (`STATUS_INPROGRESS`, `STATUS_TOCOMPLETE`, `STATUS_DONE`, etc.). Les statuts intermédiaires comme `STATUS_PLANED` (planifiée) ou `STATUS_VALIDATED` (validée) **ne sont pas regroupés** dans les blocs de la page d'accueil mobile -- elles apparaissent quand même dans la liste complète à `/interventions` mais pas dans les compteurs "En cours" / "À compléter" / "Terminée" de l'écran d'accueil. Si la fiche existe pour le technicien mais ne s'affiche que dans la liste, c'est normal : ouvrez **la liste complète** depuis le raccourci "Mes interventions" plutôt que d'attendre qu'elle apparaisse dans un bloc de statut. ##### Sémantique des statuts pilotés par la PWA - **STATUS_INPROGRESS** ("En cours") : le technicien est en train de travailler sur la fiche, le bureau le voit en quasi-temps réel. Le passage à ce statut est automatique dès qu'il clique sur le bouton d'ouverture du formulaire ("Débuter", "Compléter", "S'assigner") depuis le panneau de détail. La règle "un seul INPROGRESS par technicien à la fois" est garantie côté serveur : démarrer une 2e fiche bascule la précédente en `STATUS_TOCOMPLETE` automatiquement et trace les deux transitions dans le journal des événements (onglet Agenda de la fichinter). - **STATUS_TOCOMPLETE** ("À compléter") : le technicien a quitté le client mais doit y revenir (pièce à commander, photo manquante, signature à récupérer). Posé via le bouton **"À recompléter"** en bas du formulaire. Pas de signature requise. - **STATUS_DONE** ("Terminée") : prestation terminée et signée (technicien + client). Posé via le bouton **"Clôturer et signer"** en bas du formulaire. Les deux signatures sont obligatoires ; le serveur fait `setValid()` sur la fichinter Dolibarr et la fiche sort de DRAFT. #### 6. L'entité multi-company est-elle la bonne ? En contexte multi-company, la fiche n'apparaît que si elle est dans une entité que le technicien voit. Vérifiez l'entité de la fiche (champ `f.entity` en base) et celle du compte technicien. #### 7. Le filtre "non-urgent" exclut-il les urgences ? Avec la valeur par défaut de **`SMARTINTERVENTION_LIST_MINE_WITH_URGENT = -1`**, le filtre "Mes interventions" exclut les fiches marquées urgentes (elles apparaissent dans le filtre "Urgentes" séparé). Si vous voulez voir vos urgences dans "Mes interventions", activez l'option **Afficher les urgences dans "Mes interventions"** dans l'onglet **Smartphones** de la configuration (cf. la question dédiée plus bas). #### Vérification rapide en cas de doute Demandez à l'admin de : 1. Aller sur la fiche d'intervention manquante 2. Cliquer sur l'onglet **Contacts** 3. Confirmer la présence du technicien dans **Intervenants** (source interne) 4. Cliquer sur l'onglet **SmartInterventions** 5. S'assurer qu'une **date d'intervention prévue** est saisie 6. Enregistrer Puis sur le smartphone : tirer vers le bas pour synchroniser. La fiche doit apparaître. ### Comment afficher les interventions urgentes dans la liste principale du technicien ? Activez l'option **Afficher les urgences dans "Mes interventions"** dans l'onglet **Smartphones** de la configuration. ## Signatures ### Quelle différence entre la signature dans le formulaire et la signature en ligne ? Deux modes coexistent : - **Signature dans le formulaire** (par défaut, toujours active) : deux cadres `SignaturePad` côte à côte en bas du formulaire d'intervention, l'un pour le technicien, l'autre pour le client. Les deux signatures sont envoyées en même temps que le compte rendu. Aucune option admin à activer. - **Signature en ligne** (optionnelle) : popup déclenché après l'envoi du formulaire quand le client n'est pas physiquement présent. Permet une pseudo-signature sur le même appareil ou un lien à transmettre au client. Pilotée par les options **Activer la signature des fiches d'intervention** et **Demander la signature quel que soit le statut**. Les deux modes écrivent dans la même colonne (`si_sign_customer`) côté client et le PDF est régénéré pour intégrer l'image. ### La signature en ligne n'est pas proposée au client Cette FAQ ne concerne **que** le mode "signature en ligne" (popup post-validation). Les cadres dans le formulaire sont toujours présents indépendamment de ces options. - Vérifiez que l'option **Activer la signature des fiches d'intervention** est cochée dans l'onglet Généralités - Par défaut, la signature n'est proposée que pour les interventions au statut **Terminé**. Pour la proposer quel que soit le statut, activez l'option **Demander la signature quel que soit le statut**. ### Comment forcer le technicien à faire signer le client ? Activez l'option **Masquer le bouton "retour menu principal" pour forcer la signature** dans la configuration. Le technicien ne pourra pas quitter l'intervention sans avoir recueilli la signature. ## Documents PDF ### Comment activer le modèle Dossier complet ? 1. Dans l'onglet **PDF** de la configuration SmartInterventions, activez l'option **Activer le modèle d'export "Dossier SmartInterventions"** 2. Rendez-vous dans **Accueil > Configuration > Modules > Interventions > Modèles de document des fiches d'intervention** 3. Activez et sélectionnez le modèle SmartInterventions ### Les photos n'apparaissent pas dans le PDF Les photos doivent être attachées à la fiche d'intervention via le module ECM. L'application smartphone les enregistre automatiquement au bon emplacement. Si vous ajoutez des photos manuellement, assurez-vous qu'elles sont dans le répertoire de documents de la fiche d'intervention. ### Comment personnaliser l'arrière-plan des PDF ? Dans l'onglet **PDF**, section **Personnalisation des documents PDF générés**, téléversez vos images (formats JPG, JPEG, PNG acceptés). Sélectionnez ensuite l'image souhaitée pour la page de garde et pour les pages suivantes. ## Schémas de données ### Où trouver des schémas prêts à l'emploi ? Le site [schemas.cap-rel.fr](https://schemas.cap-rel.fr/) propose une base de données de schémas que vous pouvez télécharger et importer directement dans SmartInterventions. ### Comment créer un schéma personnalisé ? Créez un fichier JSON respectant le format attendu (voir [Configuration > Onglet Types d'intervention](/smartinterventions/configuration)), puis importez-le depuis l'onglet **Types d'intervention** de la configuration. ### Que se passe-t-il si je supprime un schéma ? La suppression d'un schéma entraîne la suppression définitive de la table de données associée et de toutes les données saisies par les techniciens pour ce schéma. Cette action est irréversible. ### J'ai associé un type d'intervention mais ses champs n'apparaissent pas sur le smartphone Les champs d'un type d'intervention (schéma) sont chargés sur l'appareil lors de la **synchronisation**. Après avoir importé un schéma ou associé un type d'intervention à une fiche côté back-office, lancez une **synchronisation** dans l'application puis rouvrez la fiche : les champs spécifiques apparaissent alors sous le compte rendu. Vérifiez également que le **type d'intervention** est bien renseigné sur la fiche et que les champs concernés sont marqués comme **visibles** dans le schéma (un champ non visible reste volontairement masqué dans le formulaire). Les champs marqués **obligatoires** doivent être renseignés pour que l'enregistrement aboutisse. ## Application mobile -- fonctionnalités avancées ### Comment installer l'application sur l'écran d'accueil du smartphone ? L'application est une PWA (Progressive Web App). Sur Android (Chrome), appuyez sur le menu puis **Installer l'application**. Sur iOS (Safari), appuyez sur l'icône de partage puis **Sur l'écran d'accueil**. L'application s'ouvre ensuite en plein écran comme une application native. ### Comment activer la vue calendrier par défaut ? Dans l'application mobile, allez dans **Paramètres > Interventions** et activez **Mode calendrier (par défaut)**. Vous pouvez aussi basculer entre les vues liste et calendrier à tout moment via l'icône calendrier en haut de la page des interventions. ### Mon brouillon a disparu, que s'est-il passé ? Les brouillons sont stockés localement sur l'appareil. Si vous changez d'appareil, si vous supprimez les données du navigateur ou si vous réinitialisez les paramètres de l'application, les brouillons sont perdus. Soumettez vos comptes rendus dès que possible pour éviter toute perte. ### Comment changer la langue de l'application mobile ? Dans l'application, allez dans **Paramètres > Langue et formats** et sélectionnez la langue souhaitée dans la liste déroulante. ### Comment utiliser le champ coordonnées GPS ? Si un schéma d'intervention contient un champ de type `coordinates`, les coordonnées GPS saisies s'affichent comme un lien cliquable. En appuyant dessus, l'application de cartographie de votre téléphone s'ouvre pour vous guider vers l'emplacement. ## Éditeur visuel PDF ### Comment créer un modèle PDF personnalisé ? Rendez-vous dans l'onglet **Types d'intervention (Schémas)** de la configuration du module. L'éditeur visuel permet de concevoir des mises en page PDF par glisser-déposer. Consultez la [documentation de configuration](/smartinterventions/configuration) pour les détails sur les éléments disponibles. ### Comment utiliser un modèle créé avec l'éditeur visuel ? Après avoir sauvegardé votre mise en page dans l'éditeur, le modèle "schemalayout" apparaît dans la liste des modèles de document des fiches d'intervention (**Accueil > Configuration > Modules > Interventions > Modèles de document**). Activez-le et sélectionnez-le comme modèle par défaut. ## Agenda ### Les interventions ne s'ajoutent pas à l'agenda du technicien Vérifiez que l'option **Ajouter automatiquement sur l'agenda** est activée dans l'onglet Généralités. Le type d'événement utilisé est celui configuré dans le champ **Type d'événement** de la fiche d'intervention. ## Emails ### Le compte rendu n'est pas envoyé au client - Vérifiez que l'option **Envoyer automatiquement le compte rendu au client** est activée (globalement ou sur l'intervention spécifique) - Vérifiez qu'un modèle de mail de type "interventions" existe et est sélectionné dans la configuration - Vérifiez que l'adresse d'expéditeur est autorisée par votre serveur de messagerie