Nitro-teken (preview)

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst	Class	Regions
Copilot Studio	Premium	Alle Power Automate regio's behalve:      - Amerikaanse overheid (GCC)      - Amerikaanse overheid (GCC High)      - China Cloud beheerd door 21Vianet      - Us Department of Defense (DoD)
Logic-apps	Standard	Alle Logic Apps-regio's , met uitzondering van het volgende:      - Azure Government regio's      - Azure China-regio's      - Us Department of Defense (DoD)
Power Apps	Premium	Alle Power Apps regio's behalve:      - Amerikaanse overheid (GCC)      - Amerikaanse overheid (GCC High)      - China Cloud beheerd door 21Vianet      - Us Department of Defense (DoD)
Power Automate	Premium	Alle Power Automate regio's behalve:      - Amerikaanse overheid (GCC)      - Amerikaanse overheid (GCC High)      - China Cloud beheerd door 21Vianet      - Us Department of Defense (DoD)

Contact
Naam	Nitro-ondersteuning
URL	https://www.gonitro.com/support
Email	prosupport@sfdc.gonitro.com

Connectormetagegevens
Uitgever	Nitro PDF
Website	https://www.gonitro.com/
Privacybeleid	https://www.gonitro.com/legal/privacy-policy
Categorieën	Productiviteit; IT-bewerkingen

Nitro-tekenconnector

Overzicht

De Nitro Sign-connector maakt veilige, end-to-end eSignature-werkstromen rechtstreeks vanuit Power Automate en Power Apps mogelijk. Hiermee kunnen toepassingen enveloppen voor ondertekening maken en beheren, documenten uploaden en opnieuw ordenen, deelnemers toevoegen en ondertekeningsvolgorde definiëren, handtekening- en gegevensvelden plaatsen, documenten verzenden voor handtekening, voortgang bijhouden en de oorspronkelijke, verzegelde en audittrailbestanden downloaden, allemaal via een volledig geautomatiseerde, API-gestuurde benadering.

Publisher: Nitro Software

---

Prerequisites

Als u Nitro Sign via deze connector wilt gebruiken, hebt u het volgende nodig:

• Een Nitro-account waarvoor Nitro Sign is ingeschakeld
  https://developers.gonitro.com/
• Een Microsoft PowerApps of Power Automate plan met mogelijkheden voor aangepaste connectors.

---

Authentication

Nitro Sign maakt gebruik van machine-naar-machine OAuth 2.0 met de clientreferenties die worden verleend om toegangstokens voor API-aanvragen te genereren.

Hoe werkt het?

• U maakt een API-toepassing in de selfserviceportal van Nitro en verkrijgt de bijbehorende client-id en clientgeheim.
• De connector wordt geverifieerd door deze referenties uit te wisselen voor een Bearer-toegangstoken .
• Het token wordt vervolgens gebruikt om volgende Nitro Sign API-aanroepen te autoriseren.

Referenties maken en de gedetailleerde handleiding lezen:
https://developers.gonitro.com/docs/authentication/credentials

Een verbinding maken in Power Automate/Power Apps

Wanneer u de connector toevoegt aan een stroom of app:

1. Klik op Een nieuwe verbinding toevoegen.
2. Voer uw client-id en clientgeheim in (uitgegeven in de Nitro-ontwikkelaarsportal).
3. Selecteer uw Nitro-regio (Europa, Verenigde Staten of APAC) - de regio die is gekoppeld aan uw Nitro-account.
4. Sla de verbinding op: bij eerste gebruik wisselt de connector uw client-id en clientgeheim uit voor een kortstondige toegangstoken met behulp van de toekenning van OAuth 2.0-clientreferenties, slaat deze in de cache op en wordt het automatisch vernieuwd. Uw referenties worden alleen gebruikt om het token te verkrijgen; volgende API-aanroepen worden namens u geverifieerd met een bearer-token.

Opmerking: er is geen gebruikers-interactieve aanmelding vereist; deze stroom is ontworpen voor server-naar-server-/app-naar-app-scenario's.

Ondersteunde bewerkingen

De connector groepeert de acties rond de vier resources van een ondertekeningswerkstroom, enveloppen, documenten, velden en deelnemers , plus een set downloadacties voor het ophalen van voltooide bestanden.

1. Enveloppen

Een envelop is de container voor de documenten, deelnemers en velden in één ondertekeningsaanvraag.

• Enveloppen weergeven
  Retourneert alle enveloppen die zijn gekoppeld aan de toepassing in het account. Resultaten worden gepagineerd: het antwoord bevat een cursortoken volgende pagina , dat u kunt opgeven voor de optionele parameter Page After om de volgende pagina (of Pagina voor naar pagina achteruit) op te halen. Beide cursorparameters bevinden zich onder Geavanceerd en zijn alleen nodig bij het doorlopen van grote resultatensets.

• Envelop maken
  Hiermee maakt u een nieuwe envelop met een naam, meldingsbericht (onderwerp + hoofdtekst, met dynamische variabelen zoals $(sender_name_or_email) en $(envelope_name)) en de ondertekeningsmodus:

  • parallel — alle deelnemers worden op hetzelfde moment op de hoogte gesteld en kunnen zich onafhankelijk ondertekenen.
  • sequential — deelnemers worden één voor één op de hoogte gesteld in de volgorde waarin zij zijn toegevoegd.

• Envelop ophalen op id
  Hiermee worden details opgehaald voor een specifieke envelop door de UUID.

• Envelop bijwerken
  Hiermee werkt u de envelopnaam, meldingsinstellingen en/of ondertekeningsmodus bij. Alle velden zijn optioneel.

• Envelop verwijderen op id
  Hiermee verwijdert u een envelop en alle bijbehorende documenten, velden en deelnemers definitief. Dit kan niet ongedaan worden gemaakt.

• Envelop verzenden voor ondertekening
  Hiermee wordt de envelop verzonden naar deelnemers voor het verzamelen van handtekeningen. Voordat de envelop wordt verzonden, moeten normaal gesproken de bijbehorende documenten, deelnemers en ondertekeningsvelden worden toegevoegd (via Document maken op envelop-id, Deelnemer(s) maken op envelop-id en Veld(en) maken op document-id. Alle documenten in de envelop moeten een geüploade status hebben voordat de envelop kan worden verzonden.

• Herinneringen voor envelop verzenden
  Hiermee worden herinneringsmeldingen geactiveerd voor deelnemers die in behandeling zijn. Als er geen meldingsinstellingen worden opgegeven, wordt de standaardmeldingssjabloon gebruikt die is geconfigureerd voor de envelop.

• Envelop annuleren op id
  Hiermee annuleert u de ondertekeningsaanvraag. Alleen enveloppen die al zijn verzonden voor ondertekening, kunnen worden geannuleerd.

---

2. Documenten

Documenten zijn de bestanden die zijn gekoppeld aan een envelop en ondertekend door deelnemers.

• Documenten weergeven op envelop-id
  Hiermee worden alle documenten opgehaald die aan een envelop zijn gekoppeld.

• Document maken op envelop-id
  Hiermee wordt een document geüpload naar een bestaande envelop. Geef het bestand op plus eenvoudige, getypte velden, zonder handgeschreven JSON:

  • Documentbestand : het bestand dat moet worden geüpload.
  • Documentnaam : de naam waaronder het document moet worden opgeslagen.
  • Inhoudstype(geavanceerd, optioneel) - het MIME-type van het bestand; is standaard ingesteld op application/pdf. Wanneer u dit weglaat, worden alleen PDF-bestanden geaccepteerd.

• Document ophalen op id
  Hiermee worden details opgehaald voor een specifiek document in een envelop.

• Document bijwerken op id
  Hiermee worden documentmetagegevens bijgewerkt. Op dit moment kan alleen de documentnaam worden gewijzigd.

• Document verwijderen op id
  Hiermee verwijdert u een document definitief van een envelop.

• Documenten opnieuw ordenen op envelop-id
  Hiermee worden de documenten in een envelop opnieuw gerangschikt op basis van een opgegeven lijst met document-id's.

---

3. Velden

Velden zijn de interactieve elementen (handtekening, initialen, datum, enzovoort) die op een document zijn geplaatst en aan een deelnemer zijn toegewezen.

• Lijstvelden op document-id
  Hiermee worden alle velden opgehaald die zijn gekoppeld aan een specifiek document.

• Veld(en) maken op document-id
  Hiermee maakt u een of meer velden in een document en wijst u deze toe aan deelnemers. Geef één item op voor één veld of meerdere items voor een bulkaanvraag. Elk veld geeft het volgende op:

  • participantID — de deelnemer die aan het veld is toegewezen.
  • type— een van signature, , initials, name, date, title, , company, , , checkbox. custom
  • page — het paginanummer (indexering op basis van 1).
  • X Position, Y Position, Width, Height — de positie en grootte van het veld, elk ingevoerd als een afzonderlijk getal in punten (X/Y worden gemeten vanaf de linker-/bovenrand van de pagina). Deze vervangen de vorige ene boundingBox matrix, dus elke waarde is een getypt veld in de gebruikersinterface in plaats van een handmatige lijst.
  • Optioneel: required (standaard true) en — onder Geavanceerd — format (bijvoorbeeld MM/DD/YYYY voor datumvelden) en modifiable.

• Veld bijwerken op id
  Hiermee worden eigenschappen van een bestaand veld bijgewerkt. Het veld type moet worden opgegeven en moet overeenkomen met het bestaande veldtype. Het wordt gebruikt om het veldschema te identificeren en wijzigt het veldtype niet .

• Veld verwijderen op id
  Hiermee verwijdert u een veld definitief uit een document.

---

4. Deelnemers

Deelnemers zijn de personen die de envelop ontvangen, ofwel om deze te ondertekenen of op de hoogte te worden gehouden.

• Deelnemers weergeven op envelop-id
  Hiermee worden alle deelnemers opgehaald die zijn gekoppeld aan een envelop.

• Deelnemer(s) maken op envelop-id
  Voegt een of meer deelnemers toe aan een envelop. Geef één item op voor één deelnemer of meerdere items voor een bulkaanvraag. Elke deelnemer geeft het volgende op:

  • email — het e-mailadres van de deelnemer.
  • role — signer (kan velden hebben toegewezen voor ondertekening) of cc (alleen-lezentoegang).
  • authentication (geavanceerd, optioneel) - momenteel toegangscode: een statische toegangscode die de deelnemer moet opgeven voordat deze wordt ondertekend. Open deze sectie alleen als de deelnemer zich moet verifiëren voordat deze wordt ondertekend.

• Deelnemer bijwerken op id
  Hiermee worden de verificatie-instellingen van een deelnemer bijgewerkt. Het e-mailadres van de deelnemer kan niet worden gewijzigd.

• Deelnemer verwijderen op id
  Hiermee verwijdert u een deelnemer definitief uit een envelop.

---

5. Downloads

Haal de voltooide bestanden op zodra documenten zijn ondertekend en verzegeld.

• Oorspronkelijke envelop downloaden
  Downloadt de oorspronkelijke niet-ondertekende documenten van een envelop als een ZIP-archief .

• Verzegelde envelop downloaden
  Downloadt de verzegelde ondertekende documenten, samen met het audittrail, als een ZIP-archief .

• Verzegeld document downloaden op id
  Hiermee downloadt u één verzegeld document als pdf-bestand .

• Audittrail van envelop downloaden
  Hiermee downloadt u het volledige audittrail voor een envelop als PDF-bestand .

Downloadacties maken systeemeigen bestandsnaam en tokens voor bestandsinhoud beschikbaar (plus bestandsinhoudstype). Zet bestandsinhoud rechtstreeks neer in de bestandsinvoer van een downstreamstap, bijvoorbeeld OneDrive/SharePoint Bestand maken en bestandsnaam in de invoer van de bestandsnaam. Er is geen body('Action_Name') expressie of handmatig getypte bestandsnaam vereist. De connector verpakt het gedownloade ZIP- of PDF-bestand in een JSON-envelop, zodat Power Automate deze als gewone tokens voor dynamische inhoud weergeeft.

---

Typische werkstroom voor ondertekening

Een volledige ondertekeningsstroom koppelt de bovenstaande acties in volgorde. Een algemene Power Automate stroom ziet er als volgt uit:

1. Envelop maken : stel de naam, het onderwerp/de hoofdtekst van de melding en de ondertekeningsmodus (parallel of sequential) in. Sla de geretourneerde envelop-id op.
2. Document maken op envelop-id : upload een of meer bestanden naar de envelop (met behulp van de envelop-id uit stap 1). Sla elke geretourneerde document-id op.
   (Optioneel)Documenten opnieuw ordenen op envelop-id : stel de documentvolgorde in.
3. Deelnemer(s) maken op envelop-id : voeg de ondertekenaars en CC-geadresseerden toe met hun verificatie via de toegangscode. Sla elke geretourneerde deelnemer-id op.
4. Veld(en) maken op document-id : plaats handtekening-/datum-/etc.-velden in elk document en wijs deze toe aan deelnemers (met behulp van de document-id uit stap 2 en de deelnemer-id uit stap 3).
5. Envelop verzenden voor ondertekening : verzend de envelop. Alle documenten moeten eerst de geüploade status hebben.
6. (Terwijl dit in behandeling is)Verzend herinneringen voor envelop om deelnemers te vervelen, of annuleer envelop per id om de aanvraag te stoppen.
7. (Wanneer voltooid)Download verzegeld / document / met idAudittrail van envelop downloaden om de voltooide bestanden op te halen.

Tip: De envelop-id, document-id en deelnemer-id die door de acties voor maken worden geretourneerd, stromen natuurlijk naar de latere acties via de kiezer voor dynamische inhoud van Power Automate: kies het id-token uit de upstream-actie in plaats van het te typen.

---

Fouten en beperking

De Nitro Sign-API kan de volgende fouten retourneren:

• 400 — Ongeldige aanvraag
• 401 — Niet geautoriseerd
• 404 — Niet gevonden
• 409 — Conflict (bijvoorbeeld handelen op een envelop in een toestand die de bewerking niet toestaat)
• 413 — Inhoud te groot
• 415 — Niet-ondersteund mediatype
• 422 — Niet-verwerkte entiteit
• 500 — Interne serverfout

Snelheidsbeperking

• API-aanroepen per verbinding: 100 per 60 seconden.

---

Platformlimieten

Bestandsgrootte

• Maximum: 25 MB per aanvraag
  Is van toepassing op bewerkingen met één bestand en meerdere bestanden.

Aantal pagina's

• Maximum: 250 pagina's per afzonderlijk document
  Totaal aantal gecombineerde pagina's in meerdere documenten kan groter zijn dan 250.

Bewaartijd

• Invoer- en uitvoerbestanden worden ongeveer 15 minuten na voltooiing van de bewerking verwijderd.

---

Opmerkingen

• Envelop-, document-, veld- en deelnemersbeheeracties retourneren JSON.
• Downloadacties retourneren het bestand (ZIP of PDF) dat is verpakt in een JSON-envelop met de bestandsnaam, het bestandstype en bestandsinhoud als systeemeigen tokens, zodat resultaten kunnen worden gekoppeld aan een downstreambestandsactie zonder expressies.
• De ondertekeningsmodus (parallel vs sequential) wordt ingesteld wanneer de envelop wordt gemaakt en kan worden gewijzigd met Envelop bijwerken voordat de envelop wordt verzonden.
• Verificatie van deelnemers ondersteunt momenteel alleen toegangscode .

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:

Standaard	Parameters voor het maken van verbinding.	Alle regio's	Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam	Typ	Description	Required
Nitro-client-id	beveiligde string	Client-id van uw Nitro-toepassing	True
Nitro-clientgeheim	beveiligde string	Clientgeheim van uw Nitro-toepassing	True
Nitro-regio	string	Selecteer de Nitro-API-regio voor uw account.	True

Acties

Audittrail van envelop downloaden	Hiermee downloadt u het PDF-bestand met het volledige audittrail voor de geselecteerde Nitro Sign-envelop.
Deelnemer(s) maken op envelop-id	Voegt een of meer deelnemers toe aan een Nitro Sign-envelop. Als u één deelnemer wilt toevoegen, geeft u één item op in de matrix Deelnemers. Als u meerdere deelnemers wilt toevoegen, geeft u meerdere items op.
Deelnemer bijwerken op id	Hiermee werkt u de verificatie-instellingen voor een deelnemer in een Nitro Sign-envelop bij. Het e-mailadres van de deelnemer kan niet worden bijgewerkt.
Deelnemer verwijderen op id	Hiermee verwijdert u een deelnemer definitief uit een Nitro Sign-envelop.
Deelnemers weergeven op envelop-id	Haalt alle deelnemers op die zijn gekoppeld aan een specifieke Nitro Sign-envelop.
Document bijwerken op id	Hiermee werkt u de metagegevens van een bestaand document bij in een Nitro Sign-envelop. Op dit moment kan alleen de documentnaam worden bijgewerkt.
Document maken op envelop-id	Uploadt een document naar een bestaande Nitro Sign-envelop. Het document kan later worden gebruikt in de werkstroom voor ondertekening.
Document ophalen op id	Hiermee worden details opgehaald voor een specifiek document in een Nitro Sign-envelop.
Document verwijderen op id	Hiermee verwijdert u een document definitief uit een Nitro Sign-envelop.
Documenten opnieuw ordenen op envelop-id	Hiermee rangschikt u de volgorde van documenten die zijn gekoppeld aan een specifieke Nitro Sign-envelop op basis van de opgegeven lijst met document-id's.
Documenten weergeven op envelop-id	Hiermee haalt u alle documenten op die zijn gekoppeld aan een specifieke Nitro Sign-envelop.
Envelop annuleren op id	Annuleert de ondertekeningsaanvraag voor een Nitro Sign-envelop. Alleen enveloppen die zijn verzonden voor ondertekening, kunnen worden geannuleerd.
Envelop bijwerken	Hiermee werkt u een bestaande Nitro Sign-envelop bij. U kunt de naam van de envelop, meldingsinstellingen, de ondertekeningsmodus of een combinatie van deze velden wijzigen.
Envelop maken	Hiermee maakt u een nieuwe Nitro Sign-envelop die later kan worden gevuld met documenten, deelnemers, velden en verzonden voor ondertekening.
Envelop ophalen op id	Hiermee haalt u details op voor een specifieke Nitro Sign-envelop met behulp van de unieke envelop-id.
Envelop verwijderen op id	Hiermee verwijdert u definitief een Nitro Sign-envelop. Deze bewerking kan niet ongedaan worden gemaakt en alle gekoppelde documenten, velden en deelnemers worden ook verwijderd.
Envelop verzenden voor ondertekening	Hiermee wordt een Nitro-tekenvelop verzonden naar deelnemers voor de handtekeningverzameling. Voordat u deze actie gebruikt, moeten voor de envelop normaal gesproken documenten, deelnemers en ondertekeningsvelden worden toegevoegd met behulp van Document maken op envelop-id, Deelnemer(s) maken op envelop-id en Veld(en) maken op document-id. Alle documenten in de envelop moeten een geüploade status hebben voordat de envelop kan worden verzonden.
Enveloppen weergeven	Het eindpunt List Envelopes retourneert alle enveloppen die zijn gekoppeld aan een toepassing in een account.
Herinneringen voor envelop verzenden	Hiermee worden herinneringsmeldingen geactiveerd voor deelnemers die in behandeling zijn bij een opgegeven Nitro Sign-envelop. Als er geen meldingsinstellingen worden opgegeven, wordt de standaardmeldingssjabloon gebruikt die is geconfigureerd voor de envelop.
Lijstvelden op document-id	Hiermee worden alle velden opgehaald die zijn gekoppeld aan een specifiek document binnen een Nitro Sign-envelop.
Oorspronkelijke envelop downloaden	Downloadt de oorspronkelijke niet-ondertekende documenten van een Nitro Sign-envelop als een ZIP-archief.
Veld(en) maken op document-id	Hiermee maakt u een of meer velden in een document en wijst u deze toe aan deelnemers. Als u één veld wilt maken, geeft u één item op in de matrix Velden. Als u meerdere velden wilt maken, geeft u meerdere items op.
Veld bijwerken op id	Hiermee worden eigenschappen van een bestaand veld in een Nitro Sign-document bijgewerkt. Het veldtype moet worden opgegeven en moet overeenkomen met het bestaande veldtype; het wordt gebruikt door de API om het veldschema te identificeren en wijzigt het veldtype niet.
Veld verwijderen op id	Hiermee verwijdert u een veld definitief uit een document in een Nitro Sign-envelop.
Verzegeld document downloaden op id	Hiermee downloadt u één verzegeld ondertekend document van een Nitro Sign-envelop als PDF-bestand.
Verzegelde envelop downloaden	Downloadt de verzegelde ondertekende documenten van een Nitro Sign-envelop, samen met het audittrail, als een ZIP-archief.

Audittrail van envelop downloaden

Deelnemer(s) maken op envelop-id

Deelnemer bijwerken op id

Deelnemer verwijderen op id

Deelnemers weergeven op envelop-id

Document bijwerken op id

Document maken op envelop-id

Document ophalen op id

Document verwijderen op id

Documenten opnieuw ordenen op envelop-id

Documenten weergeven op envelop-id

Envelop annuleren op id

Envelop bijwerken

Envelop maken

Envelop ophalen op id

Envelop verwijderen op id

Envelop verzenden voor ondertekening

Enveloppen weergeven

Herinneringen voor envelop verzenden

Lijstvelden op document-id

Oorspronkelijke envelop downloaden

Veld(en) maken op document-id

Veld bijwerken op id

Veld verwijderen op id

Verzegeld document downloaden op id

Verzegelde envelop downloaden

Definities

EnvelopNotification

EnvelopSummaryResponse

EnvelopResponse

ListDocumentsByEnvelopeIDResponse

DocumentResponse

FieldsResponse

FieldResponse

Deelnemers reageren

ParticipantsListResponse

ParticipantResponse

ParticipantAuthenticationResponse

FileDownloadResponse