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.
Ondertekening: Koppelingen voor ondertekenaar maken
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.
Ondertekening: Gedeelde koppeling maken
Hiermee maakt u één koppeling die iedereen kan openen om de documenten te ondertekenen, elk onder hun eigen geverifieerde identiteit.
Ondertekening: koppeling verwijderen
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:
- Document: Uploaden (bijvoorbeeld de bestandsinhoud en naamtokens uit SharePoint of OneDrive).
- Ondertekening: uitnodigen per e-mail. Markeer onderteken de uitnodiging.
- Ondertekening: Wacht tot de volgende ondertekenaar. De stroom wordt hier onderbroken totdat de ondertekening plaatsvindt.
- 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
reviewofconfirmation, 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_outstatus 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
- Body
- AcknowledgedResponse
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
- Body
- AcknowledgedResponse
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
- Body
- SigningWaitResponse
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
- Body
- SigningEvent
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
- Body
- AcknowledgedResponse
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
|
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
|
True |
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
|
True |
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
- Body
- AcknowledgedResponse
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
- Body
- SigningWaitResponse
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
bestand
Dit is het basisgegevenstype 'bestand'.