NEW3.01.08 · Released 13 December 2018
Breaking Change
NEWfinPOWER Connect
Released in
3.01.08
13 December 2018
  1. Opened17 Jul
  2. Closed12 Nov
  3. Released13 Dec
Article 15686 Job J021020

Electronic Signatures; add support for Secured Signing "Packages"

Added support for Secured Signing "Packages", i.e. Electronic Signatures with multiple Documents.

Previously Secured Signing "SmartTagSend" requests limited the number of Documents to 1. This has been updated to allow any number of Documents, and now uses the Secured Signed "SmartTagSend2" API which supports Packages.

Here is sample code to add a Secured Signing package of 3 documents to an Account.

Dim AccountLog As finAccountLog
Dim Request As ISElectronicSignatureRequest_SecuredSigning_SmartTagSendEx

Request = finBL.ElectronicSignature.Service_SecuredSigning.CreateRequest_SmartTagSendEx()
With Request
  .PackageName = "[PackageName]"

  .Documents.Add("[Document-FileName1]")
  .Documents.Add("[Document-FileName2]")
  .Documents.Add("[Document-FileName3]")
End With

' Create Associated Log
AccountLog = finBL.CreateAccountLog()
With AccountLog
  .AccountId = "[AccountId]"
  .Subject = "[LogSubject]"

  Success = .Save
End With

' Send Electronic Signature
If Success Then
  Success = finBL.ElectronicSignature.ExecuteSendAccountLog(Request, AccountLog.Pk, Nothing)
End If

Note, there is a new "PackageStatus" request object that can be used to import existing Secured Signing Packages. The following code snippet illustrates how to use:

Dim RequestPackageStatus As ISElectronicSignatureRequest_SecuredSigning_PackageStatus

RequestPackageStatus = finBL.ElectronicSignature.Service_SecuredSigning.CreateRequest_PackageStatus

With RequestPackageStatus
  .CreateFromExternal = True
  .PackageReference = "[ExternallyCreatedPackageReference]"
End With

Success = finBL.ElectronicSignature.Service_SecuredSigning.ExecutePackageStatus(RequestPackageStatus, Nothing)