Advanced Settings

Updated 28 Sept 2026

Configuration → Advanced → Advanced Settings changes core behaviour. In the product's own words, these allow you to change the core functionality of TwoCanConnect. Most orgs never touch them, and the ones that need to usually need exactly one. The screen is five cards; this article follows them in order.

Configuration → Advanced → Advanced Settings.

Default Settings

Other defaults

SettingDefaultWhat it affects
Country and Area Code Phone Fields SettingCombinedSalesforce uses one phone field; Xero uses separate country, area code and number. Decides how they map
Product Types to SyncProducts SoldWhether you sync items you sell, buy, or both
Xero Account Class TypesRevenueWhich Xero account classes sync. Add Asset, Expense, Liability or Equity if you post invoice lines to them
Rollup Calculation SummariesIncluding taxWhether the invoice summary fields on Account and Opportunity include tax
Decimal Places to allow on Invoice Creation24 shows four decimals on the invoice screen and allows four-decimal syncing to Xero
Rollup Last Invoice Date FieldInvoice DateWhich date sets a customer's Last Invoice Date
Rollup Dates from Future InvoicesNoWhether future-dated invoices count towards Last Invoice Date
Allow Sync Online Invoice URL for Historical InvoicesOffWhether the Xero online-invoice link is fetched for every invoice in a historical sync. Off since September 2026 because it multiplies API usage; the link can be fetched on demand from a record
Relate Repeating Invoices to the original objectOnInvoices generated by a repeating invoice link back to the Opportunity the template was raised from
The rollup settings. Changing the calculation type mass-updates the summary fields on every Account and Opportunity.

Two of these ask you to confirm. Rollup Calculation Summaries warns that it mass-updates the totals fields on Accounts and Opportunities, which can fire your own automations. Decimal Places set to 4 warns that Salesforce multi-currency must also be set to four decimal places for the extra precision to reach Xero.

Sync Batch Size and Use Xero Summary Only Parameter used to sit in this card. From version 1.145 they're under API Limits, with the other settings that decide how TwoCanConnect uses Xero's API.

Product Sync Mode (Multi-Org)

Shown only when two or more Xero organisations are active. Shared Products puts every organisation's products in the Standard Pricebook; Org-Specific Pricebooks gives each organisation its own. Switching doesn't need a resync; a background job migrates the pricebook entries. See Connecting additional Xero organisations.

Product Creation

Controls what happens to new products arriving from Xero.

Product Creation, the last setting under Default Settings.
OptionBehaviour
Smart (recommended)New items are created automatically. Items that look like an existing Salesforce product are held in the Matching Tool for review, so you don't get duplicates
Stage everything for reviewNothing is created automatically. Every new Xero item waits in the Matching Tool until you create or link it

Switching from Stage back to Smart queues a catch-up that creates or matches everything that was waiting.

Set this to Stage before migrating

If you have existing Salesforce products that aren't linked to Xero, a historical sync on Smart can create duplicate products instead of matching what you have. The migration tool warns about exactly this. Set Stage first, match your products, then proceed. See Migrating from another connector.

Notification Preferences

Who is told when the connection drops, and how often.

If Xero or Salesforce has an outage, or the connection drops, TwoCanConnect emails the people you nominate until it's reconnected.

  • Time Between Disconnect Notifications — the reminder interval. Set it to 12 hours and you're reminded every 12 hours.
  • Users or Groups to Notify — search for users or public groups. The installing user is added by default.
  • Disconnect Notifications — the on/off toggle.

Nominate a group rather than one person, so a disconnect during someone's leave still reaches somebody.

API Limits

API Limits. The values shown are this org's own; the defaults are in the table below.

These settings decide how TwoCanConnect uses Xero's API allowance, which is 60 calls a minute and 5,000 calls a day for each Xero organisation. The defaults suit almost every org.

SettingRangeDefault
Records per Xero CallAutomatic, 1,000, 500, 200 or 100Automatic
Sync Batch Size1 to 1010
Calls per minute10 to 5850
Daily reserve (calls kept free)1 to 4,0001,500
Use Xero Summary Only ParameterOn or offOff
Refresh Product Quantity on Hand20 to 4020
Version 1.145

Records per Xero Call, and this layout, arrive in version 1.145. On earlier versions Sync Batch Size and Use Xero Summary Only Parameter are under Default Settings, and this card shows API Daily Limit (default 2,500) and API Minute Limit (default 40). Upgrading moves an org still on those old defaults to the new ones; values you chose yourself are kept.

Records per Xero Call

How many records TwoCanConnect asks Xero for in one call when it fetches contacts, invoices, bills, credit notes and purchase orders. Larger pages mean far fewer calls, so a big historical sync stays inside Xero's per-minute allowance instead of stopping for a minute every few dozen calls. Quotes are always fetched 100 at a time, because Xero doesn't page quotes any other way.

Automatic starts every sync at 1,000. If a page comes back too large to process safely, or Xero or Salesforce rejects a large page, that type of record steps down to 500, then 200, then 100 for the rest of that sync. The next sync starts at 1,000 again. The most recent step-down is shown under the setting, with the reason.

Choose a fixed size only if the step-down line shows the same step-down on every sync: fixing it at that size saves the one oversized call each sync makes before stepping down.

Sync Batch Size

The records each sync run handles, in hundreds: the default of 10 means 1,000 records per run. Lower it only if you see CPU time limit errors, which are most likely on orgs with very large data volumes. A smaller run that completes beats a larger one that fails. Changing it doesn't change how many records are asked for in each call.

Calls per minute and Daily reserve

Calls per minute is how many of Xero's 60 calls a minute the historical sync uses before taking a short break until the next minute. The break is expected and shows as normal progress on the sync panel. A lower number is more cautious but slower.

Daily reserve is how many of Xero's 5,000 daily calls are kept free for the ongoing sync. When fewer than this many are left, the historical sync pauses until the next day and carries on by itself. A higher number is more cautious.

Use Xero Summary Only Parameter

For invoices with very large numbers of line items. The sync first fetches a lightweight summary of each invoice, then fetches the invoices in full in small batches to get their lines. Turning it on reveals Xero Summary Only Batch Limit, the number of invoices fetched in full in one call: 1 to 40, default 20. It uses more calls than a normal sync, so only turn it on when invoices are too large to sync otherwise.

Ask before enabling Use Xero Summary Only

The setting itself says to confirm with support before turning it on. Take that at face value.

Refresh Product Quantity on Hand

When stock levels are refreshed on an invoice, products are fetched from Xero in groups of this size. Leave it at 20 unless support suggests otherwise.

Purge Debug Log

The last two cards.

The red Purge Debug Log button deletes every TwoCanConnect debug log. Up to 10,000 logs are deleted immediately; more than that and a background job is scheduled.

Don't purge before raising a case

Logs are how support diagnoses a problem, and how you see when one started. Purge only after an issue is closed.

Usage Diagnostics

Daily Diagnostic Snapshot records a daily summary of the org's sync health, data volumes and Xero API usage and shares it with TwoCanConnect, so problems can be spotted before they affect you. It's aggregate counts only; no invoice, contact or financial data leaves your org. Turn Off stops the schedule; the status line shows Scheduled daily or Not scheduled.