Connect Xero
Link your Xero organisation to Yipii yourself: who can do it, the three clicks on Xero's own page, and what to do if you picked the wrong organisation.
Settings › Integrations › Xero links your Xero organisation to Yipii, so the invoices you issue in Yipii, and the supplier invoices you record, can also go to Xero. You do it yourself, in a couple of minutes. You sign in on Xero's own page: Yipii never sees your Xero password.
Before you start
- You need to be an admin of the account in Yipii. Anyone else sees the card but can't connect it.
- You need to be able to sign in to Xero for the organisation your invoices should go to, with Adviser or Standard access. Xero doesn't let a user with less allow a connection.
- Xero comes with Yipii Mobility. If the card is tagged With Mobility and Connect to Xero is greyed out, your plan doesn't include it yet: ask Yipii to add Mobility.
Steps
Go to Settings › Integrations and open the Xero card, under Accounting.
Press Connect to Xero. Xero's own sign-in page opens.
Sign in to Xero, pick the organisation your invoices should go to, and press Allow access.
Xero sends you back to Yipii. The card now says Connected to and your organisation's name. If you allowed more than one organisation, Yipii asks which one: press Use this one beside it, and the others are disconnected.
Go to Finance › Tax rates and fill in Xero accounts: the Xero account for each kind of invoice line, and the Xero tax rate for each of your tax rates. Copy the codes from Xero's chart of accounts and tax rates. An invoice with a mapping missing is held back with the reason, never posted to a guessed account.
What happens next
The card shows Connected to your organisation, the date it was connected, and the date the link lapses if it goes unused: Xero ends a connection that nothing has used for 60 days.
From then on, every invoice you issue (send to the customer, or record as paid) goes to Xero within a minute or so:
- as an approved invoice with the same number as in Yipii, the same date and due date, and each line on the Xero account and tax rate you mapped, so the totals and VAT match to the cent;
- to the same customer: matched by name if Xero already has them, added if it doesn't.
If your Xero already has a different invoice with that number (Xero numbers its own invoices
INV-0001, INV-0002… too), Yipii doesn't send it and the invoice says so. Renumber or remove the
one in Xero, then press Send to Xero.
Drafts and proformas are never sent, and an account with nothing connected invoices exactly as before.
The invoice shows where it stands: Sent to Xero, or Not sent to Xero with the reason (a line with no Xero account, a period locked in Xero, a figure Xero refused). Fix the cause and press Send to Xero. Sending again never makes a second copy in Xero. The same button sends an invoice you issued before you connected.
Voiding an invoice in Yipii voids it in Xero too, if Yipii sent it there. An invoice that never reached Xero is left alone in Xero. If Xero already has a payment on it, Xero keeps it and the invoice says so: take the payment off in Xero, then void it there.
Payments made in Xero come back to Yipii within about fifteen minutes. When you match a bank payment to an invoice in Xero, Yipii records it against the same invoice: a part payment leaves the rest owing, and the last one marks the invoice paid, so it stops being chased. Delete a payment in Xero and Yipii reverses it, and the invoice owes again.
You can still take a payment in Yipii, say a card at the counter. When the same amount is then matched in Xero, Yipii links the two instead of counting the money twice. Payments recorded in Yipii are not sent to Xero: Xero stays your books, so reconcile them there as usual.
If Xero has a payment that doesn't fit in Yipii (more than is still owed there, or on an invoice voided in Yipii), Yipii doesn't record it and the invoice says what Xero has. Yipii keeps that payment and tries it again every 15 minutes, so once you correct the payments on one side or the other, it is recorded (or, if you removed it in Xero, let go) and the message goes away.
To correct an invoice that has been sent, raise a credit note in Xero; Yipii has no credit notes, so a credit note or overpayment allocated in Xero does not come back to Yipii.
Supplier invoices go to Xero as bills. When you record a supplier's invoice against a purchase order (the order's Supplier invoices tab), it is also sent to Xero within a minute or so, as an awaiting payment bill:
- under the supplier's own invoice number, with its date and due date, and the purchase order numbers as the reference;
- every line on your Supplier bills account, at the Xero tax rate you mapped for the rate it was bought at, so the bill's total and VAT match Yipii's to the cent;
- to the same supplier: matched by name if Xero already has them, added if it doesn't.
Map it once in Finance › Tax rates › Xero accounts › Supplier bills: the Xero account for bills, the Xero tax rate for each rate you buy at, and one for lines bought untaxed. Each bill on the order says Sent to Xero as a bill, or Not sent to Xero with the reason; fix the cause and press Send to Xero. If Xero already has a bill from that supplier under the same number for a different total, Yipii doesn't send it and says so. You pay the bill in Xero as usual.
Deleting a supplier invoice in Yipii voids its bill in Xero first. If Xero won't (a payment is already on it), the supplier invoice stays in Yipii too, with the reason: take the payment off in Xero, then delete it.
Approved expenses go to Xero as bills too. When an expense is approved, it is sent to Xero within a minute or so, as an awaiting payment bill numbered like the expense (EX-12):
- to the person who paid it, when it is marked as paid out of their own pocket, so you repay them from Xero (the supplier is named in the reference); otherwise to its supplier;
- on the Xero account you mapped for its kind (Fuel, Repairs, Insurance…), at the Xero tax rate for the rate it was recorded at, so its total and VAT match Yipii's to the cent.
Map it once in Finance › Tax rates › Xero accounts › Approved expenses: one Xero account per kind of expense. An expense of a kind with no account isn't sent; it says Not sent to Xero with the reason. Office staff see where each expense stands on the expense itself, with Send to Xero. Sending an expense back for approval, rejecting it or deleting it voids its bill in Xero first; while it is in Xero its amount, tax, date, kind and supplier can't be changed in Yipii. A job's outside costs are not sent: they are charged on to the customer, and the supplier's invoice for them is recorded as a bill.
Disconnect on the card removes the link at any time. Yipii also tells Xero to forget it.
If it doesn't work
| Symptom | Cause | Fix |
|---|---|---|
| There is no Connect to Xero button | You are not an account admin | Ask an admin to connect it |
| Connect to Xero is greyed out and the card says With Mobility | Your plan doesn't include Yipii Mobility | Ask Yipii to add Mobility to your plan |
| The card says Xero is not set up on this server yet | Xero isn't switched on for Yipii yet | Contact Yipii support |
| Xero won't let you press Allow access, or your organisation isn't in the list | Your Xero user has less than Adviser or Standard access to it | Ask whoever runs your Xero to connect, or to raise your access |
| The card names the wrong organisation | Another one was picked on Xero's page | Press Disconnect, then Connect to Xero again and pick the right one |
| An invoice says has no Xero account or has no Xero tax type | A mapping is missing in Finance › Tax rates › Xero accounts | Fill it in, then press Send to Xero on the invoice |
| A supplier invoice says Supplier bills have no Xero account | The bills account or a purchase tax rate is not mapped | Fill in Xero accounts › Supplier bills, then press Send to Xero on the bill |
| An expense says … expenses have no Xero account | That kind of expense has no account mapped | Fill in Xero accounts › Approved expenses, then press Send to Xero on the expense |
| An expense says Xero has nobody to bill | It has no supplier and isn't marked as paid out of pocket | Choose its supplier (send it back for approval first if it is approved), then Send to Xero |
| An invoice says Xero is locked up to a date | Its date is in a period closed in Xero | Unlock the period in Xero (Settings › Advanced › Lock dates), or enter it in Xero by hand |
| An invoice says Xero has a payment of … that was not recorded | Xero has more paid on it than Yipii has owing, or it is void in Yipii | Make the payments match: reverse the wrong one in Yipii, or remove it in Xero |
| The card says the connection has expired or was removed in Xero | Someone disconnected Yipii in Xero, or it went unused for 60 days | Press Connect again and allow access once more |
Related
- Connect another system: the other integrations.
- Settings: the other Settings pages.
Was this page helpful?