Teken markeren (preview)

Mark Sign is een gekwalificeerde elektronische handtekeningservice die voldoet aan de eIDAS-regelgeving. Verzend documenten voor ondertekening, wacht op de handtekeningen, download en valideer de ondertekende bestanden.

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

Service 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)
Logische 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
Name Id markeren, UAB
URL https://marksign.eu
E-mailadres pagalba@marksign.lt
Connectormetagegevens
Publisher Id markeren, UAB
Website https://marksign.eu
Privacybeleid https://marksign.eu/privacy-policy
Categories Productiviteit; Inhoud en bestanden

Teken markeren

Mark Sign is een gekwalificeerde elektronische handtekeningservice die voldoet aan de eIDAS-verordening. Een stroom kan een document verzenden voor ondertekening, wachten totdat het is ondertekend, het ondertekende bestand downloaden en valideren.

Publisher: Id markeren, UAB

Prerequisites

U hebt een Mark Sign API-toegangstoken nodig. Zie Referenties verkrijgen hieronder.

Ondersteunde bewerkingen

Document: Uploaden

Uploadt een document (PDF, ADoc, BDoc of ASiC-E) en bereidt het voor op ondertekening. De bestandsnaam wordt de titel van het document.

Ondertekening: Uitnodigen per e-mail

Nodigt een persoon uit om te ondertekenen; Mark Sign verzendt de uitnodigings-e-mail. Als u het opnieuw belt voor dezelfde persoon, wordt er een herinnering verzonden.

Ondertekening: Uitnodigen op URL

Voegt een ondertekenaar toe zonder een e-mailbericht te verzenden en retourneert de persoonlijke uitnodigings-URL die u kunt bezorgen.

Ondertekenen: wachten op alle ondertekenaars

Bevat de stroom totdat het document is ondertekend of geweigerd, of eindigt met de timed_out status wanneer de wachttijd (standaard 29 dagen) is verlopen.

Ondertekening: Wacht tot één ondertekenaar

Houdt de stroom vast totdat één bepaalde ondertekenaar, gekozen per e-mail, tekent. Elke afwijzing beëindigt ook de wachttijd.

Ondertekenen: Wachten op volgende ondertekenaar

Hervat de stroom op het moment dat de volgende ondertekenaar tekent of afwijst, zonder polling.

Document: Status ophalen

Hiermee wordt de algehele ondertekeningsstatus van het document gecontroleerd.

Document: Ondertekenaars ophalen

Geeft de status van elke ondertekenaar weer, inclusief de reden voor afwijzing als een ondertekenaar deze heeft afgewezen.

Document: Downloaden

Downloadt het document met alle handtekeningen die tot nu toe zijn verzameld.

Document: Lijst

Geeft een lijst weer van de documenten in uw werkruimte, met tekstzoekopdrachten en paging.

Document: Verwijderen

Hiermee verwijdert u een document uit de werkruimte.

Document: Uploaden als container

Combineert verschillende bestanden in één ondertekenbaar containerdocument (ADoc, BDoc of ASiC-E). Facturering volgt de standaardtekentekenwaarde, waarbij elke ondertekenaar betaalt.

Hiermee maakt u een persoonlijke ondertekeningskoppeling voor elke ondertekenaar om uzelf te leveren. De koppelingen verlopen, kunnen identiteitsverificatie vereisen en zijn de enige ondertekeningspagina's met een weigeringsoptie.

Hiermee maakt u één koppeling die iedereen kan openen om de documenten te ondertekenen, elk onder hun eigen geverifieerde identiteit.

Hiermee verwijdert u een ondertekenaarkoppeling of gedeelde koppeling voordat deze verloopt.

Document: Geldigheid van handtekening uitbreiden

Hiermee worden de documenthandtekeningen bijgewerkt voor langetermijnvalidatie (LT) of langetermijnarchivering (LTA).

Document: Valideren

Controleert de handtekeningen van een document en retourneert het volledige validatierapport.

Referenties verkrijgen

Neem contact op met de klantondersteuning van Mark Sign om pagalba@marksign.lt een API-toegangstoken voor uw werkruimte aan te vragen. Wanneer u een verbinding in Power Automate maakt, plakt u het token in het veld API-sleutel.

Het token is gekoppeld aan één werkruimte, dus elk document dat via de verbinding wordt gemaakt of vermeld, behoort tot die werkruimte.

Getting Started

De eenvoudigste ondertekeningsstroom:

  1. Document: Uploaden (bijvoorbeeld de bestandsinhoud en naamtokens uit SharePoint of OneDrive).
  2. Ondertekening: uitnodigen per e-mail. Markeer onderteken de uitnodiging.
  3. Ondertekening: Wacht tot de volgende ondertekenaar. De stroom wordt hier onderbroken totdat de ondertekening plaatsvindt.
  4. Document: Download en sla het op waar u het nodig hebt.

Met verschillende ondertekenaars gebruikt u Ondertekenen: Uitnodigen per e-mail voor elke persoon en vervolgens één handtekening: Wacht totdat alle ondertekenaars vóór de download worden gedownload. Als u de koppelingen zelf wilt bezorgen in plaats van e-mailberichten markeren, gebruikt u Ondertekenen: Uitnodigen per URL of Ondertekening: Ondertekenkoppelingen maken en elke persoon hun koppeling verzenden met uw eigen Outlook- of Teams-actie.

Bekende problemen en beperkingen

  • De connector biedt geen stroomtriggers; gebruik in plaats daarvan de wachtbewerkingen in een stroom.
  • Een document heeft één meldingsregistratie. Voer niet twee ondertekeningen uit: wacht op de volgende stappen voor ondertekenaar op hetzelfde document tegelijk. De tweede vervangt de eerste en de eerste stap wacht totdat er een time-out optreedt. Als u een callback-URL-veld op een blok invult, wordt de registratie ook vervangen.
  • Ondertekenaars kunnen een document alleen weigeren op een ondertekeningspagina: Pagina voor ondertekenaarkoppelingen maken (met de knop Weigeren weergeven ingeschakeld); e-mailuitnodigingen, uitnodigings-URL's en gedeelde koppelingen bieden geen optie voor weigeren.
  • Mark Sign meldt alleen over handtekeningen. Wanneer een uitnodigingsblok gebruikmaakt van een doel van review of confirmation, wordt de actie van die persoon nooit geactiveerd als ondertekening: wacht op volgende ondertekenaar; controleer de status van het document: in plaats daarvan ondertekenaars ophalen .
  • Document: Downloaden retourneert alleen de bestandsinhoud; neem de bestandsnaam uit Document: Lijst of vanuit de uploadstap.
  • Een stroomuitvoering kan maximaal 30 dagen (een Power Automate limiet) duren, zodat er geen wachttijd kan worden uitgevoerd. Ondertekening: Wacht op alle ondertekenaars en ondertekening: wacht standaard tot één ondertekenaar eindigt met de timed_out status na 29 dagen. Voor ondertekening: Wacht op volgende ondertekenaar, stel een time-out in (bijvoorbeeldP29D) in de actie-instellingen en voeg een vertakking toe die is geconfigureerd om uit te voeren nadat er een time-out is opgetreden voor de actie. Als de limiet van 30 dagen eerst wordt bereikt, annuleert Power Automate de hele uitvoering en wordt deze niet verwerkt door een vertakking.
  • Document: Lijst biedt geen ondersteuning voor filteren op status.
  • Document: Upload accepteert één bestand per aanroep; loop over bijlagen om meerdere te uploaden. Document: Uploaden als container is bedoeld voor een paar bestanden; het combineren van veel grote bestanden in één aanroep kan de verwerkingstijdslimiet overschrijden.

Implementatie-instructies

Voer paconn create --api-prop apiProperties.json --api-def apiDefinition.swagger.json --script script.csx --icon icon.png deze uit om deze connector te implementeren als een aangepaste connector in uw Power Platform-omgeving. Zie de paconn-documentatie voor meer informatie.

Support

Neem contact op pagalba@marksign.ltmet de connector of de Mark Sign-API voor problemen.

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:

Default 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.

Name Type Description Required
API-sleutel beveiligde string Het Mark Sign API-toegangstoken van uw werkruimte. Vraag er een aan bij mark sign-ondersteuning op pagalba@marksign.lt. True

Acties

Document: Downloaden

Downloadt het document met alle handtekeningen die tot nu toe zijn verzameld.

Document: Geldigheid van handtekening uitbreiden

Hiermee worden de documenthandtekeningen bijgewerkt voor langdurige geldigheid of archivering.

Document: Lijst

Hier ziet u de documenten in uw werkruimte, de nieuwste eerst.

Document: Ondertekenaars ophalen

Toont de ondertekenaars van een document met hun ondertekeningsstatus.

Document: Status ophalen

Hiermee haalt u de ondertekeningsstatus van een document op.

Document: Uploaden

Uploadt een document en bereidt het voor op ondertekening.

Document: Uploaden als container

Combineert verschillende bestanden in één ondertekenbaar containerdocument, zoals een ADoc of ASiC-E. De bestanden worden in één stap geüpload en gecombineerd.

Document: Valideren

Controleert de handtekeningen van een document en retourneert het validatierapport. De stroom wacht totdat de controle is voltooid.

Document: Verwijderen

Hiermee verwijdert u een document uit uw werkruimte.

Ondertekenen: wachten op alle ondertekenaars

Wacht totdat elke ondertekenaar het document heeft ondertekend of iemand het document heeft afgewezen, waarna de stroom kan worden voortgezet. Eindigt met de status timed_out wanneer de tijd op is.

Ondertekenen: Wachten op volgende ondertekenaar

Wacht totdat de volgende ondertekenaar het document ondertekent of weigert, zonder uitnodigingen te verzenden. Gebruik deze in een lus om te wachten op verschillende ondertekenaars zonder polling.

Ondertekening: Gedeelde koppeling maken

Hiermee maakt u één ondertekeningskoppeling die iedereen kan openen om de documenten te ondertekenen. Je levert het zelf.

Ondertekening: koppeling verwijderen

Hiermee verwijdert u een ondertekenaarkoppeling of gedeelde koppeling voordat deze verloopt. Uitnodigingskoppelingen kunnen niet worden verwijderd.

Ondertekening: Koppelingen voor ondertekenaar maken

Hiermee maakt u een persoonlijke ondertekeningskoppeling voor elke ondertekenaar. U levert de koppelingen zelf, bijvoorbeeld per e-mail of Teams-bericht.

Ondertekening: Uitnodigen op URL

Voegt een ondertekenaar toe aan het document zonder een e-mailbericht te verzenden en retourneert de persoonlijke uitnodigingskoppeling die u kunt bezorgen. De koppeling verloopt niet en kan niet worden verwijderd; gebruik 'Ondertekening: ondertekenkoppelingen maken' wanneer u koppelingen nodig hebt die u kunt intrekken.

Ondertekening: Uitnodigen per e-mail

Nodigt een persoon uit om het document te ondertekenen. Mark Sign verzendt de uitnodiging per e-mail.

Ondertekening: Wacht tot één ondertekenaar

Wacht totdat een bepaalde ondertekenaar het document ondertekent, waarna de stroom kan worden voortgezet. Eindigt met de status timed_out wanneer de tijd op is.

Document: Downloaden

Downloadt het document met alle handtekeningen die tot nu toe zijn verzameld.

Parameters

Naam Sleutel Vereist Type Description
Document-ID
documentId True string

De id van het document, uit de uitvoer van 'Document: Uploaden', 'Document: Uploaden als container' of 'Document: Lijst'.

Retouren

De inhoud van het documentbestand.

Bestandsinhoud
file

Document: Geldigheid van handtekening uitbreiden

Hiermee worden de documenthandtekeningen bijgewerkt voor langdurige geldigheid of archivering.

Parameters

Naam Sleutel Vereist Type Description
Document-ID
documentId True string

De id van het document, uit de uitvoer van 'Document: Uploaden', 'Document: Uploaden als container' of 'Document: Lijst'.

Level
level True string

LT voor langetermijnvaliditeit, LTA voor langetermijnarchivering.

Retouren

Document: Lijst

Hier ziet u de documenten in uw werkruimte, de nieuwste eerst.

Parameters

Naam Sleutel Vereist Type Description
Zoekopdracht
query string

Een woordgroep die moet worden gezocht in documenttitels en bestandsnamen.

Offset
offset integer

Hoeveel documenten u wilt overslaan.

Limit
limit integer

Hoeveel documenten moeten worden geretourneerd. De standaardwaarde is 10.

Retouren

Naam Pad Type Description
Status
status RequestStatus

De status van de aanvraag.

Documenten:
data array of object

De documenten.

Document-ID
data.uuid string

De id van het document.

Bestandsnaam
data.filename string

De naam van het bestand.

Documentstatus
data.status string

De ondertekeningsstatus van het document, zoals opgeslagen (wachten op handtekeningen), signed_partially of ondertekend.

Geüpload op
data.uploaded_at date-time

Toen het document werd geüpload.

Total
total integer

Het totale aantal overeenkomende documenten.

Document: Ondertekenaars ophalen

Toont de ondertekenaars van een document met hun ondertekeningsstatus.

Parameters

Naam Sleutel Vereist Type Description
Document-ID
documentId True string

De id van het document, uit de uitvoer van 'Document: Uploaden', 'Document: Uploaden als container' of 'Document: Lijst'.

Retouren

Naam Pad Type Description
Status
status RequestStatus

De status van de aanvraag.

Ondertekenaars:
data array of object

De ondertekenaars van het document.

Ondertekenaar-id
data.id string

De id van de ondertekenaar.

Voornaam
data.name string

De voornaam van de ondertekenaar.

Achternaam
data.surname string

De achternaam van de ondertekenaar.

E-mailadres
data.email string

Het e-mailadres van de ondertekenaar.

Ondertekeningsstatus
data.status string

Of de ondertekenaar is ondertekend: in behandeling, ondertekend, afgewezen, controleren, bevestigen, geweigerd of beoordeeld.

Reden voor afwijzing
data.rejection_reason string

De reden waarom de ondertekenaar heeft opgegeven bij het weigeren van het document.

Document: Status ophalen

Hiermee haalt u de ondertekeningsstatus van een document op.

Parameters

Naam Sleutel Vereist Type Description
Document-ID
documentId True string

De id van het document, uit de uitvoer van 'Document: Uploaden', 'Document: Uploaden als container' of 'Document: Lijst'.

Retouren

Naam Pad Type Description
Status
status RequestStatus

De status van de aanvraag.

Documentstatus
data.document_status string

De ondertekeningsstatus: opgeslagen (wachten op handtekeningen), signed_partially (sommige zijn ondertekend) of ondertekend (iedereen heeft ondertekend).

Document: Uploaden

Uploadt een document en bereidt het voor op ondertekening.

Parameters

Naam Sleutel Vereist Type Description
Bestandsnaam
file_name True string

De naam van het bestand met de extensie, bijvoorbeeld contract.pdf. Het wordt de titel van het document.

body
body True binary
Access
access string

Wie kan het document bekijken. De standaardwaarde is privé.

Factureringstype
billing_type True string

Wie betaalt voor de handtekeningen.

Retouren

Naam Pad Type Description
Status
status RequestStatus

De status van de aanvraag.

Document-ID
data.uuid string

De id van het document.

Bestandsnaam
data.filename string

De naam van het bestand.

Document: Uploaden als container

Combineert verschillende bestanden in één ondertekenbaar containerdocument, zoals een ADoc of ASiC-E. De bestanden worden in één stap geüpload en gecombineerd.

Parameters

Naam Sleutel Vereist Type Description
Documenttype
document_type True string

Het type document dat moet worden gemaakt.

Bestandsnaam
file_name True string

De naam van het bestand met de extensie, bijvoorbeeld contract.pdf.

Bestandsinhoud
file_content True byte

De inhoud van het bestand.

Bestandstype (alleen ADoc)
adoc_file_type string

De rol van het bestand in de container. Alleen gebruikt wanneer het documenttype een ADoc is.

Retouren

Naam Pad Type Description
Status
status RequestStatus

De status van de aanvraag.

Document-ID
data.uuid string

De id van het document.

Bestandsnaam
data.filename string

De naam van het documentbestand.

Document: Valideren

Controleert de handtekeningen van een document en retourneert het validatierapport. De stroom wacht totdat de controle is voltooid.

Parameters

Naam Sleutel Vereist Type Description
Document-ID
documentId True string

De id van het document, uit de uitvoer van 'Document: Uploaden', 'Document: Uploaden als container' of 'Document: Lijst'.

Retouren

Naam Pad Type Description
Status
status RequestStatus

De status van de aanvraag.

Is het geldig
data.document.is_valid boolean

Of de documenthandtekeningen geldig zijn.

Geldig tot
data.document.valid_to string

Hoe lang het document geldig blijft.

Documentnaam
data.document.name string

De titel van het document.

MIME-type
data.document.mimetype string

Het bestandstype van het document.

Handtekeningen:
data.signatures array of object

Het resultaat voor elke handtekening.

Handtekening-id
data.signatures.id string

De id van de handtekening.

Ondertekeningstijd
data.signatures.signing_time string

Toen de handtekening werd gemaakt.

Handtekeningindeling
data.signatures.signature_format string

De indeling van de handtekening.

Is het geldig
data.signatures.is_valid boolean

Of de handtekening geldig is.

Geldig tot
data.signatures.valid_to string

Hoe lang de handtekening geldig blijft.

Certificaten
data.certificates array of object

De certificaten die door de handtekeningen worden gebruikt.

items
data.certificates object
Tijdstempels
data.timestamps array of object

De tijdstempels die zijn toegepast op het document.

items
data.timestamps object
Validatietijd
metadata.validation_time string

Toen de validatie werd uitgevoerd.

Document: Verwijderen

Hiermee verwijdert u een document uit uw werkruimte.

Parameters

Naam Sleutel Vereist Type Description
Document-ID
documentId True string

De id van het document, uit de uitvoer van 'Document: Uploaden', 'Document: Uploaden als container' of 'Document: Lijst'.

Retouren

Ondertekenen: wachten op alle ondertekenaars

Wacht totdat elke ondertekenaar het document heeft ondertekend of iemand het document heeft afgewezen, waarna de stroom kan worden voortgezet. Eindigt met de status timed_out wanneer de tijd op is.

Parameters

Naam Sleutel Vereist Type Description
Document-ID
documentId True string

De id van het document, uit de uitvoer van 'Document: Uploaden', 'Document: Uploaden als container' of 'Document: Lijst'.

Time-out (minuten)
timeout_minutes integer

Hoe lang moet u wachten, in minuten, voordat u eindigt met de status timed_out. De standaardwaarde is 41760 (29 dagen), maximum is 43200 (30 dagen).

Retouren

Ondertekenen: Wachten op volgende ondertekenaar

Wacht totdat de volgende ondertekenaar het document ondertekent of weigert, zonder uitnodigingen te verzenden. Gebruik deze in een lus om te wachten op verschillende ondertekenaars zonder polling.

Parameters

Naam Sleutel Vereist Type Description
Document-ID
documentId True string

De id van het document, uit de uitvoer van 'Document: Uploaden', 'Document: Uploaden als container' of 'Document: Lijst'.

Retouren

Ondertekening: Gedeelde koppeling maken

Hiermee maakt u één ondertekeningskoppeling die iedereen kan openen om de documenten te ondertekenen. Je levert het zelf.

Parameters

Naam Sleutel Vereist Type Description
Document-ID's
documents True array of string

De documenten die de koppeling ondertekent. Gebruik document-id-waarden uit de stappen voor uploaden of lijsten.

URL voor aanroep
callback_url string

Een URL om te melden wanneer het document is ondertekend.

Verlopen na (minuten)
expire_after integer

Minuten totdat de koppeling verloopt. De standaardwaarde is 2880 (twee dagen).

Document verwijderen na (minuten)
delete_document_after integer

Minuten totdat het document uit de werkruimte is verwijderd. Deze wordt standaard bewaard.

Retouren

Naam Pad Type Description
Status
status RequestStatus

De status van de aanvraag.

Koppeling voor ondertekening
data.signing_link string

De koppeling die iedereen kan openen om te ondertekenen.

Id van ondertekeningskoppeling
data.signing_link_id string

De id van de koppeling voor 'Ondertekening: koppeling verwijderen'.

Geldig tot
data.valid_until integer

Wanneer de koppeling verloopt, als een Unix-tijdstempel.

Ondertekening: koppeling verwijderen

Hiermee verwijdert u een ondertekenaarkoppeling of gedeelde koppeling voordat deze verloopt. Uitnodigingskoppelingen kunnen niet worden verwijderd.

Parameters

Naam Sleutel Vereist Type Description
Id van ondertekeningskoppeling
temporarySigningLinkId True string

De id van de ondertekeningskoppeling uit de uitvoer van 'Ondertekening: koppelingen voor ondertekenaar maken' of 'Ondertekening: gedeelde koppeling maken'.

Retouren

Ondertekening: Koppelingen voor ondertekenaar maken

Hiermee maakt u een persoonlijke ondertekeningskoppeling voor elke ondertekenaar. U levert de koppelingen zelf, bijvoorbeeld per e-mail of Teams-bericht.

Parameters

Naam Sleutel Vereist Type Description
Document-ID's
documents True array of string

De documenten voor het maken van ondertekeningskoppelingen voor. Gebruik document-id-waarden uit de stappen voor uploaden of lijsten.

Ondertekenaar-id
id string

Uw eigen id voor de ondertekenaar, uniek binnen de aanvraag. Vereist wanneer e-mail leeg is.

Voornaam
name string

De voornaam van de ondertekenaar.

Achternaam
surname string

De achternaam van de ondertekenaar.

E-mailadres
email email

Het e-mailadres van de ondertekenaar. Vereist wanneer de ondertekenaar-id leeg is.

Persoonlijke code
personal_code string

De persoonlijke code van de ondertekenaar. Vereist wanneer verificatie is vereist.

Verificatie vereisen
authentication_required boolean

Zo ja, dan moet de ondertekenaar zijn of haar identiteit verifiëren voordat de koppeling wordt geopend.

Positie (alleen ADoc)
position string

De functiepositie van de ondertekenaar, weergegeven in ADoc-handtekeningen.

Afdeling (alleen ADoc)
structural_subdivision string

De afdeling ondertekenaar, weergegeven in ADoc-handtekeningen.

Ondertekeningsdoel (alleen ADoc)
signing_purpose string

Waarom de persoon tekent, weergegeven in ADoc-handtekeningen.

URL voor aanroep
callback_url string

Een URL om te melden wanneer het document is ondertekend.

Callback-URL voor afwijzing
reject_callback_url string

Een URL om een melding te ontvangen wanneer een ondertekenaar het document weigert.

Verlopen na (minuten)
expire_after integer

Minuten totdat de koppeling verloopt. De standaardwaarde is 2880 (twee dagen).

Toon afkeurknop
show_reject_button boolean

Of ondertekenaars het document op de ondertekeningspagina kunnen weigeren. De standaardwaarde is ja.

Document verwijderen na (minuten)
delete_document_after integer

Minuten totdat het document uit de werkruimte is verwijderd. Deze wordt standaard bewaard.

Retouren

Naam Pad Type Description
Status
status RequestStatus

De status van de aanvraag.

Ondertekeningskoppelingen:
temporary_signing_links array of object

Eén ondertekeningskoppeling per ondertekenaar.

Ondertekenaar-id
temporary_signing_links.id string

Uw eigen id voor de ondertekenaar.

Voornaam
temporary_signing_links.member_name string

De voornaam van de ondertekenaar.

Achternaam
temporary_signing_links.member_surname string

De achternaam van de ondertekenaar.

E-mailadres
temporary_signing_links.member_email string

Het e-mailadres van de ondertekenaar.

Koppeling voor ondertekening
temporary_signing_links.temporary_signing_link string

De koppeling die de ondertekenaar opent om het document te ondertekenen.

Id van ondertekeningskoppeling
temporary_signing_links.temporary_signing_link_id string

De id van de ondertekeningskoppeling.

Geldig tot
temporary_signing_links.valid_until integer

Wanneer de koppeling verloopt, als een Unix-tijdstempel.

Documenten:
documents array of object

De documenten waarvoor de koppelingen zijn gemaakt.

Document-ID
documents.uuid string

De id van het document.

Bestandsnaam
documents.filename string

De naam van het documentbestand.

Ondertekening: Uitnodigen op URL

Voegt een ondertekenaar toe aan het document zonder een e-mailbericht te verzenden en retourneert de persoonlijke uitnodigingskoppeling die u kunt bezorgen. De koppeling verloopt niet en kan niet worden verwijderd; gebruik 'Ondertekening: ondertekenkoppelingen maken' wanneer u koppelingen nodig hebt die u kunt intrekken.

Parameters

Naam Sleutel Vereist Type Description
Document-ID
documentId True string

De id van het document, uit de uitvoer van 'Document: Uploaden', 'Document: Uploaden als container' of 'Document: Lijst'.

Voornaam
name True string

De voornaam van de ondertekenaar.

Achternaam
surname True string

De achternaam van de ondertekenaar.

E-mailadres
email True email

Het e-mailadres van de ondertekenaar.

Geslaagde URL
success_url string

Waar kan de ondertekenaar worden verzonden nadat ze klaar zijn met ondertekenen.

Purpose
purpose string

Waarom de persoon wordt uitgenodigd. Kies controleren om alleen te worden uitgenodigd voor weergave.

URL voor aanroep
callback_url string

Een URL om te melden wanneer het document is ondertekend.

Retouren

Naam Pad Type Description
Status
status RequestStatus

De status van de aanvraag.

Uitnodigings-URL
data.invitation_url string

De koppeling naar de persoonlijke ondertekeningspagina om aan de ondertekenaar te leveren.

Ondertekening: Uitnodigen per e-mail

Nodigt een persoon uit om het document te ondertekenen. Mark Sign verzendt de uitnodiging per e-mail.

Parameters

Naam Sleutel Vereist Type Description
Document-ID
documentId True string

De id van het document, uit de uitvoer van 'Document: Uploaden', 'Document: Uploaden als container' of 'Document: Lijst'.

Voornaam
name True string

De voornaam van de ondertekenaar.

Achternaam
surname True string

De achternaam van de ondertekenaar.

E-mailadres
email True email

Het e-mailadres van de ondertekenaar.

Language
language string

De taal van de uitnodiging. De standaardwaarde is Litouws.

Geslaagde URL
success_url string

Waar kan de ondertekenaar worden verzonden nadat ze klaar zijn met ondertekenen.

Purpose
purpose string

Waarom de persoon wordt uitgenodigd. Kies controleren om alleen te worden uitgenodigd voor weergave.

URL voor aanroep
callback_url string

Een URL om te melden wanneer het document is ondertekend.

Retouren

Ondertekening: Wacht tot één ondertekenaar

Wacht totdat een bepaalde ondertekenaar het document ondertekent, waarna de stroom kan worden voortgezet. Eindigt met de status timed_out wanneer de tijd op is.

Parameters

Naam Sleutel Vereist Type Description
Document-ID
documentId True string

De id van het document, uit de uitvoer van 'Document: Uploaden', 'Document: Uploaden als container' of 'Document: Lijst'.

E-mailadres van ondertekenaar
signer_email True string

Het e-mailadres van de ondertekenaar waarop moet worden gewacht, dezelfde e-mail die wordt gebruikt bij het uitnodigen van de persoon.

Time-out (minuten)
timeout_minutes integer

Hoe lang moet u wachten, in minuten, voordat u eindigt met de status timed_out. De standaardwaarde is 41760 (29 dagen), maximum is 43200 (30 dagen).

Retouren

Definities

SigningEvent

Naam Pad Type Description
Document-ID
uuid string

De id van het document.

Documentstatus
status string

De ondertekeningsstatus van het document, zoals ondertekend of signed_partially. Een afwijzing wordt weergegeven in de statussen van de ondertekenaar.

Aantal ondertekenaar
members_count integer

Hoeveel mensen zijn uitgenodigd om te ondertekenen.

Aantal ondertekend
signed_members_count integer

Hoeveel mensen hebben er getekend.

Ondertekenaars:
members array of object

Iedereen die is uitgenodigd om te ondertekenen.

Ondertekenaar-id
members.id string

De id van de ondertekenaar.

Voornaam
members.member_name string

De voornaam van de ondertekenaar.

Achternaam
members.member_surname string

De achternaam van de ondertekenaar.

E-mailadres
members.member_email string

Het e-mailadres van de ondertekenaar.

Ondertekeningsstatus
members.status string

De status van de ondertekenaar, zoals in behandeling, ondertekend of afgewezen.

AcknowledgedResponse

Naam Pad Type Description
Status
status RequestStatus

De status van de aanvraag.

SigningWaitResponse

Naam Pad Type Description
Documentstatus
document_status string

Hoe het wachten is beëindigd: ondertekend, afgewezen of timed_out.

Geweigerd door
rejected_by string

Wie het document heeft afgewezen, als het is afgewezen.

Reden voor afwijzing
rejection_reason string

De reden waarom de ondertekenaar heeft opgegeven, als het document is geweigerd.

Verzoekstatus

De status van de aanvraag.

De status van de aanvraag.

Status
string

bestand

Dit is het basisgegevenstype 'bestand'.