Skip to main content

Manage Xero Integration Settings

How to assign default items/tracking categories/ledger accounts from Xero, and choose which Xero Contact groups to sync with MinuteDock.

Updated this week

MinuteDock can be selective about which Xero Contact groups are synced, as well as automatically apply Xero accounting fields (Items, Tracking Categories, and Ledger Accounts) to your invoices based on the User, Contact, Project, or Task associated with each Time Entry.

Configure Default Settings

Set account-wide defaults that apply to all invoices unless overridden by more specific Contact/Project/Task settings.

Access Xero Integration Settings

  1. Click the Xero button in the top-right navigation bar

  2. Select Integration Settings from the dropdown menu

  3. Locate the Invoicing Options section

Set Your Contact Sync Settings

You can pick and choose which of your Xero Contact groups are synced into MinuteDock by checking/unchecking the tick boxes by each group under the Sync Settings section.

Important: Xero's default Customers group only includes Contacts which have had an invoice made against them in Xero. New Contacts will not automatically go to this group.

If you find you have Contacts in Xero which aren't syncing through to MinuteDock, it's likely that those Contacts are not included in the Contact groups you have chosen to Sync. Since you can't manually add Contacts to the Customers group in Xero, this is the most likely culprit.

💡Best Practice: You can create a custom Contact group in Xero for your 'MinuteDock Imports' and assign the contacts you want to sync to that group.

Set Your Invoicing Defaults

Choose default values for:

  • Item - The default service or product item from your Xero inventory

  • Account - The default ledger account for revenue recognition

  • Tracking Categories - Default categories for your Xero reporting dimensions

These defaults apply to all Time Entries unless overridden by more specific settings at the User, Contact, Project, or Task level.

Customize by User/Contact/Project/Task

Override default settings for specific Users, Contacts, Projects, or Tasks to automate field selection based on your business needs.

Understanding the Priority Order

MinuteDock applies settings in a specific priority order. Higher-priority settings override lower-priority ones:

Important: Settings apply in the following order:

  1. Task settings (highest priority) - override all others

  2. Project settings - override Contact and User settings

  3. Contact settings - override User settings

  4. User settings - override system defaults

  5. System defaults (lowest priority)

This means a Task's Xero invoicing settings will always be used if specified, regardless of other settings.

Configure User-specific Settings

Apply Xero fields based on which team member performed the work:

  1. Navigate to the Account screen using the top navigation bar

  2. Click Your Team to view all Users

  3. Click Edit next to the User in the Team list

  4. Look for Xero Invoicing Options on the right side

  5. Select specific values or leave as "Default" to use system defaults

  6. Click Save Changes

Configure Contact Settings

Apply Xero fields based on which client you're invoicing:

  1. Navigate to the Contacts tab

  2. Click Edit on the Contact card

  3. Scroll to Edit Xero Invoicing Options

  4. Choose specific values or leave as "Default"

  5. Click Save Changes

Configure Project or Task Settings

Apply Xero fields for specific types of work within a Contact:

  1. Navigate to the Projects tab

  2. Click Tasks in the sub-navigation (if editing a Task)

  3. Click Edit on the Project or Task card

  4. Scroll to Edit Xero Invoicing Options

  5. Choose specific values or leave as "Default"

  6. Click Save Changes

Success! When you send invoices to Xero, the configured fields will automatically apply to each line item based on your settings hierarchy. You'll see these reflected in your Xero draft invoices, ready for final review.

Verify Your Configuration

After setting up your Xero field automation:

You might want to create a test invoice to verify your configuration before processing client invoices.

Check that the correct Items, Tracking Categories, and Ledger Accounts appear for different combinations of Users, Contacts, Projects, and Tasks.

Did this answer your question?