eSignAnyWhere Error Codes

Here you find the list of eSAW API error codes and error codes coming from the SIGNificant Server Platform (to be exact the Workstep Controller). These might help you to fix an issue with the your integration.

An error returns and error (the code) and a message, why it failed.

Error Sample

Here you see a faulty uploadTemporarySspFile response, where the file name was empty in the request. The system returns you the baseResult as failed, the error code (ERR0002) and a textual descripton (errorMsg) why it failed.

  <baseResult>failed</baseResult>
  <errorInfo>
    <error>ERR0002</error>
    <errorMsg>ERR0002: Parameter FileName is empty</errorMsg>
    <supportId>756094</supportId>
  </errorInfo>

Messages starting with “ERR00xx” are returned errors of eSAW itself. If an error occoured in the SIGNificant Server Platform (Workstep Controller) it has an additional error code with “ERROR-xxxxx”, which identifies the SSP error. Below you find the error codes for eSAW and WSC (known by eSAW).

Here you find an response of an faulty SendEnvelope request, where the workstep configuration was invalid. The error is first a eSAW error (invalid workstep) and then a SSP/WSC error with details, why the workstep configuration was invalid:

<baseResult>failed</baseResult>
<errorInfo>
	<error>ERR0012</error>
	<errorMsg>ERR0012: Invalid workstep configuration: 
		<error>ERROR-12484</error>: 
		<errorMsg>Some configuration is missing for signature field with id '93cce567-ae5c-4e98-ac99-9f56ac034250', either provide a complete set for sig object or reference an existing field</errorMsg>
	</errorMsg>
	<supportId>441400</supportId>
</errorInfo>

eSignAnyWhere API Errors

Error codes starting with “ERR0xxx” are messages, which are coming from eSAW directly. Errors with “ERROR-” are errors from the SIGNificant Server Platform, which is reponsible for the workstep and the workstep configuration (see below).

Error Errorcode
General ERR0001
EmptyParameter ERR0002
MissingUser ERR0003
WrongUserType ERR0004
PdfConversionFailed ERR0005
HasDuplicateFormFieldNames ERR0006
MissingEnvelope ERR0007
MissingFile ERR0008
AuthorizationFailed ERR0009
EnvelopeActionNotAllowedForUser ERR0010
InvalidParameterFormat ERR0011
InvalidWorkstepConfiguration ERR0012
EnvelopeActionNotAllowedForEnvelopeState ERR0013
NotAllowedByLicense ERR0014
FileIsNoEnvelopeCompletedDocument ERR0015
WorkstepIdMappingError ERR0016
IncompleteTemplate ERR0017
RecipientActionNotAllowedForRecipientState ERR0018
AlreadyExistingUser ERR0019
FieldMarkupStringError ERR0020
ElementNotWithinPageBounds ERR0021
UnsupportedMimeType ERR0022
ContentDispositionMissingOrIncomplete ERR0023
ActionForRecipientOnlyAllowedOnBulkLevel ERR0024
ActionForRecipientNotAllowedForBulks ERR0025
MissingFirstNameField ERR0026
MissingLastNameField ERR0027
MissingEmailField ERR0028
MissingPasswordField ERR0029
CountryFieldInvalidValue ERR0030
LanguageInvalidValue ERR0031
DuplicateEmail ERR0032
InvalidInput ERR0033
InvalidEmailAddress ERR0034
DeniedByUserSetting ERR0035
MissingConfiguration ERR0036
DuplicateOrganizationName ERR0037
InvalidTimezone ERR0038
MissingTimezone ERR0039
TemplateHasNoDocuments ERR0040
MissingDisposableConfiguration ERR0041
EnvelopeActionNotAllowedForRecipient ERR0042

eSAW Errors from SIGNificant Server Platform (Workstep Controller)

Errors starting with “ERROR-” are returned from the SIGNificant Server Platform (to be exact the Workstep Controller component), which is handling the workstep and the workstep configuration. If you get this error, the mistake happend in the workstep configuration.

Workstep Controller Error Error Code
WscWorkstepDoesNotExist ERROR-12461
WscDocMissing ERROR-12462
WscSaveDocNotAllowedByPolicy ERROR-12463
WscPrepareSignNotAllowedByPolicy ERROR-12465
WscAddPrepareSigFieldNotAllowedByPolicy ERROR-12466
WscInvalidSignatureConfigProvided ERROR-12467
WscSigningNotAllowedByPolicy ERROR-12468
WscAddSigFieldNotAllowedByPolicy ERROR-12469
WscFinishWorkstepNotAllowedByPolicy ERROR-12470
WscActionNotAllowed ERROR-12471
WscFinalizeSignatureNotPossible ERROR-12472
WscSigningNotPossible ERROR-12473
WscSigFieldNotConfiguredForWorkstep ERROR-12474
WscSigFieldWithIdMissing ERROR-12477
WscRejectNotAllowedByPolicy ERROR-12478
WscMissingXmlContent ERROR-12479
WscDocumentIdEmpty ERROR-12480
WscDocumentMissing ERROR-12481
WscUndoNotPossible ERROR-12482
WscWorkstepAlreadyFinished ERROR-12483
WscInvalidConfigurationProvided ERROR-12484
WscPageMissingForSignature ERROR-12485
WscSignaturePositionOutsideOfPage ERROR-12486
WscSigFieldTaskDisabled ERROR-12487
WscRequiredParameterNotSetForSignature ERROR-12488
WscParameterMustNotBePresent ERROR-12594
WscSignaturePropertyNotSet ERROR-12597
WscPositionDoesNotFitConfiguration ERROR-12598
WscAddFreeHandAnnotationNotAllowedByPolicy ERROR-12600
WscAddTypewriterAnnotationNotAllowedByPolicy ERROR-12601
WscBiometricDataMissing ERROR-12871
WscInvalidSigTypeForFieldWithBioAuthentication ERROR-12872
WscCertificateIsExpired ERROR-13344
WscWorkstepIdIsEmpty ERROR-13404
WscFormFieldDoesNotExist ERROR-13411
WscRequiredReadonlyFormFieldNotAllowed ERROR-13414
WscFormsGroupNotConfigedInWorkstep ERROR-13415
WscFormFieldNotDefinedInGroup ERROR-13417
WscRadioButtonNotDefinedInGroup ERROR-13418
WscItemNotContained ERROR-13539
WscRadioButtonPropertiesNotEqual ERROR-13540
WscArgumentNull ERROR-13542
WscFileTypeNotSupported ERROR-13543
WscInvalidDocCompareResult ERROR-13544
WscDocTypeNotAccepted ERROR-13545
WscDocUnknown ERROR-13546
WscAddAttachmentsNotInGivenConfiguration ERROR-13547
WscInvalidPasswordProvided ERROR-13549
WscConfirmReadNotAllowedByPolicy ERROR-13550
WscPageOfReadingTaskMissing ERROR-13551
WscReadingTaskPositionOutsideOfPage ERROR-13552
WscSignatureWithIdAlreadyExisting ERROR-13599
WscDuplicateTaskId ERROR-13601
WscSignaturePluginConfigMultipleDefined ERROR-13602
WscMissingSignaturePluginConfiguration ERROR-13603
WscSignatureFieldSpecIdUndefined ERROR-13604
WscFileIdIsEmpty ERROR-13606
WscAppendAdHocAttachmentNotAllowedByPolicy ERROR-13609
WscCouldNotRestoreOriginalWscConfig ERROR-13629
WscAddPrepareStampingFieldNotAllowedByPolicy ERROR-13647
WscInvalidPositioningForLocalCertificate ERROR-13648
WscNoCapturingMethodForLocalCertificateAllowed ERROR-13649
WscReferencedPageIsMissing ERROR-14000
WscPositionOutsideOfPage ERROR-14010
WscNonExistingDocRefNumberSpecified ERROR-14020
WscOnlyOneDocRefNumberAllowedForAction ERROR-14021
WscImageResolutionTooLow ERROR-14030
WscImageResolutionTooHigh ERROR-14031
WscImageColorDepthInvalid ERROR-14032
WscAuthenticationNeeded ERROR-14100
WscInvalidProviderSpecified ERROR-14102
WscProviderConfigurationError ERROR-14103
WscTransactionInformationNeededForAuthentication ERROR-14105
WscAuthenticationProviderClientError ERROR-14107
WscPrepareAuthenticationMissingNecessaryData ERROR-14109
WscPrepareAuthenticationHashAlgorithmNotSupported ERROR-14110
WscPreparedDataNotAvailable ERROR-14111
WscPrepareAuthenticationHashAlgorithmNotDefined ERROR-14112
WscPrepareAuthenticationCertificateNotDefined ERROR-14113
WscSignatureDoesNotMatchCertificate ERROR-14114
WscPreparedDataExpired ERROR-14115
WscRequestPrepareAuthenticationInformationMissingNecessaryData ERROR-14116
WscPrepareAuthenticationInvalidData ERROR-14117
WscAuditTrailNotEnabled ERROR-14200
WscAddPictureAnnotationNotAllowedByPolicy ERROR-17000
WscInplausibleWorkstepConfiguration ERROR-17001
WscPdfFormsGroupNotInSameDocument ERROR-17100
WscWorkstepNotAccessible ERROR-18000
WscRequiredTaskDoesNotContainRequiredFields ERROR-20003
WscPictureAnnotationTaskDefinitionAlreadyExists ERROR-20687
WscDuplicateSigId ERROR-24200
WscEnablePolicyAndValidityChecksError ERROR-25856
WscPredefinedTypewriterAnnotationConfigurationDefinitionAlreadyExists ERROR-28280
WscTransactionCodeConfigurationIncomplete ERROR-28731
WscTransactionCodeConfigurationMissing ERROR-28732
WscTransactionCodeMissingInformation ERROR-28733
WscReferencedTaskHasInvalidType ERROR-34971
WscServerVersionIsWrong ERROR-35238
WscAppendingFileToWorkstepNotAllowed ERROR-51145
WscDifferentDocRefNumberDefinedInTaskAndTaskConfiguration ERROR-53163
WscSigFieldDefinitionAlreadyExists ERROR-60854
WscReferencedFontSettingsDefinitionAlreadyExists ERROR-67106
WscAppendingTasksToWorkstepNotAllowed ERROR-75653
WscColorizePdfFormsNotAllowed ERROR-75654
WscTaskSequenceViolated ERROR-75655
WscAppendingCompletedTasksToWorkstepNotAllowed ERROR-75656
WscReferencedTaskIsMissing ERROR-84655
WscCertificateIsRevoked ERROR-90568
WscFormsGroupDefinitionAlreadyExists ERROR-90720
WscDocumentCannotBeDisabled ERROR-91536
WscDocumentCannotBeEnabled ERROR-95109
WscReadingTaskDefinitionAlreadyExists ERROR-99368

Customization Error Codes

Errors codes of the customization interface.

Name Error Code
General ERR0001
CustomizationFileFormatError ERR0002
VariableError ERR0003
MissingFileError ERR0004