Contacts from Xero

Its common to hold your contacts in Xero. These contacts need to also exist in infoodle in order for you to connect transactions to people and generate receipts or report on them. As you reconcile transactions you are matching transactions to contacts. These contacts are often the same contacts as the people you have loaded into infoodle, or they could be people who have donated to your organisation.

Configuring how infoodle processes Xero contacts

In the Xero settings screen (Administration / System / Xero, or Finance / Configuration / Xero setup) you are presented with a range of options.

Build infoodle from Xero.

This instructs how you want infoodle to process any new contacts it finds during the xero import. Infoodle will always download all new contacts regardless of their settings, but you can choose how infoodle processes them:

  1. Import then manually add to infoodle. This is the default setting. It means the information imported from xero is only used on your request. You can add these contacts as a new infoodle person either manually on the reconcile contact screen (Finance / xero imports / xero contacts), or as you reconcile transactions and choose to 'create' the contact. Or
  2. Automatically add to infoodle to match xero. This means when ever a contact is found that does not already exist in infoodle, the contact will be created as a normal person contact in infoodle. This is ideal when building your database from xero information.

Infoodle honours additional settings:

Add customers: This is ticked by default. If the xero contact is a xero customer (if a contact has any AR invoices entered against them), then add them.

Add supplies: This is ticked by default. If the xero contact is a xero supplier (if a contact that has any AP invoices entered against them), then add them.

Select contact groups to import: If you use contact groups in xero, then you can click 'refresh list from xero' to pull in the list. You can then tick the groups you want infoodle to process. If you don't tick any, then infoodle assumes you don't want the contact group setting checked.

Sync xero to changes in infoodle

See this link to see how changes made in infoodle can be sync'ed back to xero

Xero contacts

This section instructs infoodle on what to do with contacts that have been updated in xero since they were imported previously to infoodle.

Updates ignored: This is the default, infoodle will not process any updates.

Manually update changes : This will note that changes are available, but flag them in the finance / xero imports / xero contacts with an 'update' button.

Automatically update infoodle : This will take the update and if the contact has been added into infoodle as regular contact, the changes will be applied. This makes xero your master database for these contacts.

When does infoodle import xero contacts?

infoodle will automatically import contacts each time it checks. If you want to process them now, you can choose to manually import them.

1. Automatic import
Each time infoodle polls xero for data, it will ask Xero for any contacts that have been added or updated since the last import.

2. Manual import
From the Finance / Xero imports / Xero contacts screen you have the ability to click 'Download contacts'. You will notice there is a date (starting from a year ago) and a page number (starting at 1). Xero supplies contacts in batches of 100 so if you have more than 100 you may have to click the download several times. Each time you click it, the page number will increase and you will import the next batch of 100 that have changed or been added since the date specified.

Reconcile Contacts Screen

Go to Finance | Xero imports | Xero Contacts. You are presented with a screen containing any contacts that have already been imported from Xero and not yet reconciled. You can keep coming back to this screen has you have time.


Each contact will provide a few options

a) If infoodle finds a direct match between the Xero contacts name and an infoodle contact - and only 1 match - infoodle presents this choice with the option to 'match'

b) If there is a direct match between the Xero contact and multiple infoodle contacts you are able to choose. Once chosen you have the option to 'match'.

c) There is no match available within infoodle.

d) If you have chosen on the Administration / System / Xero tab to 'Manually update changes' on your contacts, then you may be presented with an 'update infoodle' button. This happens when you have already reconciled the contact with infoodle, but an update has come through.

When infoodle looks for a match it checks three combinations:

- Xero Contact Firstname = infoodle Firstname and
Xero Contact Lastname = infoodle Lastname

- Xero Contact = infoodle Household/organisation name

- Xero Contact = infoodle Firstname a space and infoodle Lastname

For each of the three options that the contact could appear in, you have the chance to 'search' for the correct match if infoodle hasn't provided the correct match for you.

You can complete the match over a period of time - as you click an option, the choice you make is saved.

Correcting a reconcile

If you have made a choice in error and at a later date correct the person the xero contact is connected to, you can search for the person in infoodle, click on the blue xero contact button on their page and choose 'disconnect from xero'. You can now return to this contact reconcile screen and the contact will be listed as above.