Hubdoc and Xero: How to Set It Up Properly and Where It Quietly Breaks

What Hubdoc Actually Is

Hubdoc is a document capture tool that Xero acquired and now bundles with its Starter, Standard and Premium business plans in Australia. You are almost certainly already paying for it.

Its job is narrow and worth stating precisely. Hubdoc takes a bill or a receipt, reads the key fields off it, and pushes a draft transaction into Xero with the original document attached. That is the whole product. It is not a categorisation engine for your bank feed, it does not reconcile anything, and it does not lodge anything.

Understanding that boundary is the difference between Hubdoc saving you two hours a month and Hubdoc creating a second pile of work you have to clean up.

Getting Documents In

There are four routes, and most businesses should use two of them.

The email-in address. When you connect Hubdoc, you get a unique address ending in @app.hubdoc.com. Forward supplier invoices to it, or better, change your billing email with recurring suppliers so their invoices arrive there directly. Telcos, software subscriptions, insurers and utilities all support this. Setting it up once removes the document from your inbox permanently.

The mobile app. Photograph a receipt at the counter. This is the one that actually changes behaviour for tradies and anyone buying materials during the day, because the alternative is a glovebox full of thermal paper that has faded to blank by the time anyone opens it.

Drag and drop upload. For the batch of PDFs you already have sitting in a folder.

Automatic fetch. Hubdoc can log in to some supplier and financial accounts and pull statements and bills down on its own. Coverage in Australia is patchy and the connections break when a supplier changes their login flow or adds multi-factor authentication. Treat any fetch connection as a convenience that might stop working, not as a control you rely on.

Configuring It So the Output Is Usable

This is the part people skip, and it is where the value is.

Set the supplier rule once per supplier. The first time a document from a given supplier comes through, tell Hubdoc which Xero account to code it to, which tax rate applies, and whether to publish it as a bill awaiting payment or as a spend money transaction already paid. Hubdoc remembers. Every subsequent document from that supplier arrives pre-coded. Ten minutes spent on your twenty most frequent suppliers does most of the work forever.

Choose the right destination type. Publish as a bill when you are invoiced now and pay later, because you want it sitting in accounts payable affecting your creditors figure. Publish as spend money when the card was charged at the till, because there is no payable to track. Getting this wrong inflates your payables and makes your cash position look worse than it is.

Decide between draft and published. Draft means a human looks before it lands in Xero. Published means it goes straight through. Start everything on draft. Move a supplier to published only once you have seen several documents extract cleanly.

Check the tax rate on every new supplier. Hubdoc reads a GST amount off the document, but Australian invoices vary enormously in layout and it does get this wrong. The cases that matter are suppliers who are not registered for GST, invoices that mix GST free and taxable lines such as a grocery order, and overseas software subscriptions where GST treatment depends on the supplier's Australian registration. Verify the first document from each supplier against the paper before you trust the pattern.

The Three Ways It Creates a Mess

Duplicates With Bank Rules

This is the big one. If Hubdoc publishes a spend money transaction for a card purchase, and you also have a Xero bank rule that creates a transaction for the same card purchase when the feed arrives, you now have the expense twice. Your profit is understated and your bank will not reconcile.

The fix is to decide, per supplier, which system owns that transaction. If Hubdoc is publishing it, delete the competing bank rule. If the bank rule is doing the job, set Hubdoc to publish the document for its attachment value only or leave it at draft and archive it after matching. Do not run both.

Documents That Never Get Reviewed

Hubdoc happily accumulates. A folder of two hundred unreviewed documents is not a record keeping system, it is a backlog with better storage. Put a recurring fifteen minute block in the calendar weekly. The volume only ever grows if you skip it.

Assuming It Codes Your Bank Feed

It does not, and this is the most common misunderstanding. Hubdoc only ever knows about transactions that have a document attached. Every bank line without a matching bill or receipt still has to be categorised, and for most businesses that is the large majority of transactions. Hubdoc solves the document problem. It does not solve the categorisation problem, which is exactly the gap SortBooks fills on top of your Xero file.

Why This Matters Beyond Tidiness

The ATO requires you to keep records supporting your claims for five years, and digital copies are acceptable provided they are a true and clear reproduction of the original. A photograph taken in Hubdoc and attached to the Xero transaction satisfies that. A faded receipt in a shoebox does not.

More practically, if you are ever reviewed, the difference between a two hour exercise and a two week one is whether the source document is attached to the transaction or sitting in a drawer somewhere. Attaching it at the moment of purchase costs nothing. Finding it eighteen months later costs a great deal.

A Ten Minute Starting Point

Connect Hubdoc from the Xero menu. Find the email-in address and update the billing email on your five largest recurring suppliers. Install the mobile app and photograph one receipt to confirm it flows through. Set supplier rules for those five. Leave everything on draft for a month.

That is the whole setup. The ongoing cost is one short review session a week, and it removes the single most tedious part of keeping a Xero file current.