Xero API Setup

Updated 3 months ago by Tim

Invoices, Payments, and Purchase Orders can be exported from HirePOS to Xero.  Each record is transferred to Xero just as though you had entered these records directly into Xero.  All invoice item lines are exported to Xero and the Account Code is exported based on the Account Code set up against the Item Category or Item Type in HirePOS.  Payments created in Xero can also be transferred back and applied against the relevant invoices in HirePOS, which are typically direct bank transfer payments created from bank feeds.  Note that bank feeds are also available in HirePOS if you prefer to receive all payments in HirePOS and then post or journal them into Xero.  

Please Note
The Xero Exporter (like most time saving tools) is not 100% automated. You need to select the records you need to move (in bulk, if desired) and tell HirePOS to export them. This prevents any half done, or poorly compiled records in one application inadvertently ending up in the other application.

Firstly, go to Setup > Preferences > Accounting Integration & Other API's > Accounting Integration, and change the Accounting Software option to Xero.

Set up an application in Xero to get the Consumer Key/Secret Key:

  1. Open a web browser tab and navigate to https://developer.xero.com/myapps/
    You will be prompted to login if you are not already logged into Xero.
  2. Click the 'New app' button located at the top right of the Xero Developer page.
  3. In App name enter the application name as described in Setup > Preferences > Accounting/API's in HirePOS. Normally in the format of HirePOS (<your business name>).
  4. In Company or application URL box enter https://www.hirepos.com.au
  5. Leave the Privacy policy URL (optional) field empty.
  6. In OAuth 2.0 redirect URI enter https://hirepos-xero2.azurewebsites.net/Members/XeroAuthorize
    Double Check
    A significant portion of issues that users encounter in these steps are from not completely copying certain bits of data (like the 'e' on the end of 'XeroAuthorize' for example). Be very sure to double check your work!
  7. Tick the Terms & Conditions box.
  8. Click the Create app button.
  9. Copy the "Client id" value and paste into the "Client id" box back in the HirePOS preferences page.
  10. Click the "Generate secret" button.
  11. Copy the "Client secret" value and paste into the "Client secret" box back in HirePOS preferences page.
  12. Press Save Changes.
  13. Navigate back to the Home Screen of HirePOS (by clicking the HirePOS logo on the top left of the screen)
  14. There will now be a Xero button available for use on the left hand side of the HirePOS homescreen.

Connect HirePOS to Xero

Click the Xero button on the main menu in HirePOS.  This opens a Connect to Xero popup screen.  Click Connect, which will open a web browser window and ask you to log into Xero if you haven’t already done so.  You will then see a page asking if you want to allow the app to connect to Xero for 30 minutes. Click Allow and the final web page will confirm that you are authorised.  You will then be redirected the HirePOS v5 Web app.

Match HirePOS Account Codes with Xero Account Codes

  1. Go to Setup > Item Related > Item Types and enter the corresponding Xero Chart of Accounts code for each of the Item Types listed.  These will normally relate to a "Revenue" account.  You can manually enter the code in the Xero Account column or click the Xero button to the right to select from a list of Xero accounts directly from your Xero data.
  2. Click Save Changes when completed.
The process above can be applied to Setup > Item Related > Item Categories 
Or Setup > Invoice Categories.
HirePOS will use the codes in this order: 1. Invoice category > 2. Item Category > 3. Item Type

Match HirePOS Tax Codes with Xero Tax Rates

  1. In Xero, go to Accounting > Advanced > Tax rates.
    Check the equivalent tax in Xero and take note of the Name column.
  2. In HirePOS, go to Setup > Tax Codes.
  3. Click a tax code to edit.
  4. In the Xero Tax (Income) field enter the Xero Tax Name, e.g. GST on Income

How to export to Xero

  1. Click the "Xero" button on the main screen.  This will open a second tab in your browser.
  2. If you are not already signed into Xero you will be taken to the Xero login page to sign in.
  3. After signing in, ensure you have the correct company file selected if you have multiple companies, then click the 'Allow access for 30 minutes' button.
  4. There are 3 separate tabs for each export, i.e. Invoices, Payments, and Orders.
  5. Check off the records you wish to sync over, or select all, and then click the Export button.
     

Did this help?

Powered by HelpDocs (opens in a new tab)