Marquer le signe (préversion)
Mark Sign est un service de signature électronique qualifié conforme à la réglementation eIDAS. Envoyez des documents pour la signature, attendez les signatures, téléchargez et validez les fichiers signés.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Standard | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Marquer l’ID, UAB |
| URL | https://marksign.eu |
| pagalba@marksign.lt |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Marquer l’ID, UAB |
| Website | https://marksign.eu |
| Politique de confidentialité | https://marksign.eu/privacy-policy |
| Categories | Productivité; Contenu et fichiers |
Marquer le signe
Mark Sign est un service de signature électronique qualifié conforme à la réglementation eIDAS. Un flux peut envoyer un document pour la signature, attendre qu’il soit signé, puis télécharger le fichier signé et le valider.
Publisher : Marquer l’ID, UAB
Prerequisites
Vous avez besoin d’un jeton d’accès d’API Mark Sign. Consultez Obtenir les informations d’identification ci-dessous.
Opérations prises en charge
Document : Charger
Charge un document (PDF, ADoc, BDoc ou ASiC-E) et le prépare à la signature. Le nom du fichier devient le titre du document.
Signature : Invitation par e-mail
Invite une personne à signer ; Mark Sign envoie l’e-mail d’invitation. L’appel à nouveau pour la même personne envoie un rappel.
Signature : Inviter par URL
Ajoute un signataire sans envoyer d’e-mail et retourne son URL d’invitation personnelle à remettre.
Signature : attendre tous les signataires
Conserve le flux jusqu’à ce que le document soit signé ou rejeté, ou se termine par l’état timed_out lorsque l’heure d’attente (29 jours par défaut) s’exécute.
Signature : attendre un signataire
Conserve le flux jusqu’à ce qu’un signataire particulier, choisi par e-mail, signe. Tout rejet met également fin à l’attente.
Signature : attendre le prochain signataire
Reprend le flux au moment où le signataire suivant signe ou rejette, sans interrogation.
Document : Obtenir l’état
Vérifie l’état global de signature du document.
Document : Obtenir des signataires
Répertorie l’état de chaque signataire, y compris la raison de rejet si un signataire a rejeté.
Document : Télécharger
Télécharge le document avec toutes les signatures collectées jusqu’à présent.
Document : Liste
Répertorie les documents de votre espace de travail, avec recherche de texte et pagination.
Document : Supprimer
Supprime un document de l’espace de travail.
Document : Charger en tant que conteneur
Combine plusieurs fichiers dans un document conteneur signable (ADoc, BDoc ou ASiC-E). La facturation suit la valeur par défaut du signe mark, où chaque signataire paie.
Signature : Créer des liens de signataire
Crée un lien de signature personnel pour chaque signataire, pour vous remettre. Les liens expirent, peuvent nécessiter la vérification d’identité et sont les seules pages de signature avec une option de rejet.
Signature : Créer un lien partagé
Crée un lien que tout le monde peut ouvrir pour signer les documents, chacun sous sa propre identité vérifiée.
Signature : Supprimer le lien
Supprime un lien signataire ou un lien partagé avant son expiration.
Document : Étendre la validité de la signature
Met à niveau les signatures de document pour la validité à long terme (LT) ou l’archivage à long terme (LTA).
Document : Valider
Vérifie les signatures d’un document et retourne le rapport de validation complet.
Obtention des informations d’identification
Contactez le support technique Mark Sign pour pagalba@marksign.lt demander un jeton d’accès API pour votre espace de travail. Lors de la création d’une connexion dans Power Automate, collez le jeton dans le champ « Clé API ».
Le jeton est lié à un espace de travail. Par conséquent, chaque document créé ou répertorié via la connexion appartient à cet espace de travail.
Getting Started
Flux de signature le plus simple :
- Document : Charger (par exemple, le contenu du fichier et les jetons de nom à partir de SharePoint ou de OneDrive).
- Signature : Invitation par e-mail. Marquez les e-mails de signature de l’invitation.
- Signature : attendez le prochain signataire. Le flux s’interrompt ici jusqu’à ce que la signature se produise.
- Document : Téléchargez et stockez-le là où vous en avez besoin.
Avec plusieurs signataires, utilisez Signature : Inviter par e-mail pour chaque personne, puis une signature : attendez toutes les étapes des signataires avant le téléchargement. Pour fournir vous-même les liens au lieu des e-mails Mark Sign, utilisez Signature : Inviter par URL ou Signature : créez des liens de signataire et envoyez chaque personne avec votre propre action Outlook ou Teams.
Problèmes connus et limitations
- Le connecteur ne fournit pas de déclencheurs de flux ; utilisez plutôt les opérations d’attente à l’intérieur d’un flux.
- Un document comporte une inscription de notification. N’exécutez pas deux signatures : attendez les étapes de signataire suivantes sur le même document en même temps. La deuxième remplace la première, puis la première étape attend qu’elle expire. Le remplissage d’un champ URL de rappel sur n’importe quel bloc remplace également l’inscription.
- Les signataires peuvent rejeter un document uniquement sur une page De signature : créer des liens de signataire (avec le bouton Afficher le rejet activé) ; les invitations par e-mail, les URL d’invitation et les liens partagés n’offrent aucune option de rejet.
- Mark Sign avertit uniquement les signatures. Lorsqu’un bloc d’invitation utilise un objectif ou
reviewconfirmationque l’action de cette personne ne réveille jamais la signature : attendre le prochain signataire ; vérifiez son état avec document : obtenir les signataires à la place. - Document : le téléchargement retourne le contenu du fichier uniquement ; prenez le nom du fichier à partir du document : Lister ou à partir de votre étape de chargement.
- Une exécution de flux peut durer au plus 30 jours (une limite de Power Automate), donc aucune attente ne peut être dépassée.
Signature : attendez tous les signataires et la signature : attendez qu’un signataire se termine par l’état
timed_outaprès 29 jours par défaut. Pour la signature : attendez le prochain signataire, définissez un délai d’expiration (par exempleP29D) dans les paramètres d’action et ajoutez une branche configurée pour s’exécuter une fois que l’action a expiré. Si la limite d’exécution de 30 jours atteint en premier, Power Automate annule l’exécution entière et aucune branche ne la gère. - Document : la liste ne prend pas en charge le filtrage par état.
- Document : le chargement accepte un fichier par appel ; effectuez une boucle sur les pièces jointes pour charger plusieurs. Document : Charger en tant que conteneur est destiné à quelques fichiers ; la combinaison de nombreux fichiers volumineux dans un appel peut dépasser la limite de temps de traitement.
Instructions de déploiement
Exécutez paconn create --api-prop apiProperties.json --api-def apiDefinition.swagger.json --script script.csx --icon icon.png pour déployer ce connecteur en tant que connecteur personnalisé dans votre environnement Power Platform. Pour plus d’informations, consultez la documentation paconn .
Support
Pour les problèmes liés au connecteur ou à l’API Mark Sign, contactez pagalba@marksign.lt.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application Power est partagée avec un autre utilisateur, un autre utilisateur sera invité à créer explicitement une nouvelle connexion.
| Name | Type | Description | Required |
|---|---|---|---|
| Clé API | Securestring | Jeton d’accès de l’API Mark Sign de votre espace de travail. Demandez une prise en charge de Mark Sign à l’adresse pagalba@marksign.lt. | True |
Actions
| Document : Charger |
Charge un document et le prépare pour la signature. |
| Document : Charger en tant que conteneur |
Combine plusieurs fichiers dans un document conteneur signable, tel qu’un ADoc ou ASiC-E. Les fichiers sont chargés et combinés en une seule étape. |
| Document : Liste |
Répertorie les documents de votre espace de travail, le plus récent. |
| Document : Obtenir des signataires |
Répertorie les signataires d’un document avec leur état de signature. |
| Document : Obtenir l’état |
Obtient l’état de signature d’un document. |
| Document : Supprimer |
Supprime un document de votre espace de travail. |
| Document : Télécharger |
Télécharge le document avec toutes les signatures collectées jusqu’à présent. |
| Document : Valider |
Vérifie les signatures d’un document et retourne le rapport de validation. Le flux attend la fin de la vérification. |
| Document : Étendre la validité de la signature |
Met à niveau les signatures de document pour la validité ou l’archivage à long terme. |
| Signature : attendre le prochain signataire |
Attend que le signataire suivant signe ou rejette le document, sans envoyer d’invitations. Utilisez-le dans une boucle pour attendre plusieurs signataires sans interrogation. |
| Signature : attendre tous les signataires |
Attend que chaque signataire ait signé ou qu’une personne a rejeté le document, puis permet au flux de continuer. Se termine par l’état timed_out lorsque le délai s’écoule. |
| Signature : attendre un signataire |
Attend qu’un signataire particulier signe le document, puis laisse le flux continuer. Se termine par l’état timed_out lorsque le délai s’écoule. |
| Signature : Créer des liens de signataire |
Crée un lien de signature personnel pour chaque signataire. Vous fournissez les liens vous-même, par exemple par e-mail ou par message Teams. |
| Signature : Créer un lien partagé |
Crée un lien de signature que tout le monde peut ouvrir pour signer les documents. Tu te livres toi-même. |
| Signature : Invitation par e-mail |
Invite une personne à signer le document. Mark Sign envoie l’invitation par e-mail. |
| Signature : Inviter par URL |
Ajoute un signataire au document sans envoyer d’e-mail et retourne son lien d’invitation personnel pour vous permettre de remettre. Le lien n’expire pas et ne peut pas être supprimé ; utilisez « Signature : Créer des liens de signataire » lorsque vous avez besoin de liens que vous pouvez révoquer. |
| Signature : Supprimer le lien |
Supprime un lien signataire ou un lien partagé avant son expiration. Les liens d’invitation ne peuvent pas être supprimés. |
Document : Charger
Charge un document et le prépare pour la signature.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom du fichier
|
file_name | True | string |
Nom du fichier avec son extension, par exemple contract.pdf. Il devient le titre du document. |
|
corps
|
body | True | binary | |
|
Access
|
access | string |
Qui peut afficher le document. La valeur par défaut est privée. |
|
|
Type de facturation
|
billing_type | True | string |
Qui paie les signatures. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Statut de la demande. |
|
ID du document
|
data.uuid | string |
ID du document. |
|
Nom du fichier
|
data.filename | string |
Le nom du fichier. |
Document : Charger en tant que conteneur
Combine plusieurs fichiers dans un document conteneur signable, tel qu’un ADoc ou ASiC-E. Les fichiers sont chargés et combinés en une seule étape.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Type de document
|
document_type | True | string |
Type de document à créer. |
|
Nom du fichier
|
file_name | True | string |
Nom du fichier avec son extension, par exemple contract.pdf. |
|
Contenu du fichier
|
file_content | True | byte |
Contenu du fichier. |
|
Type de fichier (ADoc uniquement)
|
adoc_file_type | string |
Rôle du fichier dans le conteneur. Utilisé uniquement lorsque le type de document est un ADoc. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Statut de la demande. |
|
ID du document
|
data.uuid | string |
ID du document. |
|
Nom du fichier
|
data.filename | string |
Nom du fichier de document. |
Document : Liste
Répertorie les documents de votre espace de travail, le plus récent.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Search
|
query | string |
Expression à rechercher dans les titres de document et les noms de fichiers. |
|
|
Contrepartie
|
offset | integer |
Nombre de documents à ignorer. |
|
|
Limit
|
limit | integer |
Nombre de documents à retourner. La valeur par défaut est 10. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Statut de la demande. |
|
Documents :
|
data | array of object |
Documents. |
|
ID du document
|
data.uuid | string |
ID du document. |
|
Nom du fichier
|
data.filename | string |
Le nom du fichier. |
|
État du document
|
data.status | string |
État de signature du document, tel que enregistré (en attente de signatures), signed_partially ou signé. |
|
Chargé à l’adresse
|
data.uploaded_at | date-time |
Lorsque le document a été chargé. |
|
Total
|
total | integer |
Nombre total de documents correspondants. |
Document : Obtenir des signataires
Répertorie les signataires d’un document avec leur état de signature.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du document
|
documentId | True | string |
ID du document, à partir de la sortie de « Document : Charger », « Document : Charger en tant que conteneur » ou « Document : Liste ». |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Statut de la demande. |
|
Signataires :
|
data | array of object |
Signataires du document. |
|
ID du signataire
|
data.id | string |
ID du signataire. |
|
Prénom
|
data.name | string |
Prénom du signataire. |
|
Nom de famille
|
data.surname | string |
Nom du signataire. |
|
Email
|
data.email | string |
Adresse e-mail du signataire. |
|
État de signature
|
data.status | string |
Indique si le signataire a signé : en attente, signé, rejeté, examiné, confirmé, refusé ou révisé. |
|
Motif de rejet
|
data.rejection_reason | string |
Raison pour laquelle le signataire a donné lors du rejet du document. |
Document : Obtenir l’état
Obtient l’état de signature d’un document.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du document
|
documentId | True | string |
ID du document, à partir de la sortie de « Document : Charger », « Document : Charger en tant que conteneur » ou « Document : Liste ». |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Statut de la demande. |
|
État du document
|
data.document_status | string |
État de signature : enregistré (en attente de signatures), signed_partially (certains ont signé) ou signés (tout le monde a signé). |
Document : Supprimer
Supprime un document de votre espace de travail.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du document
|
documentId | True | string |
ID du document, à partir de la sortie de « Document : Charger », « Document : Charger en tant que conteneur » ou « Document : Liste ». |
Retours
- Body
- AcknowledgedResponse
Document : Télécharger
Télécharge le document avec toutes les signatures collectées jusqu’à présent.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du document
|
documentId | True | string |
ID du document, à partir de la sortie de « Document : Charger », « Document : Charger en tant que conteneur » ou « Document : Liste ». |
Retours
Contenu du fichier de document.
- Contenu du fichier
- file
Document : Valider
Vérifie les signatures d’un document et retourne le rapport de validation. Le flux attend la fin de la vérification.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du document
|
documentId | True | string |
ID du document, à partir de la sortie de « Document : Charger », « Document : Charger en tant que conteneur » ou « Document : Liste ». |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Statut de la demande. |
|
Est valide
|
data.document.is_valid | boolean |
Indique si les signatures de document sont valides. |
|
Valide jusqu'au
|
data.document.valid_to | string |
Durée pendant laquelle le document reste valide. |
|
Nom du document
|
data.document.name | string |
Titre du document. |
|
MIME Type
|
data.document.mimetype | string |
Type de fichier du document. |
|
Signatures :
|
data.signatures | array of object |
Résultat de chaque signature. |
|
ID de signature
|
data.signatures.id | string |
ID de la signature. |
|
Heure de signature
|
data.signatures.signing_time | string |
Lorsque la signature a été effectuée. |
|
Signature Format
|
data.signatures.signature_format | string |
Format de la signature. |
|
Est valide
|
data.signatures.is_valid | boolean |
Indique si la signature est valide. |
|
Valide jusqu'au
|
data.signatures.valid_to | string |
Durée pendant laquelle la signature reste valide. |
|
Certificats
|
data.certificates | array of object |
Certificats utilisés par les signatures. |
|
items
|
data.certificates | object | |
|
Horodatages
|
data.timestamps | array of object |
Horodatages appliqués au document. |
|
items
|
data.timestamps | object | |
|
Temps de validation
|
metadata.validation_time | string |
Lorsque la validation a été effectuée. |
Document : Étendre la validité de la signature
Met à niveau les signatures de document pour la validité ou l’archivage à long terme.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du document
|
documentId | True | string |
ID du document, à partir de la sortie de « Document : Charger », « Document : Charger en tant que conteneur » ou « Document : Liste ». |
|
Level
|
level | True | string |
LT pour la validité à long terme, LTA pour l’archivage à long terme. |
Retours
- Body
- AcknowledgedResponse
Signature : attendre le prochain signataire
Attend que le signataire suivant signe ou rejette le document, sans envoyer d’invitations. Utilisez-le dans une boucle pour attendre plusieurs signataires sans interrogation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du document
|
documentId | True | string |
ID du document, à partir de la sortie de « Document : Charger », « Document : Charger en tant que conteneur » ou « Document : Liste ». |
Retours
- Body
- SigningEvent
Signature : attendre tous les signataires
Attend que chaque signataire ait signé ou qu’une personne a rejeté le document, puis permet au flux de continuer. Se termine par l’état timed_out lorsque le délai s’écoule.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du document
|
documentId | True | string |
ID du document, à partir de la sortie de « Document : Charger », « Document : Charger en tant que conteneur » ou « Document : Liste ». |
|
Délai d’expiration (minutes)
|
timeout_minutes | integer |
Durée d’attente, en minutes, avant de se terminer par l’état timed_out. La valeur par défaut est 41760 (29 jours), la valeur maximale est 43200 (30 jours). |
Retours
- Body
- SigningWaitResponse
Signature : attendre un signataire
Attend qu’un signataire particulier signe le document, puis laisse le flux continuer. Se termine par l’état timed_out lorsque le délai s’écoule.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du document
|
documentId | True | string |
ID du document, à partir de la sortie de « Document : Charger », « Document : Charger en tant que conteneur » ou « Document : Liste ». |
|
E-mail du signataire
|
signer_email | True | string |
E-mail du signataire à attendre, le même e-mail utilisé lors de l’invitation. |
|
Délai d’expiration (minutes)
|
timeout_minutes | integer |
Durée d’attente, en minutes, avant de se terminer par l’état timed_out. La valeur par défaut est 41760 (29 jours), la valeur maximale est 43200 (30 jours). |
Retours
- Body
- SigningWaitResponse
Signature : Créer des liens de signataire
Crée un lien de signature personnel pour chaque signataire. Vous fournissez les liens vous-même, par exemple par e-mail ou par message Teams.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de document
|
documents | True | array of string |
Documents pour utilisant lequel créer des liens de signature. Utilisez des valeurs d’ID de document à partir des étapes de chargement ou de liste. |
|
ID du signataire
|
id | string |
Votre propre ID pour le signataire, unique dans la demande. Obligatoire lorsque l’e-mail est vide. |
|
|
Prénom
|
name | string |
Prénom du signataire. |
|
|
Nom de famille
|
surname | string |
Nom du signataire. |
|
|
Email
|
Adresse e-mail du signataire. Obligatoire lorsque l’ID du signataire est vide. |
|||
|
Code personnel
|
personal_code | string |
Code personnel du signataire. Nécessaire lorsque l’authentification est requise. |
|
|
Exiger l’authentification
|
authentication_required | boolean |
Si c’est le cas, le signataire doit vérifier son identité avant d’ouvrir le lien. |
|
|
Position (ADoc uniquement)
|
position | string |
Position du travail du signataire, affichée dans les signatures ADoc. |
|
|
Département (ADoc uniquement)
|
structural_subdivision | string |
Service du signataire, illustré dans les signatures ADoc. |
|
|
Objectif de signature (ADoc uniquement)
|
signing_purpose | string |
Pourquoi la personne signe, affichée dans les signatures ADoc. |
|
|
Callback URL (URL de rappel)
|
callback_url | string |
URL à notifier lorsque le document est signé. |
|
|
URL de rappel de rejet
|
reject_callback_url | string |
URL à notifier lorsqu’un signataire rejette le document. |
|
|
Expirer après (minutes)
|
expire_after | integer |
Minutes jusqu’à l’expiration du lien. La valeur par défaut est 2880 (deux jours). |
|
|
Afficher le bouton de rejet
|
show_reject_button | boolean |
Indique si les signataires peuvent rejeter le document sur la page de signature. La valeur par défaut est oui. |
|
|
Supprimer le document après (minutes)
|
delete_document_after | integer |
Minutes jusqu’à ce que le document soit supprimé de l’espace de travail. Par défaut, elle est conservée. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Statut de la demande. |
|
Liens de signature :
|
temporary_signing_links | array of object |
Un lien de signature par signataire. |
|
ID du signataire
|
temporary_signing_links.id | string |
Votre propre ID pour le signataire. |
|
Prénom
|
temporary_signing_links.member_name | string |
Prénom du signataire. |
|
Nom de famille
|
temporary_signing_links.member_surname | string |
Nom du signataire. |
|
Email
|
temporary_signing_links.member_email | string |
Adresse e-mail du signataire. |
|
Lien de signature
|
temporary_signing_links.temporary_signing_link | string |
Le lien que le signataire ouvre pour signer le document. |
|
ID de lien de signature
|
temporary_signing_links.temporary_signing_link_id | string |
ID du lien de signature. |
|
Valide jusqu’à ce que
|
temporary_signing_links.valid_until | integer |
Lorsque le lien expire, sous forme d’horodatage Unix. |
|
Documents :
|
documents | array of object |
Les documents dont les liens ont été créés. |
|
ID du document
|
documents.uuid | string |
ID du document. |
|
Nom du fichier
|
documents.filename | string |
Nom du fichier de document. |
Signature : Créer un lien partagé
Crée un lien de signature que tout le monde peut ouvrir pour signer les documents. Tu te livres toi-même.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de document
|
documents | True | array of string |
Documente les signes de lien. Utilisez des valeurs d’ID de document à partir des étapes de chargement ou de liste. |
|
Callback URL (URL de rappel)
|
callback_url | string |
URL à notifier lorsque le document est signé. |
|
|
Expirer après (minutes)
|
expire_after | integer |
Minutes jusqu’à l’expiration du lien. La valeur par défaut est 2880 (deux jours). |
|
|
Supprimer le document après (minutes)
|
delete_document_after | integer |
Minutes jusqu’à ce que le document soit supprimé de l’espace de travail. Par défaut, elle est conservée. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Statut de la demande. |
|
Lien de signature
|
data.signing_link | string |
Le lien que tout le monde peut ouvrir pour signer. |
|
ID de lien de signature
|
data.signing_link_id | string |
ID du lien, pour « Signature : Supprimer le lien ». |
|
Valide jusqu’à ce que
|
data.valid_until | integer |
Lorsque le lien expire, sous forme d’horodatage Unix. |
Signature : Invitation par e-mail
Invite une personne à signer le document. Mark Sign envoie l’invitation par e-mail.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du document
|
documentId | True | string |
ID du document, à partir de la sortie de « Document : Charger », « Document : Charger en tant que conteneur » ou « Document : Liste ». |
|
Prénom
|
name | True | string |
Prénom du signataire. |
|
Nom de famille
|
surname | True | string |
Nom du signataire. |
|
Email
|
True |
Adresse e-mail du signataire. |
||
|
Language
|
language | string |
Langue de l’invitation. La valeur par défaut est lituanienne. |
|
|
URL de réussite
|
success_url | string |
Où envoyer le signataire une fois la signature terminée. |
|
|
Purpose
|
purpose | string |
Pourquoi la personne est invitée. Choisissez révision à inviter pour l’affichage uniquement. |
|
|
Callback URL (URL de rappel)
|
callback_url | string |
URL à notifier lorsque le document est signé. |
Retours
- Body
- AcknowledgedResponse
Signature : Inviter par URL
Ajoute un signataire au document sans envoyer d’e-mail et retourne son lien d’invitation personnel pour vous permettre de remettre. Le lien n’expire pas et ne peut pas être supprimé ; utilisez « Signature : Créer des liens de signataire » lorsque vous avez besoin de liens que vous pouvez révoquer.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du document
|
documentId | True | string |
ID du document, à partir de la sortie de « Document : Charger », « Document : Charger en tant que conteneur » ou « Document : Liste ». |
|
Prénom
|
name | True | string |
Prénom du signataire. |
|
Nom de famille
|
surname | True | string |
Nom du signataire. |
|
Email
|
True |
Adresse e-mail du signataire. |
||
|
URL de réussite
|
success_url | string |
Où envoyer le signataire une fois la signature terminée. |
|
|
Purpose
|
purpose | string |
Pourquoi la personne est invitée. Choisissez révision à inviter pour l’affichage uniquement. |
|
|
Callback URL (URL de rappel)
|
callback_url | string |
URL à notifier lorsque le document est signé. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Statut de la demande. |
|
URL d’invitation
|
data.invitation_url | string |
Lien de la page de signature personnelle à remettre au signataire. |
Signature : Supprimer le lien
Supprime un lien signataire ou un lien partagé avant son expiration. Les liens d’invitation ne peuvent pas être supprimés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de lien de signature
|
temporarySigningLinkId | True | string |
ID du lien de signature à partir de la sortie de « Signature : Créer des liens de signataire » ou « Signature : Créer un lien partagé ». |
Retours
- Body
- AcknowledgedResponse
Définitions
SigningEvent
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID du document
|
uuid | string |
ID du document. |
|
État du document
|
status | string |
État de signature du document, tel que signé ou signed_partially. Un rejet s’affiche dans les états du signataire. |
|
Nombre de signataires
|
members_count | integer |
Combien de personnes ont été invitées à signer. |
|
Nombre signé
|
signed_members_count | integer |
Combien de personnes ont signé. |
|
Signataires :
|
members | array of object |
Tout le monde a invité à signer. |
|
ID du signataire
|
members.id | string |
ID du signataire. |
|
Prénom
|
members.member_name | string |
Prénom du signataire. |
|
Nom de famille
|
members.member_surname | string |
Nom du signataire. |
|
Email
|
members.member_email | string |
Adresse e-mail du signataire. |
|
État de signature
|
members.status | string |
État du signataire, par exemple en attente, signé ou rejeté. |
AcknowledgedResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Statut de la demande. |
SigningWaitResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
État du document
|
document_status | string |
Fin de l’attente : signée, rejetée ou timed_out. |
|
Rejeté par
|
rejected_by | string |
Qui a rejeté le document, s’il a été rejeté. |
|
Motif de rejet
|
rejection_reason | string |
Raison pour laquelle le signataire a donné, si le document a été rejeté. |
État de la demande
file
Il s’agit du type de données de base « fichier ».