Return codes of all methods

The Result of each SecuSign SDK function contains an integer return value corresponding to one of the following codes:

Return value Code Name Description

SecuSign SDK web service

0

OK

Success.

1

ERROR

Unknown error.

Signing Certificate is expired: NotAfter: Day Month dd HH:mm:ss CEST YYYY

There is no signature to timestamp in the document.

Signature already contains signature timestamp.

2

METHOD_NOT_ALLOWED

User is not allowed to call this method (e.g. Premium plan or remote sealing required)

3

UNAUTHORIZED

Error connecting to secusign backend server due to VerifyUser failed to verify basic authentication or license certificate (used for login to backend service)

4

INTERRUPTED_UNEXPECTEDLY

The operation was unexpectedly interrupted (cause: the transaction log contains the beginning, but the end is missing)

5

INVALID_PARAMETER

Invalid input parameter setting (e.g. validate and the output format is not set)

6

INVALID_INPUT

Empty or mismatched contents of input file

7

ERROR_ACCESS_SEALING_CERT

Error accessing the sealing certificate

8

NOT_IMPLEMENTED

Function not implemented

9

EXCEPTION

Exception raised during File processing

10

LTV_ANALYZE_ERROR

Error in ltvAnalyze method

11

LTV_REGISTER_ERROR

Error in ltvRegister method

12

LTV_UPDATE_ERROR

Error in ltvUpdate method

13

LTV_UNREGISTER_ERROR

Error in ltvUnregister method

14

LTV_GETINFO_ERROR

Error in ltvGetInfo method

15

LTV_GETFORUPDATE_ERROR

Error in ltvGetForUpdate method

16

LTV_SIGN_ERROR

Error in ltvSign method

17

LTV_TIMESTAMP_ERROR

Error in ltvTimestamp method

18

DOCUMENT_NOT_SIGNED

Document does not contain required digital signature or timestamp

19

LTV_UPDATE_ID_NOT_FOUND

Document with specified ID not found. Document must be registered before update.

20

LTV_UPDATE_HASH_MISMATCH

Document hash does not correspond to specified ID

21

LTV_UPDATE_FAILED

Unable to extend signature validity. For PDF, 602XMLForm and IDSOC the last signature must be VALID. For other formats, all signatures must be VALID and no one from registered signatures can be missing.

22

LTV_INCONVENIENT_CONDITIONS

Document does not comply with conditions for LTV. All/last/at least one signature must be marked as VALID.

23

DOCUMENT_NOT_REGISTERED

No document with the submitted DocID or hash has been registered (the corresponding record has not been found)

24

LICENCE_ERROR

Error when verifying licence/role

The Remote signing/sealing service

0

OK

Success. The signature/seal has been successfully created.

16

LTV_SIGN_ERROR

General error while signing/sealing a document in SDK, e.g. there was a problem when writing in the transaction log or the license certificate is not registered in the environment

101

UNKNOWN

General or unknown error returned from the Remote signing/sealing service, e.g. because no certificate has been found for the submitted CertificateID

102

USER_ACCESS_DENIED

The certificate and key have been found, but the specified user does not have access to them

103

INVALID_PIN

The certificate and key have been found, the user can access them but the submitted PIN does not match

104

CONFIG_ERROR

Error in configuration settings, e.g. the license certificate for request decryption is not set for the SignEx method

105

INVALID_PARAMETER

Invalid method parameter

106

ACCESS_DENIED

Client authentication error for the Remote signing service, e.g. the login certificate or organization ID is invalid, access is forbidden or the operation is not allowed

107

SEND_CONFIRMATION_FAILED

Error when sending a confirmation e-mail

108

CONFIRMATION_TIMEOUT

The request timed out when waiting for signature confirmation

109

CERT_NOT_FOUND

Certificate with given ID not found

110

CERT_DISABLED

Certificate has DISABLED status (been disabled)

111

CERT_REVOKED

Certificate has REVOKED status (has been revoked)

112

PKEY_NOT_AVAILABLE

Private key needed for signing is not available or not found

113

SIGNING_FAILED

(SignHash) signing hash function failed

114

CREATE_CERT_FAILED

Error creating SignMaster CA certificate

115

SET_CERT_PROP_FAILED

Error setting certificate property

116

IMPORT_FAILED

Error importing X509 / P12 certificate

117

EXPORT_FAILED

Error exporting certificate (applies to Sofa / FFS)

118

NOT_YET_IMPLEMENTED

The feature has not yet implemented

119

IMPORT_PASSWORD_INVALID

The incorrect password was used during PFX import or a damaged file was inserted

120

CERTIFICATE_EXPIRED

The selected certificate has expired. NotAfter=YYYY-MM-DDTHH:mm:ssZ.

129

DECRYPT_FAILED

Failed to decrypt data. Incorrect cipher or private key.

130

PIN_BLOCKED

This code returns in the case of that the PIN has been entered incorrectly and the selected certificate has been blocked. The code is supplemented with the text: Certificate PIN blocked until [time of blocking]

131

PUK_BLOKED

This code returns in the case of that the PUK has been entered incorrectly and the selected certificate has been blocked.

132

BATCH_SIGN_TOO_MANY_FILES

The maximum allowed number of files for batch signing exceeded

133

BATCH_SIGN_CHECK_FAILED

Attempting to batch sign a file that does not belong to the batch

134

BATCH_SIGN_TIMEOUT

The validity of signing token for batch signature has expired

The Remote signing/sealing service with 602Key

121

CONFIRMATION_NOT_ACTIVATED

The user has no device activated for two-factor confirmation

123

CONFIRMATION_REJECTED

The user has declined the operation

124

CONFIRMATION_FAILED

Operation confirmation failed (connection error with remote 602Key server, or error on remote 602Key server, etc.)

The response for every function also contains a StatusMessage, which returns a text description and error details.