Signe Nitro (préversion)

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 de chine Azure      - Us Department of Defense (DoD)
Power Apps	Premium	Toutes les régions Power Apps à l’exception des éléments suivants :      - 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
Nom	Prise en charge de Nitro
URL	https://www.gonitro.com/support
Email	prosupport@sfdc.gonitro.com

Métadonnées du connecteur
Éditeur	Nitro PDF
Website	https://www.gonitro.com/
Politique de confidentialité	https://www.gonitro.com/legal/privacy-policy
Catégories	Productivité; Opérations informatiques

Connecteur de signe Nitro

Aperçu

Le connecteur Nitro Sign permet de sécuriser les flux de travail eSignature de bout en bout directement à partir de Power Automate et de Power Apps. Il permet aux applications de créer et de gérer des enveloppes de signature, de charger et de réorganiser des documents, d’ajouter des participants et de définir l’ordre de signature, de placer la signature et des champs de données, d’envoyer des documents à des fins de signature, de suivre la progression et de télécharger les fichiers originaux, scellés et de piste d’audit, tout au long d’une approche entièrement automatisée basée sur les API.

Publisher : Nitro Software

---

Prerequisites

Pour utiliser Nitro Sign via ce connecteur, vous aurez besoin des éléments suivants :

• Un compte Nitro avec Nitro Sign activé
  https://developers.gonitro.com/
• Un plan Microsoft PowerApps ou Power Automate avec des fonctionnalités de connecteur personnalisé.

---

Authentication

Nitro Sign utilise OAuth 2.0 machine à machine avec l’octroi d’informations d’identification du client pour générer des jetons d’accès pour les demandes d’API.

Fonctionnement

• Vous créez une application API dans le portail libre-service de Nitro et obtenez l’ID client associé et la clé secrète client.
• Le connecteur s’authentifie en échangeant ces informations d’identification pour un jeton d’accès du porteur .
• Le jeton est ensuite utilisé pour autoriser les appels d’API Nitro Sign suivants.

Créez des informations d’identification et lisez le guide détaillé :
https://developers.gonitro.com/docs/authentication/credentials

Création d’une connexion dans Power Automate/Power Apps

Lors de l’ajout du connecteur à un flux ou une application :

1. Cliquez sur Ajouter une nouvelle connexion.
2. Entrez votre ID client et votre clé secrète client (émis dans le portail des développeurs Nitro).
3. Sélectionnez votre région Nitro (Europe, États-Unis ou APAC) : région associée à votre compte Nitro.
4. Enregistrez la connexion : lors de la première utilisation, le connecteur échange votre ID client et votre clé secrète client pour un jeton d’accès à courte durée à l’aide de l’octroi des informations d’identification du client OAuth 2.0, le met en cache et le renouvelle automatiquement. Vos informations d’identification sont utilisées uniquement pour obtenir le jeton ; les appels d’API suivants sont authentifiés avec un jeton du porteur en votre nom.

Remarque : Aucune connexion interactive de l’utilisateur n’est requise ; ce flux est conçu pour les scénarios serveur à serveur/application à application.

Opérations prises en charge

Le connecteur regroupe ses actions autour des quatre ressources d’un flux de travail de signature ( enveloppes, documents, champs et participants ), ainsi qu’un ensemble d’actions de téléchargement pour récupérer les fichiers terminés.

1. Enveloppes

Une enveloppe est le conteneur des documents, des participants et des champs dans une seule demande de signature.

• Répertorier les enveloppes
  Retourne toutes les enveloppes associées à l’application dans le compte. Les résultats sont paginés : la réponse inclut un jeton de curseur Page suivante , que vous pouvez fournir au paramètre Page After facultatif pour récupérer la page suivante (ou Page Avant de page vers l’arrière). Les deux paramètres de curseur sont sous Avancé et sont uniquement nécessaires lors de la marche à pas dans les jeux de résultats volumineux.

• Créer une enveloppe
  Crée une enveloppe avec un nom, un message de notification (objet + corps, avec des variables dynamiques telles que $(sender_name_or_email) et $(envelope_name)) et le mode de signature :

  • parallel — tous les participants sont avertis en même temps et peuvent signer indépendamment.
  • sequential — les participants sont avertis un par un, dans l’ordre dans lequel ils ont été ajoutés.

• Obtenir l’enveloppe par ID
  Récupère les détails d’une enveloppe spécifique par son UUID.

• Mettre à jour l’enveloppe
  Met à jour le nom de l’enveloppe, les paramètres de notification et/ou le mode de signature. Tous les champs sont facultatifs.

• Supprimer l’enveloppe par ID
  Supprime définitivement une enveloppe et tous les documents, champs et participants associés. Cela ne peut pas être annulé.

• Enveloppe d’envoi pour la signature
  Envoie l’enveloppe aux participants pour la collection de signatures. Avant d’envoyer, l’enveloppe doit normalement avoir ses documents, participants et champs de signature ajoutés (via Create Document by Envelope ID, Create Participant(s) by Envelope ID et Create Field(s) by Document ID(s) by Document ID). Tous les documents de l’enveloppe doivent avoir un état chargé avant que l’enveloppe puisse être envoyée.

• Envoyer des rappels pour l’enveloppe
  Déclenche des notifications de rappel aux participants en attente. Si aucun paramètre de notification n’est fourni, le modèle de notification par défaut configuré pour l’enveloppe est utilisé.

• Annuler l’enveloppe par ID
  Annule la demande de signature. Seules les enveloppes qui ont déjà été envoyées pour la signature peuvent être annulées.

---

2. Documents

Les documents sont les fichiers attachés à une enveloppe et signés par les participants.

• Répertorier les documents par ID d’enveloppe
  Récupère tous les documents associés à une enveloppe.

• Créer un document par ID d’enveloppe
  Charge un document dans une enveloppe existante. Fournissez le fichier plus des champs simples et typés , sans JSON écrit manuellement :

  • Fichier de document : fichier à charger.
  • Nom du document : nom sous lequel stocker le document.
  • Type de contenu(avancé, facultatif) : type MIME du fichier ; est défini par défaut sur application/pdf. En cas d’omission, seuls les fichiers PDF sont acceptés.

• Obtenir un document par ID
  Récupère les détails d’un document spécifique dans une enveloppe.

• Mettre à jour le document par ID
  Met à jour les métadonnées de document. Actuellement, seul le nom du document peut être modifié.

• Supprimer le document par ID
  Supprime définitivement un document d’une enveloppe.

• Réorganiser des documents par ID d’enveloppe
  Réorganise les documents dans une enveloppe en fonction d’une liste fournie d’ID de document.

---

3. Champs

Les champs sont les éléments interactifs (signature, initiales, date, etc.) placés sur un document et affectés à un participant.

• Répertorier les champs par ID de document
  Récupère tous les champs associés à un document spécifique.

• Créer des champs par ID de document
  Crée un ou plusieurs champs sur un document et les affecte aux participants. Fournissez un élément pour un seul champ ou plusieurs éléments pour une requête en bloc. Chaque champ spécifie :

  • participantID — participant affecté au champ.
  • type— un de signature, , nameinitials, datecheckboxtitlecompany, . custom
  • page — numéro de page (indexation basée sur 1).
  • Position X, Position Y, Largeur, Hauteur : la position et la taille du champ, chacune entrée sous la forme d’un nombre distinct en points (X/Y sont mesurées à partir du bord gauche/supérieur de la page). Celles-ci remplacent le tableau unique boundingBox précédent, de sorte que chaque valeur est un champ typé dans l’interface utilisateur plutôt qu’une liste intégrée à la main.
  • Facultatif : required (valeur par défaut true) et , sous Avancéformat (par exemple MM/DD/YYYY , pour les champs de date) et modifiable.

• Mettre à jour le champ par ID
  Met à jour les propriétés d’un champ existant. Le champ type doit être fourni et doit correspondre au type de champ existant : il est utilisé pour identifier le schéma de champ et ne modifie pas le type de champ.

• Supprimer le champ par ID
  Supprime définitivement un champ d’un document.

---

4. Participants

Les participants sont les personnes qui reçoivent l’enveloppe , soit pour la signer, soit pour être informées.

• Répertorier les participants par ID d’enveloppe
  Récupère tous les participants associés à une enveloppe.

• Créer un ou plusieurs participants par ID d’enveloppe
  Ajoute un ou plusieurs participants à une enveloppe. Fournissez un élément pour un seul participant ou plusieurs éléments pour une demande en bloc. Chaque participant spécifie :

  • email — adresse e-mail du participant.
  • role — signer (peut avoir des champs affectés pour la signature) ou cc (accès en lecture seule).
  • authentication (avancé, facultatif) :code d’accès actuellement : code d’accès statique que le participant doit fournir avant la signature. Ouvrez cette section uniquement si le participant doit s’authentifier avant la signature.

• Mettre à jour le participant par ID
  Met à jour les paramètres d’authentification d’un participant. Impossible de modifier l’e-mail du participant.

• Supprimer le participant par ID
  Supprime définitivement un participant d’une enveloppe.

---

5. Téléchargements

Récupérez les fichiers terminés une fois que les documents ont été signés et scellés.

• Télécharger l’enveloppe d’origine
  Télécharge les documents non signés d’origine à partir d’une enveloppe en tant qu’archive ZIP .

• Télécharger l’enveloppe scellée
  Télécharge les documents signés scellés, ainsi que la piste d’audit, en tant qu’archive ZIP .

• Télécharger le document scellé par ID
  Télécharge un document signé unique sous forme de fichier PDF .

• Télécharger la piste d’audit de l’enveloppe
  Télécharge la piste d’audit complète d’une enveloppe sous forme de fichier PDF .

Les actions de téléchargement exposent le nom de fichier natif du sélecteur et les jetons de contenu de fichier (plus le type de contenu de fichier). Supprimez le contenu du fichier directement dans l’entrée de fichier d’une étape en aval ( par exemple, OneDrive / SharePoint Créer un fichier ) et nom de fichier dans son entrée de nom de fichier. Aucune body('Action_Name') expression ou nom de fichier typé manuellement n’est nécessaire ; le connecteur encapsule le fichier ZIP ou PDF téléchargé dans une enveloppe JSON afin que Power Automate les expose comme des jetons de contenu dynamique ordinaires.

---

Workflow de signature classique

Un flux de signature complet chaîne les actions ci-dessus dans l’ordre. Un flux Power Automate courant ressemble à ceci :

1. Créer une enveloppe : définissez le nom, l’objet/le corps de notification et le mode de signature (parallel ou sequential). Enregistrez l’ID d’enveloppe retourné.
2. Créer un document par ID d’enveloppe : chargez un ou plusieurs fichiers dans l’enveloppe (à l’aide de l’ID d’enveloppe de l’étape 1). Enregistrez chaque ID de document retourné.
   (Facultatif)Réorganiser les documents par ID d’enveloppe : définissez l’ordre des documents.
3. Créez le ou les participants par ID d’enveloppe : ajoutez les signataires et les destinataires CC, avec leur authentification par code d’accès. Enregistrez chaque ID de participant retourné.
4. Créez des champs par ID de document : placez les champs signature/date/etc. sur chaque document et affectez-les aux participants (à l’aide de l’ID de document de l’étape 2 et de l’ID de participant de l’étape 3).
5. Envoyer l’enveloppe pour la signature : distribuez l’enveloppe. Tous les documents doivent d’abord être dans l’état chargé.
6. (En attente)Envoyez des rappels pour l’enveloppe afin de déplacer les participants, ou annulez l’enveloppe par ID pour arrêter la demande.
7. (Une fois terminé)Télécharger l’enveloppe scelléeTélécharger le document scellé par ID / télécharger la piste d’audit de l’enveloppe / pour récupérer les fichiers terminés.

Conseil : L'ID d'enveloppe, l'ID de document et l'ID de participant retournés par les actions de création sont naturellement acheminés vers les actions ultérieures via le sélecteur de contenu dynamique de Power Automate , choisissez le jeton d'ID à partir de l'action en amont plutôt que de le taper.

---

Erreurs & Limitation

L’API Nitro Sign peut retourner les erreurs suivantes :

• 400 — Demande incorrecte
• 401 — Non autorisé
• 404 — Introuvable
• 409 — Conflit (par exemple, agissant sur une enveloppe dans un état qui n’autorise pas l’opération)
• 413 — Contenu trop volumineux
• 415 — Type de média non pris en charge
• 422 — Entité non traité
• 500 — Erreur de serveur interne

Limitation

• Appels d’API par connexion : 100 par 60 secondes.

---

Limites de plateforme

Taille de fichier

• Maximum : 25 Mo par requête
  S’applique aux opérations à fichier unique et à plusieurs fichiers.

Nombre de pages

• Maximum : 250 pages par document individuel
  Le nombre total de pages combinées sur plusieurs documents peut dépasser 250.

Durée de rétention

• Les fichiers d’entrée et de sortie sont supprimés environ 15 minutes après la fin de l’opération.

---

Notes

• Les actions de gestion d’enveloppe, de document, de champ et de participant retournent JSON.
• Les actions de téléchargement retournent le fichier (ZIP ou PDF) encapsulé dans une enveloppe JSON exposant le nom de fichier, le type de contenu de fichier et le contenu de fichier en tant que jetons natifs du sélecteur, afin que les résultats puissent être chaînés dans une action de fichier en aval sans expressions.
• Le mode de signature (parallel vs sequential) est défini lorsque l’enveloppe est créée et peut être modifiée avec l’enveloppe de mise à jour avant l’envoi de l’enveloppe.
• L’authentification des participants prend actuellement uniquement en charge le code d’accès .

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 est invité à créer une connexion explicitement.

Nom	Catégorie	Description	Obligatoire
Nitro Client ID	securestring	ID client de votre application Nitro	True
Nitro Client Secret	securestring	Secret client de votre application Nitro	True
Région Nitro	string	Sélectionnez la région de l’API Nitro pour votre compte.	True

Actions

Annuler l’enveloppe par ID	Annule la demande de signature d’une enveloppe de signe Nitro. Seules les enveloppes envoyées pour signature peuvent être annulées.
Créer des champs par ID de document	Crée un ou plusieurs champs sur un document et les affecte aux participants. Pour créer un champ unique, fournissez un élément dans le tableau Champs. Pour créer plusieurs champs, fournissez plusieurs éléments.
Créer un document par ID d’enveloppe	Charge un document dans une enveloppe de signe Nitro existante. Le document peut être utilisé ultérieurement dans le flux de travail de signature.
Créer un ou plusieurs participants par ID d’enveloppe	Ajoute un ou plusieurs participants à une enveloppe de signe Nitro. Pour ajouter un seul participant, fournissez un élément dans le tableau Participants. Pour ajouter plusieurs participants, fournissez plusieurs éléments.
Créer une enveloppe	Crée une enveloppe de signe Nitro qui peut être renseignée ultérieurement avec des documents, des participants, des champs et envoyée pour la signature.
Enveloppe d’envoi pour la signature	Envoie une enveloppe Nitro Sign aux participants pour la collection de signatures. Avant d’utiliser cette action, l’enveloppe doit normalement comporter des documents, des participants et des champs de signature ajoutés à l’aide de l’ID créer un document par ID d’enveloppe, créer un ou plusieurs participants par ID d’enveloppe et créer des champs par ID de document. Tous les documents de l’enveloppe doivent avoir un état chargé avant que l’enveloppe puisse être envoyée.
Envoyer des rappels pour l’enveloppe	Déclenche des notifications de rappel aux participants en attente d’une enveloppe de signe Nitro spécifiée. Si aucun paramètre de notification n’est fourni, le modèle de notification par défaut configuré pour l’enveloppe est utilisé.
Mettre à jour le champ par ID	Met à jour les propriétés d’un champ existant dans un document Nitro Sign. Le type de champ doit être fourni et doit correspondre au type de champ existant ; il est utilisé par l’API pour identifier le schéma de champ et ne modifie pas le type de champ.
Mettre à jour le document par ID	Met à jour les métadonnées d’un document existant dans une enveloppe de signe Nitro. Actuellement, seul le nom du document peut être mis à jour.
Mettre à jour le participant par ID	Met à jour les paramètres d’authentification d’un participant dans une enveloppe de signe Nitro. Impossible de mettre à jour l’e-mail du participant.
Mettre à jour l’enveloppe	Met à jour une enveloppe de signe Nitro existante. Vous pouvez modifier le nom de l’enveloppe, les paramètres de notification, le mode de signature ou toute combinaison de ces champs.
Obtenir l’enveloppe par ID	Récupère les détails d’une enveloppe Nitro Sign spécifique à l’aide de son ID d’enveloppe unique.
Obtenir un document par ID	Récupère les détails d’un document spécifique dans une enveloppe de signe Nitro.
Réorganiser des documents par ID d’enveloppe	Réorganise les documents associés à une enveloppe Nitro Sign spécifique en fonction de la liste fournie des ID de document.
Répertorier les champs par ID de document	Récupère tous les champs associés à un document spécifique dans une enveloppe de signe Nitro.
Répertorier les documents par ID d’enveloppe	Récupère tous les documents associés à une enveloppe de signe Nitro spécifique.
Répertorier les enveloppes	Le point de terminaison List Envelopes retourne toutes les enveloppes associées à une application dans un compte.
Répertorier les participants par ID d’enveloppe	Récupère tous les participants associés à une enveloppe de signe Nitro spécifique.
Supprimer le champ par ID	Supprime définitivement un champ d’un document dans une enveloppe de signe Nitro.
Supprimer le document par ID	Supprime définitivement un document d’une enveloppe de signe Nitro.
Supprimer le participant par ID	Supprime définitivement un participant d’une enveloppe de signe Nitro.
Supprimer l’enveloppe par ID	Supprime définitivement une enveloppe de signe Nitro. Cette opération ne peut pas être annulée et tous les documents, champs et participants associés sont également supprimés.
Télécharger la piste d’audit de l’enveloppe	Télécharge le fichier PDF contenant la piste d’audit complète de l’enveloppe de signe Nitro sélectionnée.
Télécharger le document scellé par ID	Télécharge un document signé unique à partir d’une enveloppe Nitro Sign sous forme de fichier PDF.
Télécharger l’enveloppe d’origine	Télécharge les documents non signés d’origine à partir d’une enveloppe Nitro Sign en tant qu’archive ZIP.
Télécharger l’enveloppe scellée	Télécharge les documents signés scellés à partir d’une enveloppe de signe Nitro, ainsi que la piste d’audit, en tant qu’archive ZIP.

Annuler l’enveloppe par ID

Créer des champs par ID de document

Créer un document par ID d’enveloppe

Créer un ou plusieurs participants par ID d’enveloppe

Créer une enveloppe

Enveloppe d’envoi pour la signature

Envoyer des rappels pour l’enveloppe

Mettre à jour le champ par ID

Mettre à jour le document par ID

Mettre à jour le participant par ID

Mettre à jour l’enveloppe

Obtenir l’enveloppe par ID

Obtenir un document par ID

Réorganiser des documents par ID d’enveloppe

Répertorier les champs par ID de document

Répertorier les documents par ID d’enveloppe

Répertorier les enveloppes

Répertorier les participants par ID d’enveloppe

Supprimer le champ par ID

Supprimer le document par ID

Supprimer le participant par ID

Supprimer l’enveloppe par ID

Télécharger la piste d’audit de l’enveloppe

Télécharger le document scellé par ID

Télécharger l’enveloppe d’origine

Télécharger l’enveloppe scellée

Définitions

EnvelopeNotification

EnvelopeSummaryResponse

EnvelopeResponse

ListDocumentsByEnvelopeIDResponse

DocumentResponse

FieldsResponse

FieldResponse

ParticipantsResponse

ParticipantsListResponse

ParticipantResponse

ParticipantAuthenticationResponse

FileDownloadResponse