Frequently Asked Questions

Getting Started with Kadoe Client

All existing functionality is retained in Kadoe Client, and many features have been enhanced.

Kadoe Client has been designed so that VKI users can upgrade to the new software straightforwardly. 

When you first download and install Kadoe Client, it runs in a test mode in order to facilitate integration testing.  While Kadoe Client is in test mode, you can continue to run VKI in parallel with it, even on the same computer.  When you are happy with your integration, you can cut over from VKI to Kadoe Client by switching off the test mode and restarting Kadoe Client. 

It is important to do this at the right time.  

There are full instructions under "How and when should I cut over from VKI to Kadoe Client?"

For customers upgrading from VKI to Kadoe Client, the DVLA will disable your old EDI interface, and enable your new Elise interface, according to the following schedule:

  • Before go-live: Send enquiries and receive responses over EDI using the old VKI software.  You may run Kadoe Client in test mode during this time
  • Day before go-live: Receive outstanding responses using VKI but DO NOT SEND any new enquiries
  • Go-live day, 00:01 hours: Your old EDI interface is disabled and your new Elise interface is enabled
  • Go-live day: Switch Kadoe Client out of test mode.  Kadoe Client is now live and VKI is disabled.  Send a small sample of live enquiries using Kadoe Client
  • Day after go-live: Await DVLA responses using the Elise interface.  If all is well, continue business as usual

In VKI

  1. Use VKI as normal until the day before go-live
  2. On the day before go-live, do not input or import any enquiries to VKI.  Perform a Send/Receive to retrieve any outstanding enquiries
  3. On the day of go-live, your EDI connection is no longer enabled

Switch Kadoe Client out of test mode

  1. Log in to Kadoe Client - your default login is the same as in VKI
  2. Visit the Admin Functions screen, Kadoe Client tab
  3. Change the Run in TEST mode option to NO
  4. Click OK.  You will see a dialog advising you that you are switching off Test mode.
  5. Click OK again to exit Kadoe Client

Run Kadoe Client as Administrator

  1. In Windows Explorer, navigate to the folder when Kadoe Client is installed (by default, this is C:\KADOE)
  2. Right-click on the Kadoe.exe icon, and choose "Run as Administrator".  (If you are using Windows XP, choose "Run as..." and then select an Administrator account).  There are full instructions with screenshots here.
  3. Kadoe Client will start up
  4. Kadoe Client will import all your enquiry and response data from VKI.  Kadoe Client will warn you if it finds any enquiries that have either not been sent to the DVLA, or have been sent but not responded to. You can choose to ignore this warning, but if you do, all these enquiries will be deleted.
  5. The VKI database is backed up and the VKI software is disabled.
  6. Navigate through the setup wizard as before.
  7. Kadoe Client is now live.  From now on, any enquiries you send will be communicated to the DVLA.

Your database is upgraded but not replaced, so your current enquiry, response and debit statement data is retained.  As noted above, any enquiries that do not have a corresponding response will be deleted.

Kadoe stands for Keeper at Date of Event.  It refers to the owner of a Vehicle Registration Mark (VRM), and the vehicle it was registered to, at a particular point in time.  Kadoe details are provided to you by the DVLA in Swansea.

Previous versions of this software used Electronic Data Interchange (EDI) technology to send enquiries to the DVLA and receive responses from them.  The EDI interface is no longer supported by the DVLA, and is being replaced with a web service interface.  Instead of communicating with an EDI mailbox, Kadoe Client now communicates with a remote web server.  This web server routes your enquiry to the DVLA, waits for the DVLA’s response, and then routes the response data back to you.

Whereas your organisation was previously known to the DVLA by its Party Code, it is now known by its Enquirer Id.  This Enquirer Id is a unique identifier proper to you and controlled by the DVLA.   

As well as acting on its own behalf, it is also now possible for your organisation to act as an intermediary on behalf of its partners, subcontractors or associated companies.  In such cases the DVLA will provide an additional Enquirer Id in respect of each partner company, and a single Intermediary Id that is proper to you.  Any enquiry made on behalf of a partner company will carry its Enquirer Id and your Intermediary Id.  

When an Enquirer registers with the DVLA, it will do so on the basis of one or more Reasons for Enquiry, based on the circumstances that cause it to request Kadoe details from the DVLA.  The DVLA will approve one or more Reasons for Enquiry in respect of each Enquirer, and one such reason must be provided with each Vehicle Enquiry.  

When you install and run Kadoe Client for the first time, Kadoe Client will download all of these details automatically.

As well as running standalone, Kadoe Client can now also be run on multiple computers on your network, all sharing a common database.

Multiple user support is another new feature in Kadoe Client.  You may now set up multiple users, each with their own login, password and access privileges.  Users may operate Kadoe Client on any computer on your network.

Kadoe Client now allows you to blacklist a VRM, so that you do not make repeated enquiries for Kadoe details that the DVLA cannot or will not provide.

The Kadoe Client scheduler has been improved to give you more control over when it runs.  You can set the scheduler to run at specific times or at regular intervals, and you can choose the days of the week on which it runs.  You may also set a separate scheduler for retrieving DVLA Responses and Debit Statements only.

These parameters are now managed in the background.  They can be viewed via the Transmission Log when the Send and Receive process runs.

During the Kadoe Client installation process, these parameters will be retrieved from the old VKI.ini configuration file and retained for use in a new Kadoe.ini configuration file.  However, certain parameters will now be administered from the Kadoe Client software itself, rather than from the configuration file.  

If you use Kadoe Client to import and export data in one of its automatic modes, we recommend that you choose new, unique import and export folders for each of your Enquirers. 

Possibly.  The DVLA Debit Statement period runs weekly from Friday to Thursday.   If you have an assigned go-live date in midweek, then you will not receive a Debit Statement for that portion of the week before you cut over to Kadoe Client.

If the Debit Statement is important to you, and if you believe this will cause you an issue, please contact us.

If after switching out of test mode and restarting Kadoe Client, you see an error message "File already exists. Initialise application" or "Path/file access error.  Initialise application", this is because Administrator privileges are required to complete the upgrade process. 

Follow these steps to rectify the problem.

  1. Click OK on any error messages until Kadoe Client closes.
  2. In Windows Explorer, navigate to the Kadoe Client install folder (by default this is C:\KADOE)
  3. Verify there is a file called Kadoe.MDB in this folder.  If there is, go to Step 5. 
  4. If there is not, make a copy of the file Kadoe.MDB.V3BAK (right-click on the file, click Copy, click Paste) and then rename it to Kadoe.MDB (right click on the copied file, click Rename, type Kadoe.MDB)
  5. Right-click on the Kadoe.exe icon, and choose "Run as Administrator".  (If you are using Windows XP, choose "Run as..." and then select an Administrator account). There are full instructions here.
  6. Kadoe Client should now start up correctly.
  7. If you still experience a problem, try following Steps 1-6 again.  If this fails, please contact us.

 

Yes.  Four new fields have been added to the end of each row: Date of Scrapping, Date of Export, Title and EnquirerId.  The file format is otherwise unchanged.

You are advised to determine whether or not your consumer systems need to be reconfigured in order to accept the new file format. A full description of the new export file format appears in Appendix B of the User Guide, which can be dowloaded here.

Yes.  The file format has been extended to accommodate three new data fields required by the DVLA.  These include the new EnquirerId, EnquiryCode (Reason for Enquiry) and IntermediaryId fields. 

These new fields have been added to the end of each row.  The file format is otherwise unchanged.

The old file format will still be accepted by Kadoe Client.  This is because Kadoe Client will automatically associate an enquiry with your default Enquirer (and its default Enquiry Code and IntermediaryId) if these data are not provided.

If you have multiple Enquiry Codes or more than one Enquirer, you are advised to update your back-office systems to produce files in the new format.

A full description of the new import file format appears in Appendix A of the User Guide, which can be dowloaded here.

In very occasional circumstances, an incompatibility with the Windows Aero interface can lead to Main Menu buttons temporarily disappearing from view.  This does not affect Kadoe Client program functions.

If this becomes an issue, follow the steps below to disable the Windows Aero interface.

Right-click anywhere on your Desktop and choose Personalize

Scroll down past the "Aero themes" until you see "Basic and High Contrast Themes".

Finally, click on any of these themes.  The Main Menu buttons should no longer be hidden from view.

 

To ensure that non-Administrator users have permission to run Kadoe Client, follow the steps below. 

In Windows Explorer, navigate to the installation location in Windows Explorer (by default, C:\KADOE). 

Right-click on the KADOE folder and choose Properties.

A KADOE Properties window will open

Click the Security tab

Under Group or user names, select Users

Then, under Permissions for Users, against the Full Control permission, ensure that the Allow checkbox is ticked.

 

After you install Kadoe Client, navigate to the installation location in Windows Explorer.  By default this is C:\KADOE.  Double-click on the KADOE folder to view the files within it.

Right-click on the Kadoe.exe icon, and choose Properties.

A Properties window will open for Kadoe.exe


Click on the Compatibility tab.

IMPORTANT: Ensure that the "Run this program as administrator" checkbox is ticked

You should also ensure that the "Run this program in compatibility mode" checkbox is ticked, and that "Windows XP (Service Pack 2)" is selected in the dropdown menu.

Click OK to save these settings.

You may now proceed to run Kadoe Client.

When you first install Kadoe Client, right-click the downloaded installer package kadoe.v1.setup.exe, and choose "Run as administrator".

Newer versions of the Windows operating system create a user cache of the Program Files folder in a hidden VirtualStore.  This caching behaviour can lead to enquiry files being imported more than once, incurring unwanted duplication and cost.

You are advised to accept the default location during installation, which is a folder such as C:\KADOE

To avoid compatibility issues with newer versions of Windows, you should do the following:

  • Avoid installing Kadoe Client to the Program Files folder
  • Install Kadoe Client as Administrator
  • Set Kadoe.exe to Run as Administrator, in compatibility mode for XP SP2
  • Set the permissions on the install folder to all users
  • Disable the Windows Aero interface

Please contact us to discuss your needs.

To install the software, you need the Kadoe Client installer package for Windows. You can download the installer package using your web browser. To use the software, you also need your Party ID and Party Password. When you purchase your Kadoe Client licence, we will email these details to you.

These fields are pre-populated based on your Windows setup.  It’s ok just to use the pre-populated values.  You may install this application for “Anyone who uses this computer”, as access to Kadoe Client is password-protected.

You are advised to accept the default install folder (usually C:\KADOE). You may choose a different folder if you prefer, but you are advised not to install to the Program Files folder.  This is because certain versions of Windows cache the Program Files folder in memory.  This can cause files of enquiry data to be imported more than once, incurring unwanted duplication and cost.

If you are going for a multi-machine installation, then the first computer that Kadoe Client is installed on will be designated as your local server.  All communications are routed through the local server, and all other installations share its database.

Therefore it is important that the local server computer is “visible” to all the other computers on your network, and that is always on during working hours.  You are recommended to choose a server computer on your local network.

You should install the software, and complete the one-off setup journey, on this server computer first.  Once that’s done, you can proceed to install the software on the other machines.

You need to complete a one-off setup journey.  Launch Kadoe Client from its desktop icon or via the Start menu. You will be taken step-by-step through a “wizard”-type journey.

Choose the Yes option, unless you are upgrading from Kadoe Client’s predecessor software, VKI. 

Choose Yes, unless you are performing a multi-machine install and have already completed the setup journey on your local server computer.

When you purchased your Kadoe Client licence, we emailed these details to your nominated email address. If you do not have them to hand, please contact us.

Input your Party ID and Party Password and click Next. Kadoe Client will authenticate over the internet and download your Enquirer details.

Input Party Id and Password screen

Please double-check what you entered against the details we provided. 

If you are certain you entered these details correctly, please contact us.

It’s probably a firewall issue.  Please ask your network or system administrator to permit secure HTTPS traffic to and from the kadoe.co.uk domain.  If you are certain that your firewall settings permit this traffic, please contact us.

Depending on your organisation's contract with the DVLA, you will download details for one, or more than one, Enquirer.

  • Each Enquirer has a unique Enquirer Id in the format AA999 (two letters followed by three digits).
  • Each Enquirer has at least one Reason for Enquiry such as "Mileage check - Motor Trader", which is mapped to an Enquiry Code in the format 99AA (two digits, both usually zero, followed by two letters)
  • If you have more than one Enquirer, then all Enquirers will have a common Intermediary Id in the format A99 (one letter followed by two digits)

Every enquiry you make to the DVLA will carry an Enquirer Id and an Enquiry Code, and if necessary, the Intermediary Id as well.

When you input enquiries by hand, you must choose the appropriate Enquirer Id (unless you only have a single Enquirer) and Enquiry Code (unless your Enquirer only has a single Reason for Enquiry).  Kadoe Client will populate the Intermediary Id automatically for you.

When you import enquiries from file, each enquiry row in the file should specify an Enquirer Id and Enquiry Code (and if necessary the Intermediary Id).  If these are not specified, Kadoe Client will populate them automatically, based on the Enquirer you are importing the file for, and that Enquirer's default Reason for Enquiry.

Enquirer details are provided to us by the DVLA.  If the details seem incorrect, please contact us.

During setup, Kadoe Client will invite you to choose Import and Export folders for each of your Enquirers.  Each Enquirer must have an Import and an Export folder.

You are strongly advised to use new, unique Import and Export folders for each of your Enquirers. 

1. In Windows Explorer, create new Import and Export folders for each of your Enquirers

Create new unique folders for each enquirer

2. In Kadoe Client, select a particular Enquirer

Select a particular Enquirer

3. Set the Import folder for this Enquirer

Set the import folder for this Enquirer

4. Set the Export folder for this Enquirer

Choose an export folder for this Enquirer

5. Do the same for each Enquirer, if you have more than one. 

Do the same for each Enquirer

6. Finally, click Next to proceed.  If you get a message saying “Import folder for Enquirer cannot be blank”, make sure you have chosen folders for all of your Enquirers by selecting each one in turn from the dropdown list. 

Not necessarily.  An Administrator user is created automatically for you, so you can start using Kadoe Client immediately. 

  • If you are upgrading from VKI, its Username is set to your old Party Code, and your VKI Password is retained. 
  • If you are using our software for the first time, itsUsername and Password are both set to 'Admin' by default.

You can change these details if you wish by highlighting the Administrator user and clicking Edit User. 

However, the Administrator can always add or edit user details later.

Choose Standalone if this will be the only installation of Kadoe Client on your network. Choose Server if you intend to install Kadoe Client on other machines after this one.

Yes.  It is likely that you will need Windows Administrator privileges in order to install the software.  If you don't have these privileges, you should contact a system administrator at your site.

Once Kadoe Client is installed on a machine, you should determine whether any non-Administrator users will be using it.  If they will, then you need to ensure that folder permissions are correctly set. 

Once the initial setup is done, the next thing to do is test that Kadoe Client can integrate with your back-office systems. To facilitate this integration testing, Kadoe Client is supplied to run in a test mode. Please follow the steps in the integration testing FAQ.  

If you are using our software for the first time, please follow the steps below to switch Kadoe Client out of test mode. 

However, if you are upgrading from VKI to Kadoe Client, the timing is important, and you must run Kadoe Client as AdministratorPlease see here.

Switch Kadoe Client out of test mode

  1. Log in to Kadoe Client
  2. Visit the Admin Functions screen, Kadoe Client tab
  3. Change the Run in TEST mode option to NO
  4. Click OK.  You will see a dialog advising you that you are switching off Test mode.
  5. Click OK again to exit Kadoe Client
  6. Restart Kadoe Client
  7. Navigate through the setup wizard as before
  8. Kadoe Client deletes all your test enquiry and test response data
  9. Kadoe Client is now live.  From now on, any enquiries you send will be communicated to the DVLA.

Before you do, note that AutomateImport mode is mutually exclusive with Autoexecute mode.  Ensure that you are not running in Autoexecute mode. You should also be sure that you have:

To run in AutomateImport mode, make the following setting in your Kadoe.ini file (this will be done automatically if you are upgrading from VKI):

  • AutomateImport=Yes

Ensure there is at least one import file in the appropriate import folder.

Log in to Kadoe and go to the Send & Receive screen.  Choose Scheduled connection to the service