Troubleshooting & FAQ
Xero sync failed or is still pending
Keep the MiniTill operational result separate from the accounting sync and retry the specific failed Xero action rather than recreating the sale/closing.
Overview
- MiniTill has several distinct Xero workflows: Account Sale invoices, Till Closing/daily sales, Expense receipts, and Marketplace settlement/accounting flows.
- An operational MiniTill action can succeed while the Xero sync fails afterward.
- For example, a Till can be successfully closed even if its Xero sync status becomes FAILED.
- Creating another MiniTill sale/closing/settlement to fix Xero can duplicate operational/accounting records.
When to use this
- Use this when MiniTill says an order/till/settlement completed but Xero status is FAILED/pending.
Step-by-step
- Confirm the MiniTill operational record itself already completed.
- Open the specific Xero sync status/log/error for that workflow.
- Check Business Xero connection/account/contact mappings.
- Fix the mapping/connection issue.
- Use the workflow's supported Retry.
- Verify Xero before attempting any manual duplicate posting.
Common mistakes
- Do not re-close a Till because only Xero sync failed.
- Do not recreate an Account Sale invoice or order just because Xero sync is waiting to retry.
- Do not assume every Business Document Supplier Invoice Apply posts a Xero bill; that current workflow updates MiniTill purchasing prices.
Troubleshooting
- If Xero already shows the transaction but MiniTill reports a failure, do not retry immediately; contact support or confirm the sync history first to avoid a duplicate.
- If the Xero connection is disconnected, reconnect Xero and check the account mappings before retrying.