Signhost (preview)
Signhost de workflow-ondertekeningsservice van Entrust is een oplossing voor digitale ondertekening en identificatie, waardoor alle soorten bedrijven naadloos en veilig online transacties kunnen uitvoeren.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | 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 , met uitzondering van het volgende: - 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 , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Signhost Customer Success Team |
| URL | https://intercom.help/signhost/en/ |
| E-mailen | support@signhost.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | Signhost |
| Webpagina | https://www.signhost.com |
| Privacybeleid | https://www.evidos.com/privacy |
| Categorieën | Inhoud en bestanden; Productiviteit |
SignHost
Signhost de workflow-ondertekeningsservice van Entrust is een oplossing voor digitale ondertekening en identificatie, waardoor alle soorten bedrijven naadloos en veilig online transacties kunnen uitvoeren.
Uitgever
Entrust Netherlands B.V.
Vereiste voorwaarden
U hebt een SignHost-abonnement nodig om deze connector te kunnen gebruiken. U kunt een APIKey genereren vanuit de Signhost-portal
Ondersteunde bewerkingen
Transactiegegevens ophalen
Retourneert de huidige transactiegegevens. Gebruik deze actie niet voor actieve polling.
Transactie verwijderen
Een transactie verwijderen met een transactie-id. Wanneer een transactie niet de eindstatus heeft (zoals volledig ondertekend), wordt de transactie geannuleerd en opgeschoond. Een geannuleerde transactie kan worden verteld een e-mailmelding te verzenden naar de wachtende ondertekenaars dat de transactie is geannuleerd. De status van de transactie wordt ingesteld op geannuleerd. Wanneer een transactie de eindstatus heeft, wordt de transactie opgeschoond. De status van de transactie blijft hetzelfde, maar we zullen alle geüploade documenten en gevoelige gegevens zo snel mogelijk opschonen.
PDF dowloaden
Retourneert de (ondertekende) documenten.
Ontvangstbewijs downloaden
Retourneert het ontvangstbewijs wanneer de transactie is ondertekend.
Transactie maken
Hiermee maakt u een nieuwe transactie.
Bestand toevoegen
Voeg een bestand toe aan de transactie.
Transactie starten
Hiermee start u een transactie met dezelfde {transactionId}.
Referenties verkrijgen
U kunt een usertoken genereren op de pagina Instellingen in de SignHost-portal. Zorg ervoor dat u het voorvoegsel APIKey voor uw usertoken gebruikt.
Bekende problemen en beperkingen
Momenteel worden niet alle functies ondersteund. Wij verwelkomen u om contact met ons op te nemen met verzoeken of vragen.
Implementatie-instructies
Volg de instructies in Een aangepaste connector maken op basis van een OpenAPI-definitie.
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 | Typologie | Description | Verplicht |
|---|---|---|---|
| Authorization | beveiligde string | Geef uw APIKey op. | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Bestand toevoegen |
Voeg een bestand toe aan de transactie of overschrijf een bestaand bestand met dezelfde {fileId}. |
| Ontvangstbewijs downloaden |
Retourneert het ontvangstbewijs wanneer de transactie is ondertekend (Status=30) |
| Pdf downloaden |
Retourneert de (ondertekende) documenten. |
| Transactie maken |
Hiermee maakt u een nieuwe transactie |
| Transactie starten |
Start een transactie met dezelfde {transactionId} |
| Transactie verwijderen |
Een transactie verwijderen met een transactie-id |
| Transactiegegevens ophalen |
Retourneert de huidige transactiedetails |
Bestand toevoegen
Voeg een bestand toe aan de transactie of overschrijf een bestaand bestand met dezelfde {fileId}.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Transactie-id
|
transactionId | True | string |
Id van een bestaande -- nog niet gestart -- transactie |
|
Bestands-id
|
fileId | True | string |
Een unieke id die u voor het bestand hebt opgegeven. |
|
Binair bestand
|
body | True | binary |
Bestandsupload |
Ontvangstbewijs downloaden
Retourneert het ontvangstbewijs wanneer de transactie is ondertekend (Status=30)
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Transactie-id
|
transactionId | True | string |
Id van de beschrijving |
Retouren
- Content
- binary
Pdf downloaden
Retourneert de (ondertekende) documenten.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Transactie-id
|
transactionId | True | string |
Id van de beschrijving |
|
Naam
|
fileId | True | string |
Een unieke id die u voor het bestand hebt opgegeven. |
Retouren
- Content
- binary
Transactie maken
Hiermee maakt u een nieuwe transactie
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Files
|
Files | object |
Een kaart met bestanden die aan deze transactie zijn gekoppeld. |
|
|
Language
|
Language | string |
Taal, alleen de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL en nl-NL zijn toegestaan. |
|
|
Zeehond
|
Seal | boolean |
Sluit het document af voordat het naar de ondertekenaars wordt verzonden. |
|
|
Identiteitsbewijs
|
Id | string |
De id van de ondertekenaar moet uniek zijn binnen een transactie. |
|
|
E-mailen
|
True | string |
Het e-mailadres van de ondertekenaar |
|
|
IntroText
|
IntroText | string |
Een introtekst die tijdens het aanmeldingsproces aan de gebruiker wordt weergegeven. |
|
|
Typologie
|
Type | True | string |
Type van het verificatieobject. |
|
Number
|
Number | string |
Telefoonnummer: dit veld is verplicht wanneer de verificatiemethode PhoneNumber wordt gekozen |
|
|
Bsn
|
Bsn | number |
Dit veld is verplicht wanneer de BSN-verificatiemethode wordt gekozen |
|
|
Typologie
|
Type | True | string |
Type van het verificatieobject. |
|
SendSignRequest
|
SendSignRequest | boolean |
Stuur een uitnodiging voor ondertekenen naar de ondertekenaar zijn e-mailadres. |
|
|
SignUrl
|
SignUrl | string |
Een unieke URL per ondertekenaar die de ondertekeningsstroom voor de ondertekenaar biedt. |
|
|
SignRequestSubject
|
SignRequestSubject | string |
Het onderwerp van het e-mailbericht met een tekenaanvraag in tekst zonder opmaak. |
|
|
SignRequestMessage
|
SignRequestMessage | string |
Het bericht van de aanmeldingsaanvraag in tekst zonder opmaak. |
|
|
SendSignConfirmation
|
SendSignConfirmation | boolean |
Stuur de bevestiging van het teken naar de ondertekenaar zijn e-mailadres. |
|
|
Language
|
Language | string |
Taal, alleen de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL en nl-NL zijn toegestaan. |
|
|
Krabbelnaam
|
ScribbleName | string |
De naam van de ondertekenaar wordt vooraf ingevuld in het krabbelformulier. |
|
|
DaysToRemind
|
DaysToRemind | integer |
Aantal dagen voordat de ondertekenaars eraan worden herinnerd. -1 om herinneringen uit te schakelen. |
|
|
Verloopt
|
Expires | date-time |
Wanneer de ondertekenaar is ingesteld, mag de transactie na deze datum niet meer worden ondertekend. |
|
|
Reference
|
Reference | string |
De verwijzing van de ondertekenaar. |
|
|
RejectReason
|
RejectReason | string |
De afwijzingsreden die door de ondertekenaar werd gegeven toen de transactie werd afgewezen. |
|
|
ReturnUrl
|
ReturnUrl | string |
De URL waarnaar de gebruiker wordt omgeleid na ondertekening, weigeren of annuleren. |
|
|
Context
|
Context | object |
Elk geldig json-object dat we terugsturen. |
|
|
Identiteitsbewijs
|
Id | string | ||
|
Code
|
Code | integer |
Api-documentatie raadplegen |
|
|
Informatie
|
Info | string |
Kan aanvullende informatie bevatten die deel uitmaakt van deze activiteit |
|
|
Aanmaakdatum en tijd
|
CreatedDateTime | date-time | ||
|
Naam
|
Name | True | string |
De naam van de ontvanger. |
|
E-mailen
|
True | string |
Het e-mailadres van de ontvanger. |
|
|
Language
|
Language | string |
Taal, alleen de-DE, en-US, es-ES, fr-FR, it-IT en nl-NL toegestaan. |
|
|
Onderwerp
|
Subject | string |
Het onderwerp van de ontvanger-e-mail in tekst zonder opmaak. |
|
|
Message
|
Message | True | string |
Het e-mailbericht naar de ontvanger in tekst zonder opmaak. |
|
Reference
|
Reference | string |
De verwijzing van de ontvanger. |
|
|
Context
|
Context | object |
Elk geldig json-object dat we terugsturen. |
|
|
Reference
|
Reference | string |
De verwijzing naar de transactie. |
|
|
PostbackUrl
|
PostbackUrl | string |
De absolute URL voor het terugschrijven van de statusupdates. |
|
|
SignRequestMode
|
SignRequestMode | integer |
Ingesteld op 1 voor het tegelijk verzenden naar 2 voor sequentiële gegevens. |
|
|
DaysToExpire
|
DaysToExpire | integer |
Aantal dagen vóór de vervaldatum. Max. 90 dagen. |
Retouren
- Body
- Transaction
Transactie starten
Start een transactie met dezelfde {transactionId}
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Transactie-id
|
transactionId | True | string |
Id van een bestaande -- nog niet gestart -- transactie |
Transactie verwijderen
Een transactie verwijderen met een transactie-id
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Transactie-id
|
transactionId | True | string |
Id van de transactie |
|
SendNotifications
|
SendNotifications | boolean |
E-mailmeldingen verzenden naar de wachtende ondertekenaars. |
|
|
Reden
|
Reason | string |
De reden van annulering. |
Transactiegegevens ophalen
Retourneert de huidige transactiedetails
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Transactie-id
|
transactionId | True | string |
Id van de transactie |
Retouren
- Body
- Transaction
Definities
Transactie
| Name | Pad | Type | Description |
|---|---|---|---|
|
Identiteitsbewijs
|
Id | string |
De id van de transactie. |
|
Files
|
Files | array of object | |
|
Links
|
Files.Links | array of object | |
|
Rel
|
Files.Links.Rel | string | |
|
Typologie
|
Files.Links.Type | string | |
|
Link
|
Files.Links.Link | string | |
|
Schermnaam
|
Files.DisplayName | string | |
|
Language
|
Language | string |
De taal, alleen de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL en nl-NL toegestaan. |
|
Zeehond
|
Seal | boolean |
Sluit het document af voordat het naar de ondertekenaars wordt verzonden. |
|
Ondertekenaars
|
Signers | array of object |
De ondertekenaargegevens. |
|
Identiteitsbewijs
|
Signers.Id | string |
De id van de ondertekenaar moet uniek zijn binnen een transactie. |
|
E-mailen
|
Signers.Email | string |
Het e-mailadres van de ondertekenaar |
|
IntroText
|
Signers.IntroText | string |
Een introtekst die tijdens het aanmeldingsproces aan de gebruiker wordt weergegeven. |
|
Verificaties
|
Signers.Authentications | array of Authentication |
Lijst met verificaties waarmee de ondertekenaar zich moet verifiëren. |
|
Verificaties
|
Signers.Verifications | array of Verification |
Lijst met verificaties waarmee de ondertekenaar moet verifiëren. |
|
SendSignRequest
|
Signers.SendSignRequest | boolean |
Stuur een uitnodiging voor ondertekenen naar de ondertekenaar zijn e-mailadres. |
|
SignUrl
|
Signers.SignUrl | string |
Een unieke URL per ondertekenaar die de ondertekeningsstroom voor de ondertekenaar biedt. |
|
SignRequestSubject
|
Signers.SignRequestSubject | string |
Het onderwerp van het e-mailbericht met een tekenaanvraag in tekst zonder opmaak. |
|
SignRequestMessage
|
Signers.SignRequestMessage | string |
Het bericht van de aanmeldingsaanvraag in tekst zonder opmaak. |
|
SendSignConfirmation
|
Signers.SendSignConfirmation | boolean |
Stuur de bevestiging van het teken naar de ondertekenaar zijn e-mailadres. |
|
Language
|
Signers.Language | string |
Alleen de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL en nl-NL zijn toegestaan. |
|
Krabbelnaam
|
Signers.ScribbleName | string |
De naam van de ondertekenaar wordt vooraf ingevuld in het krabbelformulier. |
|
DaysToRemind
|
Signers.DaysToRemind | integer |
Aantal dagen voordat de ondertekenaars eraan worden herinnerd. |
|
Verloopt
|
Signers.Expires | date-time |
Wanneer de ondertekenaar is ingesteld, mag de transactie na deze datum niet meer worden ondertekend. |
|
Reference
|
Signers.Reference | string |
De verwijzing van de ondertekenaar. |
|
RejectReason
|
Signers.RejectReason | string |
De afwijzingsreden die door de ondertekenaar werd gegeven toen de transactie werd afgewezen. |
|
ReturnUrl
|
Signers.ReturnUrl | string |
De URL waarnaar de gebruiker wordt omgeleid na ondertekening, weigeren of annuleren. |
|
Context
|
Signers.Context | object |
Elk geldig json-object dat we retourneren. |
|
Activities
|
Signers.Activities | array of object |
Lijst met activiteiten die aan deze ondertekenaar zijn gekoppeld. |
|
Identiteitsbewijs
|
Signers.Activities.Id | string | |
|
Code
|
Signers.Activities.Code | integer |
|
|
Informatie
|
Signers.Activities.Info | string |
Kan aanvullende informatie bevatten die deel uitmaakt van deze activiteit |
|
Aanmaakdatum en tijd
|
Signers.Activities.CreatedDateTime | date-time | |
|
Ontvangers
|
Receivers | array of object | |
|
Naam
|
Receivers.Name | string |
De naam van de ontvanger. |
|
E-mailen
|
Receivers.Email | string |
Het e-mailadres van de ontvanger. |
|
Language
|
Receivers.Language | string |
De taal van de ontvanger, alleen de-DE, en-US, es-ES, fr-FR, it-IT en nl-NL zijn toegestaan. |
|
Onderwerp
|
Receivers.Subject | string |
Het onderwerp van de ontvanger-e-mail in tekst zonder opmaak. |
|
Message
|
Receivers.Message | string |
Het e-mailbericht naar de ontvanger in tekst zonder opmaak. |
|
Reference
|
Receivers.Reference | string |
De verwijzing van de ontvanger. |
|
Context
|
Receivers.Context | object |
Elk geldig json-object dat we terugsturen. |
|
Reference
|
Reference | string |
De verwijzing naar de transactie. Bijvoorbeeld '1234' |
|
PostbackUrl
|
PostbackUrl | string |
De absolute URL voor het terugschrijven van de statusupdates. |
|
SignRequestMode
|
SignRequestMode | integer |
Ingesteld op 1 voor het tegelijk verzenden naar 2 voor sequentiële gegevens. |
|
DaysToExpire
|
DaysToExpire | integer |
Aantal dagen vóór de vervaldatum. Max. 90 dagen. |
|
SendEmailNotifications
|
SendEmailNotifications | boolean |
E-mailmeldingen verzenden naar de afzender. |
|
Toestand
|
Status | integer |
Huidige transactiestatus. |
|
CancelationReason
|
CancelationReason | string |
De oorspronkelijke annuleringsreden die tijdens een DELETE-oproep is opgegeven. |
|
Context
|
Context | object |
Elk geldig json-object dat we terugsturen. |
Authenticatie
| Name | Pad | Type | Description |
|---|---|---|---|
|
Typologie
|
Type | string |
Type van het verificatieobject. |
|
Number
|
Number | string |
Telefoonnummer: dit veld is verplicht wanneer de verificatiemethode PhoneNumber wordt gekozen |
|
Bsn
|
Bsn | number |
Dit veld is verplicht wanneer de BSN-verificatiemethode wordt gekozen |
Verification
| Name | Pad | Type | Description |
|---|---|---|---|
|
Typologie
|
Type | string |
Type van het verificatieobject. |
binair
Dit is het basisgegevenstype 'binair'.