Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

For this call you need an authentication. For authentication, you’ll need an api token. You can find this information in Settings / Api Tokens and Apps. Note that all API methods require authentication. For more information about the authorization please have a look the  API Reference Guide for SOAP or the Postman Guide for REST

Expand
titleAlternative: SOAP implementation (deprecated)

After the authorization you need to BASE64 the PDF which you want to upload. If the call was successful you get a file Id which we will need for sending an envelope.

...

Info

Defining a MetaDataXML sets the value only if AdditionalClientWorkstepInformation is not already set via api. For example:

  1. Setting AdditionalClientWorkstepInformation AND MetaDataXml


    Code Block
    languagejava
    themeEclipse
    "SendEnvelopeDescription": {
        "MetaDataXml": "<Tagging doctype=\"INVOICE\"><InvoiceNr>123456</InvoiceNr></Tagging>",
    ...
    "Recipients": [
        {
            "Email": "##email##",
            ...
        }
    ],
    "RecipientType": "Signer",
    "WorkstepConfiguration": {
        "AdditionalClientWorkstepInformation": "<test id='test'>Some Information</test>",
        ...
    
    


    1. results in 

      Code Block
      languagexml
      themeEclipse
      <AdditionalClientWorkstepInformation>
          <test id='test'>Some Information</test>
      </AdditionalClientWorkstepInformation>

  2. Setting AdditionalClientWorkstepInformation only

    Code Block
    languagejava
    themeEclipse
    "SendEnvelopeDescription": {
    ...
    "Recipients": [
        {
            "Email": "##email##",
            ...
        }
    ],
    "RecipientType": "Signer",
    "WorkstepConfiguration": {
        "AdditionalClientWorkstepInformation": "<test id='test'>Some Information</test>",
        ...
    
    

    1. results in


      Code Block
      languagexml
      themeEclipse
      <AdditionalClientWorkstepInformation>
          <test id='test'>Some Information</test>
      </AdditionalClientWorkstepInformation>


  3. Setting MetaDataXml only


    Code Block
    languagejava
    themeEclipse
    "SendEnvelopeDescription": {
        "MetaDataXml": "<Tagging doctype=\"INVOICE\"><InvoiceNr>123456</InvoiceNr></Tagging>",
    ...
    "Recipients": [
        {
            "Email": "##email##",
            ...
        }
    ],
    "RecipientType": "Signer",
    "WorkstepConfiguration": {
        ...
    
    


    1. results in

      Code Block
      languagexml
      themeEclipse
      <AdditionalClientWorkstepInformation>
          <signature>
              <Tagging doctype="INVOICE">
                  <InvoiceNr>123456</InvoiceNr>
              </Tagging>
          </signature>
      </AdditionalClientWorkstepInformation>


Expiration date Image Added

Note: The following information is valid for envelopes as well as for drafts: Settings for the relative time:

...

Expand
titleAlternative: SOAP implementation (deprecated)


Code Block
languagexml
themeEclipse
<envelope>
  <name>test</name>
  <eMailSubject>Please sign the enclosed envelope</eMailSubject>
  <eMailBody>Dear #RecipientFirstName# #RecipientLastName#

#PersonalMessage#

Please sign the envelope #EnvelopeName#

Envelope will expire at #ExpirationDate#</eMailBody>
  <enableReminders>true</enableReminders>
  <firstReminderDayAmount>5</firstReminderDayAmount>
  <recurrentReminderDayAmount>3</recurrentReminderDayAmount>
  <beforeExpirationReminderDayAmount>3</beforeExpirationReminderDayAmount>
  <daysUntilExpire>28</daysUntilExpire>
  <callbackUrl></callbackUrl>
  <statusUpdateCallbackUrl></statusUpdateCallbackUrl>
  <lockFormFieldsAtEnvelopeFinish>true</lockFormFieldsAtEnvelopeFinish>
  <displayedEmailSender></displayedEmailSender>
  <steps>
    <step>
      <emailBodyExtra></emailBodyExtra>
      <orderIndex>1</orderIndex>
      <recipientType>Signer</recipientType>
      <useDefaultAgreements>true</useDefaultAgreements>
      <documentOptions>
        <documentOption docRef="1">
          <isHidden>false</isHidden>
        </documentOption>
      </documentOptions>
      <workstepConfiguration skipThirdPartyChecks="0">
        <WorkstepLabel>test</WorkstepLabel>
        <SmallTextZoomFactorPercent>100</SmallTextZoomFactorPercent>
        <WorkstepTimeToLiveInMinutes>44650</WorkstepTimeToLiveInMinutes>
        <AbsoluteExpiryDate>2020-07-10T10:57:46.4243017Z</AbsoluteExpiryDate>
        <FinishAction>
          <ClientAction clientName="SIGNificant SignAnywhere" closeApp="0" RemoveDocumentFromRecentDocumentList="0" CallClientActionOnlyAfterSuccessfulSync="1">https://www.esignanywhere.net/</ClientAction>
        </FinishAction>
        <ViewerPreferences>
          <SendVisibleArea allowedDomain="*">0</SendVisibleArea>
          <FinishWorkstepOnOpen>0</FinishWorkstepOnOpen>
        </ViewerPreferences>
        <Policy version="1.1.0.0">
          <AdhocPolicies>
            <AllowModificationsAfterSignature>1</AllowModificationsAfterSignature>
          </AdhocPolicies>
          <GeneralPolicies>
            <AllowAdhocFreeHandAnnotations>0</AllowAdhocFreeHandAnnotations>
            <AllowAdhocPdfAttachments>0</AllowAdhocPdfAttachments>
            <AllowAdhocPdfPageAppending>0</AllowAdhocPdfPageAppending>
            <AllowAdhocPictureAnnotations>0</AllowAdhocPictureAnnotations>
            <AllowAdhocSignatures>0</AllowAdhocSignatures>
            <AllowAdhocStampings>0</AllowAdhocStampings>
            <AllowAdhocTypewriterAnnotations>0</AllowAdhocTypewriterAnnotations>
            <AllowEmailDocument>1</AllowEmailDocument>
            <AllowFinishWorkstep>1</AllowFinishWorkstep>
            <AllowPrintDocument>1</AllowPrintDocument>
            <AllowRejectWorkstep>1</AllowRejectWorkstep>
            <AllowSaveAuditTrail>1</AllowSaveAuditTrail>
            <AllowSaveDocument>1</AllowSaveDocument>
            <AllowUndoLastAction>1</AllowUndoLastAction>
            <AllowRotatingPages>0</AllowRotatingPages>
            <AllowRejectWorkstepDelegation>1</AllowRejectWorkstepDelegation>
          </GeneralPolicies>
          <WorkstepTasks originalSequenceMode="NoSequenceEnforced" SequenceMode="NoSequenceEnforced">
            <Task type="SignField" DocRefNumber="1" id="1#XyzmoDuplicateIdSeperator#Signature_a3d634d1-5b9e-8089-e77d-4888a9616fb2" internalCompleted="0" finishPercentage="0" completed="0" enabled="1" displayName="" required="1" />
          </WorkstepTasks>
        </Policy>
        <Navigation />
        <timeCreated>2020-07-10T10:47:46.3930488Z</timeCreated>
        <TransactionCodeConfigurations>
    <TransactionCodeConfiguration trConfId="smsAuthTransactionCodeId">
    </TransactionCodeConfiguration>
  </TransactionCodeConfigurations>
        <receiverInformation>
          <userInformation>
            <firstName>##NAME##</firstName>
            <lastName>##NAME##</lastName>
            <eMail>##EMAIL##</eMail>
          </userInformation>
          <showNamirialDisposableDisclaimer>1</showNamirialDisposableDisclaimer>
          <trRsDcNamHolderInformation version="2">
            <recognitionType>PASS</recognitionType>
            <documentIssuedOn>07/07/2020</documentIssuedOn>
            <documentExpiryDate>29/07/2020</documentExpiryDate>
            <documentIssuedBy>Namirial</documentIssuedBy>
            <documentNumber>123</documentNumber>
            <countryResidence>AT</countryResidence>
            <firstName>##NAME##</firstName>
            <lastName>##NAME##</lastName>
            <email>##EMAIL##</email>
            <phoneMobile>##PHONENUMBER##</phoneMobile>
            <identificationType>PASSPORT</identificationType>
            <identificationCountry>AT</identificationCountry>
            <passport>123</passport>
          </trRsDcNamHolderInformation>
        </receiverInformation>
        <senderInformation>
          <userInformation>
            <firstName>##NAME##</firstName>
            <lastName>##NAME##</lastName>
            <eMail>##EMAIL##</eMail>
          </userInformation>
        </senderInformation>
        <pdfForms isEditingAllowed="0" />
        <TypewriterAnnotationTaskInfo />
        <attachmentFields />
        <signatureTemplate>
          <version>1.2.0.2</version>
          <positionReferenceCorner>Lower_Left</positionReferenceCorner>
          <positionUnits>PdfUnits</positionUnits>
          <sig id="1#XyzmoDuplicateIdSeperator#Signature_a3d634d1-5b9e-8089-e77d-4888a9616fb2">
            <TaskDisplayName />
            <param name="enabled">1</param>
            <positionPage>1</positionPage>
            <positionX>78</positionX>
            <positionY>545</positionY>
            <width>190</width>
            <height>80</height>
            <param name="positioning">onPage</param>
            <param name="req">1</param>
            <param name="fd" />
            <param name="fd_dateformat">dd-MM-yyyy HH:mm:ss</param>
            <param name="fd_timezone">datetimeutc</param>
            <DocRefNumber>1</DocRefNumber>
            <AllowedSignatureTypes>
              <sigType id="89f2876e-2149-4a88-b841-547a1b3478a5" type="TransactionCode">
                <trModType>RemoteSignatureDisposableCertificate</trModType>
                <trValidityInSeconds>300</trValidityInSeconds>
                <ly>remoteCertificate</ly>
                <trConfIdIssueCertificate>disposableCertificateEnrolAndSignSmsText</trConfIdIssueCertificate>
                <trConfId>remoteCertificateSignSmsText</trConfId>
                <StampImprintConfiguration>
                  <DisplayExtraInformation>1</DisplayExtraInformation>
                  <DisplayEmail>1</DisplayEmail>
                  <DisplayIp>1</DisplayIp>
                  <DisplayName>1</DisplayName>
                  <DisplaySignatureDate>1</DisplaySignatureDate>
                  <FontFamily>Times New Roman</FontFamily>
                  <FontSize>11</FontSize>
                </StampImprintConfiguration>
              </sigType>
            </AllowedSignatureTypes>
            <param name="spcId">padesSigningId</param>
          </sig>
        </signatureTemplate>
        <AuditingToolsConfiguration WriteAuditTrail="0">
          <NotificationConfiguration />
        </AuditingToolsConfiguration>
        <resourceUris>
          <delegationUri>https://demo.esignanywhere.net/Resource/Delegate</delegationUri>
        </resourceUris>
        <LoggingMetaInformation>
          <envelopeId>##ENVELOPEID##</envelopeId>
          <envelopeRecipientId>##RECIPIENTID##</envelopeRecipientId>
        </LoggingMetaInformation>
      </workstepConfiguration>
      <recipients>
        <recipient>
          <eMail>##EMAIL##</eMail>
          <emailBodyExtra></emailBodyExtra>
          <firstName>##NAME##</firstName>
          <lastName>##NAME##</lastName>
          <languageCode>en</languageCode>
          <disableEmail>false</disableEmail>
          <skipExternalDataValidation>false</skipExternalDataValidation>
          <addAndroidAppLink>false</addAndroidAppLink>
          <addIosAppLink>false</addIosAppLink>
          <addWindowsAppLink>false</addWindowsAppLink>
          <allowDelegation>true</allowDelegation>
          <allowAccessFinishedWorkstep>false</allowAccessFinishedWorkstep>
          <authentications />
          <disposableCertificateAdditionalInformation>
            <countryResidence>AT</countryResidence>
            <phoneMobile>##PHONENUMBER##</phoneMobile>
            <documentType>PASS</documentType>
            <documentIssuedBy>Namirial</documentIssuedBy>
            <documentIssuedOn>2020-07-07T00:00:00Z</documentIssuedOn>
            <documentExpiryDate>2020-07-29T00:00:00Z</documentExpiryDate>
            <serialNumber>123</serialNumber>
            <identificationType>PASSPORT</identificationType>
            <identificationCountry>AT</identificationCountry>
            <documentNumber>123</documentNumber>
            <overrideOnHolderMismatch>false</overrideOnHolderMismatch>
          </disposableCertificateAdditionalInformation>
        </recipient>
      </recipients>
    </step>
    <step>
      <emailBodyExtra></emailBodyExtra>
      <orderIndex>2</orderIndex>
      <recipientType>Cc</recipientType>
      <useDefaultAgreements>false</useDefaultAgreements>
      <recipients>
        <recipient>
          <eMail>##EMAIL##</eMail>
          <emailBodyExtra></emailBodyExtra>
          <firstName>##NAME##</firstName>
          <lastName>##NAME##</lastName>
          <languageCode>en</languageCode>
          <disableEmail>false</disableEmail>
          <skipExternalDataValidation>false</skipExternalDataValidation>
          <addAndroidAppLink>false</addAndroidAppLink>
          <addIosAppLink>false</addIosAppLink>
          <addWindowsAppLink>false</addWindowsAppLink>
          <allowDelegation>false</allowDelegation>
          <authentications />
        </recipient>
      </recipients>
    </step>
  </steps>
  <attachSignedDocumentsToEnvelopeLog>false</attachSignedDocumentsToEnvelopeLog>
</envelope> 


P7M Signers Image Added

Info

It is possible to define P7M signers in eSignAnyWhere (version 3. 1+). This allows you to define at the end of a signing workflow to define signers with P7M. Due technical reasons it is not possible to add non-P7M signers after the first P7M signer. P7M is an advanced feature and must be enabled for you, so please contact your Namirial Sales

...

Automatic Remote Signature Recipient via API Image Added

Via API you have to use a new recipient type (“Automatic”). Moreover the workstepConfiguration must contain information about the automatic remote signature. As additional option, you can use more than one profile for the workstep configuration at once via API. Note: this leads to a missing information in eSAW UI!

...

Code Block
languagexml
themeEclipse
<Policy version="1.1.0.0">
  <FinalizeActions>
	<AutomaticSignature sigId="GENERIC_SIG_IDENTIFIER" />
  </FinalizeActions>
</Policy>

A-Trust Image Added

Info

Note: For the A-Trust signature configuration you need an A-Trust Signaturbox first. For more information please contact us.

...

If you enter the phone number then the recipient can not enter another number. However, if you do not define a phone number then the recipient is free to choose a phone number of their choice.

BankID Image Added

In this section you can find the configuration for the bankID signature. First we have to upload a PDF. After uploading the document we can now send the document with the following workstep configuration to define the bankID signature:

Code Block
languagejava
themeEclipse
{
   "Name": "test",
  "EmailSubject": "Please sign the enclosed envelope",
  "EmailBody": "Dear #RecipientFirstName# #RecipientLastName#\n\n#PersonalMessage#\n\nPlease sign the envelope #EnvelopeName#\n\nEnvelope will expire at #ExpirationDate#",
  "DisplayedEmailSender": "##SENDER##",
  "EnableReminders": true,
  "FirstReminderDayAmount": 5,
  "RecurrentReminderDayAmount": 3,
  "BeforeExpirationDayAmount": 3,
  "DaysUntilExpire": 28,
  "CallbackUrl": "",
  "StatusUpdateCallbackUrl": "",
  "LockFormFieldsAtEnvelopeFinish": true,
  "Steps": [
    {
      "OrderIndex": 1,
      "Recipients": [
        {
          "Email": "##EMAIL##",
          "FirstName": "##NAME##",
          "LastName": "##NAME##",
          "LanguageCode": "en",
          "EmailBodyExtra": "",
          "DisableEmail": false,
          "AddAndroidAppLink": false,
          "AddIosAppLink": false,
          "AddWindowsAppLink": false,
          "AllowDelegation": false,
          "AllowAccessFinishedWorkstep": false,
          "SkipExternalDataValidation": false,
          "AuthenticationMethods": []
        }
      ],
      "EmailBodyExtra": "",
      "RecipientType": "Signer",
      "WorkstepConfiguration": {
        "WorkstepLabel": "test",
        "SmallTextZoomFactorPercent": 100,
        "FinishAction": {
          "ServerActions": [],
          "ClientActions": [
            {
              "RemoveDocumentFromRecentDocumentList": false,
              "CallClientActionOnlyAfterSuccessfulSync": true,
              "ClientName": "SIGNificant SignAnywhere",
              "CloseApp": false,
              "Action": "https://www.esignanywhere.net/"
            }
          ]
        },
        "ReceiverInformation": {
          "UserInformation": {
            "FirstName": "##NAME##",
            "LastName": "##NAME##",
            "EMail": "##EMAIL##"
          },
          "TransactionCodePushPluginData": []
        },
        "SenderInformation": {
          "UserInformation": {
            "FirstName": "##NAME##",
            "LastName": "##NAME##",
            "EMail": "##EMAIL##"
          }
        },
        "TransactionCodeConfigurations": [
          {
            "Id": "",
            "HashAlgorithmIdentifier": "Sha1",
            "Texts": [
              {
                "Value": "Please sign the document"
              }
            ]
          },
          {
            "Id": "otpSignatureSmsText",
            "HashAlgorithmIdentifier": "Sha256",
            "Texts": [
              
            ]
          }
        ],
        "SignatureConfigurations": [],
        "ViewerPreferences": {
          "FinishWorkstepOnOpen": false,
          "VisibleAreaOptions": {
            "AllowedDomain": "*",
            "Enabled": false
          }
        },
        "ResourceUris": {},
        "AuditingToolsConfiguration": {
          "WriteAuditTrail": false,
          "NotificationConfiguration": {}
        },
        "Policy": {
          "GeneralPolicies": {
            "AllowSaveDocument": true,
            "AllowSaveAuditTrail": true,
            "AllowRotatingPages": false,
            "AllowEmailDocument": true,
            "AllowPrintDocument": true,
            "AllowFinishWorkstep": true,
            "AllowRejectWorkstep": true,
            "AllowRejectWorkstepDelegation": false,
            "AllowUndoLastAction": true,
            "AllowAdhocPdfAttachments": false,
            "AllowAdhocSignatures": false,
            "AllowAdhocStampings": false,
            "AllowAdhocFreeHandAnnotations": false,
            "AllowAdhocTypewriterAnnotations": false,
            "AllowAdhocPictureAnnotations": false,
            "AllowAdhocPdfPageAppending": false
          },
          "WorkstepTasks": {
            "PictureAnnotationMinResolution": 0,
            "PictureAnnotationMaxResolution": 0,
            "PictureAnnotationColorDepth": "Color16M",
            "SequenceMode": "SequenceOnlyRequiredTasks",
            "PositionUnits": "PdfUnits",
            "ReferenceCorner": "Lower_Left",
            "Tasks": [
              {
                "PositionPage": 1,
                "Position": {
                  "PositionX": 10.0,
                  "PositionY": 10.0
                },
                "Size": {
                  "Height": 50.0,
                  "Width": 200.0
                },
                "AdditionalParameters": [
                  {
                    "Key": "sigType",
                    "Value": "TransactionCode"
                  },
                  {
                    "Key": "trModType",
                    "Value": "BankIdSignature"
                  },
                  {
                    "Key": "trValidityInSeconds",
                    "Value": "60"
                  },
                  {
                    "Key": "ly",
                    "Value": "bankId"
                  }
                ],
                "AllowedSignatureTypes": [],
                "UseTimestamp": false,
                "IsRequired": true,
                "Id": "1",
                "DisplayName": "SignField 1",
                "DocRefNumber": 1,
                "DiscriminatorType": "Signature"
              }
            ]
          }
        },
        "Navigation": {
          "HyperLinks": [],
          "Links": [],
          "LinkTargets": []
        }
      },
      "DocumentOptions": [
        {
          "DocumentReference": "1",
          "IsHidden": false
        }
      ],
      "UseDefaultAgreements": true
    },
    {
      "OrderIndex": 2,
      "Recipients": [
        {
          "Email": "##EMAIL##",
          "FirstName": "##NAME##",
          "LastName": "##NAME##",
          "LanguageCode": "en",
          "EmailBodyExtra": "",
          "DisableEmail": false,
          "AddAndroidAppLink": false,
          "AddIosAppLink": false,
          "AddWindowsAppLink": false,
          "AllowDelegation": false,
          "AllowAccessFinishedWorkstep": false,
          "SkipExternalDataValidation": false,
          "AuthenticationMethods": []
        }
      ],
      "EmailBodyExtra": "",
      "RecipientType": "Cc",
      "DocumentOptions": [
        {
          "DocumentReference": "1",
          "IsHidden": false
        }
      ],
      "UseDefaultAgreements": false
    }
  ],
  "AddFormFields": {
    "Forms": {}
  },
  "OverrideFormFieldValues": {
    "Forms": {}
  },
  "AttachSignedDocumentsToEnvelopeLog": false
}

...

Expand
titleAlternative: SOAP implementation (deprecated)


Code Block
languagexml
themeEclipse
 <authentications>
          <authentication>
                <method>BankId</method>
                <parameter>##parameter##</parameter>
          </authentication>
 </authentications> 


Generic Signing Plugin Image Added

In this section you can find the configuration for the generic signing plugin signature. First we have to upload a PDF. After uploading the document we can now send the document with the following workstep configuration to define the plugin signature:

...

Generic Signing Plugin (automatic) Image Added

In this section you can find the configuration for an automatic generic signing plugin signature. Please see the following workstep configuration for more information:

Code Block
languagejava
themeEclipse
{
    "SspFileIds": ["##SspFileId##"],

      "SendEnvelopeDescription": {
        "Name": "GenericSigningPluginForTests",
        "EmailSubject": "*GenericSigningPluginForTests*",
        "EmailBody": "*Please sign the document*",
        "Steps": [{
            "OrderIndex": 1,
            "Recipients": [{
                "Email": "##PlaceholderEmail##",
                "FirstName": "_PlaceHolderFirstName",
                "LastName": "_PlaceHolderLastName",
                "LanguageCode": "en",
                "DisableEmail": true,
                "AddAndroidAppLink": false,
                "AddIosAppLink": false,
                "AddWindowsAppLink": false,
                "AllowDelegation": false,
                "SkipExternalDataValidation": true
            }],
            "RecipientType": "Automatic",
            "WorkstepConfiguration": {
                "WorkstepLabel": "Automatic",
                "SkipThirdPartyChecks": false,
                "SmallTextZoomFactorPercent": 100,
                "WorkstepTimeToLiveInMinutes": 44650,
                "ViewerPreferences": {
                    "FinishWorkstepOnOpen": false
                },
                "Policy": {
                    "WorkstepTasks": {
                        "SequenceMode": "NoSequenceEnforced",
                        "PositionUnits": "PdfUnits",
                        "ReferenceCorner": "Lower_Left",
                        "Tasks": [{
                            "DiscriminatorType": "Signature",
                            "Id": "c5d2b3a5-afd1-4794-b8c8-c3f9c0755b75",
                            "DocRefNumber": 1,
                            "PositionPage": 1,
                            "Position": {
                                "PositionX": 0.0,
                                "PositionY": 0.0
                            },
                            "Size": {
                                "Height": 80.0,
                                "Width": 190.0
                            },
                            "AdditionalParameters": [{
                                "Key": "req",
                                "Value": "1"
                            }, {
                                "Key": "positioning",
                                "Value": "onPage"
                            }, {
                                "Key": "enabled",
                                "Value": "1"
                            }],
                            "AllowedSignatureTypes": [{
                                "DiscriminatorType": "SigTypeAutomaticSignature",
                                "Id": "SignFor_c5d2b3a5-afd1-4794-b8c8-c3f9c0755b75",
                                "GenericSigningPluginId": "GenericSigningPluginForTests",
                                "SealingProfileId": "##SealingProfileId##"
                            }]
                        }]
                    },
                    "FinalizeActions": {
                        "FinalizeActionList": [{
                            "DiscriminatorType": "AutomaticSignature",
                            "SigId": "c5d2b3a5-afd1-4794-b8c8-c3f9c0755b75"
                        }]
                    }
                }
            }
        }]
    }
}

...

Generic Signing Plugin (Batch-Signature) Image Added

In this section you can find the configuration for a batch generic signing plugin signature. Please see the following workstep configuration for more information:

...

For all placeholder with the additional “*” you need either the sender information or the receiver information which are both explained in the section “sender and receiver information”.

Reading Tasks Image Added

...

With the reading task a recipient must confirm reading the document to have the evidence that he/she was reading it.
Generally there are 3 basic ways concerning the range of the reading task:

...