Manage sign orders

• CancelOrder
• ModifySigner
• ModifySigningProcesses
• ModifyOrderDeadline
• FinalizeOrder
• DeleteDocumentData

​CancelOrder

The CancelOrder message will cancel an existing order if the sign order is in an active state. A successful CancelOrder message will update the sign order status to CancelledByMerchant.​

CancelOrder response

Back to top

ModifySigner

The ModifySigner message offers functionality to change the SignerID and the Name of a signer in an already defined sign order. One or more signers can be updated in one ModifySigner message.

Some prerequisite must be in place to use this message:

• The AcceptedPKIs element must be defined in the sign order. It is not possible to add any new eIDs by using the ModifySigner message.
• A signer’s Name and SignerID will only be changed if all sign processes related to the LocalSignerReference is either Active or Pending. The change will be rejected if a signer that shall sign more than one document already has signed at least one of the documents. 
• It will not be possible to change notifications.

Back to top

ModifySigner response

Back to top

ModifySigningProcesses

The ModifySigningProcess message offers the ability to set a sign process to the RejectedBySigner state identified by the OrderID and the SigningProcessId. A successful status modification mandates the following:

• The order status must be Active
• The SigningProcessId must be valid for this OrderID and MerchantID

Customers must keep in mind that modifying a sign process status to RejectedBySigner may cause the whole order to be RejectedBySigner. This will happen if the sign process that is being modified is labelled with TerminateOnSignerRejection = true.

Back to top

ModifySigningProcesses response

ModifyOrderDeadline

The ModifyOrderDeadline message is used to modify all sign order deadlines in both active and expired sign orders using a shift value with hours as resolution. This can be useful if the sign order has expired before all sign processes has been completed.

Back to top

ModifyOrderDeadline response

FinalizeOrder

The FinalizeOrder message offers functionality to finalize the sign order before all signers have signed the document. One signature on each document in the sign order is required before the sign order can be finalized.

Back to top

FinalizeOrder response

DeleteDocumentData

The DeleteDocumentData message offers functionality to delete documents, SDO’s, PAdES documents and signatures from the E-Signing database. Documents will only be deleted if the sign order is in a final state like Complete, Expired, RejectedBySigner, Failed, CancelledByMerchant or ExpiredByProxy. An error message will be returned if the sign order is active. A sign order can be set to a final state using the CancelOrder message. This will cancel the message and no end users will be able to sign the document(s) in the sign order.

Note: When using this message, ensure that you are either archiving your signed documents in a Nets archive or that you have fetch the signed document using for example the GetSDO message.

DeleteDocumentData response

Back to top