Hubdoc for Xero: Capture and Review 2026

Set up Hubdoc for Xero records. Capture a document, review the details and publish once to the right ledger, keeping the evidence your practice needs.

Published
Updated

Use Hubdoc for Xero to capture a supplier document, check its details against the source and publish it once to the correct client organisation.

Treat capture, accounting entry and final review as separate steps. A document arriving in Hubdoc does not prove that a transaction exists in Xero.

Confirm the Client Organisation and Access

Before importing records, identify the client’s Hubdoc organisation and the Xero organisation it must reach. Confirm who owns the account, who manages its subscription and who will review the documents.

  1. Open the client’s Hubdoc organisation. In settings, inspect the Xero connection under Integrations and compare the connected organisation name with the client file.
  2. If a connection is needed, use Xero’s documented Hubdoc connection procedure. Select the intended organisations and authorise access. One Hubdoc organisation connects to one Xero organisation.
  3. Confirm each staff member’s Hubdoc permissions. Xero roles do not automatically carry across. Give the reviewer access to the documents and give the person publishing the Publish Documents permission.
  4. Confirm the client’s subscription entitlement separately. An included Hubdoc subscription does not give every invited user permission to publish. The related Hubdoc pricing guide covers inclusion and charging structure.

Xero’s Hubdoc permissions guide distinguishes upload-only, standard and accountant/bookkeeper access. Upload-only users normally see their own uploads. Standard users can see all documents, but publishing requires the relevant permission.

If you discover the wrong connection, stop the import and have the account administrator correct it. Keep the affected documents and any existing Xero entries on the review list before reconnecting.

Capture, Check and Publish Once

Review the source image before publishing its extracted data. Leave supplier autosync off while you establish the client’s coding and review procedure.

Consider a fictional supplier invoice for office stationery. The invoice shows $220 including $20 GST, a supplier invoice number and payment due 14 days after issue. These are example bookkeeping amounts.

  1. Capture a clear image or upload the supplier’s PDF into the correct Hubdoc organisation. Emailing an attachment to that organisation’s Hubdoc address is another documented capture route.
  2. Open the document and compare the extracted supplier and invoice number with the source. Check the invoice date, due date and currency as well as the total and GST.
  3. Check for a potential duplicate. Open Show Duplicates when Hubdoc flags a match, then compare the source and existing Xero record before deciding which document to retain.
  4. Enter the account code and tax treatment that fit the purchase. For the fictional invoice, confirm that $200 before GST plus $20 GST equals $220. Resolve a missing or unclear source detail before continuing.
  5. Under Destinations, select Xero. Choose the appropriate purchase transaction and status, such as a draft for later approval. Review any line items that need different coding.
  6. Select Publish for the Xero destination. Record the document identifier so the reviewer can trace the result. Publish All sends to every connected destination, so use it only when that is intended.

Xero’s manual publishing instructions describe creating a new transaction with the source document attached. Hubdoc does not automatically extract individual line items. Enter them or use an appropriate saved supplier configuration.

Sending a Source to Xero Files

Push to Xero Files sends a copy into Xero’s file library. The presence of a file there does not establish that a bill has been created or approved.

Choose the transaction route when you need an accounting entry. The file-library route leaves the source available for a separate task in Xero. Partner edition plans restrict publishing to spend money transactions or Xero Files.

For the fictional invoice, finding the image in Xero Files is an incomplete check. Locate the purchase transaction and confirm its amount and status before treating the invoice as entered.

Verify the Ledger and Retain the Source

Open the destination transaction in the correct Xero organisation and compare it with the source. Confirm the supplier, invoice reference and amounts, then inspect the coding and transaction status.

Keep the source and review record accessible to the next staff member. Record who checked the invoice and any correction made. A published draft still needs the practice’s approval step before payment.

Diagnose a Missing or Failed Document

SymptomFirst checkCorrective action and expected result
Document missing from HubdocConfirm the organisation and the uploader’s viewing permissionsFind it under an authorised account before sending another copy
Emailed document missingInspect the destination address and actual attachmentSend the PDF or image to the correct address. Hubdoc cannot download a document from an emailed hyperlink
Extraction incompleteCompare the image with the fields Hubdoc needsObtain a readable source and correct its details before publishing
Publish failsRead the error and search Xero for the invoice referenceResolve the stated account, tax or transaction-state issue before retrying
Transaction present, attachment absentInspect the source size and document linkXero’s instructions say documents under 3MB attach, while larger documents appear as a link

Xero’s document troubleshooting guide covers failed capture and duplicate review. An archived document can already have been published through autosync, so inspect its destination before uploading it again.

For a publishing error, follow Xero’s error-specific guidance. Republishing can update the original transaction, but a paid, reconciled or otherwise changed transaction can prevent that operation. Avoid creating a replacement until the existing entry is accounted for.

If several users or organisations fail together, consult the official Xero service status. A single blurred invoice or restricted user account needs a document or permission correction, even when the service is operating.

After recovery, repeat the destination check. The invoice must appear once in the correct organisation, with the expected status and an accessible source. Escalate unresolved errors with the document identifier, organisation and error text, using the vendor’s secure support channel.

One client form. One finished return.

Your client completes one guided form. Tax Genie checks it, chases mistakes and sends the details to your engagement letter and tax software.

See how Tax Genie works

Made for Australian accounting firms

Tax GenieSee how Tax Genie works