Scanner Integration with Adempiere

Problem Statement

While using ADempiere many times we come across a need to scan a document or image and upload that scanned document into one of ADempiere standard window as an attachment. Right now, It is two step process where you need to manually scan the entity and store it in your system and them upload that document as attachment

Scope of Article :

This article demonstrates automation of scanning and uploading of documents in ADempiere in one step. It demonstrates seamless integration of scanner device with ADempiere attachment functionality.

Technology :

1. ADempiere 343 onwards
2. Jfreesane.jar ( Version 0.8)
3. guava.jar ( Version r09)
4. Sane Daemon (SANE Server)

Prerequisites :

Sane daemon must be installed in machine where scanner is attached, it can be server machine or any machine in the server LAN. Steps install SANE daemon is not covered in this document, but you can find detailed steps at

Implementation Detail :

Step 1: Create system configuration variables to allow user to configure machine on which scanner is connected and device name

Step 2: Enhance attachment popup window to show additional button for scanning

Step 3: Enhance attachment functionality to store the scanned image as attachment in database or file system

Once all the steps are completed, you can see the scan of image in live.

Steps for Scan :

Step 1: Log into application with any role you would like

Step 2: Open any standard ADempiere window and select an existing record or create a new record if no record is available and click on attachment button

Step 3: See the attachment popup, it has one more button, with scanner image

Step 4: Click on Scanner Button..

Step 5: It prompts user for confirmation, then click on ok button

Step 6: Now scanning is completed, you can see the scanned image rendered in attachment popup window

Step 7 : Click on ‘Ok’ button to store the scanned image on storage device


After going through this article you  must have an overall idea about what you need to do to successfully integrate Scan devices with Adempiere. I hope you found this article useful and it helps you in improving efficiency of your end users.

Walking Tree promotes Adempiere and we support the users as well as the developers to ensure that business is able to take complete advantage of Adempiere’s wonderful capability. In case you are looking for a professional assistance then do visit our website to get in touch with us.


Tagged with: , , ,
Posted in ADempiere
3 comments on “Scanner Integration with Adempiere
  1. Hans Riess says:

    great article.

    in our installation we scan documents and ocr them automatically in dms system (alfresco open source),which is connected to adempiere 370 lts.

    • Walking Tree says:

      Your effort seem to be complementing the stuff documented in this article. We will be happy if you want to share more about your experience.

      • Hans Riess says:

        i was following the recommendations from adempiere community and enhanced this with ocr process (running on linux backend as a sevice).
        Our purchase and selling processes are now supported with real documents from vendors, which are linked to adempiere.
        I can organize a telecon/teamviewer meeting in order to show the current status of this project.
        Hans (germany)

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

We Have Moved Our Blog!

We have moved our blog to our company site. Check out for all latest blogs.

Sencha Select Partner Sencha Training Partner
Xamarin Authorized Partner
Recent Publication
%d bloggers like this: