Standalone client

Unit4 Access Point standalone client enables you to download and upload PEPPOL invoices to our access point in minutes.

Prerequisites for using the standalone client:
  • An ERP system that can read/write PEPPOL invoices on file system
  • A recent Java 8 installed on the server

Table of content

Installation on Linux

  1. Download the standalone client zip file
  2. Unzip the zip file
    sudo unzip -d /opt
  3. Make symbolic link to unzipped folder
    sudo ln -s /opt/ringo-client-1.1.27 /opt/ringo-client
  4. Read the README.txt
    less /opt/ringo-client/README.txt
  5. Define CRON jobs
    sudo crontab -e
    	# Download PEPPOL invoices at 08:15 every day
        15 8 * * * /opt/ringo-client/bin/ username password path-to-inbox
        # Upload PEPPOL invoices at 16:15 every day
        15 16 * * * /opt/ringo-client/bin/ username password path-to-outbox path-to-archive EHF
  6. Configure your ERP system to import invoices from your inbox folder and export to your outbox folder.
  7. Done :)

Installation on Windows

  1. Click here to download Unit4 Access Point standalone client and click Save as. Download and click Save as
  2. Choose to download the file into a folder that you can find again later and click the Save button. Choose directory and click save
  3. Click Open folder in the browser popup line at the bottom of the browser window. Click Open folder If this browser popup line doesn't appear in your browser, open Windows File Explorer and navigate to the selected folder.
  4. Right click the downloaded file and click Extract All... Right click and click Extract All...
  5. Specify destination folder and click the Extract button. Specify destination and extract file In this example I use C:\ringo-client, but you are free to select other destination folder - but to prevent issues do not use "space" in foldernames.
  6. The extracted file contains another folder with the version number. Do not change this. Includes version number
  7. Click Start --> Control Panel --> Search Control Panel: System environment variables Control Panel edit system environment variables Click Edit the system environment variables
  8. Click Environment Variables... Click Environment Variables...
  9. Create new system variable, click the New... button. Create new system variable
  10. Define the new system variable.

    Variable name: RINGO_CLIENT
    Variable value: C:\ringo-client\ringo-client-1.0.6 Define the new system variable Click the OK button.

    Whenever you download a new version of the Unit4 Access Point standalone in the future,
    you just edit this system variable to point to the new ringo client folder.

  11. Find the Path system variable and click the Edit... button. Find path variable and edit
  12. Append ";%RINGO_CLIENT%\bin" and click the OK button. Append RINGO_CLIENT to path Click OK twice to exit System Administration.
  13. Click Start and type cmd.exe in the Search program and files search field and hit Enter on your keyboard. Start cmd.exe
  14. Download PEPPOL invoices to your server - (incoming invoices from your suppliers). Download PEPPOL invoices example If your username is, password is 123456 and the path to your inbox folder is C:\Inbox you will execute this command:
    download 123456 C:\Inbox
    All downloaded EHF invoices will now be saved in C:\Inbox and you have to configure your ERP system to import EHF invoices from this folder.
  15. Upload PEPPOL invoices from your server - (outgoing invoices to your customers) Upload PEPPOL invoices example If your username is, password is 123456, the path to your outbox folder is C:\Outbox and the path to your archive folder is C:\Outbox\Archive you will execute this command:
    upload 123456 C:\Outbox C:\Outbox\Archive EHF
    Just use EHF for channel.

    All EHF invoices that were found in your outbox folder, will be moved to the archive folder after they has been uploaded. If an error occurs during the transfer, the EHF invoice will be left in the outbox folder together with an error file describing the problem.

Task Scheduler

If you want to run upload or download automatically every night, you could use Windows Task Scheduler. How to do this varies slightly between Windows versions, take a look here for some hints on configuring Windows Task Scheduler.