Skip to main content
Skip table of contents

Contactless document handling

When do you need this

When you want to increase the productivity of transport desk employees by allowing them to work undisturbed (avoid that truck drivers keep disturbing them).

When you want to increase driver comfort, by facilitating the document handling in their own language. When you want to avoid mistakes and communication struggles related to this process.

When you want to enhance process conformity, by making sure every document is digitized. No more lost documents. Automated workflows for scanned documents, resulting in less administration follow-up.


Main idea

Peripass document handling allow so

  • Store documents

  • Sign documents on upload (by transport desk)

  • Scan documents during registration

  • Sign documents during check out (by drivers)

  • Print documents during check out

  • Print documents at any desired time (using Triggers & Actions)

  • Email documents (using Triggers & Actions)


How to use

The difference between a workflow document and other attachments

Workflow documents

Organised attachments that have business logic attached.

They have a document type such as CMR or bill of lading.

There can only be one workflow document of each document type per visitor (e.g. only one CMR, one BOL, …).

Pictures

IP camera pictures
Captured by IP cameras, e.g. when entering the site.

Yard task pictures

Captured as part of a yard operations task for this visitor.

Miscellaneous

Unorganised attachments. Can be anything.

Only purpose is to save them with the visitor. No business logic, printing, scanning or signing is possible with these attachments.

Manually uploading a document

Peripass does not create documents, but documents and pictures can be attached to visitor via API or manually.

image-20241008-083125.png
image-20241008-083226.png
image-20241008-083700.png
image-20241008-084203.png

Sign on upload

When your document requires a signature on upload, this will happen automatically.

If you do not have a signature configured, you will not be allowed to upload this type of document.

image-20241008-085449.png

View summary of missing documents

In the visitor overview, you can view a summary of the workflow documents that are required for check out. Enable this column by clicking on the black button on the top right of the table and enable the column with the name “required for check out”.

image-20250116-101306.png

View documents and attachments for a single visitor

image-20241008-083446.png
image-20241008-083405.png
image-20241008-084538.png

Note: A document can have multiple versions. This is used to distinguish the original uploaded document from the signed version. Once a document is signed, it is no longer possible to modify or delete it. New uploads will be added as new versions. The status of the file always displays the latest upload.

Warning: uploading a new version of a file does not impact the status of the visitor. If the visitor needs te re-sign, this should be handled manually or using triggers & actions.

Scan a document

During registration, the visitor can be asked to scan a document. This flow has following steps:

Step

How it looks on the kiosk

Visitor is asked to fetch the right document. An example is shown to help choosing the right document.

Note: Make sure to have a clear “Example” watermark on the picture to avoid any misunderstanding.

image-20241007-142530.png

Visitor is asked to insert the document in the correct way.

image-20241007-142546.png

Scanning in progress

image-20241007-142602.png

Visitor is asked to confirm the scan. This is mainly to validate the page is not upside down.

scan.png

Optional: scan another page for the same document.

Visitor is reminded to remove the document from the scanner.

image-20241007-142630.png

Exception flow: if there is an issues with scanning the visitor will see an error message.

image-20241007-141837.png

Note: document scanning is only initiated when it is enabled on the profile AND the kiosk has scanner hardware configured. When no scanner hardware is configured, the flow will be skipped with no error message.

Inform drivers when their documents are ready

Drivers will be informed by an SMS message when they transition to the status READY FOR CHECK OUT .

To end in this status, you need to do 2 things:

Finish the yard operation

Finishing the yard operation will either transition your visitor to the WAITING FOR DOCUMENTS. If you have uploaded all required documents already, then it will immediately proceed to READY FOR CHECK OUT.

image-20241008-082949.png

Upload all required documents

Once all documents are uploaded, Peripass will automatically transition your visitor from WAITING FOR DOCUMENTS to READY FOR CHECK OUT.

See above to learn where to find the required documents of a visitor.

As long as you have not uploaded all required documents, it will also not be possible to initiate a check out process. The visitor will see this message on the kiosk:

image-20241008-092211.png

This is how the 2 statuses above will be shown on the dispatch dashboard:

image-20241008-085106.png

More on status changes: Visitor status flow.

Sign documents during check out

During check out, the visitor can be asked to sign documents. This flow has following steps:

Steps

How it looks on the kiosk

Visitor is shown a preview of the document that needs a signature.

image-20241008-092604.png

Visitor needs to provide their full name

image-20241008-093023.png

Visitor needs to add a signature

image-20241008-093301.png

The visitor needs to confirm the document including their signature.

image-20241008-093425.png

Print documents during check out

During check out, the visitor can be asked to print documents. This flow has following steps:

Steps

How it looks on the kiosk

Printing in progress

image-20241008-093448.png

Optional: Visitor is asked to confirm they received all documents. Typically used to confirm customs documents are received, to avoid issues later during the transport.

This might be important if it is very important to the driver

Warning: this step should only be used in combination with barriers, preventing the drivers to leave before accepting.

If this would be the case, the check out flow will timeout and check out won’t be completed.

image-20241008-093503.png

Note: When the visitor is checking out on a kiosk that does not have a printer configured, the printing will be skipped. If you want to limit visitors to check-out on these types of kiosks, you have to change the profiles that are enabled for check-out on that kiosk: Check out process | Limit-visitor-that-are-allowed-to-check-out-on-this-kiosk


Printing at any time (using Triggers Actions)

You can use the action “print documents” to print at any desired moment on a printer in an office or in your production / warehouse. More information:Actions


Email or SMS documents

You can use the action “Send email” or “Send SMS message” to communicate a link to the document. Use an autofill fields to add the link to your message. More information:Actions


Document storage lifetime

See: Data retention policies and storage limitations


Known limitations

  • Document generation. The required documents are created externally and uploaded; either manually or through the API.

  • Having the visitor add comments on check-out (observations and reservations) is not possible. Whenever comments are required, we assume a discussion between someone from the transport desk and the driver will be required.

  • Signing by the transport desk is restricted to the signature of the user uploading the document. It is not possible to have someone sign by the transport desk using the management portal, nor through the API.

  • It is not possible to scan documents on check out.


How to set up

  1. Create your document type: Configuration > Document types > Create

    1. There are some other features and possibilities available, like printing some documents always 2-sided (BOL) and others always 1-sided (CMR).

  2. Enable your flows on your profile: Configuration > Profiles > Edit > Document types > Add or Edit > Scan on kiosk section.

    1. There are some other features and possibilities available, like printing or scanning multiple pages.

  3. Enable the hardware on your kiosk: Configuration > Self-service kiosks > Edit > Scanning configuration or check-out configuration.

The kiosk is not directly communicating with the scanner and printer but queues this commands via the Local Action Worker. Therefore the scanner and printer should be in the same network as the Local Action Worker.

Set up sign during check out (by drivers)

You should configure where signatures are added on your document. This is configured here: Configuration > Document types > Create

Set up sign on upload (by transport desk)

You should configure where signatures are added on your document. This is configured here: Configuration > Document types > Create

To allow a user to sign on upload, you should add a signature to this user. This can be added via Configuration > Users > Edit > Extra information tab.

There exist free online tools like https://www.signwell.com/online-signature/draw/ to generate the users' signature image to upload to the user in Peripass. We advise a transparent background for the best user experience.

Note: we do not support sign on upload (by transport desk) for documents uploaded by the API. We assume in this case the 3rd party responsible for uploading the document knows who approved it and thus that systems adds the transport desk signature.

Set up Automation

Document handling is embedded in Triggers & Actions :

  • A condition can check for the existence of a specific workflow document on a visitor.

  • An action can print a specific workflow document to a known printer installed on the local server.

  • An action can email a list of attached workflow documents

  • An action can send an url that expires after 10 days


Explore more


Troubleshooting

My file does not show text on the kiosk?

This is because the pdf file does not have fonts embedded. You must embed the fonts in the PDF to ensure they print properly. You can verify whether your pdf has embedded fonts by using acrobat reader:

  • File > Document properties > Fonts

    • When a font should mentions “Embedded Subset”, it is embedded in the pdf

    • image-20240812-095621.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.