Installation

Téléchargement

Téléchargez l'archive zip du module depuis le DoliStore ou depuis votre espace client CAP-REL.

Prérequis techniques

Avant d'installer le module, vérifiez que les extensions PHP suivantes sont installées et chargées sur votre serveur :

S'il en manque une, l'onglet Serveur de la configuration du module l'indique et ne s'affiche pas plus loin.

Le module GED (Gestion Électronique de Documents) de Dolibarr est également nécessaire : UptoSign en dépend pour le stockage des fichiers joints et l'active automatiquement s'il ne l'est pas encore.

Installation du module

1. Connectez-vous en tant qu'administrateur Dolibarr
2. Allez dans Accueil > Configuration > Modules/Applications
3. Ouvrez l'onglet Déployer/Installer un module externe
4. Sélectionnez l'archive zip téléchargée et envoyez-la

L'archive contient tout ce dont le module a besoin : aucune autre opération n'est nécessaire sur le serveur.

Activation

1. Dans Accueil > Configuration > Modules/Applications, recherchez "UptoSign"
2. Cliquez sur le bouton d'activation du module

À l'activation, le module :

• prépare ses données et vérifie qu'elles sont complètes : si une partie n'a pas pu être créée, l'activation est refusée et un message d'erreur s'affiche, ce qui vous évite de travailler avec un module incomplet ;
• installe des configurations prêtes à l'emploi pour les modèles PDF standard de Dolibarr : cyan et azur (propositions commerciales), einstein (commandes clients), cornas et muscadet (commandes fournisseurs), aurore (propositions commerciales fournisseurs), crabe (factures), strato (contrats), soleil (fiches d'intervention), espadon, merou et rouget (expéditions). Une configuration dont le modèle PDF n'est pas disponible sur votre Dolibarr est désactivée ;
• ajoute les types de contact Signature électronique (client) et Signature électronique (vendeur) sur les documents, ainsi que le champ Signature électronique sur les devis, commandes, contrats, projets et propositions commerciales fournisseurs ;
• installe ses modèles d'e-mails (voir la page Utilisation) ;
• vous avertit par un message lorsqu'une version plus récente du module est disponible.

Sécurité Dolibarr

L'onglet Serveur de la configuration du module vérifie que l'algorithme de chiffrement des mots de passe de Dolibarr est défini (constante MAIN_SECURITY_HASH_ALGO). S'il ne l'est pas, l'onglet affiche le message "La configuration sécurité de votre dolibarr est incomplète (système de chiffrement des mots de passe et autres clés de sécurité)" et n'affiche pas les identifiants de connexion tant que la situation n'est pas corrigée. Sans cette configuration, les liens envoyés à vos clients pour consulter et signer les documents risquent de ne pas fonctionner.

Consultez la documentation technique de sécurité pour mettre votre Dolibarr en conformité.

Premier paramétrage

Après activation, cliquez sur l'icône de configuration du module dans Accueil > Configuration > Modules/Applications. Le module présente plusieurs onglets détaillés dans la page Configuration.

Les étapes minimales pour démarrer sont :

1. Configurer le serveur (onglet Serveur) - Choisissez le serveur (production ou démonstration), renseignez vos identifiants, acceptez les conditions générales, enregistrez puis cliquez sur Tester la connexion.
2. Définir l'utilisateur par défaut (onglet Paramètres UptoSign) - Sélectionnez l'utilisateur Dolibarr associé aux actions faites sans utilisateur connecté (page publique, tâches planifiées).
3. Vérifier les configurations de documents (onglet Modèles de documents) - Contrôlez les configurations installées pour vos modèles PDF et créez celles qui manquent.
4. Donner les permissions (Accueil > Utilisateurs & Groupes, onglet Permissions) - Accordez Lancer un processus de signature ou scellement d'un document aux utilisateurs qui doivent faire signer ou sceller des documents : seules les permissions de lecture sont données par défaut. Le détail est dans la section Permissions.

Mise à jour

1. Téléchargez la nouvelle archive zip du module
2. Installez-la par Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe, comme lors de la première installation
3. Désactivez puis réactivez le module dans Accueil > Configuration > Modules/Applications : cette étape applique les mises à jour des données et enregistre les nouvelles fonctionnalités et permissions

Si vous oubliez l'étape 3, le module affiche "Module UptoSign : attention, la version de votre module n'est pas cohérente avec la version de la base de données, pensez bien à désactiver et réactiver le module..." sur l'onglet Signature électronique des documents et sur l'onglet Position de la signature des enveloppes de signature en masse.

[!NOTE] La désactivation conserve toutes les données du module : signatures et leur historique, liens vers les documents signés, enveloppes de signature en masse (menu Signatures multiples) et leurs destinataires, configurations de documents et paramètres. La réactivation les retrouve telles quelles.

Une version plus ancienne du module effaçait ces données à la désactivation sur l'entité principale, après en avoir sauvegardé une partie. Si c'est votre cas, la réactivation restaure ce que contient cette sauvegarde : les signatures, vos paramètres et vos configurations de documents personnalisées. Les enveloppes de signature en masse et les liens vers les documents signés effacés à ce moment-là ne peuvent pas être récupérés.

Désinstallation

Désactivez le module depuis Accueil > Configuration > Modules/Applications. Les documents signés déjà rapatriés restent dans les fichiers joints de vos fiches Dolibarr. La désactivation ne supprime aucune donnée du module, sur l'entité principale comme sur les entités secondaires.