Module uptosign pour dolibarr dolibarr-uptosign

Sur les listes factures, propositions, commandes, contrats, fiches d'intervention, expéditions et projets : sélectionner plusieurs documents validés avec PDF, choisir "Sceller un lot de ... (via uptosign)". Attendu : chaque document est scellé individuellement selon la configuration de son modèle ; un document sans PDF, sans configuration ou avec procédure en cours est signalé et ignoré sans bloquer les autres ; l'action n'apparaît pas sans le droit "Lancer un processus..." ; rejouer l'action ne crée pas de doublon.

Depuis un module consommateur, lancer une signature d'un objet via uptosignCore : avec un PDF de l'objet, un PDF du tiers de l'objet, un PDF d'un autre objet, et sans objet. Attendu : les deux premiers sont envoyés ; le PDF étranger et l'appel sans objet sont refusés et loggués ; la liste "qui peut signer" retournée est celle de la fenêtre de positionnement ; l'interface ArrayAccess reste compatible avec les consommateurs existants.

Onglet Automatisations : activer la création de facture, le scellement de cette facture, l'envoi par e-mail et choisir le modèle d'e-mail. Faire signer un devis. Attendu : une facture est créée depuis le devis et liée à lui ; elle est scellée ; elle est envoyée au client avec le modèle choisi (événement AC_BILL_SENTBYMAIL) ; rejouer le webhook ne crée pas de seconde facture ni de second envoi. Si le module Workflow crée déjà une commande à la signature, l'onglet affiche l'avertissement.

1. Activer "Fermeture automatique d'une commande lors de sa signature", faire signer une commande : elle est classée livrée.
2. Option désactivée : la commande garde son état.
3. Annuler la procédure côté UptoSign puis ouvrir la fiche de la commande : elle passe à l'état annulé (sur Dolibarr 23+, via cancel($user)).

Activer "Activer automatiquement tous les services à la signature du contrat". Faire signer un contrat comportant plusieurs lignes de services inactives. Attendu : toutes les lignes passent à l'état actif avec la date de signature. Option désactivée : les lignes restent inactives.

1. Compte UptoSign normal : les onglets Distributeurs (1) et (2) affichent "Compte utilisateur normal" et rien d'autre.
2. Compte revendeur : Distributeurs (1) permet de régler les assistants et les services (abonnement, signatures, scellements), enregistrés après rechargement ; Distributeurs (2) liste "Mes clients" avec le tiers de même e-mail et son contrat, et les données de consommation des 6 derniers mois. Attendu : les valeurs venant du serveur sont échappées ; les actions exigent le jeton.

Compte revendeur, assistants activés. Pour un client sans contrat, utiliser le bouton de création de contrat, puis celui de création contrat + première facture + facture modèle récurrente. Attendu : le contrat est créé sur le bon tiers avec les services configurés ; la facture et la facture modèle sont créées et liées ; un second clic ne crée pas de doublon.

Onglet Modèles de documents :

1. Nouveau : choisir un modèle (ex. propal:cyan) et "Signature", créer.
2. Modifier : saisir Sceau (position) x,y, Page du sceau, Signature (position), Page de la signature ; enregistrer, les valeurs sont conservées.
3. Naviguer avec les flèches entre configurations, ouvrir la Liste.
4. Désactiver : les boutons UPTOSIGN du devis cyan sont grisés "Il n'y a pas de configuration pour ce modèle de document" ; Activer : ils redeviennent actifs.
5. Supprimer : la configuration disparaît.

Sur une configuration en modification, déplacer les étiquettes du sceau et de la signature sur l'aperçu du PDF, enregistrer. Attendu : les coordonnées en millimètres sont mises à jour en cohérence avec la position visuelle ; une signature lancée ensuite sur ce modèle place sceau et signature à cet endroit sur le PDF signé.

Configurer Page de la signature = -1 et Page du sceau = -3. Sceller/signer un document de 2 pages puis un de 6 pages (CGV en fin). Attendu : la signature est toujours sur la dernière page ; le sceau est sur la 3e page avant la fin ; si le document a moins de pages que demandé, la page retenue reste dans le document (pas d'erreur de l'API).

1. Utilisateur sans "Lire la configuration UptoSign" : la liste et la fiche des configurations sont refusées. Avec lecture seule : pas de boutons Nouveau/Modifier/Supprimer. Supprimer exige le droit dédié.
2. Saisir (ou forger en POST) un nom de modèle du type "propal:../../x" ou un nom inexistant. Attendu : refusé avec message, aucun fichier inclus en dehors des modèles PDF Dolibarr.

Laisser vide "Compte utilisateur dolibarr à utiliser par défaut en cas d'action anonyme" puis ouvrir l'onglet "Signature électronique" d'un devis. Attendu : un message d'erreur indique que ce réglage manque. Le renseigner : le message disparaît, et les actions sans utilisateur connecté (page publique, webhook, tâches planifiées) sont faites au nom de cet utilisateur (visible dans les événements créés).

1. Suffixes "signe" et "preuves" : faire signer PR2201-0001.pdf, rapatrier ; attendu PR2201-0001-signe.pdf et PR2201-0001-preuves.pdf à côté de l'original.
2. Suffixes vides : attendu PR2201-0001-signed.pdf et PR2201-0001-proof.pdf.
3. Suffixes identiques : les deux fichiers ne s'écrasent pas. Dans tous les cas le PDF d'origine n'est jamais remplacé (seul un scellement remplace l'original).

1. Activer "Forcer UpToSign comme système de signature par défaut pour tout nouvel objet" : créer un devis, une commande, un contrat, un projet, une proposition fournisseur ; le champ "Signature électronique" vaut UpToSign.
2. Activer l'option pour les objets clonés : cloner un ancien devis dont le champ est vide ; le clone a UpToSign.
3. Options désactivées : le champ reste vide.

Lier au devis un contact client avec un rôle autre que "Signature électronique (client)" (ex. contact facturation). Attendu : option désactivée, il n'est pas proposé comme signataire ; option activée, il est proposé (fenêtre de positionnement et page publique).

Activer l'option Dolibarr de création automatique d'un contact avec le tiers et l'option "Le contact créé en même temps que le tiers est signataire de tout par défaut". Créer un tiers. Attendu : le contact créé a les rôles de signature client et vendeur sur tous les types de documents. Sans l'option UptoSign, il n'a aucun rôle de signature.

Signataire avec un poste renseigné (ex. "Directeur"). Activer l'option "Ajouter le poste/fonction du contact sur le document pdf signé", lancer une signature et signer. Attendu : le PDF signé porte le nom, le prénom et le poste du signataire. Option désactivée : seulement nom et prénom.

1. Mode global "email" : lancer une signature ; le signataire reçoit le code par e-mail et non par SMS.
2. Activer le choix par tiers : le champ "[uptosign] envoyer le code de double authentification par" apparaît sur la fiche tiers. Mettre "email" sur un tiers, laisser le global en SMS ; le signataire de ce tiers reçoit le code par e-mail, celui d'un autre tiers par SMS.

Activer l'option de pseudo-anonymisation, lancer une signature et la mener à terme. Attendu : sur le document signé et le dossier de preuves, adresses e-mail et numéros de téléphone sont partiellement masqués. Option désactivée : ils sont affichés en entier.

1. Adresse de redirection personnalisée : en fin de signature sur UptoSign, le signataire arrive sur cette page (défaut https://uptosign.com/).
2. "Envoyer les mails d'erreurs à l'adresse" : provoquer une erreur sur la page publique ; un e-mail arrive à cette adresse.
3. "Envoyer une copie des notifications à l'adresse" : à la signature d'un document lancé par n'importe quel utilisateur, cette adresse reçoit la notification.

Ouvrir l'onglet Serveur de la configuration. Attendu : le choix propose production, démonstration et développement ; l'identifiant est prérempli avec l'e-mail de la société ; les boutons d'action n'apparaissent qu'une fois la case "Accepter les conditions générales UptoSign" cochée ; les liens CGU et politique de protection des données sont présents. Enregistrer : les valeurs sont conservées après rechargement.

Sur le serveur de démonstration :

1. Identifiant inconnu : "Tester la connexion" crée le compte et obtient une clé d'API.
2. Compte existant avec mauvais mot de passe : message d'erreur, boutons "Réinitialisation du mot de passe" et "Créer un compte" vers le site du serveur.
3. Serveur injoignable : message d'erreur, identifiants et clé d'API enregistrés conservés.
4. Après une mise en pause des appels (backoff), un test réussi lève la pause immédiatement.

Enregistrer un mot de passe contenant des caractères spéciaux (< > " ' & %). Recharger la page. Attendu : le champ mot de passe est vide (le mot de passe n'apparaît pas dans le source HTML) ; il est stocké encodé en base ; enregistrer avec le champ vide conserve le mot de passe précédent ; le test de connexion utilise bien le mot de passe complet.

Supprimer la constante MAIN_SECURITY_HASH_ALGO puis ouvrir l'onglet Serveur. Attendu : le message "La configuration sécurité de votre dolibarr est incomplète..." s'affiche et les champs d'identifiants ne sont pas proposés. Remettre la constante : les identifiants réapparaissent.

Préparer des utilisateurs actifs internes : un complet (e-mail, mobile +33..., permission "Utilisateur de dolibarr pouvant être sollicité pour signer"), un sans mobile, un avec mobile national (06...), un sans e-mail, un sans la permission, et un utilisateur externe (rattaché à un tiers). Attendu : l'externe n'est pas listé ; seul l'utilisateur complet est cochable ; les autres ont la case grisée et le motif en rouge. Cocher l'utilisateur complet, enregistrer : il est proposé comme signataire interne sur tous les documents.

Basculer l'interface en da_DK, de_DE, en_US, es_ES, fr_FR, hu_HU, it_IT, nl_NL, pl_PL, pt_BR et sl_SI, parcourir configuration, onglet Signature électronique, historique, enveloppe et page publique. Attendu : aucun libellé n'apparaît sous forme de clé brute ; les fichiers de langue ont les mêmes clés et les mêmes paramètres de substitution ; les textes passés au JS n'affichent pas d'entités HTML.

Ouvrir l'onglet À propos. Attendu : version, éditeur, licence, versions minimales Dolibarr/PHP, formulaire "Vous aimez ce module ?", lien de soutien, liens documentation/support/forum/contact et historique des versions s'affichent ; l'envoi du formulaire d'avis exige le jeton et n'envoie l'e-mail que s'il est saisi. Quand une version plus récente est publiée, un message l'indique.

Sur un Dolibarr PostgreSQL, activer le module, lancer une signature, ouvrir l'historique avec filtres, une enveloppe avec destinataires, et désactiver/réactiver. Attendu : les fichiers SQL s'exécutent sans erreur (une sorte d'instruction par fichier), aucune erreur SQL dans les journaux pendant le parcours.

Depuis "Envoyer email" d'un devis, d'une commande, d'un contrat, d'une intervention et d'une expédition, choisir le modèle UptoSign correspondant (français puis anglais). Attendu : le modèle est proposé, le lien de la page publique de signature est substitué et fonctionne ; le modèle d'expédition est de type shipping_send ; un modèle modifié par l'utilisateur est conservé à la réactivation du module ; en multisociété, les modèles existent dans chaque entité où le module est actif.

Provoquer les notifications du module (signature terminée, erreur, contact ajouté depuis la page publique) sur un devis, une facture et sans objet. Attendu : chaque e-mail porte l'en-tête X-Dolibarr-Info et un trackid du préfixe Dolibarr de l'objet suivi de son id (pro12, inv5...), ou "uts" + horodatage sans objet ; la copie automatique MAIN_MAIL_AUTOCOPY_TO n'est pas doublée ; l'utilisateur ayant lancé la procédure est prévenu.

Menu Documents > UptoSign. Attendu : la liste "Historique des signatures et scellements UptoSign" affiche Réf., Réf. pièce, Type pièce, Tiers, Contact signature, Utilisateur, Date création, Date traitement, Créé par, État UptoSign, État ; les filtres par colonne, la recherche rapide, le tri et la pagination fonctionnent ; un filtre forgé sur un champ inconnu est ignoré sans erreur SQL ; seules les procédures de l'entité courante sont listées.

Ouvrir une procédure en attente puis une signée. Attendu : l'historique du processus est affiché signataire par signataire avec le lien envoyé, un QR code lisible qui ouvre ce lien sur téléphone, chaque étape datée ; "Actualiser l'historique" recharge depuis le serveur ; le lien de signature n'apparaît jamais dans les logs.

Sur une procédure signée et rapatriée, cliquer "Vérifier la somme de contrôle du fichier". Attendu : "Le fichier n'a pas été modifié, aucune erreur signalée, la somme de contrôle correspond au fichier présent dans dolibarr". Modifier un octet du fichier local puis recommencer : un message d'écart s'affiche. Fichier absent : message explicite, pas d'erreur PHP.

Sur un Dolibarr sans UptoSign, activer le module dans Accueil > Configuration > Modules/Applications. Attendu :

• l'activation réussit ; si une table n'a pas pu être créée, l'activation est refusée avec un message d'erreur ;
• les configurations des modèles PDF standard sont installées (cyan, azur, einstein, cornas, muscadet, aurore, crabe, strato, soleil, espadon, merou, rouget) ; celle d'un modèle PDF absent du Dolibarr est désactivée ;
• les types de contact "Signature électronique (client)" et "Signature électronique (vendeur)" existent ;
• le champ "Signature électronique" apparaît sur les devis, commandes, contrats, projets et propositions commerciales fournisseurs ;
• les modèles d'e-mails UptoSign sont présents (devis, commande, contrat, intervention, expédition).

Avec des procédures, des enveloppes de signature en masse (et leurs destinataires), des configurations de modèles personnalisées et des paramètres UPTOSIGN_ renseignés : désactiver le module, vérifier en base que les tables et constantes sont toujours là, puis le réactiver. Attendu : procédures, historique, liens vers les documents signés, enveloppes, destinataires, configurations et paramètres sont retrouvés à l'identique, sur l'entité principale comme sur une entité secondaire. Aucune configuration par défaut n'est dupliquée.

Déployer une version plus récente du module sans le désactiver/réactiver (UPTOSIGN_MODULE_VERSION reste à l'ancienne valeur). Attendu : l'onglet "Signature électronique" d'un document et l'onglet "Position de la signature" d'une enveloppe affichent "Module UptoSign : attention, la version de votre module n'est pas cohérente avec la version de la base de données...". Après désactivation/réactivation, le message disparaît et les migrations prévues pour les versions intermédiaires ont été appliquées (une seule fois).

Simuler une ancienne installation : tables du module supprimées et présence du fichier de sauvegarde d'une ancienne version. Réactiver le module. Attendu : les signatures, les paramètres et les configurations de documents personnalisées de la sauvegarde sont restaurés. Si les tables existent déjà, la sauvegarde n'est PAS rejouée. La migration des chemins de fichiers (2.0.40) ne tourne que si une version précédente est connue, jamais sur une constante de version vide.

Activer le module puis créer un nouvel utilisateur. Attendu : il reçoit "Lire les signatures" et "Lire les listes de signatures" uniquement. "Lancer un processus de signature ou scellement", "Annuler un processus de signature", les droits de configuration et d'écriture des listes ne sont pas cochés. Un utilisateur existant qui avait reçu "Lancer..." avec une ancienne version la conserve.

Sur un Dolibarr 18 (PHP 7.4) puis sur la dernière version supportée : activer le module, ouvrir chaque onglet de configuration, ouvrir l'onglet "Signature électronique" d'un devis validé, la liste de l'historique et une enveloppe de signature en masse. Attendu : aucune erreur PHP (ni warning/deprecated dans les logs), aucune page blanche ; la matrice PHPStan 18 à 24 de la CI est verte.

Deux entités avec des comptes UptoSign distincts, un devis partagé de l'entité 1. Connecté sur l'entité 2, lancer la signature ; puis se connecter sur l'entité 1 et synchroniser, télécharger, actualiser l'historique, supprimer. Attendu : la procédure appartient à l'entité 2 ; toutes les actions ultérieures utilisent la clé de l'entité 2, jamais celle de l'entité courante ; si l'entité 2 n'a pas de clé, rien n'est envoyé et un message l'indique ; la pause backoff de l'une n'affecte pas l'autre.

Deux entités ayant chacune un devis de même référence. Depuis l'entité 2, signer le devis partagé de l'entité 1. Attendu : le PDF envoyé est celui du répertoire de l'entité 1 (jamais l'homonyme de l'entité 2) ; le PDF signé et la preuve sont enregistrés dans le répertoire de l'entité 1.

Procédure de l'entité 2 terminée chez UptoSign. Laisser arriver le webhook (hors connexion), puis exécuter la tâche d'archivage depuis l'entité 1. Attendu : le webhook bascule sur l'entité 2 avant tout appel et utilise sa clé ; les événements créés appartiennent à l'entité 2 ; la tâche d'archivage traite la procédure avec le compte de l'entité 2. La liste de l'historique de l'entité 1 n'affiche pas cette procédure.

Envoyer un devis avec le modèle d'e-mail "UptoSign devis", ouvrir le lien reçu sans être connecté. Attendu : la page "Page de signature des documents électroniques" affiche le document, le bouton "Consulter le document" (qui ouvre le PDF) et le signataire désigné ; avec plusieurs signataires possibles, un choix est proposé ; "Accepter et signer" affiche "Votre demande a bien été enregistrée..." et le signataire reçoit le lien UptoSign ; un second clic ne crée pas de seconde procédure. Affichage correct sur smartphone.

Depuis la page publique d'un devis, cliquer "Refuser". Attendu : le devis passe à l'état refusé (non signé) dans Dolibarr ; aucune procédure UptoSign n'est créée ; le bouton Refuser n'existe que pour les devis.

Activer "Option permettant au client de créer son contact signataire" et renseigner l'adresse des erreurs.

1. Document sans signataire : le formulaire permet de créer le signataire ; le contact est créé sur le tiers avec le rôle de signature.
2. Signer avec un autre contact : nouveau contact créé.
3. Modifier le mobile d'un contact existant : le nouveau numéro est enregistré, l'ancien conservé dans la note privée. Attendu : l'adresse des erreurs reçoit un e-mail à chaque ajout et modification ; e-mail ou mobile invalide refusé avec message. Option désactivée : pas de formulaire.

Ouvrir la page publique avec : une clé de sécurité fausse, une référence inexistante, un type d'objet non géré, un document brouillon ou déjà signé, un paramètre entity d'une autre entité. Attendu : message d'erreur sans fuite d'information (pas de PDF servi, pas de données du tiers), aucune procédure créée ; avec un lien valide d'une autre entité, le document de la bonne entité est affiché.

Tester avec un utilisateur sans aucun droit, puis en ajoutant un droit à la fois. Attendu : "Documents > UptoSign" visible seulement avec "Lire les signatures" ; "Signatures multiples" exige en plus "Lire les listes de signatures" ; l'onglet "Signature électronique" exige "Lancer un processus..." ; l'accès direct par URL à une page non autorisée est refusé.

Rejouer en GET/POST, sans jeton puis avec un jeton faux, chaque action d'écriture : lancer signature/scellement, actions de masse, suppression de procédure (confirm_delete), synchronisation, bouton "UpToSign pour tout document", ajout/suppression de destinataires, envoi d'enveloppe, modification de configuration. Attendu : toutes refusées sans modification ; avec droit et jeton valides, elles aboutissent ; sans le droit, refusées même avec jeton.

Mode "Sceller (actif)", placer le sceau, cliquer Sceller. Attendu : une procédure de scellement est créée ; une fois traitée, l'état passe à "Scellé" puis "Téléchargé" ; le PDF scellé remplace le PDF d'origine en gardant son nom ; aucun signataire n'est sollicité.

Sur une facture validée avec configuration crabe, cliquer UPTOSIGN / Sceller puis confirmer. Attendu : une boîte de confirmation s'affiche ; après confirmation le sceau est placé selon la configuration du modèle ; annuler la confirmation ne lance rien ; recharger la page après l'envoi ne relance pas un second scellement.

Sceller un devis, attendre le rapatriement, puis lancer une signature sur le même devis. Attendu : la signature est autorisée (la procédure de scellement terminée ne bloque pas) ; elle porte sur le PDF scellé ; le document signé final conserve le sceau. Même scénario sur un contrat.

Passer backtopage / backtopageforcancel = https://exemple.invalid/ puis //exemple.invalid sur les fiches et assistants du module. Créer un tiers, un contact et une enveloppe dont les libellés contiennent , des guillemets et des apostrophes. Attendu : les liens externes sont ignorés (retour sur la page du module) ; aucune valeur n'est interprétée comme HTML ou JS dans les pages, sélecteurs, la fenêtre de positionnement et les pages d'administration.

Avec le niveau de log au maximum puis à INFO, dérouler une signature complète, le webhook, la page publique et un test de connexion. Attendu : chaque ligne du module commence par "uptosign" ; aucune clé d'API, mot de passe, hook_key, securekey, lien de signature ou clé de partage n'apparaît à aucun niveau ; e-mails, mobiles et noms n'apparaissent qu'en DEBUG ; le corps des requêtes HTTP vers UptoSign n'est jamais journalisé.

Ouvrir admin/logs.php en administrateur, puis en non-administrateur, puis en administrateur d'une entité secondaire avec Multisociété. Tenter de lire un fichier hors racine des logs (../, sous-dossier, fichier non .log) et sans jeton. Attendu : seuls les fichiers *.log à la racine des documents sont listés et lisibles ; non-admin et admin non superadmin en multisociété refusés ; chemins forgés et requêtes sans jeton refusés.

Sur un devis validé :

1. Contact lié au devis avec le rôle "Signature électronique (client)" : seul ce contact est proposé côté client.
2. Aucun contact lié au devis : les contacts du tiers ayant ce rôle sont proposés.
3. Utilisateur interne lié au devis (rôle vendeur) et utilisateur coché dans Signataires internes : proposés comme signataires internes. Attendu : la liste de la fenêtre de positionnement, celle de la page publique et celle de l'API uptosignCore sont identiques.

Lier au document des contacts : un sans e-mail, un sans nom, un avec mobile national 0612345678 d'un pays connu, un avec mobile invalide, deux contacts avec le même mobile. Attendu : les contacts sans e-mail, sans nom ou au mobile inutilisable sont écartés avec un message qui dit quoi compléter ; un mobile national est normalisé au format international selon le pays ; un même mobile ne donne qu'un signataire. Sans aucun signataire valide : "Attention: aucun contact n'est désigné pour la signature."

Ouvrir la fiche d'un contact sans rôle de signature et cliquer sur "UpToSign pour tout document". Attendu : le contact reçoit les rôles de signature client et vendeur sur tous les types de documents gérés (propositions, commandes, factures, contrats, interventions, projets, expéditions, documents fournisseurs) ; un second clic ne crée pas de doublon ; le bouton exige le droit de lancement et le jeton CSRF.

Tiers sans contact, mobile vide et téléphone renseigné au format international. Ouvrir la fenêtre de positionnement d'un de ses documents (ou de l'onglet Signature électronique du tiers). Attendu : le tiers est proposé comme signataire avec son téléphone utilisé comme mobile. Si le mobile est renseigné, c'est lui qui est utilisé. Sans aucun numéro utilisable, le tiers est écarté avec un message.

Sur un devis :

1. Brouillon : pas de boutons. Validé, avec configuration, champ "Signature électronique" = UpToSign, utilisateur avec "Lancer un processus..." : boutons actifs.
2. Sans le droit : boutons absents.
3. Champ Signature électronique vide : pas de bouton Signer (Sceller reste si configuration).
4. Sans configuration pour le modèle PDF : boutons grisés, survol "Il n'y a pas de configuration pour ce modèle de document".
5. Sans signataire : Signer grisé avec motif.
6. Procédure déjà en cours sur le PDF : grisé avec motif.

Avec le droit "Lancer un processus...", vérifier la présence de l'onglet "Signature électronique" et l'ouverture sans erreur de la fenêtre de positionnement sur : devis, commande client, facture, contrat, fiche d'intervention, projet, expédition, proposition commerciale fournisseur, commande fournisseur, facture fournisseur, tiers et utilisateur. Attendu : l'onglet est présent partout, absent sans le droit ; les PDF proposés sont ceux du répertoire de l'objet (et de son tiers).

Valider un devis sans générer son PDF (ou supprimer le PDF), puis ouvrir la fenêtre de positionnement. Attendu : le message "Aucun fichier PDF n'est associé à cet objet !" s'affiche, aucune procédure n'est créée, aucune erreur PHP.

Joindre plusieurs PDF à un devis, cliquer sur UPTOSIGN / Signer. Attendu : la fenêtre s'ouvre au-dessus de la fiche sans menus ni styles Dolibarr ; le sélecteur liste les PDF du devis ; changer de PDF recharge l'aperçu ; les boutons de pages naviguent entre les pages ; depuis l'onglet, le mode de départ est "Sceller (actif)" et "Signer"/"Sceller" basculent le mode ; la croix et la touche Échap ferment la fenêtre sans rien lancer. Aucune erreur dans la console JS.

Utiliser un modèle PDF (ou ODT) contenant UPTOSIGN_STAMP_SEAL_HERE, UPTOSIGN_STAMP_SIGN_HERE, UPTOSIGN_SIGN_TO_HERE (ou 00), UPTOSIGN_SIGN_TO_01_HERE, UPTOSIGN_SIGN_TO_02_HERE et UPTOSIGN_SIGN_FROM_HERE. Attendu : en mode scellement le sceau est placé sur STAMP_SEAL ; en mode signature sur STAMP_SIGN ; chaque signataire externe sur son mot-clé dans l'ordre, l'interne sur SIGN_FROM ; ces positions priment sur celles de la configuration ; sans mot-clé, la configuration s'applique. Si le lecteur PHP échoue et que l'option PdfToText est active, le second essai trouve les mots-clés.

Dans la fenêtre de positionnement :

1. Retirer le sceau puis cliquer Signer : "Veuillez positionner le sceau UptoSign sur votre document".
2. Mode Signer, sceau placé mais aucune signature : "Veuillez placer une signature sur votre document". Attendu : aucun appel au serveur UptoSign ni procédure créée tant que les deux conditions ne sont pas remplies.

Devis validé, PDF généré, un signataire client et un signataire interne. Placer sceau et signatures, vérifier le "Titre du dossier et du mail", cliquer Signer. Attendu : message "Demande de signature de document envoyée avec succès." ; redirection vers la fiche de la procédure à l'état "En attente" ; chaque signataire reçoit l'e-mail UptoSign avec son lien ; le code arrive par SMS ; après signature de tous, le devis passe à l'état signé et le PDF signé + preuve sont rapatriés.

Lancer une signature sur un devis (procédure en attente). Puis :

1. relancer depuis la fiche, l'onglet, la page publique ;
2. régénérer le PDF du devis et relancer ;
3. double-cliquer / renvoyer le formulaire (F5) au moment de l'envoi. Attendu : chaque nouvelle tentative est refusée avec un message indiquant la procédure en cours ; aucune seconde procédure créée localement ni chez UptoSign. Une fois la procédure terminée, annulée ou expirée, un nouveau lancement est possible.

Activer "Ajouter un bouton pour lancer le processus de signature en local". Attendu : le bouton "Signature locale" apparaît à côté de Signer pour un devis, une fiche d'intervention, un contrat (documents à signature en ligne Dolibarr) et pas pour une facture ; un clic crée la demande puis affiche directement la page de signature dans le navigateur, sans e-mail au client ; le client peut signer. Option désactivée : pas de bouton.

Forger la requête d'envoi en remplaçant le nom du PDF par "../../autre/fichier.pdf", par un chemin absolu, par un fichier non PDF, ou par un lien symbolique sortant de DOL_DATA_ROOT. Attendu : refus avec message et log "uptosign: ..." ; aucun fichier envoyé au serveur UptoSign ; aucune écriture ni suppression hors du répertoire de l'objet.

Documents > UptoSign > Signatures multiples > Nouveau, saisir Libellé et Description, Créer. Attendu : l'enveloppe est en "Brouillon" avec une référence provisoire (PROVn) ; les onglets Signature en masse, Notes, Fichiers joints, Destinataires, Destinataires (sélection avancée), Position de la signature et Documents signés sont présents ; aucun bouton Valider ; la liste des enveloppes affiche la nouvelle ligne avec filtres et recherche rapide fonctionnels.

Onglet Fichiers joints : envoyer un PDF, puis un second. Attendu : les deux fichiers sont listés et téléchargeables ; ils sont rangés dans le répertoire de l'enveloppe de l'entité courante ; un utilisateur sans droit de lecture des listes ne peut pas les télécharger (accès document refusé).

Onglet Destinataires, source "Contacts of thirdparties". Tester chaque filtre : poste/fonction, catégorie de contact, catégorie client/prospect, catégorie fournisseur, nature du tiers, langue, puis un contact précis via "Rechercher un contact (avec mobile et e-mail)". Attendu : seuls les contacts actifs ayant e-mail et mobile sont ajoutés ; le compteur correspond au filtre ; la recherche ne propose que des contacts avec mobile et e-mail ; un contact d'une autre entité n'est jamais proposé. Source masquée si le module Tiers est désactivé.

Source "Utilisateurs dolibarr avec email et tél. mobile". Filtrer par état, salarié ou non, groupe ("Filtrer les salariés par groupe"), puis un salarié précis via la recherche. Attendu : seuls les utilisateurs avec e-mail et mobile sont ajoutés ; les filtres sont respectés ; un utilisateur désactivé n'est ajouté que si le filtre d'état le demande.

Module Adhérents actif. Source "Membres de l'association", filtres statut, type, catégorie, date de fin d'adhésion. Préparer un adhérent avec mobile, un avec seulement le téléphone, un sans numéro. Attendu : les deux premiers sont ajoutés (le téléphone sert de mobile au second) ; le troisième ne l'est pas et un message indique combien d'adhérents sans numéro ont été écartés. Source absente si le module Adhérents est désactivé.

Module Organisation d'événements actif. Un événement avec trois participants : un dont l'e-mail correspond à un contact actif avec mobile, un dont le contact n'a pas de mobile, un sans contact correspondant. Attendu : seul le premier est ajouté, avec le mobile du contact ; les deux autres sont ignorés. Source absente si le module est désactivé.

Source "E-mails à partir d'un fichier". Fichiers à tester :

1. Lignes "prénom;nom;mobile;email" et une ligne avec seulement un e-mail, en UTF-8 avec accents : tous ajoutés, accents conservés.
2. Deux lignes consécutives avec le même e-mail : ajouté une fois.
3. Une ligne avec e-mail invalide : tout l'import échoue avec un message citant la ligne, rien n'est ajouté.
4. Fichier vide ou non texte : message d'erreur.

Source "E-mails entrés par l'utilisateur" :

1. Lignes "prénom;nom;mobile;email" séparées par point-virgule : ajoutées.
2. Colonnes copiées depuis un tableur (tabulations) : ajoutées avec les bons champs.
3. Une adresse invalide : toute la saisie échoue avec un message, rien n'est ajouté.
4. Coller deux fois la même personne : elle est ajoutée deux fois (cette source ne dédoublonne pas, comportement documenté).

Onglet "Destinataires (sélection avancée)" : cibler tiers, contacts, puis les deux ; critères nom, catégorie, nature, pays, état, champ complémentaire. Ajouter, puis enregistrer les critères comme filtre et le recharger. Attendu : les tiers/contacts trouvés avec e-mail rejoignent l'enveloppe ; un tiers utilise son téléphone comme mobile, un tiers sans numéro est ajouté quand même ; le filtre enregistré est rattaché à l'enveloppe (type_element uptosignlist) et n'apparaît pas dans l'e-mailing Dolibarr.

Ajouter deux fois la même source avec les mêmes filtres, puis une autre source contenant une adresse déjà présente ; double-cliquer sur Ajouter. Attendu : les sources Dolibarr n'ajoutent jamais un e-mail déjà présent ; le bouton se bloque après le premier clic ; aucun doublon en base.

Sur une enveloppe avec destinataires : supprimer une ligne, en supprimer plusieurs via l'action de masse, "Vider liste", puis "Télécharger". Attendu : suppressions effectives et compteur à jour ; le CSV contient tous les destinataires avec la colonne error_text ; les valeurs affichées (noms contenant < " ') sont échappées ; ces actions exigent le droit d'écriture des listes et le jeton.

Préparer une enveloppe avec 30 destinataires puis une avec 31. Attendu : à 30, le bouton "Lancer la demande de signature auprès de 30 destinataires" est proposé ; à 31, il est remplacé par "Votre liste de destinataires est trop importante pour cette étape de tests (maxi 30 procédures)" et aucun envoi n'est possible, même en forgeant la requête.

Onglet Position de la signature > Positionner les signatures, choisir le PDF, placer sceau et zone de signature, vérifier le titre, cliquer "Lancer la demande de signature auprès de X destinataires". Inclure un destinataire sans e-mail. Attendu : une procédure UptoSign indépendante par destinataire, avec un PDF nommé avec son e-mail ; le destinataire sans e-mail est ignoré avec "Signature non envoyée à ... ERREUR MAIL MANQUANT" ; l'enveloppe reçoit sa référence définitive et son PDF est renommé ; état "Envoyée partiellement" puis "Envoyée entièrement" ; les procédures apparaissent dans l'historique. Si aucune demande ne part, l'enveloppe revient en Brouillon.

Après l'envoi, appuyer sur F5 puis utiliser le bouton Retour du navigateur et renvoyer le formulaire. Attendu : retour sur la fiche de l'enveloppe, aucune procédure créée en double. Une enveloppe validée par une ancienne version affiche "La procédure est en cours vous ne pouvez plus accéder à cette fonctionnalité" ; après "Retour en brouillon" elle peut être envoyée.

Inclure un destinataire au mobile refusé par le serveur UptoSign. Attendu : un message cite son nom et le motif ; les autres destinataires reçoivent leur demande ; l'enveloppe reste "Envoyée partiellement" ; le CSV téléchargé contient le motif dans error_text pour cette ligne.

Après signature de quelques destinataires, ouvrir l'onglet Documents signés, sélectionner les lignes, action "Synchronisation UptoSign". Attendu : chaque ligne affiche nom, prénom, e-mail, source, référence de procédure, état, date de signature et lien vers le document signé ; la synchronisation met à jour les états et rapatrie les fichiers, nommés avec le type et l'identifiant du destinataire (ex. contact-12) ; le PDF de l'enveloppe n'est jamais remplacé.

Avec "Supprimer la liste de signatures", supprimer une enveloppe ayant des procédures ouvertes et terminées. Attendu : les procédures ouvertes sont annulées chez UptoSign, les terminées supprimées localement ; une annulation en échec refuse la suppression de l'enveloppe avec message ; sans le droit, pas de bouton et requête forgée refusée.

Sur la fiche d'une enveloppe : envoyer un e-mail (droit d'écriture des listes exigé), saisir des notes publique/privée, consulter les onglets contacts et agenda, utiliser les liens "Retour à la liste". Attendu : chaque onglet s'ouvre sans erreur ; l'e-mail est envoyé avec l'en-tête X-Dolibarr-Info et tracé ; sans droit, le bouton d'envoi est absent ; les liens de retour mènent à la liste des enveloppes (un backtopage externe est ignoré).

Dolibarr joignable depuis Internet. Faire signer un devis par tous les signataires. Attendu : sans action manuelle, la procédure passe à "Signé" puis "Téléchargé" ; le PDF signé puis le dossier de preuves sont enregistrés à côté du PDF d'origine ; le devis passe à l'état "Signé" ; un événement est créé dans l'agenda du devis. Rejouer le même appel webhook ne duplique ni fichier ni événement.

Simuler (ou provoquer) chaque retour du serveur : refus du signataire, procédure annulée côté UptoSign, erreur de signature, expiration. Attendu : états respectifs "Le correspondant a refusé de signer le document", "UptoSign annulé", "Erreur de signature", "Expiré" ; un devis refusé passe à l'état non signé/refusé ; aucun fichier signé n'est créé ; le libellé d'état distant est traduit.

Appeler public/hook.php : sans signature, avec une signature HMAC fausse, avec un uuid inconnu, avec une méthode GET. Attendu : réponse d'erreur, aucune modification en base ni sur disque, raison logguée "uptosign: ..." sans clé ni secret dans le log. Avec une signature valide, l'appel est traité.

Dolibarr non joignable par le webhook. Après signature :

1. "Synchronisation UptoSign" sur la fiche du document : l'état passe à Signé.
2. "Télécharger le document signé" (ou "scellé") : le fichier apparaît dans les fichiers joints.
3. Supprimer le fichier local ou le modifier, puis "Synchronisation UpToSign forcée" : le fichier est rapatrié à nouveau. Attendu : chaque bouton exige "Lire les signatures" et le jeton ; aucun doublon de fichier ; un utilisateur sans droit ne voit pas les boutons.

Avec "Annuler un processus de signature" :

1. Procédure en attente : Supprimer ; elle est annulée chez UptoSign (le lien du signataire ne marche plus) puis supprimée localement avec son fichier signé éventuel.
2. Serveur injoignable ou refus d'annulation : message d'erreur, procédure conservée.
3. Procédure terminée (signée, scellée, refusée, expirée, annulée) : supprimée seulement dans Dolibarr, aucun appel d'annulation. Attendu : sans le droit ou sans jeton, la suppression est refusée ; le hook ne supprime jamais de lui-même.

Sélectionner dans l'historique des procédures ouvertes et terminées, action de masse Supprimer. Attendu : même règle que la suppression unitaire (ouvertes annulées à distance puis supprimées, terminées supprimées localement) ; une annulation en échec conserve la procédure concernée et l'indique ; droit "Annuler un processus de signature" exigé.

Pour chaque type (devis, commande, facture, contrat, intervention, projet, expédition, documents fournisseurs, tiers, contact) ayant des procédures ouvertes et terminées : supprimer le document. Attendu : procédures ouvertes annulées chez UptoSign, terminées supprimées localement ; si une annulation échoue, la suppression du document est refusée avec message, les procédures déjà annulées le restent et la suppression réessayée reprend avec les suivantes. Exception : supprimer un utilisateur conserve ses procédures terminées et documents signés.

Procédures signées/scellées dont le fichier local manque. Exécuter la tâche "UptoSign - Archivage automatique des documents signés" :

1. option "Activer la tâche planifiée d'archivage" désactivée : sortie "rien à faire", retour 0 ;
2. option activée : les fichiers manquants sont téléchargés, au plus UPTOSIGN_ARCHIVE_MAX_PER_RUN par exécution, avec la pause UPTOSIGN_API_SLEEP_MS entre deux ;
3. un fichier inconnu du serveur fait passer la procédure à "Expiré", elle n'est plus redemandée ;
4. une procédure jamais lancée depuis 30 jours passe à "Expiré". Attendu : la sortie de la tâche est toujours renseignée ; en cas d'erreur, le message d'erreur est rempli.

Simuler des refus successifs (clé refusée, HTTP 429, serveur indisponible). Attendu : le module se met en pause 5 min, puis 15, 30 et 60 min aux refus suivants (UPTOSIGN_API_BACKOFF_UNTIL / _LEVEL renseignés, par entité) ; pendant la pause aucun appel n'est envoyé et l'utilisateur voit que les appels sont suspendus ; l'archivage s'arrête et reprend là où il en était ; un appel réussi remet le compteur à zéro ; "Tester la connexion" réussi lève la pause.

Compte revendeur, option "Activer la tâche planifiée spéciale des revendeurs" activée, clients avec contrat et facture modèle. Exécuter la tâche deux fois le même jour. Attendu : les quantités de signatures et scellements du mois en cours sont reportées sur les lignes du contrat, celles du mois précédent sur la facture modèle ; la seconde exécution du jour ne fait rien ; option désactivée : sortie "rien à faire", retour 0.