When tidying up old payout reconciliations or fixing a clearing house balance mismatch, you may see this Xero error: "The document date cannot be before the end of year lock date."
Why this happens
Xero lock dates prevent changes to closed periods. When Rechargly reconciles an old payout, it needs to record payments and invoices on their original dates. If those dates fall before your Xero lock date, Xero rejects the entries and the payout stays in For Review with a balance mismatch.
How to fix it
In Xero, go to Settings > Advanced settings > Financial settings.
Note your current lock dates so you can restore them afterwards.
Temporarily remove (or move) the lock date covering the period you need to fix.
In Rechargly, go to Payouts > For Review and select Reconcile again on the affected payout.
Once the payout reconciles, restore your lock dates in Xero.
Before you unlock a closed financial year
If the mismatch relates to a closed financial year, we suggest moving the cost and reconciliation into the new financial year. Please contact support and we will help move this for you.