Connecting Microsoft Excel to Xero

The Xero ODBC driver enables you to connect Microsoft Excel to Xero and work with Xero data in your spreadsheets.

The Xero ODBC driver is available to download from the Easysoft web site:

1. Download the Windows Xero ODBC driver.
2. Install and license the Xero ODBC driver on the machine where Excel is installed.

   For installation instructions, refer to the Xero ODBC driver documentation.

Now, create a Xero app, which the Xero OAuth mechanism will use to authorise and keep track of your ODBC connection. We recommend that you create a Xero app for each Xero ODBC data source that you create.

To do this:

1. Add a Xero Oauth application.
2. In the Add a new app screen, enter a meaningful name in the App name box.
3. In the OAuth 2.0 grant type section, choose Auth code Web app.
4. Enter your organisation's web site URL in the Company or application URL box.

   Save the App details to move on to the next screen.

5. In the OAuth 2.0 redirect URL box, enter:

   http://localhost:9998

6. Choose the Create app button.
7. In the App details page for the newly created app, copy the Client id. You will need this to create your data source.
8. Generate and copy a Client secret. You will need this to create your data source.

Before you can use the Xero ODBC driver to connect Excel to Xero, you need to configure an ODBC data source. An ODBC data source stores the connection details for the target database (in this case, Xero) and the ODBC driver that is required to connect to it (in this case, the Xero ODBC driver).

You can configure a user ODBC data source, which is only available to the user who creates it, or a system ODBC data source, which is available to all users on the machine. You configure ODBC data sources in ODBC Data Source Administrator, which is included with Windows.

64-bit Windows There are two versions of ODBC Data Source Administrator on this platform. (If you are not sure whether your version of Windows is 32-bit or 64-bit, follow the instructions in this Microsoft Knowledge Base article to find out.) The version of ODBC Data Source Administrator that you need to run depends on whether you have a 32-bit or a 64-bit version of Excel. To find out which version of Excel you have, start Excel, and then start Windows Task Manager. In Task Manager, choose the Processes tab. Look for Excel.exe in the list. If this process name is followed by *32, your version of Excel is 32-bit. Otherwise, your version of Excel is 64-bit.

If you have the 64-bit version of Excel, you need to run 64-bit version of ODBC Data Source Administrator. To do this, open Administrative Tools in Control Panel, and then open Data Sources (ODBC). (On Windows Server 2003 and earlier, the Control Panel applet that launches ODBC Data Source Administrator is labelled Data Sources. On Windows 8 and later, the Control Panel applet is labelled ODBC Data Sources (64-bit).)

If you have the 32-bit version of Excel, you need to run 32-bit version of ODBC Data Source Administrator. To do this, in the Windows Run dialog box, enter:

%windir%\syswow64\odbcad32.exe

32-bit Windows To run ODBC Data Source Administrator on 32-bit Windows, open Administrative Tools in Control Panel, and then open Data Sources (ODBC). (On older versions of Windows, the Control Panel applet that launches ODBC Data Source Administrator is labelled Data Sources.)

Use ODBC Data Source Administrator to create your Xero ODBC driver data source:

Do one of the following:

1. • To create a user data source, in the User DSN tab, choose Add.

   –Or–

   • To create a system data source, choose the System DSN tab, and then choose Add.
2. In the Create New Data Source dialog box, choose Easysoft ODBC-Xero driver, and then choose Finish.
3. Complete the Easysoft ODBC-Xero driver DSN Setup dialog box:

   Setting	Value
   DSN	Xero
   Organisation	The name of your Xero Organisation, for example "Demo Company (UK)".
   Client Id	The Client Id for the Xero app that you created for this data source.
   Client Secret	The Client Secret for the Xero app that you created for this data source.

4. Choose the Authenticate and obtain token button and follow the onscreen instructions.
5. Use the Test button to verify that you can successfully connect to Xero.

You can now connect Excel to Xero.

Example: How to return data from Xero to Microsoft Excel by using Microsoft Query

1. Do one of the following:
   • For Excel 2007 and later, on the Data tab, in the From Other Sources group, choose From Microsoft Query.
   • For Excel 2003 and earlier, on the Data menu, choose Import External Data, and then choose New Database Query.

   The New Database Query command uses Microsoft Query to import data. Microsoft Query is an optional feature, which by default is not installed. If you do not have Microsoft Query installed, choosing New Database Query will prompt you to install it. To do this, in Control Panel, choose Programs and Features (or Add or Remove Programs). Choose Microsoft Office (if you installed Excel as part of Office) or Microsoft Excel, and then choose Change. Follow the instructions on screen. Select Choose advanced customization of applications during the Setup wizard if this option is present for your version of Office or Excel. Microsoft Query is located under Office Tools.

   When you have installed Microsoft Query, repeat step 1.

2. In the Choose Data Source dialog box, choose your Xero ODBC driver data source from the list, and then choose OK.
3. In the Query Wizard, choose the columns that contain the data you want to retrieve, and then click Next.
4. If you want to return a subset of the data, use the Filter Data screen to filter the results of your query (this is the equivalent of a SQL WHERE clause), and then click Next.
5. If you want to change the sort order of your data, use the Sort Order screen to sort the results of your query (this is the equivalent of a SQL ORDER BY clause), and then click Next. Click Finish to return your Xero data to Excel.