⏱️ 3 minute read
Forecast's integration with Xero provides improved financial monitoring and accessibility. Using the integration enables users to manage invoices, purchase orders and clients. In order to take advantage of the integration's capabilities, client profiles must first be linked across platforms.
This article covers:
- Importing Client Profiles from Xero
- How Forecast Matches Xero Customers to Existing Clients
- Contacts Synced from Xero
- Linking Existing Forecast Clients with Xero
- Unlinking Client Profiles
Importing Client Profiles from Xero
In order to export to Xero, invoices must contain an assigned client. With the integration, you can create new Forecast client profiles by importing your customers from Xero. Client profiles can be imported in bulk or individually. When a customer is imported, the people linked to it in Xero are also brought across as contacts on the Forecast client (see Contacts Synced from Xero).
To import client profiles from Xero
- Click Admin in the navigation ribbon.
- Select Clients from the dropdown.
- Click Import from Xero at the top right.
- Select the clients to import or use Select all.
- Click Create Clients.
- If any selected customers match existing Forecast clients in a way that needs your input, the Review matching clients window opens (see below). Otherwise, a new client profile is created for each imported customer. Profiles linked with Xero will reflect the Xero logo.
How Forecast Matches Xero Customers to Existing Clients
Before creating anything, Forecast checks for existing clients so that importing a customer you already have does not create a duplicate. It compares each selected customer’s Primary Person email (exact match) with the primary contact email of your existing Forecast clients. Only primary-to-primary emails are compared, so an Additional Person’s email never triggers a match.
| What Forecast finds | What happens |
|---|---|
| No match | A new client is created and linked. |
| One customer matches one client | The customer is linked to the existing client automatically. No duplicate is created. |
| One customer matches several clients | You choose which client to link. |
| Several customers match one client | You choose which customer to link. |
| Several customers match several clients | You see all the candidates and can confirm one or more pairs at once. |
| The only matching client is already linked to a different Xero customer |
Review matching clients
When a match needs your input, the Review matching clients window opens.
- A banner shows how many customers will be linked automatically.
- Import Clients becomes available as soon as at least one match is confirmed, whether automatically or by you. Its count shows confirmed matches only.
- Any group you don’t resolve is marked Needs review and skipped.
- If you close the window without confirming, nothing is imported for those customers. Run the import again to return to it.
A client linked through a match gets the same contact sync as a newly created one. The review window only appears for manual imports. Background Xero syncs never show it and never link ambiguous matches.
Contacts Synced from Xero
A Xero customer can have one Primary Person and any number of Additional People. All of them become contacts on the Forecast client, and the Primary Person is set as the primary contact.
| Xero field | Where it goes in Forecast |
|---|---|
| Primary Person: first name, last name, email | Primary contact: First Name, Last Name, Email |
| Additional People: first name, last name, email | Other contacts on the same client: First Name, Last Name, Email |
| Business phone number (customer level) | Primary contact: Phone Number |
Xero holds one phone number per customer rather than per person, so Additional People are created without a phone number. Job titles aren’t synced, and people who aren’t linked to the customer you’re importing are never brought in.
Keeping contacts up to date
Changes in Xero reach Forecast automatically, with no manual action. The sync only goes one way, from Xero to Forecast.
- Name or email changed in Xero: the matching Forecast contact is updated. The client is never re-matched or re-linked.
- Business phone number changed in Xero: the primary contact’s phone number is updated.
- Person added to a linked Xero customer: a new contact is created on the Forecast client.
- Person removed from a linked Xero customer: their Forecast contact is deleted, but only if it was created by this sync. Contacts you added by hand in Forecast are never deleted.
Note:
- Xero values overwrite Forecast values. When contacts sync, details from Xero replace what is in Forecast, including contact details entered by hand.
- Clients that were already linked to Xero aren’t backfilled. Their contacts come across the next time one of the changes above happens in Xero.
- Customers skipped in an import before this update aren’t retried automatically. Import them again.
Linking Existing Forecast Clients with Xero
If client profiles already exist in Forecast, you can link them to Xero manually. Manual linking is done within the Forecast client profile.
To link an existing client profile with Xero
- Click Admin in the navigation ribbon.
- Select Clients from the dropdown.
- Find the profile to link with Xero.
- Click on the profile icon or hover over the right side of the profile and click Edit to open the profile.
- Scroll down to Xero.
- Select the Xero client from the dropdown.
- Confirm the action by clicking Link.
- The client profile is now linked with Xero and displays the Xero logo to reflect.
Unlinking Client Profiles
It is possible to unlink client profiles from Xero if needed. Unlinking is done manually within an individual Forecast client profile.
To unlink a client profile from Xero
- Click Admin in the navigation ribbon.
- Select Clients from the dropdown.
- Find the client profile to unlink.
- Click on the profile icon or hover over the right side of the profile and click Edit to open the profile.
- Scroll down to Xero.
- Click Unlink.
- Confirm the warning and click Unlink.
- The client profile is now unlinked from Xero and no longer displays the Xero logo.
Comments
0 comments
Article is closed for comments.