Xero Integration Sync Errors: E-commerce & Marketplace

Re-establish authentication between your integration app and Xero:

1. Log into your integration platform (Shopify app, Amazon connector, etc.)
2. Navigate to Settings → Integrations or Connections
3. Find Xero connection status
4. Click "Disconnect" or "Revoke Access"
5. Confirm disconnection
6. Wait 30-60 seconds for complete disconnect
7. Click "Connect to Xero" or "Authorize Xero"
8. You'll be redirected to Xero login page
9. Log in with your Xero credentials
10. Select the correct Xero organization
11. Review requested permissions carefully
12. Click "Allow access" to grant permissions
13. Verify successful connection in integration dashboard

Ensure transactions are mapped to active Xero accounts:

1. In your integration app, go to Settings → Account Mapping
2. Review all mapped Xero accounts:
3. Sales/Revenue account
4. Cost of Goods Sold (COGS)
5. Shipping/Freight account
6. Refunds account
7. Fees/Expenses account
8. Payment gateway account
9. For each mapping, verify account still exists in Xero
10. Log into Xero → Accounting → Chart of Accounts
11. Ensure mapped accounts are not archived or deleted
12. If account missing, update mapping to correct active account
13. Click "Update Chart of Accounts" in integration app
14. Save all mapping changes
15. Test sync with a recent transaction

Ensure integration has required access to Xero data:

1. Log into Xero
2. Go to Settings → Connected Apps
3. Find your integration app in the list
4. Click on the app name to view details
5. Review granted permissions - should include:
6. Read and write invoices
7. Read and write contacts
8. Read and write bank transactions
9. Read chart of accounts
10. Read and write items/inventory
11. If permissions are insufficient, disconnect and reconnect app
12. Grant all requested permissions during reconnection
13. Test sync after permissions update

Xero API has rate limits that can cause sync failures:

1. Check integration app for rate limit warnings
2. Xero rate limits (per organization):
3. 60 API calls per minute
4. 5,000 API calls per day
5. 10,000 API calls per day for partner apps
6. If hitting limits, adjust sync frequency:
7. Change from real-time to hourly sync
8. Reduce number of synced items
9. Schedule syncs during off-peak hours
10. Wait for rate limit reset (usually 1 hour)
11. Retry sync after waiting period

Per Minute: 60 calls
Per Day: 5,000 calls (standard) / 10,000 (partner)
Limit Reset: Hourly rolling window
 
Error Response: 429 Too Many Requests

Identify specific sync errors from detailed logs:

1. In integration app, find Error Logs or Sync History
2. Look for recent failed syncs
3. Click on failed transaction to view error details
4. Common error messages and solutions:
5. "Account code archived" → Update account mapping
6. "Invalid tax code" → Fix tax rate mapping
7. "Contact not found" → Create customer in Xero
8. "Duplicate invoice" → Check for existing invoice
9. "Authentication failed" → Reconnect to Xero
10. Fix identified issues based on error message
11. Use "Retry" button to resync failed transactions
12. Monitor for successful sync completion

Ensure products and tax rates sync correctly:

1. In integration app, go to Product Mapping or SKU Mapping
2. Review product assignments to Xero items
3. For unmapped products:
4. Create matching item in Xero inventory
5. Or assign to existing Xero item code
6. Check tax code assignments:
7. Tax Exempt → Tax Exempt in Xero
8. Standard Rate → Tax on Sales (20% UK, varies by country)
9. Zero Rate → Zero Rated Expenses/Sales
10. Save all product and tax mappings
11. Run "Update Product Catalog" if available
12. Test with a sample order containing mapped products

Reset integration app data cache:

1. In integration app settings, look for "Clear Cache" option
2. Click "Clear Cache" or "Reset Sync"
3. This removes temporary sync data and resets connection
4. Log out of integration app
5. Clear browser cache and cookies
6. Log back into integration app
7. Verify Xero connection is still active
8. Trigger manual sync for failed transactions
9. Monitor sync progress and check for errors

If errors persist, get help from integration provider:

1. Gather error details before contacting support:
2. Exact error messages
3. Transaction IDs that failed
4. Screenshots of error logs
5. When error first occurred
6. Contact integration app support via:
7. In-app chat or support ticket
8. Email support team
9. Phone support (if available)
10. Provide all gathered information
11. Follow their specific troubleshooting steps
12. Request escalation if standard fixes don't work