Xero connector reference
This feature is in Beta. To use it, a workspace admin must turn on Lakeflow Connect for Xero from the Previews page. See Manage Databricks previews.
The managed Xero connector in Lakeflow Connect supports 23 source tables in the default schema. Twelve tables sync incrementally using the UpdatedDateUTC cursor field, and the other 11 tables use full refresh on every run.
Supported source tables
The Xero connector supports the following source tables, all under the default source schema:
Source table | Primary key | Description | Sync mode | Cursor field |
|---|---|---|---|---|
|
| Accounts in the chart of accounts. | Incremental |
|
|
| Spend money and receive money transactions on bank accounts. | Incremental |
|
|
| Transfers of money between bank accounts. | Full refresh only | |
|
| Branding themes applied to invoices and other documents. | Full refresh only | |
|
| Overall and tracking budgets. | Full refresh only | |
|
| Customers and suppliers, including archived contacts. | Incremental |
|
|
| Contact groups and the contacts in each group. | Full refresh only | |
|
| Credit notes for customers and suppliers. | Incremental |
|
|
| Currencies enabled for the organization. | Full refresh only | |
|
| Sales invoices and purchase bills. | Incremental |
|
|
| Products and services that the organization buys and sells. | Incremental |
|
|
| Links between billable expenses and the sales invoices they are billed to. | Full refresh only | |
|
| Manual journals. | Incremental |
|
|
| Details of the connected organization. | Full refresh only | |
|
| Overpayments made to suppliers or received from customers. | Incremental |
|
|
| Payments applied to invoices, credit notes, prepayments, and overpayments. | Incremental |
|
|
| Prepayments made to suppliers or received from customers. | Incremental |
|
|
| Purchase orders. | Incremental |
|
|
| Repeating invoice templates. | Full refresh only | |
|
| Tax rates. | Full refresh only | |
|
| Tracking categories and their options, including archived ones. | Full refresh only | |
|
| Users of the organization. | Incremental |
|
|
| Projects from Xero Projects. | Full refresh only |
Connector options
For usage, see Examples.
Option | Type | Scope | Required | Applies to | Description |
|---|---|---|---|---|---|
| String | Pipeline | Yes | All tables | The ID of the Xero organization (tenant) to ingest from. See Find the tenant ID. |
| String | Pipeline | No | All incremental tables | Earliest modification date and time to ingest, in |
Destination table schemas
accounts
Primary key: AccountID
Sync mode: Incremental
Cursor field: UpdatedDateUTC
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
bank_transactions
Primary key: BankTransactionID
Sync mode: Incremental
Cursor field: UpdatedDateUTC
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support slowly changing dimensions (SCD) type 2 because it has VARIANT columns.
bank_transfers
Primary key: BankTransferID
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
branding_themes
Primary key: BrandingThemeID
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
budgets
Primary key: BudgetID
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
contacts
Primary key: ContactID
Sync mode: Incremental
Cursor field: UpdatedDateUTC
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
contact_groups
Primary key: ContactGroupID
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
credit_notes
Primary key: CreditNoteID
Sync mode: Incremental
Cursor field: UpdatedDateUTC
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support slowly changing dimensions (SCD) type 2 because it has VARIANT columns.
currencies
Primary key: Code
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
invoices
Primary key: InvoiceID
Sync mode: Incremental
Cursor field: UpdatedDateUTC
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support slowly changing dimensions (SCD) type 2 because it has VARIANT columns.
items
Primary key: ItemID
Sync mode: Incremental
Cursor field: UpdatedDateUTC
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
linked_transactions
Primary key: LinkedTransactionID
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
manual_journals
Primary key: ManualJournalID
Sync mode: Incremental
Cursor field: UpdatedDateUTC
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
organisation
Primary key: OrganisationID
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
overpayments
Primary key: OverpaymentID
Sync mode: Incremental
Cursor field: UpdatedDateUTC
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support slowly changing dimensions (SCD) type 2 because it has VARIANT columns.
payments
Primary key: PaymentID
Sync mode: Incremental
Cursor field: UpdatedDateUTC
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support slowly changing dimensions (SCD) type 2 because it has VARIANT columns.
prepayments
Primary key: PrepaymentID
Sync mode: Incremental
Cursor field: UpdatedDateUTC
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support slowly changing dimensions (SCD) type 2 because it has VARIANT columns.
purchase_orders
Primary key: PurchaseOrderID
Sync mode: Incremental
Cursor field: UpdatedDateUTC
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support slowly changing dimensions (SCD) type 2 because it has VARIANT columns.
repeating_invoices
Primary key: RepeatingInvoiceID
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support slowly changing dimensions (SCD) type 2 because it has VARIANT columns.
tax_rates
Primary key: TaxType
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
tracking_categories
Primary key: TrackingCategoryID
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
users
Primary key: UserID
Sync mode: Incremental
Cursor field: UpdatedDateUTC
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
projects
Primary key: projectId
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Required OAuth permissions
When you sign in during connection setup, the connector requests the following read-only OAuth scopes. For what each scope grants, see OAuth 2.0 scopes.
Scope | Required for |
|---|---|
| Baseline access. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|