/dataAccess/publishDocumentContainer/
¶
Publishes a document container. After a document container has been published, it is then available to be reviewed. A document container needs to be published in order to finish the construction phase of documents and their containers.
Request
POST {{server}}/VPE/dataAccess/publishDocumentContainer/
Content-Type: application/json
{
"DeviceId": "device-id",
"SessionId": "...",
"ContainerId": "...",
"CallbackUrl": "https://www.my-company.co.uk/web-hooks/container-event-callback/",
"ReplaceContainerId": null,
"ReplaceDocumentId": null,
"RFIDFailed": false,
"EstablishedDocumentData": { ... },
"MergeContainers": false,
"MergeTargetContainerId": null,
"WebClientRequest": true,
"WebClientIgnoreOCR": false,
"AutoReferral": true,
"LockAccess": false
}
- PublishDocumentContainerRequest.ContainerId¶
=
ContainerId
Unique identifier of the document container that is being published.
- PublishDocumentContainerRequest.CallbackUrl¶
=
CallbackUrl
Optional: The webhook callback URL to call when this application has been processed and the result is ready for download.
- PublishDocumentContainerRequest.ReplaceContainerId¶
=
ReplaceContainerId
Optional: Replace a specific document from the given document container with documents from this application.
- PublishDocumentContainerRequest.ReplaceDocumentId¶
=
ReplaceDocumentId
Optional: Replace the document with the given identifier with documents from this application.
- PublishDocumentContainerRequest.RFIDFailed¶
=
RFIDFailed
Indicate that the RFID chip was not read successfully. This property should not be set to
true
if there is no RFID chip on the document, to begin with.
- PublishDocumentContainerRequest.EstablishedDocumentData¶
=
EstablishedDocumentData
When replacing an existing document, apply the given data to the replaced document. This data may have already been established by an operator reviewing a document.
See also
EstablishedDocumentData for more information about established document data.
- PublishDocumentContainerRequest.MergeContainers¶
=
MergeContainers
Allows the documents of the published document container to be merged with an existing application that the current user has access to, based on similarities of the name and/or document number.
- PublishDocumentContainerRequest.MergeTargetContainerId¶
=
MergeTargetContainerId
Allows the documents of the published document container to be merged with the document container specified by this property.
- PublishDocumentContainerRequest.WebClientRequest¶
=
WebClientRequest
Indicates that this application was constructed through the Web API rather than a desktop client with a scanner attached to it. Therefore the processing of the document is handled differently. If the document data was simply uploaded without using a specialised document scanner device, set this property to
true
.
- PublishDocumentContainerRequest.WebClientIgnoreOCR¶
=
WebClientIgnoreOCR
If
true
any uploaded image will be ignored and optical character recognition is ignored as long as there is a machine-readable zone available.
- PublishDocumentContainerRequest.AutoReferral¶
=
AutoReferral
Indicates that this application should be automatically referred to human reviewers in the case that the application contains errors, like MRZ parsing errors for example. Automatic referral is only available if an automatic referral is enabled through the service configuration and the request is scheduled as a callback operation. The callback operation will be dispatched, once a manual reviewer has been invoked with the application, if applicable.
- PublishDocumentContainerRequest.LockAccess¶
=
LockAccess
true
if access to the published document container is automatically locked by the current user so that no other user session can change the application and any of its documents while the container is being locked.
Response
{
"Success": true,
"Message": "Operation executed successfully.",
"MergeContainers": false,
"Merged": false,
"DocumentReplaced": false,
"AutoReferred": false
}
- PublishDocumentContainerResponse.MergeContainers¶
=
MergeContainers
true
if the published document container was meant to be merged with an existing document container.
- PublishDocumentContainerResponse.Merged¶
=
Merged
true
if the published document container was merged with an existing document container.
- PublishDocumentContainerResponse.DocumentReplaced¶
=
DocumentReplaced
true
if the published document was replacing an existing document.
- PublishDocumentContainerResponse.AutoReferred¶
=
AutoReferred
true
if the application has been referred automatically.