Connecting Xero
Connecting Xero shows you which tracked calls turned into a quote, and makes a call worth what the customer actually paid, read from the quotes and invoices you already keep instead of a figure somebody typed into a CRM or a spreadsheet. It only ever reads: nothing is written to Xero.
Where this stands: the connection is built but has not yet been run against a real Xero organisation, so the Xero card says Partly working. Treat its first results with care, and use Check Xero (which writes nothing) before Read quotes and invoices.
Connecting
- Go to Connections, find the Xero card under Finance, and press Connect. That opens the Xero page, where everything below happens.
- Press Connect Xero. Xero asks you to sign in and to tick the organisation (or organisations) you are allowing us to read. This happens on Xero's own site.
- Back on the Xero page, choose which organisation this account reads. You are asked even when there is only one, because one Xero login often reaches several sets of books — an accountant's own, or several clients' — and reading the wrong one would put another business's sales into your figures.
- Press Check Xero. It reads the last 90 days of quotes and sales invoices, matches each one, and tells you what it would record. Nothing is saved.
- When the check looks right, press Read quotes and invoices. From then on each run picks up where the last one stopped.
A live Xero connection is included from the Pro plan. On every plan you can still import deal values from a CSV.
What we ask Xero for
Read-only access to invoices (in Xero that permission also covers quotes and credit notes) and to contacts, and permission to stay connected without you signing in every half hour. Nothing else: not your bank transactions, not your reports, not your settings, and no permission to create or change anything. Xero shows this list on the screen where you approve it.
When an invoice counts
- Once Xero marks it paid. The amount is what was actually paid: the invoice total less any credit note applied to it.
- An unpaid or part-paid invoice is shown as awaiting payment, with what has been paid so far, and is not counted yet. A deposit on a job therefore appears once the balance is paid, not before.
- Only sales invoices. Bills from your suppliers are never read as revenue, and neither are drafts.
- If an invoice we counted is later voided, or its payment is removed, the next run takes it back out of your figures. What your ad platforms are told about each is below.
- Currency is kept as invoiced. A dollar invoice is recorded in dollars and never converted; the run tells you when an invoice is in a different currency from your account.
Refunds made as a separate credit note, not applied to the invoice itself, are not read yet.
Quotes
A quote is the stage before the sale, and seeing which calls got quoted — and which quotes were won — is often the most useful thing Xero can tell you about your marketing. Each quote is matched to a call exactly as an invoice is (below), and appears on your pipeline report as a stage of that sale. Each quote and paid invoice is also listed on its own under Sales, and on the call it is linked to, behind that call's Sales button in the call log (Quotes and sales):
- Sent or accepted: open, at the quote's total.
- Invoiced: still open until the invoice is paid. Once it is, the paid invoice takes over and the quote drops out of your totals, so the sale is counted once. Xero copies the quote's reference (or its number) onto the invoice it creates, and that is how we tell they are the same sale. If you change the reference on the invoice, we show the pair to you to confirm instead; meanwhile, a quote Xero then reports as deleted or declined, for exactly the amount the same customer went on to pay, is treated as replaced by that invoice rather than lost, so the sale is not reported as both won and lost. Saying the two are different sales counts the quote as lost again. The quote stays listed under Sales, marked superseded with the invoice that replaced it, and is not counted.
- Declined, deleted, or past its expiry date while still only sent: lost. A quote the customer accepted is not lost because its date went by.
- Drafts are not read: nobody has been offered anything yet.
Quotes are never sent to your ad platforms. People ask for quotes to compare prices, and telling Google or Meta that a quote is worth its value teaches their bidding to find more people who ask for prices and buy elsewhere. Only what was paid is sent.
How a quote or invoice is matched to a call
A quote or invoice is attached to a call only when exactly one of your callers has the phone number or email address on the Xero contact, and rang one of your tracking numbers on or before the day it was raised (and within the year before it). Otherwise it stays unmatched, and the run lists it with the reason. We never attach an invoice to the nearest call, match on the contact's name, or guess from the last few digits of a number — a wrong match puts your revenue against the wrong advert, and unlike a miss you would not see it.
| What the run says | What it means | What fixes it |
|---|---|---|
| No phone or email | The Xero contact has neither | Add the customer's number to the contact in Xero |
| Number unreadable | The contact has something in the phone field we cannot read as a number | Correct it in Xero, with the area code |
| Nobody rang from it | None of your callers has that number or email | Often nothing: not every sale starts with a call |
| Only rang afterwards | They called, but only after the invoice was raised — usually to pay it | Nothing; that call did not win the work |
| Rang too long before | Their last call before the invoice was more than a year earlier | Nothing; a call that old is not evidence for this sale |
| More than one caller | Two of your callers share that number or email, such as a switchboard or a household | Give the contact a direct number or email in Xero |
| Phone and email disagree | The number points to one caller and the email to another | Check which is right on the Xero contact |
A matched invoice becomes the value of that sale in your pipeline report, credited to the marketing behind the call. The invoice itself, with its number and the call it was matched to, is under Sales.
If you also use HubSpot
The same sale is often a HubSpot deal and a Xero invoice. We do not add them together. Where the two records name each other — the invoice's Reference carries the job or order number the deal also has — the duplicate is left out of your totals and the invoice's amount is used, because it is what was actually paid. Where they only look alike (same customer, same amount, same week), the value stays in and the pipeline report shows it as in question until you say whether they are one sale or two. More on duplicates.
What your ad platforms are told
A call your ad platforms already know about is one conversion there. A paid invoice does not add another: it updates the value of the conversion that sale already has, so bidding learns what the call was really worth.
- If the invoice is linked to a HubSpot deal (they share a reference, as above), the deal's conversion is updated to the amount paid. HubSpot re-syncing its own figure does not overwrite it while the invoice stands.
- Otherwise, the call's own conversion is updated: the most recent call from that person that counted as a conversion, on or before the invoice.
- If the call never became a conversion — it was shorter than your qualifying length, say — the paid invoice starts one for that call. A deposit invoice and a balance invoice for the same call add up on that one conversion rather than counting as two sales.
- A HubSpot deal that arrives after the invoice joins the same conversion rather than starting its own, through the reference they share or through the same call, and the paid amount stands.
- If the caller already has HubSpot or imported deals and we cannot tell which one this invoice belongs to, or it only looks like one of them, it is not sent — it still counts in Proofbell. Telling a platform about the same sale twice is worse than telling it once, and confirming the pair on the pipeline report lets the next run send it.
- Voided or credited in full: Xero corrects an invoice by voiding it and raising
another, so a void is treated as a correction, not a lost sale.
- A conversion a won HubSpot or imported deal speaks for goes back to the deal's own figure — a call's conversion included.
- The call's own conversion goes back to the call's own value in Proofbell, and is never withdrawn — the call happened whatever became of the invoice. Your ad platforms keep the last value they were sent: none of them can take a conversion back to "no value" without withdrawing the call, so nothing is sent, and the conversion's history says so. When the replacement invoice is paid, its amount is sent as usual.
- A conversion we started for the call waits 14 days for a replacement, keeping its value. A replacement paid in that time updates it. If nothing has been paid by then, it is withdrawn from the platforms that allow it — whether or not anyone reads Xero again, because the process that sends to your ad platforms makes that check itself. A withdrawal cannot be undone, so a replacement paid after those 14 days still counts in Proofbell but is not sent for that call.
- A payment removed never withdraws anything, because a removed payment is usually a correction. The conversion keeps the paid value until the invoice is paid again or voided — except that a HubSpot deal's conversion goes back to the deal's own figure meanwhile, and a conversion with other paid invoices behind it carries their total.
Each ad platform connection stays in dry run — checked, never sent — until you switch it to live on its own page, and platforms that cannot correct a value they have received (Meta, GA4 and LinkedIn) keep the value they were first sent.
One read at a time. If somebody starts reading Xero while another read of the same account is still running, the second is refused with a message saying so, and nothing is read or written by it. Wait for the first to finish, then read again. Checking, which records nothing, is never blocked.
Your data
We read a quote's or invoice's number, reference, amounts, dates and status, and its contact's name, phone numbers and email address, in order to do the matching above. What we keep for a matched quote or invoice is its value, currency, dates, stage, number and reference against the caller it matched. What reaches an ad platform is the conversion's value, never the quote or invoice itself. The summary of each run keeps counts and totals only. Your customers' invoices are data you direct us to read, covered by our data processing addendum; Xero is your supplier, not ours.
Who can see it: checking or reading Xero needs permission to manage connections and to see revenue, because the answer lists each invoice's amount. Somebody who can see connections but not revenue sees the counts from the last run without the amounts. Checking or reading HubSpot needs the same two permissions, for the same reason.
Every read that records is written to your account's audit log as integration.synced, with who ran it and how many invoices, quotes and conversions it recorded, updated, held or withdrawn — counts only, never an amount or an invoice number. A HubSpot read that records is logged the same way.
Disconnecting on the Xero page deletes our access immediately and keeps the values already recorded. To remove Proofbell from your organisation on Xero's side as well, go to Xero's Connected apps settings and disconnect it there — we deliberately never change anything in your Xero, including that.