Dividend Vouchers and Xero: A Complete Integration Guide (UK)

This guide explains a typical Xero -> dividend voucher workflow at a practical level. It is not legal or tax advice. Confirm compliance requirements for your company’s circumstances with an accountant. If you run your books in QuickBooks Online, read the QuickBooks integration guide instead.

Why integrate dividend vouchers with Xero?

For most UK limited companies on Xero, the dividend itself is already in the books: a payment leaves the bank and is coded to a dividends account. What is usually missing is the paperwork around it — the dividend voucher for each shareholder, the board minutes that approved the payment, and the declaration or resolution behind it.

Producing those separately, in Word or a spreadsheet, creates predictable friction:

• data gets re-keyed,
• per-share calculations can drift,
• dates and shareholder details can mismatch,
• voucher files are stored in multiple places,
• year-end documentation becomes harder to gather quickly.

An integration approach uses Xero as the source of accounting context, generates the voucher and its companion documents from the same figures, and files the PDF back against the transaction in Xero so the audit trail stays in the books.

What data you typically need from Xero

A dividend voucher workflow draws on a narrow slice of your Xero organisation:

• the organisation you connect (one Xero organisation per Dividendly company),
• your chart of accounts — the bank account the dividend is paid from and the account it is coded to,
• contacts, because each shareholder is mapped to the Xero contact the payment is made to,
• past SPEND transactions on the dividend account, if you want to back-fill vouchers for dividends already paid.

Your financial year is read from Xero, so there is nothing extra to confirm when you connect.

Which account code for dividends? Xero’s default UK chart of accounts has no dedicated dividends account, and dividends shouldn’t be coded to 960 Retained Earnings or to share capital, so you will normally need to add an equity account for dividends paid. Ask your accountant which code to use; Dividendly posts to whichever account you choose.

Registered office address comes from Companies House. Dividendly fetches your company’s registered office address directly from Companies House rather than Xero, so vouchers always reflect the official UK record on file. Xero remains the source for accounting context and contacts.

A typical end-to-end workflow (at a high level)

Here’s the common “happy path” for UK Xero users who want a repeatable voucher workflow. The step-by-step Xero walkthrough covers the same flow in shorter form.

1. Connect your Xero organisation

   • Authorise the connection on Xero’s OAuth consent screen. Dividendly asks to read and write transactions, read contacts and settings, and add attachments — the full scope list is on the security page. It does not read payroll or payments.
   • You can also sign in to Dividendly with your Xero login (Sign in with Xero) instead of a magic link.

2. Choose the bank account and dividend account

   • Pick the bank account dividends are paid from and the account they are coded to. Every posting uses this pair.

3. Map shareholders to Xero contacts

   • Match each shareholder to the existing Xero contact that represents them. Each shareholder’s shareholding and share class are kept in Dividendly, so per-share amounts are calculated from the shareholdings on file, not typed.

4. Run a dividend

   • Enter the total and the date; Dividendly allocates it across shareholders by shareholding and drafts a voucher for each. You preview the first shareholder’s documents before the run is queued.
   • For each shareholder it posts a SPEND transaction to the chosen bank and dividend account in Xero, and attaches the voucher PDF to it.
   • Board minutes and a dividend declaration (interim) or shareholder resolution (final) are generated alongside, using the defaults you set for the company.

5. Sign and send

   • Each voucher passes through an e-signature acknowledgement step, then goes to the shareholder by email. A copy stays in voucher history.

6. Keep the audit trail in the books

   • Open the SPEND transaction in Xero and the voucher PDF is there as an attachment. Nothing to file separately.

“Upcoming runs” vs “historical runs”

The workflow above is an upcoming run: Dividendly creates the Xero transaction. There is also a historical run for dividends that were paid and coded in Xero before you connected.

A historical run reads past SPEND transactions on your dividend account within a date range you choose, and drafts a voucher for each one you select — same document, same fields, no new transaction. You preview each PDF before generating. It is the quickest way to bring an existing company’s paperwork up to date. It needs a connected Xero or QuickBooks account, so it is not available in documents-only mode, and it is included on Growth, Accountant and Enterprise.

Practical integration tips (to avoid common issues)

• Code dividends consistently. Back-fill finds past dividends by account. If some were coded to the directors’ loan account or a general expense account, they will not appear until they are recoded.
• Deleting a voucher from an upcoming run voids its Xero transaction. When you delete it, the SPEND transaction Dividendly posted is voided in Xero and the voucher is removed from your records. (In QuickBooks the equivalent Purchase is permanently deleted, because QuickBooks has no void for it.) A back-filled or manual voucher has no transaction posted by Dividendly, so deleting it leaves Xero unchanged. The in-app dialog says this before you confirm.
• Check the contact mapping before the first run. A shareholder mapped to the wrong contact produces a correct voucher against the wrong payee in Xero.
• One provider per company. A company can be connected to Xero or QuickBooks, not both. Switching means disconnecting one and connecting the other.
• Use the same dates throughout. The voucher payment date should match the payment date in the minutes and the date of the SPEND transaction in Xero — it decides which tax year the dividend falls in.
• Use a documented process across clients. If you’re an accountant managing several organisations, the accountants’ guide to client dividends in Xero sets out a per-client checklist.

Where Xero fits into compliance (and where it doesn’t)

Xero records the money. It does not draft the voucher, and it does not know whether the company had distributable reserves, whether the directors met to approve the payment, or whether every shareholder in a share class was paid pro rata. Those are the questions a voucher, minutes and resolution exist to answer — and the questions HMRC or a buyer’s due-diligence team will ask.

The integration keeps the records consistent with the books. It does not replace the judgement of an accountant on whether a dividend was lawful in the first place.

Your accounting connection tokens are encrypted at rest and voucher PDFs are stored privately behind expiring links; the full scope list and tenant model are on the security page.

FAQ: Xero dividend voucher integration

Do I need to type voucher details manually?

No. Shareholders and shareholdings are kept on file in Dividendly, the registered office comes from Companies House, and the payment details come from the run you plan or the Xero transaction you back-fill. You review the PDF before it is issued.

Can I generate vouchers for past dividends?

Yes — run a historical back-fill over the date range you need. It reads past SPEND transactions on your dividend account and drafts a voucher for each one you select. Historical runs are included on Growth, Accountant and Enterprise, and need a connected Xero or QuickBooks account.

What happens in Xero when I delete a voucher?

If the voucher came from an upcoming run, the SPEND transaction Dividendly posted is voided in Xero and the voucher is removed from your records. A back-filled or manual voucher has no transaction posted by Dividendly, so only the voucher is removed. The in-app dialog warns you before you confirm, and it cannot be undone.

Does it cost more to connect Xero?

No. Xero and QuickBooks Online integrations are included on every plan, and so is documents-only mode. Plan limits are the same whichever way you work. See pricing for the plans.

How do I keep vouchers organised for accountants?

Vouchers from upcoming runs are attached to their SPEND transaction in Xero, and every voucher is kept in Dividendly’s voucher history, scoped to the company. For a practice workflow across several clients, see the accountants’ guide.

I don’t use Xero or QuickBooks. Can I still use Dividendly?

Yes. Pick Documents only at sign-up: vouchers, board minutes and resolutions are generated, e-signed and emailed without any accounting connection. You can connect Xero later without redoing anything. See dividend vouchers without accounting software.

Does this replace my accountant?

No. Integration improves operational voucher generation and record consistency. Your accountant remains responsible for tax planning, compliance interpretation, and advice for your company’s circumstances.