NAV Online Invoice Connection
This guide will help you set up the connection between DIOXO and the NAV Online Invoice system to automatically synchronize incoming invoices.
Prerequisites
- Active NAV Online Invoice access
- Primary user permissions in the NAV system
- Access to the NAV User Management application
Settings in the NAV System
STEP 1: Sign In
Sign in to the NAV Online Invoice website with your primary user credentials.
STEP 2: Open Users Menu
Select the “Users” menu item from the top menu bar.
STEP 3: Open User Management
Click on the “User Management” link (NAV User Management application).
STEP 4: Start New Technical User Creation
Click the “New User” button.
STEP 5: User Type
Select the “Technical User” type.
STEP 6: Password + Permissions
Set a password, then configure the permissions.
Remember this password, as you will need it in the final step of the connection!
Check the following boxes:
- “Invoice Management”
- “Invoice Query”
- “OPG Log Query”
- “Own Invoice Query” (recommended, not required)
Then click the “Save” button!
STEP 7: Key Generation (XML)
On the displayed page, click the “Key Generation” button! This will create the XML signing and exchange keys.
STEP 8: Copy Data
Copy the username, XML signing key, and XML exchange key. You will paste these into DIOXO in the next section.
Settings in DIOXO
Opening NAV OSA Settings
- Open the DIOXO system and navigate to the Settings menu item.
- Find and open the NAV OSA Settings document among the settings.
- If no entry has been created yet, create a new one by clicking the “New” button.
General Settings
The fields in the “General” group:
Automatic Synchronization of Incoming Invoices: Enable this feature if you want the system to automatically synchronize invoices from NAV.Synchronize Incoming Invoices From Date: Here you can specify from which date the synchronization should start. This date will be the starting point for the first full synchronization.
The starting date for initial and manual full synchronization. While automatic updates start from the last synchronized invoice, full synchronization reloads data starting from this date.
Entering Technical Data
In the “Technical Data” group, you need to enter the information copied from the NAV system:
-
Taxpayer ID (Registration Number): Enter your company’s tax number. -
Technical Username: Paste the technical user’s username from the NAV system (which you saw in step 8). -
Technical User Password: Enter the technical user’s password (which you set in step 6). The system will automatically create a SHA-512 hash from it. -
XML Signing Key: Paste the XML signing key from the NAV system (which you saw in step 8). -
XML Exchange Key: Paste the XML exchange key from the NAV system (which you saw in step 8).
Check that the XML keys have been copied correctly (no spaces or line breaks)!
Connection Verification
After entering the settings, the system automatically verifies the NAV connection. A status indicator at the top of the form shows the connection status:
- Connecting..: The system is checking the connection
- Connection Active: Successful connection, ready for synchronization
- Connection Error: An error occurred while establishing the connection - check the entered data
- No Connection: Required data is missing
Starting Invoice Synchronization
If the connection is active (green “Connection Active” indicator):
- If
Automatic Synchronization of Incoming Invoicesis enabled, the system will automatically fetch and process incoming invoices, no manual start is required. - Regardless, you can also start a manual (full) synchronization at any time.
Starting manual synchronization:
- Click the “Start Invoice Synchronization” button on the right side of the form.
- Read the warnings in the dialog box that appears.
- Click the “Start Synchronization” button.
- During the process, the system will:
- Query the invoice list from the NAV system
- Process the invoices and create incoming invoices
Synchronization can take several minutes depending on the period to be synchronized. Do not close the window during the process!
Troubleshooting
Connection Error
- Check that you have filled in all fields correctly.
- Make sure that the technical user in the NAV system is active and has the necessary permissions.
- Check that the XML keys have been copied correctly (no spaces or line breaks).
- Try checking the connection again after saving the settings.
Synchronization Error
If an error occurs during synchronization:
- Check the connection status (green “Connection Active” indicator).
- Make sure there are no pending changes on the form.
- Try again later, or contact support.
Summary
After successfully setting up the NAV Online Invoice connection:
- You can automatically synchronize incoming invoices (if you enabled automatic synchronization)
- You can also manually start invoice synchronization at any time
- New invoices will automatically appear in the Incoming Invoices list