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.

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.

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.

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).

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.

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.

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.

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.

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).

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.

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.

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é.

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é.

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.

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.

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.

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.

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 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é.

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.

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.

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é.

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.

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é.

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.