📄Document handling
Last updated
Last updated
If you want to specify locatation of graphical representation of signature you have to set graphicalRepresentationType to CUSTOM. And specify values of top, left, page. You can see example on image below.
A single „rectangle” with a signature measures Width: 160px Height: 36px
Maximum position of A4 signature placement vertically: Max top = 807px Max left = 435px
Maximum position of A4 signature placement horizontal: Max top = 560px Max left = 682px
WARNING!! On one vertical A4 sheet you can fit 3 signatures (on one level). To center them perfectly, set the coordinates according to image below.
POST http://yourserver.com/
Successfully implementing signing process with Signius requires client to take care of document status change notifications. The url for callback notification has to be configured beforehand on the client’s account. Depending on the configuration the callback notification can be sent either after placing last signature on a document (a good time to download fully signed file), or after every signature placed on the document (when you may want to notify next signee about awaiting signature
documentId
string <uuid>
presentSignee
string <uuid>
nextSignee
string or null <uuid>
documentStatus
string
The value should be "SIGNED" or "SIGNING_IN_PROGESS"
Start document signing by defining all attributes. After the request is processed, the document becomes availble in the portal. If the automatic email sending is enabled, users are being notified about a document delegated to sign.
/services/documents/{documentId}
The id of the document.
Type of signature. Only signatures of the same type ("EASY", or "ADVANCED", or "QUALIFIED") can be stored in one folder. Adding another document of different signature type to the same folder will result in an error.
EASY
ADVANCED
, QUALIFIED
, EASY
Document name
title
Skipping account creation for EASY signature. Defaults to false
false
Type of graphical representation. Defaults to LAST_PAGE. CUSTOM to set custom location.
LAST_PAGE
NONE
, LAST_PAGE
, FIRST_PAGE
, CUSTOM
A list of document signees
Retrieves an individual link to the document for defined signee. For the signing flow without registration - the link is valid for 30 days since retrieval
/services/documents/{documentId}/link
Id of the document
Id of the signee for whom the link is retrieved.
Enables downloading originally uploaded document (unless previously removed)
/services/documents/{documentId}/file
The id of the document.
Enables downloading signed document (unless previously removed). In case document was not yet signed the 404 code is returned
/services/documents/{documentId}/signed
The id of the document.
Enables to check the signing status (signed or unsigned) of all documents uploaded in one folder.
/services/documents/document-folders/{documentFolderId}
The id of the folder.
Removes document the system. By default SIGNIUS removes all data older than 30 days. Only audit logs are retained.
/services/documents/{documentId}//
The id of the document.