Skip to main content

Account mapping error on Link My Books

Fixing Account Code Archived, Account Code Invalid, Missing Accounting Codes and Deleted Account Reference errors when a settlement posts to Xero or QuickBooks

Written by Donna Walker

What this error means

You may see an error like:

  • Account Code Archived

  • Account Code Invalid

  • Missing Accounting Codes

  • Deleted Account Reference

  • Failed to save accounts (this one happens during the setup wizard rather than when a settlement posts — see the section at the bottom of this article)

This error appears when Link My Books tries to send a settlement to your accounting software, but one of the accounts or tax codes referenced in the transaction is no longer valid.

This usually happens when an account that Link My Books is configured to use has been deleted, archived, or changed in Xero or QuickBooks.


Why this happens

Common reasons include:

  • An account used by Link My Books was archived in Xero or QuickBooks

  • An account was deleted or renamed

  • A tax code referenced by Link My Books is no longer available

  • The account mapping in Link My Books was not fully completed

Because the account or code cannot be found, the accounting platform rejects the transaction.

How to resolve it

Check the account mappings used by Link My Books.

Steps:

  • Open Link My Books

  • Go to Accounting & Taxes settings

  • Review your account and tax mappings

  • Ensure all required accounts and tax codes are selected

You should also check in Xero or QuickBooks that:

  • the mapped account still exists

  • the account has not been archived

  • the tax code used in the mapping is active

If an account was deleted or archived, either restore the account or update the mapping in Link My Books.


"Failed to save accounts" during the Setup Wizard

If you see "Failed to save accounts" while completing the Accounts & Taxes wizard — rather than when a settlement posts — that is a different problem from the errors above, and it is documented in full in How to Set Up Your Account and Tax Rate Mappings, under Troubleshooting setup wizard errors.

✅ Worth knowing before you contact us: several causes of that error you can fix yourself, including an expired free trial — take out a subscription and re-run the wizard. The other causes covered there are accounts with conflicting names or codes in your bookkeeping software, permission restrictions on the connected bookkeeping account, a stale sales channel connection, and the same marketplace seller ID already being connected to another Link My Books account.

When to contact Link My Books support

Contact Link My Books support if:

  • you cannot identify which account is causing the error

  • all accounts appear active but the error still occurs

  • the settlement continues to fail after updating the mappings

Please include:

  • the settlement ID

  • the exact error message

  • the events or steps that led to the error

  • a screenshot if possible

This will help our team investigate more quickly.

Did this answer your question?