Set up your Xero integration

Connect Smokeball to your Xero account to sync payment information to Xero automatically.

About the Xero integration

When you create a finalised invoice in Smokeball, the invoice details will flow through to Xero.

• An invoice will be automatically created in Xero.
• The invoice will be saved as ‘Awaiting Payment’ under the invoice listing.

When you receive a payment or credit or you waive your invoice in Smokeball, this will automatically apply against the corresponding invoice in Xero.

• The invoice will be displayed in the ‘Paid’ listing.
• If you need to reverse the payment against the invoice in Smokeball, this will automatically reverse the payment against the invoice in Xero and it will return to ‘Awaiting Payment’ status.
• If you waive an invoice or partially waive an invoice, this will create a credit note. The credit note will map to the code you have set for Bad Debts in your Smokeball Firm Settings.

You can also download an invoice report from the Reports section in Smokeball to assist your accountant/bookkeeper with their record-keeping in Xero.

Connect to Xero

1. In the Smokeball Web App, select the Settings icon, then select Firm Settings.
   
2. Select the Xero tab from the left menu, then select Connect to Xero.
   
3. A new tab will open in the browser that redirects you to Xero. Log in to Xero with your account credentials.
4.  Select Allow access and wait for the window to load and confirm that your connection has been successful.
   
5. Navigate back to Smokeball Xero Settings. There will now be a message notifying you that the connection is successfully established.
   
6. Go to Firm Settings and select Xero from the left menu.
7. Apply accounts to the newly available Xero mappings. 
   
8. Click Save.

If your Smokeball firm was set up prior to 16th March 2023, select Enable Invoice Integration, then select Download Invoice Report for your accountant’s records.

Frequently Asked Questions

What is the best Xero plan for integration with Smokeball?

All Xero plans are compatible with Smokeball. Choose the plan that best suits your firm’s needs.

What is the best practice for integrating Xero accounts in Smokeball?

Ensure you have mapped the relevant accounts to each account drop-down menu in Smokeball. You may need to consult your accountant or bookkeeper to make sure the correct account is selected.

• Office Payments and Client Cost Recovery Income serve distinct purposes. Office Payments represent expenses (payable to supplier), while client cost recovery income pertains to recoverable costs.
• The Bad Debts, Interest Payments’ and Surcharges accounts have default mappings for convenience. If you do not use these accounts, mapping them may not be necessary.

How do I bring across invoices that were created prior to connecting to Xero?

It is not possible to sync invoices to Xero retroactively. If there were unpaid invoices in Smokeball before connecting Xero, and those invoices are paid afterward, the payment will show up as a bank transaction in Xero.

Troubleshooting issues with the Xero integration

The first step is to make sure that the accounts are mapped correctly. If you still have issues with syncing payments, select Disconnect Xero from the bottom-right-hand corner and reconnect to Xero. 

Contact the support team if you still experience issues with syncing payments to Xero after reconnecting.