Xero Archived Account Error: Deleted Account Mapping

Find which account code is causing the error:

1. Look at the error message carefully
2. Note the account code (e.g., "Account code '310' has been archived")
3. Or note the account name mentioned in error
4. If error doesn't specify account:
5. Check transaction line items for missing accounts
6. Review integration mapping settings
7. Look at bank feed rule configurations
8. Write down the account code/name for next steps

Determine the account status in Xero:

1. Log into Xero
2. Go to Accounting → Chart of Accounts
3. Scroll to bottom of accounts list
4. Click "Show archived accounts" link
5. Search for your account code or name
6. If found in archived list: Account can be restored (proceed to Step 3)
7. If not found anywhere: Account was deleted (proceed to Step 4)

Reactivate archived account to fix error:

1. In Chart of Accounts with archived accounts showing
2. Locate the archived account
3. Click "Restore" button next to account name
4. Xero will confirm: "Are you sure you want to restore this account?"
5. Click "Restore" to confirm
6. Account immediately becomes active
7. Account appears in regular chart of accounts list
8. All historical transactions remain intact
9. Retry your transaction or integration sync
10. Error should now be resolved

If account was deleted, create a new replacement account:

1. Go to Accounting → Chart of Accounts
2. Click "Add Account" button
3. Select appropriate account type:
4. Sales → Revenue/Income accounts
5. Expense → Cost/Expense accounts
6. Asset → Bank, receivables, inventory, fixed assets
7. Liability → Payables, credit cards, loans
8. Equity → Capital, retained earnings
9. Enter account code (can use same code if desired)
10. Enter account name
11. Select tax rate
12. Enable "Show on dashboard" if needed
13. Click "Save"
14. Update mappings to use new account (Step 5)

Remap integrations to active accounts:

1. Log into your integration app (Shopify, Stripe, PayPal, etc.)
2. Go to Settings → Account Mapping or Chart of Accounts
3. Click "Refresh" or "Update Chart of Accounts" button
4. This loads current active accounts from Xero
5. Find mappings showing the archived account
6. Update each mapping to use:
7. Restored account (if you restored it), OR
8. New replacement account (if original was deleted)
9. Save all mapping changes
10. Test sync with a sample transaction
11. Verify transactions post to correct accounts

Sales/Revenue account
Cost of Goods Sold (COGS)
Shipping/Freight
Payment processing fees
Refunds/Returns
Discounts/Promotions
Gift cards/Store credit
Tax liability accounts

Update bank rules using archived accounts:

1. In Xero, go to Accounting → Bank accounts
2. Click "Manage bank rules"
3. Review all active bank rules
4. Look for rules with archived accounts in:
5. Account field
6. Tracking categories
7. Click "Edit" on affected rules
8. Change account to active account
9. Update any archived tracking categories
10. Click "Save"
11. Test rule by applying it to a transaction

Fix recurring invoices and bills with archived accounts:

1. Go to Business → Invoices → Repeating
2. Check all recurring invoices
3. Click on invoices showing errors
4. Edit line items using archived accounts
5. Change account codes to active accounts
6. Save changes
7. Repeat for Bills → Repeating
8. Check Purchase Orders if you use them
9. Verify next scheduled transaction will work

If you restored account only to fix mappings:

1. After updating all mappings and rules
2. Verify all integrations sync successfully
3. Check no recurring transactions reference account
4. If account no longer needed:
5. Go to Chart of Accounts
6. Find the account
7. Click "Archive" to hide it again
8. Only archive if you're certain it's not being used