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

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 - <jours> 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 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), 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 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