The electronic company stamp with Validated ID, also known as a seal, technically works like a centralised signature and can have an advanced or qualified certificate.
A seal, however, is always bound to a legal entity, such as a company or another organization. An electronic signature, by contrast, is always assigned to a natural person.
The organization issuing the seal must be registered with Validated ID. For a qualified signature, the organization must also have completed a separate identification process.
Example: Before a contract is sent to the customer, the authenticity of the contract is confirmed by an automatic signature - the electronic company stamp. An employee's signature is not required.
Read general information on the service methods and parameters with Validated ID.
The following methods are available for the electronic company stamp:
AddNewDocumentStamp
This method sends one file of a document for signing with an electronic company stamp. The signature is placed at one position.
AddNewClippedDocumentStamp
This method sends multiple files of a document for signing with one electronic company stamp. The signature is placed at multiple positions.
For an overview, here are the same methods and information in table form:
Method | Description | Files | Signers | Signature positions |
|---|---|---|---|---|
AddNewDocumentStamp | This method sends one file of a document for signing with an electronic company stamp. The signature is placed at one position. | 1 | 1 | 1 |
AddNewClippedDocumentStamp | This method sends multiple files of a document for signing with one electronic company stamp. The signature is placed at multiple positions. | multiple | 1 | multiple |
AddNewDocumentStamp
This method sends one file of a document for signing with an electronic company stamp. The signature is placed at one position.
Parameters must be specified. Exceptions are marked as "optional".
Parameter name | Category | Variable type in the workflow | Description | Values |
Token (string) | General | Text | The workflow uses the token to authenticate itself to the Signature Service. The token is created when the Signature Service is registered and is sent by email. | |
DateSignedFieldName (string) | Fields | Text | Specifies an index field into which the date of signing is entered. It can be a text, date, or date/time field. If the field is a text field, the date is entered in UTC and displayed in DocuWare. We recommend using a field of type Date or Date/Time so that the date and time are displayed in the local time zone and local format. |
|
StatusFieldName (string) | Fields | Text | Specifies an index field into which the status of a signature is entered. The field is filled with "SuccessStatusValue" or "FailureStatusValue". This field is ideal for continuing the workflow after the signature. | |
SuccessStatusValue (string) | Fields | Text | Value entered into the index field defined in "StatusFieldName" after a successful signature. | |
FailureStatusValue (string) | Fields | Text | Value entered into the index field defined in "StatusFieldName" after a failed signature. | |
DaysBeforeExpiration (int) | Process | Integer | With a value of >0, sets a deadline in days for signing. If the deadline is exceeded, the document is considered rejected and is no longer available for signing. | |
PostSigningAction (string) | Process | Text | Specifies whether the signed document is sent to the signer by email. |
|
SendSignedDocument (Boolean) | Process | Text | Specifies how the signed document is stored in DocuWare: either the original document is overwritten, or the signed document is clipped to the front or back of the original document. |
|
FileCabinetId (string) | Document | Text | Specifies, by its GUID, the file cabinet in which the document to be signed is stored. The GUID is displayed in the file cabinet administration. | |
DocId (int) | Document | Integer | Specifies the document to be signed by its DocID. | |
SectionNumber (int) | Position | Integer | Specifies the file (section) of a clipped document that is to be signed. |
|
PageNumber (int) | Position | Integer | Specifies the page number in the document on which the signature is placed. If an anchor text is used, this parameter specifies the page from which the anchor text is searched. |
|
AnchorText (string) | Position | Text | Specifies a text that is used as the reference point for the signature position. If no value is specified, the reference point is the top left corner of the page. | |
AnchorTextOccurrence (int) | Position | Integer | If the anchor text occurs several times in the document, this parameter specifies which occurrence is used to calculate the position. |
|
PositionX (int) | Position | Integer | Specifies the horizontal position of the signature. The reference line is the left page margin or (when an anchor text is used) the left edge of the found text. Positive numbers are to the right of the reference line, negative numbers to the left. Values are in millimeters. | |
PositionY (int) | Position | Integer | Specifies the vertical position of the signature. The reference line is the top page margin or (when an anchor text is used) the top edge of the found text. Positive numbers are below the reference line, negative numbers above it. Values are in millimeters. | |
SizeX (int) | Position | Integer | Specifies the width of the signature image in millimeters. | |
SizeY (int) | Position | Integer | Specifies the height of the signature image in millimeters. | |
SignerName (string) | Signer | Text | Specifies the name of the signing user. Not required if "SignerNameEditable" is enabled. | |
SignerEmail (string) | Signer | Text | Specifies the email address of the signing user. | |
SignerID (string) | Signer | Text | Specifies an ID number (e.g. identity card number) of the signer. Required for the centralised signature and the company stamp, optional for remote signature and biometric signature. | |
CertificateGUI (string) | Signer | Text | Specifies the certificate used to sign the document. This value is provided by Validated ID. | |
CertificatePin (string) | Signer | Text | Specifies the PIN for the "CertificateGUI". The PIN is provided by Validated ID together with the certificate. |
AddNewClippedDocumentStamp
This method sends multiple files of a document for signing with one electronic company stamp. The signature is placed at multiple positions.
In the list parameters, the order and the number of values separated by “MultiValueSeparator” must be identical.
Parameters must be specified. Exceptions are marked as "optional".
Parameter | Category | Variable type in the workflow | Description | Values |
Token (string) | General | Text | The workflow uses the token to authenticate itself to the Signature Service. The token is created when the Signature Service is registered and is sent by email. | |
DateSignedFieldName (string) optional | Fields | Text | Specifies an index field into which the date of signing is entered. It can be a text, date, or date/time field. If the field is a text field, the date is entered in UTC and displayed in DocuWare. We recommend using a field of type Date or Date/Time so that the date and time are displayed in the local time zone and local format. |
|
StatusFieldName (string) | Fields | Text | Specifies an index field into which the status of a signature is entered. The field is filled with "SuccessStatusValue" or "FailureStatusValue". This field is ideal for continuing the workflow after the signature. | |
SuccessStatusValue (string) | Fields | Text | Value entered into the index field defined in "StatusFieldName" after a successful signature. | |
FailureStatusValue (string) | Fields | Text | Value entered into the index field defined in "StatusFieldName" after a failed signature. | |
DaysBeforeExpiration (int) optional | Process | Integer | With a value of >0, sets a deadline in days for signing. If the deadline is exceeded, the document is considered rejected and is no longer available for signing. | |
PostSigningAction (string) | Process | Text | Specifies how the signed document is stored in DocuWare: either the original document is overwritten, or the signed document is clipped to the front or back of the original document. |
|
SendSignedDocument (Boolean) | Process | Text | Specifies whether the signed document is sent to the signer by email. |
|
MultiValueSeparator (string) | Process | Text | Specifies how multiple values within one parameter are separated from each other. Common separators are a comma, a caret ^, or a vertical bar | | |
MultiSectionCount (int) | Process | Integer | Number of files of a DocuWare document to be signed | |
FileCabinetId (string) | Document | Text | Specifies, by its GUID, the file cabinet in which the document to be signed is stored. The GUID is displayed in the file cabinet administration. | |
DocId (int) | Document | Integer | Specifies the document to be signed by its DocID. | |
MultiSectionNumber (string) | Position | Text | List of multiple "SectionNumber" values separated by "MultiValueSeparator". See method “AddNewDocumentStamp”. | |
MultiPageNumber (string) | Position | Text | List of multiple "PageNumber" values separated by "MultiValueSeparator". See method “AddNewDocumentStamp”. | |
MultiAnchorText (string) | Position | Text | List of multiple "AnchorText" values separated by "MultiValueSeparator". See method “AddNewDocumentStamp”. | |
MultiAnchorTextOccurrence (string) | Position | Text | List of multiple "AnchorTextOccurence" values separated by "MultiValueSeparator". See method “AddNewDocumentStamp”. | |
MultiPositionX (string) | Position | Text | List of multiple "PositionX" values separated by "MultiValueSeparator". See method “AddNewDocumentStamp”. | |
MultiPositionY (string) | Position | Text | List of multiple "PositionY" values separated by "MultiValueSeparator". See method “AddNewDocumentStamp”. | |
MultiSizeX (string) | Position | Text | List of multiple "SizeX" values separated by "MultiValueSeparator". See method “AddNewDocumentStamp”. | |
MultiSizeY (string) | Position | Text | List of multiple "SizeY" values separated by "MultiValueSeparator". See method “AddNewDocumentStamp”. | |
PostSigningAction (string) | Process | Text | Specifies how a signed document is stored in the file cabinet. |
|
SignerName (string) | Signer | Text | Specifies the name of the signing user. Not required if "SignerNameEditable" is enabled. | |
SignerEmail (string) | Signer | Text | Specifies the email address of the signing user. | |
SignerID (string) | Signer | Text | Specifies an ID number (e.g. identity card number) of the signer. Required for the centralised signature and the company stamp, optional for remote signature and biometric signature. | |
CertificateGUI (string) | Signer | Text | Specifies the certificate used to sign the document. This value is provided by Validated ID. | |
CertificatePin (string) | Signer | Text | Specifies the PIN for the "CertificateGUI". The PIN is provided by Validated ID together with the certificate. |