How to Set Up Dext With Xero: Supplier Rules and Auto-Publish

Coding Liquids tutorial cover featuring Sagnik Bhattacharya for How to Set Up Dext With Xero: Supplier Rules and Auto-Publish.
Coding Liquids tutorial cover featuring Sagnik Bhattacharya for How to Set Up Dext With Xero: Supplier Rules and Auto-Publish.

Set up Dext with Xero in four moves: connect it under Business settings, then Connections, so Dext pulls your accounts, tax rates, suppliers and tracking categories; write a supplier rule for each regular supplier; switch on auto-publish for one trusted supplier at a time; then check every auto-published bill in Dext's History tab and Xero once a week.

The Complete Excel Course with AI Integration

From formulas and pivot tables to Power Query, DAX, VBA and AI with Copilot, ChatGPT and Claude — hands-on from the first lesson.

By Sagnik Bhattacharya and Virginia Thorn, Primetime Emmy Award winner

Buy now

The order protects you. Auto-publish only works on documents Dext can code completely, and a published item cannot be unpublished, so rules come first, auto-publish second and only for suppliers whose bills look the same every month. Dext's own advice is to start with a small set of suppliers, check after a week and widen one supplier at a time.

How do you connect Dext to Xero?

Dext connects to Xero from Business settings, then Connections: choose Connect under Accounting software, pick Xero, sign in, allow access and select the organisation. Only Admin users can make the connection.

  1. In Dext, open Business settings in the sidebar and select Connections.
  2. Under Accounting software, click Connect, select Xero, then click Connect software.
  3. Log in to Xero and click Allow access.
  4. Select the organisation and click Finish. If the organisation appears greyed out in Xero, click Continue with [number] organisations rather than selecting it again.

Dext then pulls seven lists from Xero: the chart of accounts, suppliers, customers, tax rates, tracking categories, products and services, and payment methods. The chart of accounts appears in Dext under Business settings, then Lists, then Categories. Bank accounts and transactions come across only when you turn on Sync bank data (below).

Two sync details shape everything after this. Dext refreshes Xero data every 48 hours, so a new account code or tracking option added in Xero today may not be selectable in Dext until you reload it (Costs, Suppliers, Reload for suppliers, or Refresh integration data under the connection's Manage menu). And if your Xero organisation has more than 3,000 contacts, Dext only syncs suppliers and contacts that already have invoices in Xero. Dext's connection guide covers reconnecting if the link ever breaks.

Which integration settings should you choose on day one?

Dext's integration settings for Xero live under Business settings, then Connections, then Manage, then Settings, and four of them decide what your bills look like in Xero: destination, publish status, tax handling and bank data.

SettingOptionsSensible starting choice
Supplier listAll contacts, or Only suppliersOnly suppliers, so customers do not clutter the supplier picker
Default "publish to" destination for costsPurchases (bills), Bank Accounts (Spend Money), Classic Expense ClaimsPurchases, so every bill appears in Bills to pay with its document attached
Publish costs items to purchases asDraft, Awaiting Approval, Awaiting Payment, Paid (where possible)Awaiting Payment if you review in Dext; Awaiting Approval only if someone approves in Xero weekly
Publishing tax dataAllow Dext to decide; Allow Dext to decide with exceptions; Allow Xero to calculateDext recommends Allow Dext to decide; Allow Xero to calculate is its suggestion for businesses not registered for sales tax
Use supplier tax ratesOn or offOn only after checking each supplier's tax rate in Xero
Sync bank data and Autofill paymentOn or offOn if you want Bank Match and bank-match auto-publish

The publish status needs the most thought. Bills published as Awaiting Approval stay off Xero's Aged Payables report, which is why supplier statement balances then refuse to agree. If you want Dext to be the review step, publish as Awaiting Payment so Xero's payables are always complete. One plan-level limit: on the Xero Simple plan, Dext can only publish bills as Draft. Paid (where possible) needs the payment method linked to a Xero bank account, or Dext falls back to Awaiting Payment.

How tax rates flow from Xero into Dext

Dext does not extract tax rates; it pulls them from Xero and then sends either the tax amount it extracted from the document or a tax amount calculated from the rate on the item. A rate reaches an item in three ways: chosen by hand on the item's details page, set by a supplier rule, or applied as the default from integration settings, with rules beating the default. Turn on "Use tax list" so Xero's rates appear on item pages.

Two behaviours cause surprises. With "Use supplier tax rates" on, the supplier's tax rate from Xero overrides any tax amount Dext extracted. And with Allow Dext to decide set, if a line looks overtaxed (the category rate on the total comes out lower than the extracted tax), Dext applies the default tax rate instead. The "Xero category tax default behaviour" drop-down then chooses between always using Dext's defaults, always using the Xero category's tax code, or using Dext's defaults only when the category is "No tax". If you are unsure which suits your tax position, ask your accountant before the first publish rather than after a quarter of bills.

How do Dext supplier rules work?

Dext supplier rules are saved defaults per supplier, set under Costs, then Suppliers: category, tax rate, payment method, paid status, due date, description, currency, tracking and auto-publish, applied to each new document from that supplier.

Open a supplier from Costs, then Suppliers, or click Set Supplier Rules on an item's details page, fill in the fields and click Apply. Only Admin users can create rules; standard users cannot open the Suppliers page at all. The fields a rule can set:

  • Category (the Xero account the bill codes to)
  • Invoice due date
  • Tax rate
  • Payment method
  • Paid or unpaid status
  • Description
  • Currency (multi-currency rules work with Xero)
  • Project fields, which for Xero are your two tracking categories
  • Auto-publish
  • A workflow note, shown on the item details page for new documents from that supplier

Three rules about rules. They apply to new documents by default; to update what is already in the inbox, tick Apply to all inbox items when setting the rule from an item, or edit from the Rules page, though auto-publish and line item extraction never apply to existing inbox items. They never change what Dext extracts, such as the total, tax amount, date or invoice number. And they have a pecking order: payment method rules, user rules and auto-publish exceptions beat supplier rules for the same field, while supplier rules beat account-level defaults.

Here is a filled-in rule set for an illustrative tutoring centre with nine regular suppliers, two Xero tracking categories (Centre: North, South; Programme: Primary, Secondary) and a review-in-Dext approach:

SupplierCategoryTax ratePaymentDueTrackingAuto-publish
Room hire (church hall)RentNo taxBank transfer14 daysCentre: NorthYes, week 2
Online booking softwareSoftware subscriptionsStandardCompany cardPaidNoneYes, week 1
Video-call subscriptionSoftware subscriptionsStandardCompany cardPaidNoneYes, week 1
Printing firmPrinting and stationeryVariesBank transfer30 daysProgramme variesNo
Cleaning companyCleaningStandardBank transfer30 daysCentre: SouthYes, week 3
Electricity supplierLight and heatReduced rateDirect debitPaidCentre: SouthNo, usage bills vary
Textbook supplierTeaching materialsVaries by itemBank transfer30 daysProgramme variesNo
Supermarket (snacks, sundries)SundriesVariesCompany cardPaidNoneNo
AccountantAccountancy feesStandardBank transfer30 daysNoneNo, a few bills a year

"Varies" is the signal to keep a supplier off auto-publish. A printing firm that bills some jobs to the primary programme and some to secondary needs a person to pick the tracking category; a supermarket receipt mixes items at different tax treatments. Use the rule's workflow note for these, for example "Split by programme; check tax per line".

Rules set in Xero can overwrite Dext rules when the two sync every 48 hours. If you change a supplier's default account or tax rate in Xero, refresh the integration data in Dext and check the rule still says what you meant.

Which suppliers are safe to auto-publish?

Suppliers are safe to auto-publish when their documents always look the same and a supplier rule codes them completely: same category, tax rate, paid status and due date every time, with nothing you usually edit.

Dext's auto-publish best practices say to leave out rarely used suppliers, suppliers whose category depends on what was bought, and suppliers you often edit. Dext may also suggest candidates: suppliers whose documents you have published over the last three months without editing. A simple score makes the choice repeatable:

Test (1 point each)Booking softwareRoom hirePrinting firmElectricity
Same category every bill1101
Same tax rate every bill1101
Same tracking every bill1101
Amount predictable within 10%1100
Published 3 months with no edits1100
At least one bill a month1111
Score out of 66: auto-publish6: auto-publish1: review4: review

Only a 6 goes on auto-publish. The electricity supplier fails on amount, not coding, and that matters: a usage bill that doubles because of an estimated reading is exactly the bill a person should see before it reaches Xero.

How do you turn on auto-publish in Dext?

Dext turns on auto-publish at three levels: per supplier from Costs, then Suppliers; for all items in the Xero connection settings; and per payment method under Business settings, then Lists, then Payment methods.

  1. One supplier (recommended). Costs, then Suppliers, open the supplier, set the Auto-publish toggle to Yes.
  2. A payment method. Business settings, then Lists, then Payment methods, choose Yes in the method's Auto-publish drop-down. Setting it to Never blocks auto-publishing for everything paid that way, which is useful for a personal card used by mistake.
  3. Everything. Business settings, then Connections, Manage next to Xero, Settings, scroll to Automatic publishing and set Auto-publish all items to Yes. Dext names this account-wide switch as the setting behind most unexpected publishing; leave it off.

Auto-publish only affects documents submitted after the rule exists, and it runs after extraction. When rules overlap, Dext applies AI Assist guidance first, then user rules, payment method rules, supplier rules and finally account defaults, and Cost item exceptions override all of them. Use exceptions for document types that should never publish themselves, such as credit notes or supplier statements; note that exceptions match the item's Type field, so a statement misread as an invoice slips past a statement exception.

Bank-match auto-publish

A separate route publishes items that have a unique match on your bank feed. It needs Sync bank data and Autofill payment switched on in the integration settings first, and turning Sync bank data off stops Bank Match working at all. Bank Match compares Costs items with unreconciled bank feed transactions from the last six months, on total amount and timing: paid within 30 days of the document date when there is no due date, or within 10 days of the due date when there is one. It links existing records; it never creates bank transactions.

What stops an item publishing

Items stay in the inbox when essential fields could not be extracted, when the item was flagged as suspicious, when its type is an exception, or when a required field such as Category is still empty. An item marked To review lists its problems in the "Please resolve these issues" panel at the top of the details page: a missing supplier, category or total, a tax code the destination needs, mismatched line amounts, a duplicate in your archive, or a field an Admin made mandatory. Check auto-categorisation is not set to Never, because uncategorised documents cannot publish.

What can go wrong when Dext auto-publishes to Xero?

Auto-publishing to Xero goes wrong in four ways: the wrong code repeats on every bill, a published item cannot be pulled back, a corrected bill arrives twice, and locked periods reject certain destinations.

  • Errors at scale. A rule with the wrong account or tax rate is wrong on every bill it touches. One mistyped rule for a weekly supplier means 52 wrong bills a year until someone looks.
  • No unpublish. Dext says published items cannot be unpublished; you fix them in Xero.
  • Duplicates on republish. To republish a corrected item you must clear its publishing data first, or Xero receives a second copy.
  • Lock dates. When a document's date falls inside a Xero lock date, Dext can still publish it to Purchases as Draft or Awaiting Approval, but not as a Spend Money transaction, which fails with "The document date cannot be before the end of year lock date". Either change the destination or have an adviser move the lock date, then refresh integration data and publish again.

A realistic example of the first problem, and how it showed up. The tutoring centre's rule for the cleaning company had the tracking category set to Centre: North when the contract was for the South centre. Auto-publish posted four weekly bills in a month to the wrong centre, and nobody noticed until the monthly profit-by-centre report showed the North centre's cleaning cost up by the whole contract value while South showed none. The fix took ten minutes (correct the rule, recode four bills in Xero); the cost was a month of wrong management figures. A weekly look at auto-published bills would have caught it on day seven.

If you want help fitting Dext rules and a review routine into how your books already run, I offer one-to-one AI consultations for small businesses.

What should the weekly Dext and Xero review cover?

A weekly Dext and Xero review takes 20 to 30 minutes for a small business and covers items still To review, items auto-published that week, Xero's bill count against Dext's, and failed publishes.

  1. Clear the To review pile in Dext. Hover each badge or open the item and fix what the issues panel lists. Suspected duplicates held in Review mode sit here with an amber dot.
  2. Check auto-published items. In Dext's Archive, open each item published that week and read the History tab: it says "published via autopublish and archived by Dext" or "published manually and archived by" a named user. Spot-check five auto-published bills properly: total, tax, account, tracking and due date.
  3. Compare with Xero. In Xero's Bills to pay, count the bills created that week and compare with Dext's published count. A gap means something was keyed by hand in Xero (a duplicate risk) or something failed in Dext.
  4. Look for yellow Ready. In Dext, a Ready status in yellow means the item is correct but a previous publish attempt returned an error; hover to read it.
  5. Refresh lists if Xero changed. New account codes, suppliers or tracking options need Refresh integration data before rules can use them.
  6. Write one line in the log. What you changed and why.

Here is a filled-in weekly log from the tutoring centre's first month on auto-publish:

WeekAuto-publishedManually publishedTo review clearedProblems foundChange made
16274NoneAdded room hire to auto-publish
211243One booking software receipt with an annual chargeWorkflow note: "annual renewals go to prepayments"
313225Cleaning bills on the wrong centre (4 bills)Rule corrected; bills recoded in Xero
414212Xero count 1 higher than DextHand-keyed printing bill found; staff told to upload instead

If the weekly comparison of Dext's published count against Xero's bills in a spreadsheet is the slow part, try The Complete Excel Course with AI Integration on Coding Liquids.

Worked example: a tutoring centre's first two months on Dext and Xero

To put numbers on the set-up, follow the illustrative tutoring centre from connection to a settled routine. It receives about 140 documents a month: 35 supplier bills, 70 card receipts and 35 small sundry receipts, which fits inside Dext Business's 250 documents a month ($302.50 a year, excluding tax, for up to 5 users).

StageWorkTime
Connect and settingsConnect Xero, choose Purchases and Awaiting Payment, tax option agreed with the accountant, Sync bank data on45 minutes
Supplier rulesNine rules as in the table above, with workflow notes on the three "varies" suppliers60 minutes
Month 1, manual publishingEvery document reviewed and published by hand, about 1.5 minutes eachAbout 210 minutes
Month 2, four suppliers on auto-publish44 auto-published; 96 reviewed at about 1.2 minutes each; four weekly reviews of 25 minutesAbout 215 minutes
Month 3 onwardsWeekly review drops to 15 minutes as the log stays emptyAbout 175 minutes

Look at month 2: auto-publish saved processing time, but the weekly reviews used it up. That is normal and it is the point. The saving arrives in month 3, once the review has shown the rules are right, and the real gain is not minutes but trust: the cleaning-bill error was found in a week instead of at year end. A business that switches on account-wide auto-publish to save those first-month minutes is buying speed with its management accounts.

What the minutes do not show: card receipts were the slow part throughout, because they mix items and payment methods. Bank Match helped there by filling payment details from the bank feed, and receipts matched to a unique bank transaction became candidates for bank-match auto-publish in month 3.

Is Xero Smart Document Capture enough instead of Dext?

Xero Smart Document Capture is enough when a person codes a modest flow of bills anyway; Dext earns its price when rules, auto-publish and duplicate and statement checks save more than it costs.

Xero lists Smart Document Capture on its small business plans at no extra charge. You photograph a receipt in the Xero Accounting app, email documents to your Xero address or drag files in on the web; Xero reads receipts, invoices, bills and rent statements, attaches the original, and you double-check and approve the details before it creates the record.

NeedXero Smart Document CaptureDext with Xero
Capture by app, email or uploadYesYes, plus more routes
Saved coding per supplierNot described on Xero's pageSupplier rules for category, tax, tracking, payment, due date
Publishing without a personNo: you approve before a record is createdAuto-publish by supplier, payment method or bank match
Duplicate handlingNot described on Xero's pageAutomatic or Review modes, per supplier
Supplier statement checksNot described on Xero's pageSupplier statement reconciliation
Extra costNone on Xero's plans$302.50 a year for Dext Business

A quick sum for the tutoring centre: if Dext's rules and auto-publish save 35 minutes a month from month 3 and the owner's time is worth $35 an hour, that is about $20 a month of time against $25.21 a month of Dext. On time alone it barely pays; the case rests on the controls (duplicate review, statement checks, the audit trail in History). A business with half the documents would be better served by Xero's own capture, which the comparison of Xero Smart Document Capture against Dext examines in more depth.

Set-up mistakes that come back to bite

  • Switching on Auto-publish all items on day one. It publishes documents nobody expected. Use supplier-level rules.
  • Publishing as Awaiting Approval without an approver. Bills pile up off the Aged Payables report and supplier statements never agree; the monthly statement check in Dext's supplier statement reconciliation exposes this quickly.
  • Keying bills in Xero as well. Every bill keyed by hand for a supplier that is in Dext is a duplicate waiting to happen.
  • Changing lists in Xero and not refreshing Dext. Rules point at old codes for up to 48 hours.
  • Leaving duplicate detection on Off. Set Review for suppliers who send the same invoice twice.
  • Trusting bank matches blindly. A unique match on amount can still be the wrong supplier on a busy card; spot-check card receipts.

Three further reads help once the basics run. For the bank side of the same routine, see turning on Xero JAX auto-reconciliation and checking matches. For a trade business's version of the bill flow, capturing van receipts and supplier bills in Xero shows the same ideas with different suppliers. And if you are deciding whether Dext's paid AI coding guidance is worth adding, the breakdown of Dext AI Assist's cost weighs it up; for receipt habits generally, AI receipt capture and bank categorisation covers the set-up a bookkeeper would use.

Dext with Xero: follow-up questions

Do Dext supplier rules change bills already in my inbox?

Usually not. Dext applies rules to new documents by default. Tick Apply to all inbox items when setting a rule from an item's details page, or edit from the Rules page, to update existing inbox items. Auto-publish and line item extraction never apply to items already in the inbox.

Can I unpublish a bill that Dext auto-published to Xero?

No. Dext says published items cannot be unpublished. Fix the bill in Xero, or correct it in Dext and republish after clearing its publishing data, which Dext requires so the corrected bill does not arrive in Xero as a duplicate. That is why auto-publish starts with a few predictable suppliers.

Why won't Dext auto-publish a bill from a supplier with a rule?

Something blocked it. Dext holds back items whose essential fields could not be extracted, items flagged as suspicious, document types listed as exceptions, and items with required fields still empty, such as Category. Open the item; the Please resolve these issues panel lists what is missing.

How often does Dext sync with Xero?

Every 48 hours. That covers the chart of accounts, suppliers, customers, tax rates, tracking categories, products and services and payment methods. After changing lists in Xero, choose Refresh integration data under Business settings, Connections, Manage, or reload suppliers from Costs, Suppliers, so rules use current codes.

Should Dext publish bills to Xero as Awaiting approval?

Only if someone approves bills in Xero every week. Awaiting approval keeps bills off Xero's Aged Payables report, so supplier statements and payables balances will not agree until they are approved. Awaiting payment suits businesses that review in Dext before publishing and pay from Xero.

Further reads

Show 3 more related tutorials

Sources: Dext help centre articles on connecting Dext with Xero, supplier and customer rules, using auto-publish, auto-publish best practices, publishing documents to Xero, publishing tax data to Xero, Xero lock dates, Bank Match, To review and Ready statuses, and duplicate handling; Dext business and practice pricing pages; Xero's Smart Document Capture page (all read 22 November 2026).

Want a second pair of eyes on your setup?

Bring the process you're trying to fix. On a 1:1 call we'll work out which AI tools should handle it, which parts stay manual, and how to roll it out without disrupting the team.

Book a 1:1 call with me