---
title: Getting Started
slug: xero/getting-started
description: Improve data synchronization between Xero and Salesforce with Breadwinner, a powerful tool that creates tabs and objects in Salesforce to populate Xero data. Authenticate your data within Breadwinner and ensure it stays up-to-date with any changes made in
docTags: 
createdAt: 2021-10-28T11:20:50.000Z
---

Whenever you need to send data between Xero and Salesforce, Breadwinner has you covered. The approach you take will depend on your automation needs and the records you want to sync.

As the method depends on *which direction* you want the data to flow, the sections below are split between the two data flow options.

## Data Flow from Xero to Salesforce

Breadwinner, upon installation, creates a number of tabs and objects in Salesforce, which allows Breadwinner to populate Xero data to Salesforce quickly and easily. This means that seeing Xero data in Salesforce simply requires authenticating Xero from within Breadwinner. Once verified, you'll see Xero data in those tabs/objects within minutes. 

Here is a screenshot depicting the Breadwinner Xero Objects (Invoices, Xero Contacts, Line Items, and Payments), displaying some of the Invoices from Xero in Breadwinner: 

![](https://api.archbee.com/api/optimize/amOMwpmEgToJSqhaSTxXr/mRNdMQaE-aLUbit-KfoZ0_invoice-view.png "Breadwinner Invoice View")

You may note the different symbols and flag colors, which correspond to the Invoice status (e.g., red = overdue, green = paid, pencil = draft invoice, etc.)

And, here is an example of the "Xero Invoices" tab, with an individual Invoice record:

![](https://api.archbee.com/api/optimize/amOMwpmEgToJSqhaSTxXr/sjESGe2yxuBUPCaswg0AG_breadwinner-xero-invoice.png "Breadwinner for Xero Invoice")

After the initial sync with Xero, Breadwinner will ensure that data stays fresh and up-to-date. If something changes in Xero, that change is reflected within minutes back in Salesforce.

Controlling access to the Breadwinner objects can be done easily through the provided permission sets and/or Salesforce sharing rules (we recommend you install the app "Admin Only" and then use Breadwinner's permission sets to assign the appropriate permissions to your users).

Why do we take this approach? Because we consider Xero as the System of Record for accounting and so are making sure that Xero is easily reflected in Salesforce, as that’s vital to an efficient business.

## Data Flow from Salesforce to Xero

To see data flow from Salesforce to Xero, ensure that you are in "Xero Active Mode".

Active Mode:

![](https://api.archbee.com/api/optimize/amOMwpmEgToJSqhaSTxXr/3h2eWAATGGSDa6JI67SO-_active-mode.png "Breadwinner Mode Switch")

Syncing data from Salesforce to Xero will depend on your business needs and will also be based on your finance director's preferences.

Best of all, whatever you create or edit in Xero will be reflected back in Salesforce immediately via Breadwinner.

Here are the four ways you can sync data to Xero:

|                        | Used By     | Configured By                    |
| ----------------------- | ----------- | -------------------------------- |
| Guided Wizard           | Users       | Power Users, Admins, Consultants |
| Custom Guided Wizard    | Users       | Admins, Consultants              |
| -- Button URL Generator |            | Admins                           |
| Flows                   | (Automated) | Admins, Consultants              |
| Global API              | (Automated) | Developers                       |
| -- Apex Generator       |            | Developers                       |

The above chart also includes two generators, designed for admins and developers to help make their lives easier. The "Button URL Generator" creates the URL needed for the Custom Guided Wizard button. The "Apex Generator" will generate Apex for you, for either a Trigger or for use within a Flow as an invocable method.

:::hint{type="info"}
- The Global API is an additional add-on. Please reach out to the Sales team for more information.
- The Apex Generator is a tool that helps you write the necessary Apex code. You will still need to make additional changes to this code to fit your needs.


:::