The GetPaperlessDocumentLinkRequest API provides time-limited access to previously uploaded paperless documents through dynamically generated pre-signed download URLs. This endpoint serves as the document retrieval mechanism within the paperless ecosystem.
In detail:
The link is temporary, and expires after one hour
Only documents uploaded by the MOL user can be downloaded, by specifying them through the PaperlessDocumentId
If enabled at MOL user setting level by the Store, documents uploaded by other MOL users referring to the same customer may also be downloadable
Documents have a retention date on HUB, so it is possible that after 6-12 months the documents will no longer be downloadable, and then the API will return with an error
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.onlinembe.eu/ws/">
<soapenv:Header/>
<soapenv:Body>
<ws:GetPaperlessDocumentLinkRequest>
<RequestContainer>
<System></System>
<Credentials>
<Username></Username>
<Passphrase></Passphrase>
</Credentials>
<InternalReferenceID>XXXX</InternalReferenceID>
<PaperlessDocumentId>400</PaperlessDocumentId>
</RequestContainer>
</ws:GetPaperlessDocumentLinkRequest>
</soapenv:Body>
</soapenv:Envelope>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:GetPaperlessDocumentLinkRequestResponse xmlns:ns3="http://www.onlinembe.eu/ws/">
<RequestContainer>
<InternalReferenceID>fdgafg</InternalReferenceID>
<Status>OK</Status>
<PaperlessDocumentLink><![CDATA[https://...]]></PaperlessDocumentLink>
</RequestContainer>
</ns3:GetPaperlessDocumentLinkRequestResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:GetPaperlessDocumentLinkRequestResponse xmlns:ns3="http://www.onlinembe.eu/ws/">
<RequestContainer>
<InternalReferenceID>fdgafg</InternalReferenceID>
<Status>ERROR</Status>
<Errors>
<Error>
<Id>5</Id>
<ErrorCode>GPD_005</ErrorCode>
<Description>Paperless documents not found</Description>
</Error>
</Errors>
</RequestContainer>
</ns3:GetPaperlessDocumentLinkRequestResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:GetPaperlessDocumentLinkRequestResponse xmlns:ns3="http://www.onlinembe.eu/ws/">
<RequestContainer>
<InternalReferenceID>fdgafg</InternalReferenceID>
<Status>ERROR</Status>
<Errors>
<Error>
<Id>5</Id>
<ErrorCode>GPD_005</ErrorCode>
<Description>Not authorized to download the selected document. Check with your store for more information</Description>
</Error>
</Errors>
</RequestContainer>
</ns3:GetPaperlessDocumentLinkRequestResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>