YoutrustRouteurStable

Send document for email signature (Youtrust)

Creates a Youtrust request from documents containing Smart Anchors, invites one or more signatories by email, and routes the process according to the final result.

Vue d’ensemble

Have a document signed by email (Youtrust) covers the full remote-signature lifecycle: document preparation, signatory creation, activation, waiting for the result, and retrieval of final artifacts.

Youtrust sends signing invitations to supplied contacts. The process remains waiting until the request is signed, declined, expired, or canceled.

  • The node accepts one or more PDF or DOCX documents and one or more signatories.
  • Smart Anchors define signature fields in each document.
  • Signed documents and audit trails may be retained as Ormuz files.

Typical scenario

A generated DOCX commercial contract contains one anchor for the customer and another for the company representative. Youtrust invites both contacts in the intended order, then the signed route continues contract activation.

Quick start

Prepare a document with at least one Smart Anchor and bind the contacts who must receive the Youtrust invitation.

Document

  • PDF or DOCX accessible to the process
  • At least one detectable Smart Anchor
  • s1, s2, etc. indexes consistent with the signatory list

Signataires

  • First name, last name, and email populated
  • List order verified
  • Authentication appropriate for the signature level
Configuration example
ParameterBindingRole
documentscontract_fileDocument rendered by an earlier step
signerscontract_signersContacts in anchor order
Key point Youtrust sends each signatory their invitation and signing link by email.

Decision routes

signed

Request signed

All expected signatories signed and Youtrust considers the request complete.

Recommended actionContinue the business process and use signed documents or audit trails as needed.
declined

Signature declined

The signatory declined to sign the request.

Recommended actionStop handling that requires a signature and plan the appropriate communication or business review.
expired

Request expired

The deadline was reached before all expected signatures were obtained.

Recommended actionDecide whether a new request should be created with a new expiration date.
cancelled

Request canceled

The Youtrust request was canceled before completion.

Recommended actionStop automatic continuation or create a new request if cancellation does not end the business need.
Key point A non-terminal request selects no route: the process remains waiting for the Youtrust result.

Process example

Contract to sign
Faire signer un document par e-mail (Youtrust)
Signé
Refusé
Expiré
Annulé
Activate the contract
Handle the decline
Relancer
Close

Send a contract by email, wait for the Youtrust result, then continue according to the terminal route.

Data resolution

The node builds the request from linked Ormuz objects.

DataSource or rule
Signatory identityFirst name, last name, email, and, when available, phone from contact.
Field positionsLocations and dimensions carried by Smart Anchors in the documents.
Ordre s1, s2, …Contact order in signers.
LangueDefault language from the Youtrust configuration when the contact does not provide one.

Parameters 10

Request and documents

Configuration, name, and documents defining the request.

extension_config_idRequisref(extension_config:youtrust)
Active Youtrust configuration used to create or retrieve the request. It notably determines sandbox/production environment and default language.
nameRequisstring
Business name of the signature request, visible in Youtrust. Choose a title that clearly identifies the contract or case.
documentsRequisFile
An Ormuz file or list of PDF/DOCX files to sign. Signature locations must be defined in the documents using Youtrust Smart Anchors.

Signatories and security

Recipients, order, signature level, and authentication.

signersRequisContact
An Ormuz contact or ordered contact list. Every contact must provide at least a usable first name, last name, and email for Youtrust.
ordered_signersOptionnelboolean
When enabled, Youtrust solicits signatories in supplied order. That order also determines s1, s2, etc. indexes used by Smart Anchors.
signature_levelOptionnelenum
Requested signature level: simple by default or advanced. Verify that your account and selected authentication mode support the requested level.
authentication_modeOptionnelenum
Signatory authentication mode: no_otp, email_otp, or sms_otp. SMS mode requires a usable phone number to be available to Youtrust.

Lifecycle and retention

Deadline, business reference, and proof retention.

expiration_dateOptionneldate
Request deadline as a date. After this date, an incomplete request may take the expired route.
external_referenceOptionnelstring
Optional business reference sent to Youtrust to make reconciliation with your contract or case easier.
persist_artifactsOptionnelboolean
When enabled, Ormuz retains final signed documents and audit trails as platform files when Youtrust makes them available.

Outputs 9

Youtrust request

Request, documents, and people tracked at Youtrust.

signature_requestYoutrust signature request
Youtrust request with identifier, current state, and available signature-lifecycle information.
documentsYoutrust document[]
Youtrust documents attached to the request, including available identifiers and metadata.
signersYoutrust signer[]
Youtrust signatories attached to the request and their current states.

Decision

Result used to continue or route the process.

signature_resultOptionnelYoutrust signature result
Business result of the request, notably its state and signed, declined, expired, or cancelled decision.
selected_routeenum
Terminal route selected by the node: signed, declined, expired, or cancelled.
selected_valueenum
Decision value that led to process routing.

Documents finaux

Evidence and files available at the end of the lifecycle.

audit_trailsOptionnelYoutrust audit trail[]
Youtrust audit trails available for signatories of the completed request.
signed_documents_fileOptionnelFile
Ormuz file containing signed documents downloaded from Youtrust. Available when the request is signed and artifact retention is enabled.
audit_trails_fileOptionnelFile
Ormuz file containing audit trails downloaded from Youtrust when retention is enabled.

Behavior

Prepare the request

The node creates or reuses the request corresponding to this step and sends documents with Smart Anchor analysis enabled.

Add signatories

Each contact becomes a Youtrust signatory with the configured signature level and authentication.

Send invitations

The request is activated in email mode and Youtrust handles invitations.

Wait for the result

The process remains suspended until the request reaches a terminal state.

Finaliser

The result, documents, and available audit trails are exposed before the route is selected.

Limits and responsibilities

  • The document template must contain Smart Anchors corresponding to the expected signatories.
  • An incorrect or inaccessible email address prevents the signatory from receiving the invitation.
  • A new business attempt after decline, expiration, or cancellation must create a new lifecycle according to your rules.

Troubleshooting

No Smart Anchor detected

Check the syntax, keep the anchor on one line, and use Arial at 10 to 14 px.

A signatory receives nothing

Check their email, signing order, and notification settings in your Youtrust account.

The request remains pending

Check request state in Youtrust and receipt of signature-completion events.

Smart Anchors Youtrust

Smart Anchors are text markers placed directly in the PDF or DOCX. Youtrust creates each signature field at the marker's location.

Attention Minimal example: {{s1|signature|85|37}} creates an 85 × 37 px signature field for the first signatory.
SegmentSignification
s1First contact in signers. Use s2, s3, etc. for following signatories.
signatureField type created by Youtrust.
85Field width in pixels.
37Field height in pixels.
  • Write each anchor on one line and keep all its segments in the same text block.
  • Prefer Arial between 10 and 14 px; set the text color to the background color so it remains invisible in the final document.
  • Every signatory index must exist in the request. An s2 anchor creates no field when only one signatory is supplied.
  • The node automatically enables anchor analysis and rejects preparation when no anchor is detected in signable documents.

See the Youtrust Smart Anchors documentation for other field types and advanced variants.