ormuz
Home/Integrations/Youtrust/Nodes/Get signature result (Youtrust)
YoutrustConnecteurStable

Get signature result (Youtrust)

Retrieves the current state of a Youtrust request and its signed documents, signatories, and audit trails when available.

Vue d’ensemble

Retrieve signature result (Youtrust) provides an updated view of a known request. It fits processes that manually compose the Youtrust lifecycle or need to reread artifacts.

When the request is complete and persist_artifacts is enabled, signed documents and audit trails are retained as Ormuz files.

  • Retrieval does not create a new request.
  • Artifacts are available only in compatible states.
  • Already-persisted files are reused.

Typical scenario

A control process retrieves a request after receiving a Youtrust event and sends the signed document to the business-archiving step.

Quick start

Bind a previously obtained request and keep artifact persistence enabled when following steps need the files.

Input

  • Same Youtrust configuration
  • signature_request object with an identifier
  • File-persistence permissions granted to the node
Configuration example
ParameterBindingRole
signature_requestsignature.signature_requestRequest to retrieve
Key point A still-active request returns its current state, but final signed documents may not yet be available.

Process example

Request to retrieve
Récupérer le résultat de signature (Youtrust)
Use the evidence

Retrieve a known Youtrust request and make its final artifacts available to following steps.

Parameters 3

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.
signature_requestRequisYoutrust signature request
Youtrust signature request obtained from an earlier step, for example Prepare signature or Send for signature.

Lifecycle and retention

Deadline, business reference, and proof retention.

persist_artifactsOptionnelboolean
When enabled, Ormuz retains final signed documents and audit trails as platform files when Youtrust makes them available.

Outputs 8

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_resultYoutrust signature result
Business result of the request, notably its state and signed, declined, expired, or cancelled decision.
artifacts_availableboolean
Whether final artifacts can be retrieved for this request.

Documents finaux

Evidence and files available at the end of the lifecycle.

audit_trailsYoutrust 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

Retrieve the request

The node gets its current state and information from Youtrust.

List contents

Associated documents and signatories are exposed.

Evaluate availability

artifacts_available indicates whether final artifacts can be retrieved.

Retain evidence

When requested, signed documents and audit trails are made available as Ormuz files.

Limits and responsibilities

  • The node does not advance a request still in progress.
  • It returns no decision route.
  • Exact audit-trail availability depends on Youtrust request state and content.

Troubleshooting

Artefacts indisponibles

Check that the request is complete and Youtrust has finalized generation of signed documents.

Request not found

Check that it comes from the same Youtrust configuration and environment.

Files not retained

Enable persist_artifacts and check that the process authorizes this file operation.