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.
Where override rules appear
Open Integrations > Xero. The Xero settings open as a stepped wizard with the steps Tax Mapping, Sales, Purchases, Manufacturing, Inventory, and Review & Save; go to the step you want. 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 step — rules for sales/invoice posting (under Sales Account) and payment posting rules (Payments, Payment posting rules (by gateway)).
- Manufacturing step — manufacturing rules. The step header above the default-account picker explains the relationship: If a rule matches, its ledger account & tracking override the defaults above.
- Inventory step — Cost Of Goods Sold account rules and Inventory Adjustments account rules.
- Purchases step — 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.
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.
How to add a rule
- Open the relevant Xero settings step (Sales, Purchases, Manufacturing, or Inventory).
- In the rule section, click Add rule. The Edit Sync Rule dialog opens.
- Under Conditions, 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.
- Under Actions, choose Set ledger account to and, if needed, Set tracking category to.
- Click Apply to add the rule, then Save changes at the bottom of the Xero settings page to persist it.
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 step)
| 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. Click Save changes after reordering.
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.
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 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.
