ERD / Object Structure
Breadwinner is designed to be enhanced by developers. We provide Xero Data in native and custom Salesforce objects. You can further add formulas, Apex roll-ups, workflows, and triggers.
Breadwinner consists of four objects that are exposed in a Read-Only manner, and Breadwinner also allows for the editing and creation of records in Xero through Guided Wizards that enforce financial controls.
The four objects are:
- Invoice (which is a perfect copy/slave record of the Xero Invoice object, and also includes Credit Notes, and optionally Bills and Purchase Orders)
- Xero Contact (which is a perfect copy/slave record of the Xero Contact object, and includes Xero Customers and Xero Vendors)
- Line Items (a master-detail record under the Invoice, reflecting Xero Line Items)
- Payments (a master-detail record under the Invoice, reflecting Xero Payments)
For security reasons, the above objects are stored as Read-Only data, that is updated from Xero four times an hour. So any changes made in Xero will be reflected in Salesforce within approximately 15 minutes.
Creating or editing records in Xero is possible through our guided Invoice creation process, which can pull data from any object or object/child object structure.
Many Salesforce consultants ask if they can edit the data in Salesforce and have that reflected back to Xero. Yes, you can do that using Breadwinner's Global API but it isn't supported with standard Guided Wizard.
Breadwinner can also transparently and instantly create Xero Inventory Items at the moment of Invoice creation, however, Xero Inventory is rarely used by end customers.
If you need to bring Xero Inventory Items into Salesforce as Opportunity Products, you can do so as a one-time operation from the Breadwinner tab. Once Inventory is imported as Opportunity Products, we strongly recommend using Opportunity Products as your master data set, rather than Xero. This is because Opportunity Products have a more sophisticated structure in Salesforce, and also because we can create (if needed) Xero Inventory Items transparently at the time of Invoice creation.