ormuz
Accueil/Intégrations/Youtrust/Nodes/Sign document in Journey (Youtrust)
YoutrustAction utilisateur avec décisionStable

Sign document in Journey (Youtrust)

Présente une session de signature Youtrust directement dans l’expérience utilisateur Ormuz pour un signataire unique, puis dirige le processus dès que Youtrust confirme un résultat terminal.

Vue d’ensemble

Faire signer un document dans le parcours (Youtrust) garde le signataire dans l’expérience Ormuz : la page de signature Youtrust est intégrée, puis le processus reprend automatiquement lorsque la demande est signée ou refusée.

Ce node est destiné à la personne actuellement présente dans le parcours et accepte exactement un contact comme signataire.

  • Le processus reprend lorsque Youtrust confirme la signature ou le refus.
  • Le domaine qui affiche l’expérience doit être autorisé dans les réglages iFraming Youtrust.
  • Les mêmes Smart Anchors que pour la signature par e-mail définissent les champs du document.

Scénario type

À la fin d’un onboarding, le représentant signe immédiatement le mandat affiché dans le parcours. La route signed poursuit alors l’activation du dossier.

Prise en main

Activez d’abord l’iFraming dans Youtrust, puis reliez un document avec Smart Anchor et le contact actuellement engagé dans le parcours.

Compte Youtrust

  • iFraming activé
  • https://journey.ormuz.io/ ajouté aux domaines autorisés
  • Configuration sandbox ou production cohérente avec le compte

Demande

  • Un seul signer
  • PDF ou DOCX avec une ancre s1
  • Niveau simple ou avancé compatible avec l’iFrame
Exemple de configuration
ParamètreBindingRôle
documentscontract_fileDocument contenant une ancre `s1`
signercurrent_contactPersonne présente dans le parcours
Attention Prérequis obligatoire : dans les réglages iFraming Youtrust, autorisez explicitement le domaine https://journey.ormuz.io/ avant une utilisation en production.

Routes de décision

signed

Demande signée

Tous les signataires attendus ont signé et Youtrust considère la demande comme terminée.

Action recommandéePoursuivre le processus métier et utiliser les documents signés ou les pistes d’audit selon vos besoins.
declined

Signature refusée

Le signataire a refusé de signer la demande.

Action recommandéeArrêter le traitement qui exige une signature et prévoir la communication ou la revue métier appropriée.
expired

Demande expirée

La date limite a été atteinte avant l’obtention de toutes les signatures attendues.

Action recommandéeDécider si une nouvelle demande doit être créée avec une nouvelle date d’expiration.
cancelled

Demande annulée

La demande Youtrust a été annulée avant son achèvement.

Action recommandéeInterrompre la suite automatique ou créer une nouvelle demande si l’annulation ne met pas fin au besoin métier.
À retenir Une demande non terminale ne choisit aucune route : le processus reste en attente du résultat Youtrust.

Exemple de processus

Contrat à signer
Faire signer un document dans le parcours (Youtrust)
Signé
Refusé
Expiré
Annulé
Poursuivre
Traiter le refus
Relancer
Clôturer

Présenter la signature au contact dans l’expérience Ormuz et reprendre automatiquement sur la route Youtrust correspondante.

Résolution des données

Le node construit la demande à partir des objets Ormuz reliés.

DonnéeSource ou règle
Identité du signatairePrénom, nom et email du contact fourni dans signer.
Champ s1Emplacement de la Smart Anchor du signataire unique dans le document.
Canal de remiseSession de signature présentée dans l’expérience Ormuz.
Fin du parcoursÉvénement terminal émis par l’interface Youtrust après signature ou refus.

Paramètres 13

Demande et documents

Configuration, nom et documents qui définissent la demande.

extension_config_idRequisref(extension_config:youtrust)
Configuration Youtrust active utilisée pour créer ou consulter la demande. Elle détermine notamment l’environnement sandbox ou production et la langue par défaut.
nameRequisstring
Nom métier de la demande de signature, visible dans Youtrust. Choisissez un intitulé qui permet d’identifier clairement le contrat ou le dossier concerné.
documentsRequisFile
Un fichier Ormuz ou une liste de fichiers PDF ou DOCX à signer. Les emplacements de signature doivent être définis dans les documents avec des Smart Anchors Youtrust.

Signataires et sécurité

Destinataires, ordre, niveau de signature et authentification.

signerRequisContact
Contact Ormuz qui signe dans l’expérience intégrée. Ce node accepte exactement un signataire afin que l’action utilisateur corresponde à la personne présente dans le parcours.
signature_levelOptionnelenum
Niveau de signature demandé : simple par défaut ou advanced. Vérifiez que votre compte et le mode d’authentification choisi permettent le niveau demandé.
authentication_modeOptionnelenum
Mode d’authentification du signataire : no_otp, email_otp ou sms_otp. Le mode SMS suppose qu’un numéro de téléphone utilisable soit disponible côté Youtrust.

Cycle et conservation

Échéance, référence métier et conservation des preuves.

expiration_dateOptionneldate
Date limite de la demande au format date. Après cette date, une demande inachevée peut emprunter la route expired.
external_referenceOptionnelstring
Référence métier optionnelle transmise à Youtrust pour faciliter le rapprochement avec votre contrat ou votre dossier.
persist_artifactsOptionnelboolean
Lorsque cette option est active, Ormuz conserve les documents signés et les pistes d’audit finales comme fichiers de plateforme lorsque Youtrust les rend disponibles.

Reprise du parcours

Options avancées qui encadrent le rejeu de l’action utilisateur.

allow_replay_from_hereOptionnelboolean
Autorise un opérateur habilité à reprendre ultérieurement le processus depuis cette action utilisateur. N’activez cette option que si une nouvelle présentation de la même demande est acceptable.
replay_boundaryOptionnelboolean
Marque cette signature comme point de non-retour pour la reprise du processus. Cette option évite de rejouer involontairement les étapes qui ont créé ou envoyé la demande.

Autres paramètres

titleOptionnelstring
Titre affiché au signataire dans l’expérience intégrée avant et pendant la signature. Il doit identifier clairement le document ou l’action attendue.
descriptionOptionnelstring
Texte d’accompagnement affiché au signataire dans l’expérience intégrée afin de préciser le contexte et les conséquences métier de la signature.

Sorties 9

Demande Youtrust

Demande, documents et personnes suivis chez Youtrust.

signature_requestYoutrust signature request
Demande Youtrust avec son identifiant, son état courant et les informations disponibles sur son cycle de signature.
documentsYoutrust document[]
Documents Youtrust rattachés à la demande, avec leurs identifiants et métadonnées disponibles.
signerYoutrust signer
Signataire Youtrust présenté dans l’expérience intégrée.

Décision

Résultat utilisé pour poursuivre ou orienter le processus.

signature_resultOptionnelYoutrust signature result
Résultat métier de la demande, notamment son état et la décision signed, declined, expired ou cancelled.
selected_routeenum
Route terminale choisie par le node : signed, declined, expired ou cancelled.
selected_valueenum
Valeur de décision ayant conduit au routage du processus.

Documents finaux

Preuves et fichiers disponibles à la fin du cycle.

audit_trailsOptionnelYoutrust audit trail[]
Pistes d’audit Youtrust disponibles pour les signataires de la demande terminée.
signed_documents_fileOptionnelFile
Fichier Ormuz contenant les documents signés téléchargés depuis Youtrust. Disponible lorsque la demande est signée et que la conservation des artefacts est activée.
audit_trails_fileOptionnelFile
Fichier Ormuz contenant les pistes d’audit téléchargées depuis Youtrust lorsque leur conservation est activée.

Comportement

Préparer la demande

Le document est analysé, le signataire unique est ajouté et la demande est activée pour une présentation intégrée.

Afficher la signature

La page de signature Youtrust s’ouvre dans l’expérience Ormuz autorisée par la whitelist iFraming.

Laisser le signataire agir

Le signataire consulte le document, réalise l’authentification demandée et signe ou refuse depuis Youtrust.

Détecter la fin

L’expérience se termine automatiquement uniquement lorsque Youtrust émet un événement de signature terminée ou de refus.

Diriger le processus

Les artefacts disponibles sont récupérés, puis la route terminale correspondante reprend le processus.

Limites et responsabilités

  • Le node accepte un seul signataire. Pour plusieurs personnes distantes, utilisez le node de signature par e-mail ou plusieurs étapes adaptées au parcours métier.
  • La signature qualifiée n’est pas disponible dans une iFrame Youtrust ; utilisez un canal pris en charge par Youtrust pour ce niveau.
  • Un Owner ou un Admin Youtrust doit autoriser le domaine utilisé par l’expérience Ormuz.

Résolution des problèmes

L’espace de signature reste vide

Vérifiez que l’iFraming est activé et que https://journey.ormuz.io/ figure exactement dans les domaines autorisés du compte Youtrust.

Aucun champ de signature

Vérifiez que le document contient une ancre {{s1|signature|85|37}} détectable et que son texte reste sur une seule ligne.

La signature est faite mais le processus attend

Vérifiez les événements de la demande dans Youtrust et la configuration des webhooks de la connexion Youtrust.

Smart Anchors et iFraming

Les Smart Anchors sont des marqueurs texte placés directement dans le PDF ou le DOCX. Youtrust crée chaque champ de signature à l’emplacement de son marqueur.

Attention Exemple minimal : {{s1|signature|85|37}} crée un champ de signature de 85 × 37 px pour le premier signataire.
SegmentSignification
s1Signataire unique fourni dans signer.
signatureType de champ créé par Youtrust.
85Largeur du champ en pixels.
37Hauteur du champ en pixels.
  • Écrivez chaque ancre sur une seule ligne et conservez tous ses segments dans le même bloc de texte.
  • Utilisez de préférence Arial entre 10 et 14 px ; donnez au texte la couleur du fond pour qu’il reste invisible dans le document final.
  • Chaque indice de signataire doit exister dans la demande. Une ancre s2 ne crée aucun champ si un seul signataire est fourni.
  • Le node active automatiquement l’analyse des ancres et refuse la préparation lorsqu’aucune ancre n’est détectée dans les documents signables.

Consultez la documentation Youtrust sur les Smart Anchors pour les autres types de champs et les variantes avancées.

Attention Dans Youtrust, choisissez le mode « domaines autorisés uniquement » et ajoutez https://journey.ormuz.io/ à la whitelist iFraming.

Consultez les réglages de sécurité iFrame Youtrust et le guide d’intégration iFrame.