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.