Mark Sign (förhandsversion)
Mark Sign är en kvalificerad elektronisk signaturtjänst som är kompatibel med eIDAS-förordningen. Skicka dokument för signering, vänta på signaturerna, ladda ned och verifiera de signerade filerna.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alla Power Automate regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Logiska appar | Standard | Alla Logic Apps-regioner utom följande: - Azure Government regioner - Azure kinaregioner - US Department of Defense (DoD) |
| Power Apps | Premium | Alla Power Apps regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alla Power Automate regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Markera ID, UAB |
| URL | https://marksign.eu |
| E-postmeddelande | pagalba@marksign.lt |
| Metadata för anslutningsprogram | |
|---|---|
| Publisher | Markera ID, UAB |
| Website | https://marksign.eu |
| Sekretesspolicy | https://marksign.eu/privacy-policy |
| Categories | Produktivitet; Innehåll och filer |
Markera tecken
Mark Sign är en kvalificerad elektronisk signaturtjänst som är kompatibel med eIDAS-förordningen. Ett flöde kan skicka ett dokument för signering, vänta tills det är signerat och sedan ladda ned den signerade filen och verifiera den.
Publisher: Mark ID, UAB
Prerequisites
Du behöver en åtkomsttoken för Mark Sign API. Se Hämta autentiseringsuppgifter nedan.
Åtgärder som stöds
Dokument: Ladda upp
Laddar upp ett dokument (PDF, ADoc, BDoc eller ASiC-E) och förbereder det för signering. Filnamnet blir dokumentrubriken.
Signering: Bjud in via e-post
Bjuder in en person att signera; Mark Sign skickar e-postmeddelandet med inbjudan. Att anropa den igen för samma person skickar en påminnelse.
Signering: Bjud in via URL
Lägger till en undertecknare utan att skicka ett e-postmeddelande och returnerar sin personliga inbjudnings-URL som du kan leverera.
Signering: Vänta på alla undertecknare
Håller flödet tills dokumentet signeras eller avvisas, eller slutar med statusen timed_out när väntetiden (29 dagar som standard) tar slut.
Signering: Vänta på en undertecknare
Håller flödet tills en viss undertecknare, vald via e-post, signerar. Alla avvisanden avslutar också väntan.
Signering: Vänta på nästa undertecknare
Återupptar flödet så fort nästa undertecknare signerar eller avvisar, utan avsökning.
Dokument: Hämta status
Kontrollerar dokumentets övergripande signeringsstatus.
Dokument: Hämta undertecknare
Visar en lista över varje undertecknarens status, inklusive avvisningsorsaken om en undertecknare avvisades.
Dokument: Ladda ned
Laddar ned dokumentet med alla signaturer som samlats in hittills.
Dokument: Lista
Visar en lista över dokumenten på arbetsytan med textsökning och växling.
Dokument: Ta bort
Tar bort ett dokument från arbetsytan.
Dokument: Ladda upp som container
Kombinerar flera filer i ett signerbart containerdokument (ADoc, BDoc eller ASiC-E). Faktureringen följer standardvärdet Markera tecken, där varje undertecknare betalar.
Signering: Skapa undertecknarlänkar
Skapar en personlig signeringslänk för varje undertecknare för att leverera dig själv. Länkarna upphör att gälla, kan kräva identitetsverifiering och är de enda signeringssidorna med alternativet Avvisa.
Signering: Skapa delad länk
Skapar en länk som vem som helst kan öppna för att signera dokumenten, var och en under sin egen verifierade identitet.
Signering: Ta bort länk
Tar bort en undertecknarlänk eller delad länk innan den upphör att gälla.
Dokument: Utöka signaturens giltighet
Uppgraderar dokumentsignaturerna för långsiktig giltighet (LT) eller långsiktig arkivering (LTA).
Dokument: Verifiera
Kontrollerar signaturerna för ett dokument och returnerar den fullständiga valideringsrapporten.
Hämta autentiseringsuppgifter
Kontakta Mark Sign customer support på pagalba@marksign.lt för att begära en API-åtkomsttoken för din arbetsyta. När du skapar en anslutning i Power Automate klistrar du in token i fältet "API Key".
Token är kopplad till en arbetsyta, så varje dokument som skapas eller listas via anslutningen tillhör den arbetsytan.
Getting Started
Det enklaste signeringsflödet:
- Dokument: Ladda upp (till exempel filinnehåll och namntoken från SharePoint eller OneDrive).
- Signering: Bjud in via e-post. Markera Signera e-postinbjudan.
- Signering: Vänta på nästa undertecknare. Flödet pausas här tills signeringen sker.
- Dokument: Ladda ned och lagra det där du behöver det.
Med flera undertecknare använder du Signering: Bjud in via e-post för varje person och sedan en Signering: Vänta på alla undertecknare innan nedladdningen. Om du vill leverera länkarna själv i stället för Mark Sign-e-postmeddelanden använder du Signering: Bjud in via URL eller Signering: Skapa undertecknarlänkar och skicka varje person sin länk med din egen Outlook- eller Teams-åtgärd.
Kända problem och begränsningar
- Anslutningsappen tillhandahåller inte flödesutlösare. använd vänteåtgärderna i ett flöde i stället.
- Ett dokument har en meddelanderegistrering. Kör inte två signeringar: Vänta på nästa inloggningssteg i samma dokument samtidigt. Det andra ersätter det första och det första steget väntar sedan tills tidsgränsen uppnås. Om du fyller i ett url-fält för återanrop i ett block ersätts registreringen också.
- Undertecknare kan bara avvisa ett dokument på sidan Signering: Skapa undertecknarlänkar (med knappen Visa avvisa på); e-postinbjudningar, inbjudnings-URL:er och delade länkar erbjuder inget avvisande alternativ.
- Mark Sign meddelar endast om signaturer. När ett inbjudningsblock använder syftet
reviewmed ellerconfirmationaktiveras aldrig signeringen: Vänta på nästa undertecknare. Kontrollera deras status med Dokument: Hämta undertecknare i stället. - Dokument: Nedladdning returnerar endast filinnehållet. ta filnamnet från Dokument: Lista eller från uppladdningssteget.
- En flödeskörning kan pågå i högst 30 dagar (en Power Automate gräns), så ingen väntan kan överleva det.
Signering: Vänta på alla undertecknare och signering: Vänta tills en undertecknare slutar med statusen
timed_outefter 29 dagar som standard. För signering: Vänta på nästa undertecknare anger du en timeout (till exempelP29D) i åtgärdsinställningarna och lägger till en gren som konfigurerats att köras när åtgärden har överskridit tidsgränsen. Om körningsgränsen på 30 dagar når först Power Automate avbryter hela körningen och ingen gren hanterar den. - Dokument: Listan stöder inte filtrering efter status.
- Dokument: Ladda upp accepterar en fil per anrop; loopa över bifogade filer för att ladda upp flera. Dokument: Ladda upp som container är avsedd för några filer; om du kombinerar många stora filer i ett anrop kan det överskrida bearbetningstiden.
Distributionsinstruktioner
Kör paconn create --api-prop apiProperties.json --api-def apiDefinition.swagger.json --script script.csx --icon icon.png för att distribuera den här anslutningsappen som en anpassad anslutningsapp i din Power Platform-miljö. Mer information finns i paconn-dokumentationen .
Support
Om du har problem med anslutningsappen eller Mark Sign-API:et kontaktar du pagalba@marksign.lt.
Skapa en anslutning
Anslutningsappen stöder följande autentiseringstyper:
| Standard | Parametrar för att skapa anslutning. | Alla regioner | Går inte att dela |
Standard
Tillämpligt: Alla regioner
Parametrar för att skapa anslutning.
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
| Name | Type | Description | Required |
|---|---|---|---|
| API-nyckel | securestring | Mark Sign API-åtkomsttoken för din arbetsyta. Begär en från Mark Sign-supporten på pagalba@marksign.lt. | True |
Åtgärder
| Dokument: Hämta status |
Hämtar signeringsstatus för ett dokument. |
| Dokument: Hämta undertecknare |
Visar en lista över undertecknarna av ett dokument med deras signeringsstatus. |
| Dokument: Ladda ned |
Laddar ned dokumentet med alla signaturer som samlats in hittills. |
| Dokument: Ladda upp |
Laddar upp ett dokument och förbereder det för signering. |
| Dokument: Ladda upp som container |
Kombinerar flera filer till ett signerbart containerdokument, till exempel en ADoc eller ASiC-E. Filerna laddas upp och kombineras i ett enda steg. |
| Dokument: Lista |
Listar dokumenten på din arbetsyta, den senaste först. |
| Dokument: Ta bort |
Tar bort ett dokument från arbetsytan. |
| Dokument: Utöka signaturens giltighet |
Uppgraderar dokumentsignaturerna för långsiktig giltighet eller arkivering. |
| Dokument: Verifiera |
Kontrollerar signaturerna för ett dokument och returnerar valideringsrapporten. Flödet väntar tills kontrollen är klar. |
| Signering: Bjud in via e-post |
Uppmanar en person att signera dokumentet. Mark Sign skickar inbjudan via e-post. |
| Signering: Bjud in via URL |
Lägger till en undertecknare i dokumentet utan att skicka ett e-postmeddelande och returnerar deras personliga inbjudningslänk som du kan leverera. Länken upphör inte att gälla och kan inte tas bort. använd "Signering: Skapa undertecknarlänkar" när du behöver länkar som du kan återkalla. |
| Signering: Skapa delad länk |
Skapar en signeringslänk som vem som helst kan öppna för att signera dokumenten. Du levererar det själv. |
| Signering: Skapa undertecknarlänkar |
Skapar en personlig signeringslänk för varje undertecknare. Du levererar länkarna själv, till exempel via e-post eller Teams-meddelande. |
| Signering: Ta bort länk |
Tar bort en undertecknarlänk eller delad länk innan den upphör att gälla. Det går inte att ta bort inbjudningslänkar. |
| Signering: Vänta på alla undertecknare |
Väntar tills varje undertecknare har signerat eller någon har avvisat dokumentet och låter sedan flödet fortsätta. Slutar med statusen timed_out när tiden tar slut. |
| Signering: Vänta på en undertecknare |
Väntar tills en viss undertecknare signerar dokumentet och låter sedan flödet fortsätta. Slutar med statusen timed_out när tiden tar slut. |
| Signering: Vänta på nästa undertecknare |
Väntar tills nästa undertecknare signerar eller avvisar dokumentet, utan att skicka några inbjudningar. Använd den i en loop för att vänta på flera undertecknare utan avsökning. |
Dokument: Hämta status
Hämtar signeringsstatus för ett dokument.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
ID:t för dokumentet, från utdata från "Document: Upload", "Document: Upload as container" eller "Document: List". |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Status för begäran. |
|
Dokumentstatus
|
data.document_status | string |
Signeringsstatus: sparad (väntar på signaturer), signed_partially (vissa har signerat) eller signerat (alla har signerat). |
Dokument: Hämta undertecknare
Visar en lista över undertecknarna av ett dokument med deras signeringsstatus.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
ID:t för dokumentet, från utdata från "Document: Upload", "Document: Upload as container" eller "Document: List". |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Status för begäran. |
|
Undertecknare:
|
data | array of object |
Undertecknarna av dokumentet. |
|
Signer-ID
|
data.id | string |
ID:t för undertecknaren. |
|
Förnamn
|
data.name | string |
Undertecknarens förnamn. |
|
Efternamn
|
data.surname | string |
Undertecknarens efternamn. |
|
E-postmeddelande
|
data.email | string |
Undertecknarens e-postadress. |
|
Signeringsstatus
|
data.status | string |
Om undertecknaren har signerat: väntande, signerad, avvisad, granska, bekräftad, nekad eller granskad. |
|
Avslagsorsak
|
data.rejection_reason | string |
Anledningen till att undertecknaren gav när dokumentet avvisades. |
Dokument: Ladda ned
Laddar ned dokumentet med alla signaturer som samlats in hittills.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
ID:t för dokumentet, från utdata från "Document: Upload", "Document: Upload as container" eller "Document: List". |
Returer
Innehållet i dokumentfilen.
- Filinnehåll
- file
Dokument: Ladda upp
Laddar upp ett dokument och förbereder det för signering.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Filnamn
|
file_name | True | string |
Namnet på filen med dess tillägg, till exempel contract.pdf. Det blir dokumentrubriken. |
|
body
|
body | True | binary | |
|
Access
|
access | string |
Vem kan visa dokumentet. Standardvärdet är privat. |
|
|
Faktureringstyp
|
billing_type | True | string |
Vem betalar för signaturerna. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Status för begäran. |
|
Dokument-ID
|
data.uuid | string |
Dokumentets ID. |
|
Filnamn
|
data.filename | string |
Namnet på filen. |
Dokument: Ladda upp som container
Kombinerar flera filer till ett signerbart containerdokument, till exempel en ADoc eller ASiC-E. Filerna laddas upp och kombineras i ett enda steg.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokumenttyp
|
document_type | True | string |
Vilken typ av dokument som ska skapas. |
|
Filnamn
|
file_name | True | string |
Namnet på filen med dess tillägg, till exempel contract.pdf. |
|
Filinnehåll
|
file_content | True | byte |
Innehållet i filen. |
|
Filtyp (endast ADoc)
|
adoc_file_type | string |
Filens roll i containern. Används endast när dokumenttypen är en ADoc. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Status för begäran. |
|
Dokument-ID
|
data.uuid | string |
Dokumentets ID. |
|
Filnamn
|
data.filename | string |
Namnet på dokumentfilen. |
Dokument: Lista
Listar dokumenten på din arbetsyta, den senaste först.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Sök efter order
|
query | string |
En fras att söka efter i dokumentrubriker och filnamn. |
|
|
Offset
|
offset | integer |
Hur många dokument som ska hoppas över. |
|
|
Limit
|
limit | integer |
Hur många dokument som ska returneras. Standardvärdet är 10. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Status för begäran. |
|
Dokument:
|
data | array of object |
Dokumenten. |
|
Dokument-ID
|
data.uuid | string |
Dokumentets ID. |
|
Filnamn
|
data.filename | string |
Namnet på filen. |
|
Dokumentstatus
|
data.status | string |
Signeringsstatus för dokumentet, till exempel sparat (väntar på signaturer), signed_partially eller signerat. |
|
Uppladdad vid
|
data.uploaded_at | date-time |
När dokumentet laddades upp. |
|
Total
|
total | integer |
Det totala antalet matchande dokument. |
Dokument: Ta bort
Tar bort ett dokument från arbetsytan.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
ID:t för dokumentet, från utdata från "Document: Upload", "Document: Upload as container" eller "Document: List". |
Returer
- Body
- AcknowledgedResponse
Dokument: Utöka signaturens giltighet
Uppgraderar dokumentsignaturerna för långsiktig giltighet eller arkivering.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
ID:t för dokumentet, från utdata från "Document: Upload", "Document: Upload as container" eller "Document: List". |
|
Level
|
level | True | string |
LT för långsiktig giltighet, LTA för långsiktig arkivering. |
Returer
- Body
- AcknowledgedResponse
Dokument: Verifiera
Kontrollerar signaturerna för ett dokument och returnerar valideringsrapporten. Flödet väntar tills kontrollen är klar.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
ID:t för dokumentet, från utdata från "Document: Upload", "Document: Upload as container" eller "Document: List". |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Status för begäran. |
|
Är giltigt
|
data.document.is_valid | boolean |
Om dokumentsignaturerna är giltiga. |
|
Giltig till
|
data.document.valid_to | string |
Hur länge dokumentet förblir giltigt. |
|
Dokumentnamn
|
data.document.name | string |
Dokumentets rubrik. |
|
MIME-typ
|
data.document.mimetype | string |
Dokumentets filtyp. |
|
Signaturer:
|
data.signatures | array of object |
Resultatet för varje signatur. |
|
Signaturidentitet
|
data.signatures.id | string |
ID:t för signaturen. |
|
Signeringstid
|
data.signatures.signing_time | string |
När signaturen gjordes. |
|
Signaturformat
|
data.signatures.signature_format | string |
Formatet på signaturen. |
|
Är giltigt
|
data.signatures.is_valid | boolean |
Om signaturen är giltig. |
|
Giltig till
|
data.signatures.valid_to | string |
Hur länge signaturen är giltig. |
|
Certifikat
|
data.certificates | array of object |
De certifikat som används av signaturerna. |
|
items
|
data.certificates | object | |
|
Tidsstämplar
|
data.timestamps | array of object |
De tidsstämplar som tillämpas på dokumentet. |
|
items
|
data.timestamps | object | |
|
Valideringstid
|
metadata.validation_time | string |
När verifieringen utfördes. |
Signering: Bjud in via e-post
Uppmanar en person att signera dokumentet. Mark Sign skickar inbjudan via e-post.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
ID:t för dokumentet, från utdata från "Document: Upload", "Document: Upload as container" eller "Document: List". |
|
Förnamn
|
name | True | string |
Undertecknarens förnamn. |
|
Efternamn
|
surname | True | string |
Undertecknarens efternamn. |
|
E-postmeddelande
|
True |
Undertecknarens e-postadress. |
||
|
Language
|
language | string |
Inbjudans språk. Standardvärdet är litauiska. |
|
|
Url för lyckad åtgärd
|
success_url | string |
Var undertecknaren ska skickas när signeringen är klar. |
|
|
Purpose
|
purpose | string |
Varför personen är inbjuden. Välj granska om du bara vill bjuda in för visning. |
|
|
Återanrops-URL
|
callback_url | string |
En URL som meddelar när dokumentet är signerat. |
Returer
- Body
- AcknowledgedResponse
Signering: Bjud in via URL
Lägger till en undertecknare i dokumentet utan att skicka ett e-postmeddelande och returnerar deras personliga inbjudningslänk som du kan leverera. Länken upphör inte att gälla och kan inte tas bort. använd "Signering: Skapa undertecknarlänkar" när du behöver länkar som du kan återkalla.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
ID:t för dokumentet, från utdata från "Document: Upload", "Document: Upload as container" eller "Document: List". |
|
Förnamn
|
name | True | string |
Undertecknarens förnamn. |
|
Efternamn
|
surname | True | string |
Undertecknarens efternamn. |
|
E-postmeddelande
|
True |
Undertecknarens e-postadress. |
||
|
Url för lyckad åtgärd
|
success_url | string |
Var undertecknaren ska skickas när signeringen är klar. |
|
|
Purpose
|
purpose | string |
Varför personen är inbjuden. Välj granska om du bara vill bjuda in för visning. |
|
|
Återanrops-URL
|
callback_url | string |
En URL som meddelar när dokumentet är signerat. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Status för begäran. |
|
Inbjudnings-URL
|
data.invitation_url | string |
Länken till den personliga signeringssidan för att leverera till undertecknaren. |
Signering: Skapa delad länk
Skapar en signeringslänk som vem som helst kan öppna för att signera dokumenten. Du levererar det själv.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokument-ID
|
documents | True | array of string |
Dokumenten som länken signerar. Använd dokument-ID-värden från uppladdnings- eller liststeg. |
|
Återanrops-URL
|
callback_url | string |
En URL som meddelar när dokumentet är signerat. |
|
|
Upphör att gälla efter (minuter)
|
expire_after | integer |
Minuter tills länken upphör att gälla. Standardvärdet är 2 880 (två dagar). |
|
|
Ta bort dokument efter (minuter)
|
delete_document_after | integer |
Minuter tills dokumentet tas bort från arbetsytan. Som standard behålls den. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Status för begäran. |
|
Signeringslänk
|
data.signing_link | string |
Länken som vem som helst kan öppna för att signera. |
|
Signeringslänk-ID
|
data.signing_link_id | string |
ID:t för länken för "Signering: Ta bort länk". |
|
Giltig tills
|
data.valid_until | integer |
När länken upphör att gälla, som en Unix-tidsstämpel. |
Signering: Skapa undertecknarlänkar
Skapar en personlig signeringslänk för varje undertecknare. Du levererar länkarna själv, till exempel via e-post eller Teams-meddelande.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokument-ID
|
documents | True | array of string |
Dokumenten som du vill skapa signeringslänkar för. Använd dokument-ID-värden från uppladdnings- eller liststeg. |
|
Signer-ID
|
id | string |
Ditt eget ID för undertecknaren, unikt i begäran. Krävs när e-post är tom. |
|
|
Förnamn
|
name | string |
Undertecknarens förnamn. |
|
|
Efternamn
|
surname | string |
Undertecknarens efternamn. |
|
|
E-postmeddelande
|
Undertecknarens e-postadress. Krävs när signer-ID är tomt. |
|||
|
Personlig kod
|
personal_code | string |
Undertecknarens personliga kod. Krävs när autentisering krävs. |
|
|
Kräv autentisering
|
authentication_required | boolean |
Om ja måste undertecknaren verifiera sin identitet innan länken öppnas. |
|
|
Position (endast ADoc)
|
position | string |
Undertecknarens jobbposition, som visas i ADoc-signaturer. |
|
|
Avdelning (endast ADoc)
|
structural_subdivision | string |
Undertecknarens avdelning, som visas i ADoc-signaturer. |
|
|
Signeringssyfte (endast ADoc)
|
signing_purpose | string |
Varför personen signerar, som visas i ADoc-signaturer. |
|
|
Återanrops-URL
|
callback_url | string |
En URL som meddelar när dokumentet är signerat. |
|
|
Motringnings-URL för avvisande
|
reject_callback_url | string |
En URL som meddelar när en undertecknare avvisar dokumentet. |
|
|
Upphör att gälla efter (minuter)
|
expire_after | integer |
Minuter tills länken upphör att gälla. Standardvärdet är 2 880 (två dagar). |
|
|
Visa knappen Avvisa
|
show_reject_button | boolean |
Om undertecknare kan avvisa dokumentet på signeringssidan. Standardvärdet är ja. |
|
|
Ta bort dokument efter (minuter)
|
delete_document_after | integer |
Minuter tills dokumentet tas bort från arbetsytan. Som standard behålls den. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Status för begäran. |
|
Signeringslänkar:
|
temporary_signing_links | array of object |
En signeringslänk per undertecknare. |
|
Signer-ID
|
temporary_signing_links.id | string |
Ditt eget ID för undertecknaren. |
|
Förnamn
|
temporary_signing_links.member_name | string |
Undertecknarens förnamn. |
|
Efternamn
|
temporary_signing_links.member_surname | string |
Undertecknarens efternamn. |
|
E-postmeddelande
|
temporary_signing_links.member_email | string |
Undertecknarens e-postadress. |
|
Signeringslänk
|
temporary_signing_links.temporary_signing_link | string |
Länken som undertecknaren öppnar för att signera dokumentet. |
|
Signeringslänk-ID
|
temporary_signing_links.temporary_signing_link_id | string |
ID för signeringslänken. |
|
Giltig tills
|
temporary_signing_links.valid_until | integer |
När länken upphör att gälla, som en Unix-tidsstämpel. |
|
Dokument:
|
documents | array of object |
Dokumenten som länkarna skapades för. |
|
Dokument-ID
|
documents.uuid | string |
Dokumentets ID. |
|
Filnamn
|
documents.filename | string |
Namnet på dokumentfilen. |
Signering: Ta bort länk
Tar bort en undertecknarlänk eller delad länk innan den upphör att gälla. Det går inte att ta bort inbjudningslänkar.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Signeringslänk-ID
|
temporarySigningLinkId | True | string |
Signeringslänk-ID:t från utdata från "Signering: Skapa undertecknarlänkar" eller "Signering: Skapa delad länk". |
Returer
- Body
- AcknowledgedResponse
Signering: Vänta på alla undertecknare
Väntar tills varje undertecknare har signerat eller någon har avvisat dokumentet och låter sedan flödet fortsätta. Slutar med statusen timed_out när tiden tar slut.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
ID:t för dokumentet, från utdata från "Document: Upload", "Document: Upload as container" eller "Document: List". |
|
Tidsgräns (minuter)
|
timeout_minutes | integer |
Hur länge du ska vänta, i minuter, innan du slutar med statusen timed_out. Standardvärdet är 41760 (29 dagar), max är 43200 (30 dagar). |
Returer
- Body
- SigningWaitResponse
Signering: Vänta på en undertecknare
Väntar tills en viss undertecknare signerar dokumentet och låter sedan flödet fortsätta. Slutar med statusen timed_out när tiden tar slut.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
ID:t för dokumentet, från utdata från "Document: Upload", "Document: Upload as container" eller "Document: List". |
|
E-post för undertecknare
|
signer_email | True | string |
E-postmeddelandet från undertecknaren att vänta på, samma e-postmeddelande som används när du bjuder in dem. |
|
Tidsgräns (minuter)
|
timeout_minutes | integer |
Hur länge du ska vänta, i minuter, innan du slutar med statusen timed_out. Standardvärdet är 41760 (29 dagar), max är 43200 (30 dagar). |
Returer
- Body
- SigningWaitResponse
Signering: Vänta på nästa undertecknare
Väntar tills nästa undertecknare signerar eller avvisar dokumentet, utan att skicka några inbjudningar. Använd den i en loop för att vänta på flera undertecknare utan avsökning.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
ID:t för dokumentet, från utdata från "Document: Upload", "Document: Upload as container" eller "Document: List". |
Returer
- Body
- SigningEvent
Definitioner
SigningEvent
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Dokument-ID
|
uuid | string |
Dokumentets ID. |
|
Dokumentstatus
|
status | string |
Signeringsstatus för dokumentet, till exempel signerat eller signed_partially. Ett avvisande visas i undertecknarstatusarna. |
|
Antal undertecknare
|
members_count | integer |
Hur många som blev inbjudna att skriva under. |
|
Signerat antal
|
signed_members_count | integer |
Hur många som har skrivit på. |
|
Undertecknare:
|
members | array of object |
Alla bjöd in att skriva under. |
|
Signer-ID
|
members.id | string |
ID:t för undertecknaren. |
|
Förnamn
|
members.member_name | string |
Undertecknarens förnamn. |
|
Efternamn
|
members.member_surname | string |
Undertecknarens efternamn. |
|
E-postmeddelande
|
members.member_email | string |
Undertecknarens e-postadress. |
|
Signeringsstatus
|
members.status | string |
Undertecknarens status, till exempel väntande, signerad eller avvisad. |
AcknowledgedResponse
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Status för begäran. |
SigningWaitResponse
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Dokumentstatus
|
document_status | string |
Hur väntan slutade: signerad, avvisad eller timed_out. |
|
Avvisad av
|
rejected_by | string |
Vem avvisade dokumentet om det avvisades. |
|
Avslagsorsak
|
rejection_reason | string |
Anledningen till att undertecknaren gav, om dokumentet avvisades. |
Begärandestatus
fil
Det här är den grundläggande datatypen "fil".