AwardXero App of the Year Awards 2026 Finalist
qoblex_logo_main

Xero

Xero Override Rules and Tracking Categories

Each section of your Xero settings has a default ledger account that Qoblex posts to when it syncs a transaction. Override rules let you send specific transactions to a different ledger account, or stamp them with a Xero tracking category, when the default is not right for every case — for example routing one sales location to its own revenue account.

This article explains where override rules live in the Xero settings, how to build a rule and its conditions, how rule priority decides which rule wins, and what the special Inherit, None, and Do Not Sync choices do. After reading it you will be able to add, order, and review override rules with confidence, and know exactly how each rule changes where future transactions land in Xero.

Override rules are accounting controls: a rule changes where future sales, payments, COGS, adjustments, or manufacturing postings land in Xero. Set them with your bookkeeper or finance owner.


Where override rules appear

Open Integrations > Xero. What you see depends on whether Xero is already set up:

  • During first-time setup, the Xero settings open as a stepped wizard with the steps Tax Mapping, Sales, Purchases, Manufacturing, Inventory, and Review & Save. Move between steps with Back and Next, and finish on the last step with Save & Finish.
  • Once Xero is connected, the settings open as tabbed sections: Sales, Purchases, Manufacturing, Inventory, Tax mappings, and Sync Status. Edit any tab and click Save changes at the bottom to persist. (The Sync Status tab has no save action.)

Either way, the same rule sections and rule builder are used. Rule sections appear directly beneath the default-account picker they apply to. Each section starts empty, showing No added rules, with an Add rule button below it.

The override-rule sections available today are:

  • Sales section — rules for sales/invoice posting (under Sales Account) and payment posting rules (Payments, Payment posting rules (by gateway)).
  • Manufacturing section — manufacturing rules. The header above the default-account picker explains the relationship: If a rule matches, its ledger account & tracking override the defaults above.
  • Inventory section — Cost Of Goods Sold account rules and Inventory Adjustments account rules.
  • Purchases section — bill payment override rules appear under the Payments header (Bill payments default account). See the note below: these rules are not currently applied by the sync.

Sales, COGS, adjustments, and manufacturing rules choose a Xero ledger account. Sales payment rules choose a Xero bank account instead.

Bill payment override rules (Purchases section) are not applied yet. The Xero settings expose a bill payment rule section, but the sync ignores it: every bill payment posts to the Bill payments default account you set under the Purchases section’s Payments header, regardless of any rule you add. Set the default account to control where bill payments land.


What a rule does

When a transaction matches a rule’s conditions, Qoblex applies that rule’s two actions, shown in the rule builder under Actions (“What happens when a record matches this rule?”):

  • Set ledger account to — the Xero ledger account (or, for payment rules, the bank account) this transaction posts to.
  • Set tracking category to — the Xero tracking category to stamp on the posting.

Transactions that match no rule keep using the section’s default account, so the default still matters — a rule should only handle a specific exception.

Rules apply to future syncs only. Saving or changing a rule does not rewrite Xero records that were already synced before the change.


How to add a rule

  1. Open the relevant Xero settings section (Sales, Purchases, Manufacturing, or Inventory).
  2. In the rule section, click Add rule. The Edit Sync Rule dialog opens.
  3. Under Conditions (Define the conditions that trigger this rule), build the condition that should match the transaction: – Pick a Field (the available fields depend on the section — see the tables below). – Pick an Operator (for example matches, Contains, is, or a numeric comparison). – Enter or select the value to compare against. – To combine two conditions, click Add Rule Part and choose And or Or. A rule can have at most two conditions.
  4. Under Actions (What happens when a record matches this rule?), choose Set ledger account to and, if needed, Set tracking category to.
  5. Click Apply to add the rule to the section, then persist your changes: during first-time setup, advance to the Review & Save step and click Save & Finish; once Xero is connected, click Save changes at the bottom of the settings tab.

After saving, review the next synced transaction that should match the rule to confirm the condition and the selected account behave as you expect.


Rule conditions by section

The fields you can build conditions on differ per section. These are the fields Qoblex offers in each rule builder.

Sales rules

Field Notes
Online store Match by the connected store.
Sales location Match by the order’s location.
Shipping & Freight Yes/No: the line is a landed shipping/freight cost.
Sales Channel Match by sales channel code.
Tax amount applied Numeric comparison on the applied tax percentage.
Order tags Text match on order tags.
Sales origin country Match by one or more origin countries.
Sales by Product Type Match by product type.
Sales by product tags Match on product tags (contains).
Sales by Brand Match by brand.

Sales payment rules

Field Notes
Online store Match by the connected store.
Sales location Match by the order’s location.
Gateway Text match on the payment gateway.

Bill payment rules (Purchases section)

Field Notes
Gateway Text match on the payment gateway.

Manufacturing rules

Field Notes
Production Location Match by the production location.
Order tags Text match on order tags.

Cost of Goods Sold (COGS) rules

Field Notes
Location Match by location.
Online store Match by the connected store.
Order tags Text match on order tags.
Sales by Product Type Match by product type.
Sales by product tags Match on product tags (contains).
Sales by Brand Match by brand.

Inventory adjustment rules

Field Notes
Adjustment location Match by the adjustment’s location.
Adjustment Reason Text match on the adjustment reason.
Product tags Text match on product tags.

Rule order and priority

Each rule in a section carries a priority, shown as a numbered badge at the start of the rule row. Qoblex evaluates rules in priority order and applies the first rule whose conditions match; later rules are not applied to that transaction.

Reorder rules with the up and down arrows on each row. Moving a rule renumbers the whole list so the priority badges always match the displayed order. Put your most specific rules above broader ones, so a broad rule does not catch a transaction that a narrower rule should have handled. Save your changes after reordering (Save changes in the connected settings, or Save & Finish during setup).


Inherit, None, and Do Not Sync

The two dropdowns offer different special choices:

  • Inherit (ledger/bank account dropdown only) — leave the account at the section default. If a rule’s ledger account is Inherit, the matched transaction keeps the section’s default account. Use this when a rule should override only the tracking category, not the account.
  • Do Not Sync (ledger/bank account dropdown) — the “do not sync” choice, meaning the transaction is not posted to that account.
  • None (tracking-category dropdown) — do not stamp any tracking category on the posting.

The tracking-category dropdown lists only None followed by your Xero tracking categories — it has no Inherit option. A rule therefore overrides tracking only by selecting a specific category or None; to leave tracking unchanged, leave the rule’s tracking action unset.

A rule can override the account independently of the tracking category. Set the account to Inherit to change only the tracking, or leave the tracking action unset to change only the account.


Reviewing rules

Review your override rules after major accounting changes — new locations, new product categories, a new tax setup, or changes to how you manufacture or adjust stock. For each rule, confirm its condition still matches the records you intend and that the selected Xero account is still active in Xero. Remove rules created for a temporary exception that no longer reflects your accounting policy, then save your changes.

Keep rules limited to the exception they are meant to handle and order them so your accounting team can see why a transaction posted to a different account.


Troubleshooting

A transaction synced to the wrong account or tracking category
Check the section’s default account first, then confirm the rule you expected was actually saved (after clicking Apply in the dialog, you must still save the settings). Check whether another rule with a higher priority sits above it and matched first, and confirm the rule’s condition really matches the transaction. Finally, confirm the Xero account or tracking category is still active in Xero.
The tracking category came out blank
Check whether the rule’s tracking category is set to None (no tracking). If the rule leaves its tracking action unset, the posting keeps the section default, which may itself be blank.
A rule did not apply to a transaction that already synced
Rules apply to future syncs only. A transaction synced before the rule was added or changed keeps its original Xero posting. Review and correct that record in Xero according to your accounting process; changing the rule does not rewrite historical postings.
A broad rule is catching transactions a specific rule should handle
Rules apply in priority order and the first match wins. Use the up arrow to move the more specific rule above the broader one, then save your changes.

Share

Updated

Your next stage of growth is just a click away