Setup

The following instructions are for first-time authentication.

1. Go to Administration > API integration > Apps.
2. At the top right of the screen, click "Add app" and select "Xero".
3. The configured entityAn entity can be a subsidiary, division, business unit, brand, etc. of your organization. Entities can have similar or different AP processes and workflows. in Tipalti is presented. Click "Start setup" to open the Xero app and begin the authentication step.
4. On the Xero login page, enter your credentials to log in to your account.



5. Once you successfully logged in, select the organization that you want to sync with your Tipalti account and click "Allow access". This organization will sync with the default payer entity you configured in Tipalti (If there are more than one).



Once back to the Tipalti Hub, continue with the first time configuration process.

1. In the "Record type" column, to the left of each entity types you want to sync, toggle the button "On".
2. In the "Sync options", select
   1. "Sync all payees in Xero to Tipalti" checkbox to sync your payees during the initial sync.
   2. "Sync bill images" checkbox to sync the invoice image linked to a bill/ vendor credit to Xero.
   3. "Mark Tipalti payments as reconciled" checkbox to automatically sync Tipalti payments as reconciled.
   4. "Mark Tipalti fee payments as reconciled" checkbox to automatically sync Tipalti fee payments as reconciled.

   Xero limits the size of the image to 10 MB

3. Click "Next".



4.  

Map existing custom fields between Tipalti and Xero.

1. Click the "+Add field" button according to the record type to which you want to map the custom field (Bill line or Vendor credit line).

2. In the "Xero field" column, select the tracking category name in Xero from the dropdown.
3. In the "Tipalti field" column, select the corresponding custom field name in Tipalti from the dropdown.
4. Repeat the previous three steps for each custom field you want to map.

Xero only allows to configure four tracking categories and only two can be active at any time. The same tracking categories may be applied on bill lines and vendor credits.

5. To delete a row, hover over the mapping line, click on the right side of the row, and confirm the deletion.
6. When you are finished mapping fields, click "Next" to be directed to the "Accounts" screen.

Map existing GLA general ledger (GL) is used for recording transactions related to business assets, liabilities, equity, revenue and expenses. and bank accounts between Tipalti and Xero.

Default expense account

In the "Default expense accountThe general ledger (GL) account that is debited for the payment amount" field, begin typing the default expense account for bills, then select it from the populated list.

Tipalti/ Xero accounts mapping

Each Tipalti account must be mapped to the bank account from Xero of the corresponding currency. Only relevant accounts are displayed.

1. Adjacent to each Tipalti account name, begin typing the Xero account to which Tipalti payments will be synchronized, then select it from the populated list.
2. Click "Next".

Map fee bill and corresponding fee payment between Tipalti and Xero. Payer fees are synced to Xero once a day as a fee bill and payment per each currency (according to the Tipalti accounts) for the payments that were made in the previous day. Each bill line represents the fee for one payment and includes the payment reference and fee type.

SaaS/ subscription fees are synced in a similar manner on a separate bill.

Ensure that, on the "Sync preferences" page, the button besides the "Fees" field is toggled "On".

1. In the first row, from the dropdown list, select the relevant Tipalti vendor for each currency.
2. In the second row, from the dropdown list, select the expense account that you want to associate with each currency for Tipalti's transaction fees.
3. In the last row, select the expense account for Tipalti's monthly fees.
4. Click "Next".



5. On the Sync summary dialog, review the sync fields and click "Confirm".