Skip to main content

Xero Defaults and Mappings

Control how Donorfy data is sent to Xero using defaults and detailed mapping rules.

Cristina Gruita avatar
Written by Cristina Gruita
Updated over a month ago

You must connect Donorfy to Xero before configuring Defaults and Mappings.

๐Ÿ“ŒNote: The Accounts Interface Codes set on Products, Funds, and other entities are not used by the Xero integration. They apply only to the Accounts Download feature for other accounting systems.

Open Xero Settings

To access Defaults and Mappings:

  1. Go to Settings, then click Configuration.

  2. Open Xero Settings.

From here, you can configure Defaults, Bank Accounts, and detailed Xero mappings.


Configure Default Mappings

Default mappings act as a fallback when no specific mapping exists.

  1. Open the Default Mappings tab.

  2. Select values from the dropdown lists, which are populated from your connected Xero account.

Many default settings are optional.

๐Ÿ“ŒNote: If you select an Inventory Item, you must ensure that a unit price is defined for that item in Xero.


Exclude Payment Methods

You can prevent certain transactions from ever being sent to Xero.

  1. In Excluded Payment Methods, select the payment methods to exclude.

Common examples include:

  • Pledges, where no bank transaction exists.

  • Grants that may already be invoiced in Xero.

This prevents duplicate or inappropriate entries in Xero.


Set the Integration Start Date

The Integration Start Date controls which transactions can be sent to Xero.

  1. Enter the Integration Start Date.

Transactions dated before this date will not be eligible for export, which helps prevent historical data being sent unintentionally.


Map Bank Accounts

If you use multiple bank accounts in Xero, you must map them correctly.

  1. Open the Bank Accounts tab.

  2. Click the plus button to add a new mapping.

  3. Select the Donorfy bank account and the corresponding Xero bank account.


Any bank accounts that do not match the default currency in Donorfy are clearly flagged.


Configure Xero Account Mappings

This is where you define specific relationships between Donorfy entities and Xero entities.

  1. Open the Xero Account Mappings tab.

  2. Click the plus button to add a mapping.

  3. Select a Donorfy entity, such as:

    • Campaign.

    • Product.

    • Fund.

    • Department.

    • Payment Method.

    • Constituent Type.

    • Area.

    • Region.

  4. Select the corresponding Xero entity, such as:

    • Revenue Account.

    • Tracking Code 1.

    • Tracking Code 2.

    • Tax Rate.

You can create as many mappings as required.

Where multiple conflicting mappings exist, the most recently added mapping takes priority.

โš ๏ธImportant:
The Xero integration is a Professional-only feature. Essential subscribers, please contact us to find out more about upgrading.


Donorfy Academy

The Donorfy Academy features a learning course for Xero - enrol here

Did this answer your question?