To get the initial integration going, check out this article.
Xero and Clients.
Importing your Clients from Xero is optional, and is done through the Import Clients tab below the Integration one in Company Account.
Client syncing (linking data directly) between Xero & GeoOp is not done automatically. However, any future Client Imports from Xero will update existing data rather than create duplicate Clients. When a Client is created via a Xero Import, it is given a unique identifier that is not visible or editable in GeoOp. This will allow Xero to update existing GeoOp Client records with new Xero information.
- Clients that are added in GeoOp but not in Xero are added into Xero automatically when you 'push' an invoice into Xero.
- During the Import process, you have the option to exclude Suppliers or not.
- Xero matches customer information based on the Company Name, so if you have multiple Clients in GeoOp with the same Company Name, Xero will randomly choose one to match with.
- GeoOp only adds the Primary Person and doesn't recognise any other People added to the contact.
Xero and Tax Rates
Xero's Chart of Accounts codes are added into GeoOp automatically during the Integration process. The codes are added into the Tax Rates tab under Company Account, however you will still need to set the default codes to be used in GeoOp. For further information see Managing Tax Rates.
- If a tax rate is set as a payment in Xero, it will display under the default Payments tax rate, but not under Charges or Parts.
- For bank accounts (Chart of Accounts), we only pick up accounts which have a code given.
- In order to keep the invoiced jobs separate and recognizable, not all customization options are applied when invoicing "by Client"
You can also import your items lists from Xero to GeoOp. This is done at (A)Settings > (B)Parts. Click the (C)Sync Parts button to begin. As with Clients, the data is not linked directly and you will have to periodically click this link to refresh the Parts data.
Please note that it is currently not possible to filter the parts to import from Xero by status. All parts will be imported regardless of their status in Xero.
When the Xero parts integration is active, every search for parts via mobile are directed to the Xero API since it is not yet possible to provide an active sync. This may take more than a few seconds depending on how many parts you have in Xero, but is necessary to ensure the data read is up to date.
The description needs to be entered in the Sales Description of the inventory item in Xero for it to come over into GeoOp.
Xero next steps: Invoicing
When your Integration is enabled, from GeoOp's Invoicing screen you will see a Send to Xero button at the top-right of your items list. Below this you also will have an additional tick box for 'Approve Invoices'. This will define if your invoices are to go to Xero as 'Draft' or 'Approved':
Draft: These will go to Xero marked as Draft and added to the Draft Invoices tab in Xero. These will then have to be approved in Xero. A PDF copy of the invoice will be returned (marked as Draft) to GeoOp for reference.
Approved: These will be added to the Approved Invoices tab in Xero.
- You can change the terminology of a 'Draft' invoice to whatever you want. Please see the latest Xero support documents for how to information.
- Important Note: Invoices going from GeoOp to Xero will only add an address to the Xero invoice if it is in the Postal Address fields in GeoOp. Ensure you have these fields completed if you wish to show an address on your invoices.
For invoicing to Xero, you also have a range of options for displaying Job data (eg Job Address & Date) as line items on your Xero invoice. If you choose, you can also use Xero invoice numbering instead of GeoOp Job Reference numbering. This is particularly relevant for European invoicing that may require management of fully sequential invoice numbering. Go to Settings > Company Account > Document Manager to view all currently available options.
For further information please see our article on Invoicing.
GeoOp forwards the Job Reference and Order Number to Xero. These are displayed under the Invoice Number and Invoice Reference fields, respectively.
For further reading on reference fields please read the article on Field Mapping.